年度预算协同平台
连接船东与代理,让预算协同更清晰。
连接航运 · 让预算更清晰
环境与接口说明
已接真实接口:登录/会话、案例读取、草稿保存与校验、提交/退回/批准、对比视图;结构化数据导出(CSV)已联调通过(QA 证据 backend/evidence/shouye-qa/ui-export-bom-verify-0155)。仍未实现:xlsx 导出、Word 附件审核报告。本部署为验收演示环境,请勿输入真实凭据。
技术说明
已接真实接口:案例读取、草稿保存与校验、提交/退回/批准、对比视图。本页不加载假数据;失败态如实提示,不伪造成功。
数据说明
收入拆分 12 个科目按“一项一行、左侧名称、右侧金额”填报;手机端自动改为上下排列。合计与年化结果由系统统一生成。月份数由审核方确认,代理只读;提交后进入审核流程,退回后按理由修改并重新提交。
主营业务收入拆分(代理原币)
请按顺序逐项填写 12 类收入,空值视为缺失/待补,不以 0 代替。月份数由审核方确认,本页只读:待总管理人确认。分段合计与年化结果由系统统一生成。
合计(第一段,5 项):(后端未返回,待联调)
合计(第二段,6 项):(后端未返回,待联调)
月均(后端返回):(后端未返回,待联调)
剩余月估算(后端返回):(后端未返回,待联调)
全年预估(后端返回):(后端未返回,待联调)
尚未提交。
月份数 N 由审核方设定,前端只读;批准为终态锁定、不自动重开。提交/退回/批准均可在网络中断后安全重试。
技术说明
N 未确认或依赖规则未获批时,提交会被后端以 422 阻断(例如 PERIOD_MONTHS_INVALID);审核终态口径未获批时后端按 422 阻断,前端不自定义批准语义;提交/退回/批准均带 If-Match 与幂等键。
报告输出
按当前选中的提交版本生成预算报告,包含原币金额、全年预估、原因说明和审核记录。
选择提交版本后,点击“预览报告”。
提交与交付结果
尚未读取提交信息。
技术详情
提交版本:
交付结果
技术说明
数据来自只读 GET /api/v1/submissions/{submission_id}/artifacts(state 由后端交付表状态派生,未枚举的取值按原文显示)。本页不重算、不写回、不发起任何写请求;下载链接指向只读 GET /api/v1/artifacts/{artifact_id}/download。
技术详情
历史提交
技术说明
采纳规则:历史提交里 version 最大者为「当前提交」;退回后重新提交会生成新的 version,界面自动切换到最新一条。每条目自带「采纳为当前提交」按钮,点击后立即用该 submission_id 覆盖当前目标并重绘本页「当前提交」文案(只改目标,不发出任何写请求)。退回/审核(approve)都作用于已采纳的 submission_id,且 If-Match 取案例冻结 revision(GET /api/v1/cases/{id} 的 ETag),不使用提交版本号。本区数据来自 GET /api/v1/submissions/{submission_id}(冻结快照与交付登记),本页不重算金额、不写回、不发起任何写请求;交付状态为 null 或缺失时显示"暂无登记"。
呈现行
技术详情
技术说明
只读展示:数据来自 GET /api/v1/submissions/{submission_id}/presentation-rows(冻结快照的年化口径)。金额原样展示,本页不重算、不取整;缺失依赖显示“暂无依赖数据”,不以 0 代替。
结构化数据导出
提交审核通过后,可导出代理填列数据(CSV / XLSX)。未完成或失败时不会生成文件;Word 附件审核报告暂不可用。
技术说明(端点与联调证据)
导出已真实可用,需该提交已审核通过;未导出或失败时不会生成任何文件。状态码 202 仅表示受理,不表示完成。xlsx 导出已实现(与 CSV 同源同数据);仍未实现:Word 附件审核报告(模板映射未确认)。导出为只读 GET /api/v1/submissions/{submission_id}/agent-input.csv;下载件与后端响应体逐字节相同(含 UTF-8 BOM 与 CRLF),已在真实 Chrome + 真实后端联调通过(QA 证据 backend/evidence/shouye-qa/ui-export-bom-verify-0155)。
数据对比(只读,船东实际 vs 代理预算)
左右滑动查看全部对比列,科目名称会保持固定。
| 科目 | 船东1~8月实际(原币) | 船东全年(原币) | 船东1~8月实际(本币) | 船东全年(本币) | 代理2027预算 | 代理2026年化(原币) | 代理2026年化(本币) | 差异 | 差异率 | 环比 | 环比率 | 原因说明 |
|---|
只读展示:金额一律原样,本页不计算、不取整;缺失或不可用显示“待补/不可用”,不以 0 代替。
技术说明
数据来自 GET /api/v1/cases/{case_id}/comparison。列组①–⑧按原币口径,本币值仅展示。行结构按 docs/architecture/reviewer-comparison-view.md 二、行结构:第一段(船代)5 项(AGF / MGF / CGF / TGF / DD COM)+ 小计;第二段(货代)操作佣金=DOPT+OPT、揽货佣金=NDSAL+NSAL、运费收取佣金=DCOL+COL、进舱单的local charge返还佣金 + 小计;末行总计(=两段小计之和),故共 12 行(2 个小计 + 1 个总计);小计行与总计行加粗。