编制: 西安远晨信息科技有限公司 ｜ 日期: 2026-06-29 ｜ 状态: 草稿（待客户确认）
目标读者: 冯庆（创信腾跃业务负责人）及参与需求确认的业务团队成员
用途: 逐模块锁定二期需求细节，为开发合同提供范围依据。本文档不含报价、人天、技术实现方案。
配套: Mockup 原型（线上地址: mockup-0-index.html）；《二期需求确认书 v1.0》

创信出口贸易合同管理系统 — 二期详细需求设计

文档导航

本文档按业务域组织，共 13 章 + 2 个附录。每个模块包含：业务背景 → 角色 → 页面与交互 → 数据字段 → 业务规则 → 与其他模块的关系 → 待确认项。

建议按章节顺序阅读，也可直接跳到关注的模块。文中所有 mockup 引用均可在线上原型对应页面找到具体位置。

| 章 | 内容 | Mockup |
|---|------|:--😐---|
| 一 | 总览：从一期到二期的变化 | — |
| 二 | 多公司治理与权限自定义 | C-3 |
| 三 | 贸易链条配置化 | 4C |
| 四 | 合同模板配置化 | C-2 |
| 五 | 订单录入增强 | C-11 |
| 六 | 核价台升级 | C-6 核价台 C-6 配置 |
| 七 | 报关与许可证闭环 | C-4 |
| 八 | 铭牌生成 | C-4 页面内含入口 |
| 九 | 系统管理模块群 | B 系统配置 3B BOM |
| 十 | 看板与多维报表 | C-7 |
| 十一 | 业务履约节点 | 履约进度 |
| 十二 | 财务收付款与退税 | C-9 |
| 十三 | 站内通知中心 | C-10 |
| 十四 | 手机端响应式适配 | C-3 移动端 |
| 十五 | 系统基础能力与工程保障（安全/审计/性能/OSS/密码/版本/配置） | — |
| 附录A | 待客户确认问题清单 | — |
| 附录B | Mockup 完整索引 | — |

一、总览：从一期到二期的变化

1.1 一期系统现状

一期系统（https://trade.cxautomobile.com）已于 2026 年 6 月验收上线，覆盖改装车单一业务类型、创信单一公司主体的以下能力：

• 订单管理：财务核价台 + 经销商自助建单，共享同一订单流程（draft → pending_contract → generating → completed）
• 财务核价：每日汇率锁台、单车费用录入、换汇比预警、核价确认触发合同生成
• 合同生成：7 份合同 + 1 份形式发票一键生成，车型名称按合同自动匹配，PDF/ZIP 下载，电子印章自动加盖
• 基础能力：4 个固定角色（admin/finance/salesperson/dealer）、首页看板、经销商管理、用户管理、订单软删除保护

系统的核心约束：贸易链条硬编码（创信→聊工→璟沁玥→4S店→宁波豪威斯特）、合同模板写死、角色写死、单公司。

1.2 二期要解决的核心问题

瑞驰新业务（约 2 亿订单）即将启动，要求：

1. 瑞驰以独立公司主体接入——与创信数据隔离，新车直出，链条完全不同（无改装厂、无物料合同，只出 3 份合同）
2. 报关出错成本高——报关单出错改一张几百美元，海关另罚款 1000~20000 元，需要系统内自动核验
3. 贸易链条需灵活——未来可能增减中间商、切换业务类型，链条不能写死
4. 手工台账效率低——许可证、报关、收付款等全靠 Excel + 微信群
5. 系统管理需自主化——管理员在前台维护车型、配件、配置，不依赖技术人员

1.3 二期目标

从「固定单链条、单公司、单业务类型」升级为「可配置链条、多公司隔离、全链路闭环」的贸易管理平台。两条主线：

• 配置化：贸易链条、合同模板参数、加点费率、权限角色、系统参数从硬编码改为可配置
• 业务闭环：补齐报关、许可证、退税、收付款等下游环节

1.3a 系统演进全景

一期是固定单链条合同生成工具，二期升级为多公司可配置贸易管理平台。

1.4 二期新增系统角色

角色不再写死——通过权限自定义实现功能勾选式配置（见第二章）。

1.5 实施优先级与本文档覆盖范围

P2 模块（履约节点/收付款）在本文档中只描述数据模型和界面形态，具体交互细节在进入开发阶段时补充。对象存储迁移及其他系统基础能力详见第十五章。

二、多公司治理与权限自定义

Mockup: 角色权限配置页（页面中部「权限配置」Tab）

2.1 业务背景

一期只有创信一个公司主体，4 个角色写死在代码里。瑞驰接入后，两个公司的数据须完全隔离：

• 瑞驰管理员只能看瑞驰的订单、合同、报表
• 创信管理员只能看创信的数据
• 超级管理员（冯庆）可跨公司查看全部数据

同时，新增的许可证岗、信息员、退税财务需要对应的工作权限，且未来岗位可能调整，权限不能写死。

2.1a 多公司组织结构

超级管理员跨公司可见全部数据。各公司管理员及以下角色绑定本公司，数据完全隔离。具体权限通过角色管理页的功能勾选矩阵配置。

2.2 操作角色

• 超级管理员：创建公司、设置公司管理员、查看全部公司数据
• 公司管理员：管理本公司的用户、角色、基础数据、系统配置（授权范围不得超过自身权限）

2.3 页面与交互

公司管理

系统管理菜单下新增「公司管理」页（仅超级管理员可见）。页面结构：

• 公司列表（表格）：公司代码 / 公司名称 / 默认增值税率 / 状态（启用/停用）/ 操作（编辑/停用）
• 顶部「新增公司」按钮，弹窗填写公司信息

顶部 Header 右侧有「公司选择器」下拉（超管可切换，普通用户锁定当前公司）。

角色与权限配置

系统管理菜单下新增「角色管理」页（公司管理员可见，仅操作本公司角色）。页面结构：

• 左侧角色列表：显示本公司所有角色（含系统内置角色如「公司管理员」「资料岗」「核价财务」等，标记🔒不可删除）
• 右侧权限矩阵：点击左侧角色，右侧显示该角色的功能权限表

权限矩阵结构（参照 mockup 中部「权限配置」Tab，页面右侧表格区）：

每个模块 6 个操作维度（查看/新增/编辑/删除/审批/导出），勾选即授权，未勾选则对应菜单和按钮不显示。

角色详情区包含：

• 角色名称、角色描述
• 数据范围：本人数据 / 本公司数据 / 跨公司数据（跨公司仅超级管理员可配）
• 经销商数据范围：全部经销商 / 本人经销商 / 指定经销商
• 该角色下的用户列表

用户管理增强

现有用户管理页新增以下字段和能力：

• 所属公司：下拉选择（超管可设，公司管理员新增用户默认本公司）
• 角色：下拉选择本公司已配置的角色
• 停用/启用：替代删除（有业务数据的用户不可删除，只能停用）
• 管理员重置密码：管理员可为用户重置密码，用户首次登录强制修改

2.4 数据字段

公司（Company）

角色（Role）

用户（User 扩展）

2.5 业务规则

1. 公司管理员授权边界：公司管理员创建角色时，只能在自己已有权限范围内勾选；不得授予跨公司数据范围。跨公司范围仅超级管理员可配置，操作写入审计日志。
2. 数据隔离粒度：二期只做到公司级 + 经销商级。订单、合同、核价、基础数据、报表均按 company_id 过滤。更细粒度（字段级、时间维）后置。
3. 角色迁移：一期 4 个角色（admin/finance/salesperson/dealer）在二期上线时自动转为各公司的内置角色模板，已有用户按原角色分配到对应模板。权限矩阵按原代码行为预勾选。
4. 瑞驰合伙人入口：瑞驰合伙人默认只看到本公司看板、订单进度和必要提单入口。具体首页指标和授权边界见第十四章和附录 A Q20。

2.6 与其他模块的关系

• 贸易链条：贸易链条按 owner_company_id 隔离；各公司配置各自的链条
• 合同模板：模板抬头、收款账户按公司分别配置
• B1-B10 系统管理：所有管理界面按公司过滤数据
• 通知中心：通知按公司+角色路由
• 手机端：瑞驰合伙人首页和数据权限由多公司角色模型控制

2.7 待确认

• Q20：瑞驰合伙人手机端首页必看指标、是否可提单、公司管理员能否创建用户和管理员、授权是否不得超过自身权限 → 见附录 A

三、贸易链条配置化

Mockup: 贸易链条配置页

3.1 业务背景

一期贸易链条硬编码为「创信→聊工→璟沁玥→4S店→宁波豪威斯特」，合同生成引擎按此固定链条产出 7 份合同。但：

• 瑞驰做新车直出，无改装厂、无物料合同，只出 3 份合同（①外贸 + ⑤底盘 + ⑦形式发票）
• 璟沁玥下游可能再加供应链公司，或绕过璟沁玥直采
• 二手车直出，下游无配件商

链条必须从代码中解耦，改为后台可配置。

3.1a 贸易链条概念模型

模型的核心区分：贸易公司（TradeCompany）是链条配置级参与方，可增删替换；4S店、国外客户、经销商是订单级可变参与方，在节点中以占位符形式引用（__4s__、__customer__、__dealer__），不在链条配置中固化。

3.2 操作角色

• 公司管理员：创建和维护本公司的贸易链条
• 财务（核价时）：为订单选择走哪条贸易链条

3.3 页面与交互

系统管理菜单下新增「贸易链条」页。页面结构（参照 mockup 中部「节点配置」表格）：

上半部分——链条列表：

• 表格列：链条名称 / 业务类型（改装车/新车/二手车）/ 合同数量 / 状态（启用/停用）/ 操作
• 「新增链条」按钮 → 弹窗：链条名称、业务类型、说明

下半部分——节点与合同配置（点击链条行展开）：

• 节点序列表（表格，一行一个买卖关系）：

其中 __4S店__、__国外客户__、__配件供应商__ 为订单级占位符——这些参与方每单不同，不在配置中固化。其他为贸易公司（TradeCompany），需先在「贸易公司管理」中登记。

• 合同项配置（表格，该链条出哪几份合同）：

• 右侧流程预览图：小型流程图，展示卖方→买方链条和对应合同编号，配置时实时更新。

核价台选链条

财务在核价台创建核价时，新增「选择贸易链条」下拉框（参照 mockup C-6 核价台页面顶部「贸易链条」选择区）。选定链条后，合同生成将按该链条产出对应合同。

3.4 数据字段

贸易公司（TradeCompany——链条上可配置的参与方）

贸易链条（TradeChain）

链条节点（TradeChainNode）

链条合同项（TradeChainContract）

3.5 业务规则

1. 链条与车型解耦：贸易链条独立配置，不与车型绑定。财务在核价时为每笔订单选择走哪条链条。
2. 一个合同不跨链条：同一订单内车型如果贸易路径不同，拆为独立订单/合同处理。
3. 改装车出 7 份，新车/二手车出 3 份：具体合同清单由链条合同项配置决定。
4. 配件供应商是链条级参与方（宁波豪威斯特等配件商可配置、可替换），但 4S 店、国外客户是订单级可变参与方（占位符形式），不在链条配置中固化。
5. 订单 trade_chain_id：核价时财务选定链条后写入订单，后续合同生成、履约节点均据此展开。

3.6 与其他模块的关系

• 合同模板：链条合同项绑定模板代码，决定每份合同用哪个模板
• 核价台：核价时选链条，加点配置按链条节点取值
• 履约节点：履约节点列表挂在贸易链条上（一条链一套节点）
• 多公司隔离：链条按公司隔离，各公司独立配置

3.7 待确认

• Q15：已闭环——系统已是动态可配设计，具体节点清单实施时配置即可，不阻塞需求确认。

四、合同模板配置化

Mockup: 合同模板配置页

4.1 业务背景

一期 7 份合同的模板结构、表头、收款账户、币种全部写死在合同模板代码中。瑞驰接入需要不同的卖方抬头和收款账户，离岸人民币场景需要 VTB 银行账户，一期无法支持。

二期对模板进行分层处理：

在线合同编辑器（可视化模板编辑）属于远期需求，二期不做。

4.2 操作角色

• 公司管理员：配置本公司的合同模板参数
• 资料岗：生成合同时系统按配置自动填充表头和账户

4.3 页面与交互

系统管理菜单下新增「合同模板」页。页面结构（参照 mockup 中部「模板配置」区域）：

• 左侧模板列表：7 份合同模板（①外贸 / ②内采 / ③底盘聊工→璟沁玥 / ④物料聊工→璟沁玥 / ⑤底盘璟沁玥→4S店 / ⑥物料璟沁玥→配件商 / ⑦形式发票）
• 右侧配置区（点击模板展开）：

表头信息：

• 卖方抬头（公司名称中/英文）
• 卖方地址、税号、联系人、电话
• 买方占位符（订单数据带入）

收款账户（按币种分列）：

• USD 账户：开户行 / 账号 / SWIFT Code
• RMB 账户：开户行 / 账号
• 离岸人民币（VTB）账户：开户行 / 账号

合同⑤特定信息段变量槽（待客户提供样本后确定具体字段）

4.4 数据字段

合同模板配置（ContractTemplateConfig）

4.5 业务规则

1. 币种联动：订单选择币种后，合同生成时自动选用对应币种账户。
2. 模板绑定：合同模板通过 链条合同项与贸易链绑定，一条链上的每份合同对应一个模板。模板本身不绑定业务类型——瑞驰新车和改装车可复用同一套模板（仅链条合同项不同）。
3. 结构不放开：模板的 模板结构（条款、表格、排版）不在二期前台配置范围内。如需调整结构，通过代码发布更新。

4.6 待确认

• 合同⑤中璟沁玥→4S店合同的「特定信息段（1~12 月数据）」具体包含哪些字段？→ 需客户提供当前在用合同样本确认

五、订单录入增强

Mockup: 订单录入页

5.1 业务背景

一期订单录入存在以下问题：

• 合规事故：合同岗曾把霍尔果斯（境内）经销商误录为外贸客户，签了外贸合同还收了美金，外汇局出现异常记录。4 月发生一次后又重犯。
• 地址记忆不稳定：客户地址靠浏览器缓存带出，部分电脑无效。
• 缺少离岸人民币：外贸合同只能选 USD，无法支持离岸人民币（VTB 银行）场景。
• 订单号容量：当前 4 位流水，按年约 1449 条，虽暂不破万，但瑞驰 2 亿订单上线后可能接近上限。

5.2 操作角色

• 经销商：录入新订单，选择币种
• 资料岗：代录订单
• 财务（核价时）：审阅订单信息

5.3 页面与交互

参照 mockup C-11 订单录入页。

境外地址校验（新增）

订单录入表单中，当买方为「国外客户」时：

1. 系统检查买方名称和地址是否包含国内城市英文名（基于内置城市英文名库）
2. 若命中境内城市 → 表单校验失败，提示「买方地址包含境内城市 [城市名]，外贸客户不应为境内主体」
3. 校验通过后解锁「提交核价」按钮

示例：地址含 Khorgos（霍尔果斯）、Shenzhen（深圳）等 → 拦截。

经销商不校验

经销商是系统预配置数据（下拉选择，不自由填写），不做境内外校验。

地址数据库记忆（新增）

• 录入新客户名称和地址后，系统自动保存
• 后续相同客户名称 → 自动联想带出上次地址
• 跨浏览器、跨设备生效（服务器端存储，非浏览器缓存）

币种选择（新增）

订单创建表单新增「币种」下拉（参照 mockup 中部「定价参数」区）：

• USD（默认）
• 离岸人民币（CNY Offshore）

选择离岸人民币后，合同收款账户自动切换为 VTB 银行账户（由合同模板配置决定，见第四章）。

订单号动态扩位

• 订单号格式：{prefix}{YYMM}{序号}{suffix}
• 序号部分动态扩展：4 位→5 位→6 位（达到上限自动进位）
• 按年重置，每个公司独立序号队列
• prefix/suffix 按公司×合同类型可配置（如改装车后缀 G、二手车后缀 E）
• 历史订单号不受扩位影响，新旧并存

5.4 数据字段

城市英文名库

一次性导入公开数据（民政部行政区划英文名 + 常用变体/拼写别名），不需持续维护机制。支持模糊匹配（如 Horgas/Khorgos/Horgos 均匹配霍尔果斯）。

地址记忆

5.5 业务规则

1. 校验仅针对外贸客户字段：经销商字段不校验境内/境外
2. 城市名库覆盖：含所有地级市+直辖市+霍尔果斯等特殊口岸的英文名
3. 记忆更新：同一客户名称重新录入地址时覆盖旧记录
4. 订单号扩位不回溯：已生成的订单号不变，仅影响新生成

5.6 待确认

• Q9：订单号扩位策略已内部定案（按年重置+动态扩展+每公司独立队列）。请客户过目确认。
• Q11/Q12：已闭环——经销商不校验，城市英文名库一次性导入即可。

六、核价台升级

Mockup: 核价台操作页 + 加点配置页

6.1 业务背景

一期核价台计算引擎中，加点系数硬编码为两个全局值：margin_cxlg=0.013（创信→聊工加价 1.3%）和 margin_lgjqy=0.008（璟沁玥→聊工加价 0.8%）。无法直观查看和调整，核价台也不展示各环节留存利润。

二期要求：(1) 加点可视化配置（比例/固定额）；(2) 核价台展示留存利润；(3) 加点配置有修改记录可回溯；(4) 回退重算时控制加点取值策略。

6.1a 核价加点链路

下图以改装车标准链为例，展示从4S店底盘采购价到最终外贸价的逐环加价链路：

一期只有2个固定加点系数（margin_lgjqy=0.008, margin_cxlg=0.013）。二期将加点配置化为每个链环节可独立设置比例或固定额，核价确认时快照定格，回退时可选择沿用快照或切换最新配置。

6.2 操作角色

• 公司管理员：配置本公司贸易链各节点的加点
• 财务（核价时）：查看留存利润，回退时选择加点取值方式
• 经销商：不可见价格字段

6.3 页面与交互

加点配置页

系统管理菜单下新增「加点配置」页（参照 mockup C-6 加点配置页）。

页面结构：按贸易链展开，每条链下列出各环节的加点设置。

每行可编辑加点方式（无/比例/固定额/比例+固定额）、具体数值、生效日期。修改历史保留，可按日期回溯。

核价台展示增强

核价台计算结果区域（参照 mockup C-6 核价台页中部「计算结果」区）新增：

链条选择（页面顶部）：

• 下拉框选择本公司的贸易链条（如「改装车标准链」「新车直出链」）

留存利润展示（计算结果表格新增列）：

不含税单价与增值税（新增字段）：

• 聊工→璟沁玥开票需要不含税单价和增值税额，当前系统只有含税总额。核价台表格新增「不含税单价」「增值税额」两列。

开票辅助视图

核价台左侧新增「开票辅助」入口（参照 mockup C-6 左侧筛选区），用于快速定位订单逐张开票：

• 筛选条件：合同号（主筛选）/ 经销商 / 客户 / 日期
• 列表展示匹配订单，带翻页（上一个/下一个）
• 点击订单行 → 直接进入该订单详情页的履约节点 Tab，打勾开票

回退重算的加点取值

订单回退到核价前，核价台重新计算时（参照 mockup C-6 加点配置页底部「回退取值」区）：

• 经销商费率：回退后强制重新选择（不沿用快照，提示「费率可能已变更，请重新选择」）
• 加点：默认沿用上次核价快照值；若检测到配置有变化，展示 toggle 供财务选择「沿用快照」或「切换为最新配置」
• 汇率：维持现有 toggle 行为（沿用核价时汇率 / 切换今日汇率）

6.4 数据字段

加点配置（MarkupConfig）

加点快照（核价时定格）

核价确认时，将当前加点配置值快照到 Pricing 记录中，后续核价历史和报表均基于快照值计算，不受配置变更影响。

6.5 业务规则

1. 加点不频繁改（业务方原话），需要时配一下即可。修改记录保留。
2. 经销商费率回退后强制重选：防止回退后沿用旧费率导致计算偏差。
3. 留存利润计算基数：基于对应链环节的成交价（如「创信留存 = 聊工卖给创信的价格 × 比例 + 固定额 - 创信成本」），具体公式沿用一期 pricing_calculator.py 并扩展为多环节。

6.6 待确认

• Q13：加点/费率回退取值策略已内部定案（经销商强制重选 + 加点 toggle 同汇率）。请客户过目确认。
• Q14：开票辅助按合同号主筛选——已内部确认，无需再问客户。

七、报关与许可证闭环

Mockup: 报关资料页

7.1 业务背景

一期系统完全不涉及报关。现状全靠手工：

• 发票/箱单/申报要素用 Excel 模板手工做
• 报关行回传报关单草单 PDF，业务方打印出来逐项勾选核对
• 报关单出错改一张几百美元，海关罚款 1000~20000 元，已有多单出错

业务方自研了原型工具（OCR核验），但不稳定。二期将此能力集成进系统：系统内生成单据、上传许可证和草单、逐字段核验、按车架号累计核销。

7.2 操作角色

• 资料岗：合同生成后，触发单据生成；上传对方回传的双章外贸合同 PDF
• 许可证岗：上传出口许可证（PDF+编号）；上传报关单草单 PDF；执行核验
• 信息员：归档核验结果

7.3 业务流程

合同生成 → 系统自动生成发票/箱单/申报要素
         → 补录许可证编号 + 上传许可证 PDF
         → 上传双章外贸合同 PDF（报关打包前置）
         → 资料齐全后 → 下载「出向资料包」发给报关行
         → 报关行申报后回传「报关单草单」PDF
         → 许可证岗上传草单 PDF → 系统逐字段核验
         → 核验通过 → 按车架号勾选核销
         → 核验不通过 → 列出不一致项，人工修正 → 重新核验 → 修正后归档
         → 最终生成「核验归档包」内部留痕

两个包：

• 出向资料包（发给报关行）：商业发票 + 装箱单 + 申报要素 + 许可证 + 双章外贸合同。不包含草单。
• 核验归档包（内部留痕）：草单 + 核验快照 + 差异修正记录 + 核销结果。

7.3a 报关全流程

关键规则：核销以车架号为准、按批计数（非按台），同批退柜重报不新增批记录。许可证最多12批次，达上限预警。

7.4 页面与交互

参照 mockup C-4 报关资料页。入口在订单详情页新增「报关资料」Tab（与「订单信息」「合同」Tab 并列）。

Tab 内分区

① 出向单据区

合同生成时系统自动生成三份 Excel（商业发票、装箱单、申报要素），展示为文件卡片：

• 每份单据：文件名 + 生成时间 + 下载按钮
• 数据来源：订单信息 + 车型参数（HS 编码/排量/功率/座位数/重量/品牌类型/包装方式）
• 系统数据为准，不再从 Excel 手工粘贴

申报要素自动填充字段：

② 许可证区

• 「许可证编号」输入框 + 「上传许可证 PDF」拖拽区
• 许可证关联订单，一证对一订单。非一批一证最多核销 12 批次。
• 许可证状态标签：有效 / 已用完 / 已作废

多车型订单的许可证申领策略待确认（Q18）：若一笔订单含多个车型且 HS 编码不同，是一张证覆盖全订单，还是按 HS/车型分张？当前设计默认一张证覆盖全订单，如业务实际分张，则调整为 Order ─1:N─ ExportLicense。

③ 双章外贸合同回传区

• 上传对方已盖章的外贸合同 PDF（报关打包前置材料）
• 上传后标记为「双章版本」，原系统生成版本保留可追溯
• 报关打包时优先引用双章版本
• 首期仅外贸合同①，内采/底盘/物料合同是否纳入待确认（Q17）

④ 报关单草单上传与核验区

报关行回传草单 PDF 后，许可证岗上传，系统执行核验。

核验结果展示为字段级核对矩阵（参照 mockup 中部「核验结果」区）：

不一致项高亮标出，点击展开显示系统值与报关单值对比。

核验技术路线：优先解析电子 PDF 原始文本，不依赖 OCR。扫描件识别不在二期首版范围。

⑤ 核销区

核验通过后，许可证岗按车架号勾选已核销车辆：

• 从订单 VIN 列表中勾选本批已报关的车架号
• 记录本批核销时间、报关海关、核销批次序号
• 系统累计已核销批次数，达 12 次上限时预警
• 同批车退柜重报不新增核销批次（同批重报关算一次）

⑥ 出向资料包下载区

资料齐全（三单据+许可证+双章外贸合同）后，「下载出向资料包」按钮点亮，下载 ZIP 发给报关行。

⑦ 核验归档包

核验完成后，系统生成内部归档包（草单+核验快照+差异修正记录+核销结果），供后续追溯。

7.5 数据字段

出口许可证（ExportLicense）

核销批次记录（CustomsClearance）

核销车架号明细（CustomsClearanceVIN）

出向单据集（CustomsDeclaration）

7.6 业务规则

1. 核销计数按批不按台：一辆车可与其他车同批核销，不占用额外批数。34 台订单可能 3~4 批即核销完，远不触及 12 批上限。
2. 同批重报不新增批记录：退柜重报时标记与上次相同，clearance_seq 不递增。
3. 许可证超限预警：证下批数达 12 时 ExportLicense.status=exhausted 并预警。
4. 核验只管固定字段：发票号、日期、目的港、车架号、许可证号、贸易国、买家地址等。不一致项列出即可，不做自动修正。
5. 三单齐全才能核验：许可证 PDF + 报关单草单 PDF + 双章外贸合同 PDF 全部上传后才可触发核验。

7.7 待确认

• Q1：台账 AD 列含义（高置信推定「已出口台数」）→ 一句话确认 + CXTY26040461G 异常行核对
• Q2：台账 U 列「新」语义 → 待客户解释
• Q17：双章回传是否扩展到内采/底盘/物料合同？是否允许替换并保留历史版本？经销商可否上传？
• Q18：多车型订单许可证是一张覆盖全订单还是按 HS/车型分张？
• Q19：核验结果需正式 PDF 报告还是字段级快照即可？差异草单是否保留历史版本？

八、铭牌生成

Mockup: 功能入口在 C-4 报关资料页中以 doc-card 形式展示

8.1 业务背景

铭牌制作当前靠手工：把车架号逐个复制粘贴到 Excel 模板（10 套车型模板）。二期在合同生成时自动生成铭牌文件。

8.2 操作角色

• 资料岗：合同生成时自动触发铭牌生成
• 经销商：下载铭牌文件

8.3 页面与交互

合同生成时，系统按车型匹配铭牌模板，逐 VIN 生成铭牌文件。经销商在订单详情「合同」Tab 下载合同 ZIP 时，铭牌文件一并包含在内。

• 仅改装车生成铭牌，新车/二手车不需要
• 复用 10 套车型铭牌模板（与一期对应）
• 铭牌与合同盖章回传并行无先后——铭牌系统直接给经销商

8.4 待确认

暂无核心开放问题。铭牌模板具体格式以业务方现有 Excel 模板为参照。

九、系统管理模块群

Mockup: B 系统配置 + 3B BOM 配置

9.1 业务背景

一期基础数据（车型、配件、BOM、客户、4S 店）维护依赖 Excel 导入或后台管理——没有前台界面，管理员无法自主操作。二期要求提供完整的前台 CRUD 管理能力，且全部按公司隔离。

9.2 概述

10 个管理模块统一放在「系统管理」侧栏菜单组下，每个模块遵循相同的 CRUD 范式：列表页（表格+分页+筛选）+ 新增/编辑弹窗 + 停用操作。

9.2a 系统管理模块全景

10个模块全部按公司隔离——创信和瑞驰各自维护独立的车型、配件、价格、印章和汇率数据。B-5系统配置中心不重复管理加点费率，加点配置唯一入口见第六章加点配置页。

B-5 系统配置中心中，加点费率不在此配置——加点配置的唯一入口是 C-6 加点配置页（见第六章）。B-5 仅保留增值税率、合同编号前缀、公司信息等公司级基础参数。

9.3 各模块要点

B-1 车型管理

一期已有 Vehicle 模型，二期补充：

• 车型分类：改装车/新车/二手车
• 报关所需字段：排量(ml)、功率(kW)、座位数、整备质量(kg)、电池容量(kWh，新能源车)
• 上述字段在生成申报要素时自动带出

B-3 BOM 配置

配件是独立主数据（B-2），BOM 是车型↔配件多对多关联（一个配件可被多车型复用）。配置时从配件库下拉选配件 + 填每台用量。界面参照 mockup 3B BOM 配置页，支持增删行，实时计算单台物料参考成本。

B-9 汇率管理

独立页面，支持每日汇率设置（USD→RMB），历史汇率查询，变更记录（谁/何时/旧值→新值）。汇率变更后，核价台可选用「今日汇率」或「上次核价汇率」。

9.4 待确认（B 类无核心开放问题）

B 类模块均为基础 CRUD，需求明确。仅以下两点随开发细化：

• B-5 系统配置中各公司独立的合同编号前缀/后缀格式 → 参照第五章订单号规则
• B-10 审计日志记录的操作类型和保留期限

十、看板与多维报表

Mockup: 看板与报表页

10.1 业务背景

一期首页只有订单计数统计，无金额维度。日报、月报、经销商汇总全部手工 Excel。二期补充实时金额看板和多维报表导出。

10.2 操作角色

• 超级管理员：可切换查看各公司报表
• 公司管理员/财务/业务员：查看本公司报表
• 经销商：仅见本人数据的汇总视图

10.3 页面与交互

首页看板增强

参照 mockup C-7 上半部分 KPI 卡片区。现有首页增加：

当日/当月实时 KPI（卡片）：

• 今日订单数 / 当月订单数
• 今日外贸额（USD + RMB）/ 当月外贸额
• 当月留存利润 / 当月收汇额 / 当月付款额
• 待处理事项计数（待核价/待生成合同/待报关核验/待收汇…）

趋势图：近 6 个月外贸额（柱状图）、月度订单数趋势
环形图：各经销商订单占比

报表导出

「报表」页（独立页面，在看板页有入口）提供三种报表：

每张报表支持筛选后导出 Excel。

多维筛选

报表页支持多维度交叉筛选（参照 mockup 中部筛选区）：

• 按经销商 / 国外客户 / 车型 / 时间范围（带/不带时间）
• 勾选需要导出的列
• 导出 Excel

历史业务数据导入

一期 1400+ 条历史合同执行数据需导入系统。

请客户知悉——这是一次性导入，导入后仅供报表统计。
历史数据来自客户现用的《改装车出口数据.xlsx》台账，每行是一条已完成的合同执行记录（合同号、经销商、车型、各环节金额与日期）。它们只以汇总形式进入看板和报表，不会回流到系统的业务流程里——不能对历史订单重新核价、重新生成合同、补报关核销或走履约节点。系统能做到的就是「把台账数字纳入统计口径」，到此为止。这是历史数据本身的局限（缺字段、流程已结束），不是功能取舍。

导入要求：

• 标记为「历史数据」，与上线后数据区分
• 记录来源（文件/批次/导入人/导入时间）
• 导入后数据参与报表计算
• 发现错误后可在系统内修正并留审计

10.4 业务规则

1. 实时计算：放弃预计算大汇总表，报表数据实时从订单/核价/合同表计算。查询不频繁，加载提示即可。
2. 性能：目标——常规查询 1 分钟内出结果。
3. 数据口径：报表中的「外贸金额 RMB」按核价汇率折算（非结汇汇率）。如后续需要按结汇汇率口径。

10.5 待确认

• Q4：外贸金额 RMB 折算口径——核价汇率 vs 结汇汇率？（当前设计默认核价汇率）
• Q22：历史数据导入是否需要逐记录标记来源文件、sheet、行号、批次？发现错误后如何修正？
• Q3：经销商脏值（「作废/1677」等）清洗规则
• Q23（新增）：历史台账里的经销商是否要作为基础数据进系统？台账《改装车出口数据.xlsx》里有经销商列（去重约 17~19 个，含脏值如「作废」「1677」「聊工-金璟源」等需清洗），可提取。但台账里没有 4S店、国外客户、目的港字段——这些下游主体无法从历史台账自动提取，若要进系统作基础数据，需客户另行提供清单或上线后逐步录入。请确认：①历史经销商是否导入为正式经销商档案；②4S店/国外客户档案如何建立（客户提供 / 上线后录入 / 不建档）。

十一、业务履约节点

优先级: P2（后置） ｜ Mockup: 履约进度页

11.1 二期范围说明

业务工作流引擎分两阶段实现。二期先交付固定节点列表 + 打勾界面；可配置编排引擎属于后续阶段。

11.2 节点清单

履约节点挂在贸易链条上（一条链一套节点），在订单详情页新增「履约进度」Tab 展示。节点以打勾+记时间+记操作人的方式运行，不强制顺序依赖。

业务主链节点（按贸易链顺序）：

财务节点（与主链不强制顺序，可随时填报）：

5 个发票节点：沿合同②③④⑤⑥逐环独立打勾。各节点操作人/触发条件待业务确认（Q10）。节点存在性已确认。

11.2a 履约节点状态机

业务主链节点按贸易链条顺序流转，每个节点打勾+记录时间+记录操作人。5个发票节点沿合同②③④⑤⑥逐环独立确认。财务节点（收汇/结汇/付款）与主链并行，随时填报，不强制顺序。

11.3 页面形态

订单详情页新增「履约进度」Tab（参照 mockup-2 履约进度页）：

• 顶部进度时间线：已完成节点→当前节点→待完成节点，横向时间线展示
• 下方节点列表：每个节点一行，显示节点名称、状态（✓已完成 / ◯进行中 / ○待完成）、完成时间、操作人
• 点击当前节点 → 弹出打勾确认框（含数据录入区，如金额/张数）
• 税务节点「退税资料齐全/推送财务」为状态转换点——信息员确认资料齐全后主动推送财务（不是普通 checkbox）

11.4 待确认

• Q10：5 个发票节点各自的操作人角色和依赖顺序
• Q21：聊工月度发票是否跨多单？税额如何分摊？

十二、财务收付款与退税

优先级: P2（后置） ｜ Mockup: 财务收付款页

12.1 二期范围说明

财务收付款和退税追踪属于 P2 后置模块。二期先落库基础数据字段，为第十章报表和第十一章履约节点提供数据源。具体交互界面在进入开发阶段时细化。

12.2 数据字段

收付款记录（OrderFinance）

退税记录（TaxRefund）

退税口径：系统按聊工增值税额自动计算「预计退税额」。实际申报金额是否始终等于预计值、实际到账金额是否需要单独记录，待曹瀚/退税财务或退税台账样本确认（Q6）。

12.3 待确认

• Q6：退税预计值 vs 实际申报/到账金额口径
• Q7：能否提供退税台账样本？
• Q8：四项费用「已付」标记由谁勾选（核价财务/退税财务）？

十三、站内通知中心

Mockup: 通知中心页

13.1 业务背景

当前流程协调全靠微信群，消息容易遗漏。二期在系统内建立弱提醒通知机制。

13.2 设计要点

• 形态：小红点 + 角落弱提示面板（不弹窗）
• 入口：Header 右侧铃铛图标，红点数字显示未读数
• 通知面板（下拉/侧拉）：全部通知 / 待办任务 两个 Tab
  • 「全部」= 未读 + 已读通知列表
  • 「待办任务」= 仅可领取/待处理的任务

13.3 触发事件

13.3a 通知事件流转

通知仅作用于系统内——Header铃铛红点 + 下拉面板展示。不做弹窗、短信或微信推送。待办任务支持认领（点击领取），防止多人重复处理同一事项。通知按公司路由，创信和瑞驰的通知互不可见。

13.4 任务认领

「待办任务」中的通知支持认领（点击「领取」按钮），防止多人重复处理同一事项。已认领的通知显示认领人和时间。

13.5 业务规则

• 通知保留 90 天，过期自动清理
• 已读通知可查看历史
• 通知按公司+角色路由（依赖 E17）

13.6 待确认

• 通知保留期 90 天是否合适？
• 哪些事件需要认领（防止重复处理）？

十四、手机端响应式适配

Mockup: 手机端页面

14.1 业务背景

瑞驰合伙人需要手机端查看业务数据；经销商周末偶尔需要手机提单。形态已定为响应式 Web（不做小程序或原生 App）。

14.2 适配范围

首期手机端适配以下页面：

• 首页看板（瑞驰合伙人/管理员）：当日/当月台数、金额、订单进度
• 订单列表：查看和筛选
• 订单录入：经销商周末提单（表单适配手机布局）
• 订单详情：基本信息 + 进度查看

页面交互采用响应式布局（Ant Design 内置 breakpoint），在手机上自动切换为单列堆叠布局。菜单缩为汉堡菜单。

14.3 待确认

• Q16：手机端首批功能范围——看板/订单录入/进度查看，还有没有其他必须适配的页面？
• Q20：瑞驰合伙人手机端首页必看指标、是否需要手机端提单、公司管理员能否创建用户/管理员

十五、系统基础能力与工程保障

以下能力不直接对应某个业务模块，但影响系统的安全性、可靠性、可维护性和长期运行成本。它们随各波次业务开发同步实施，不需要逐项业务决策，但客户应知悉这些是二期工程范围的一部分。

15.1 安全加固

当前系统已完成 用户登录认证、角色权限、跨域安全等基础安全项。二期进一步补强：

• 登录 IP 限流：连续失败锁定，防止暴力破解
• 敏感信息加密：密钥、令牌等字段落库加密存储
• HTTPS/HSTS 部署：全站强制 HTTPS，证书自动续期
• mass assignment 审计：确保后端接口不会因前端传入额外字段导致越权修改数据

这些属于生产系统安全基线，在二期各波次开发中默认执行。

15.2 数据生命周期与审计追溯

一期已实现订单软删除保护（已生成合同的订单禁止删除）。二期扩展：

• 全模块删除保护：有业务关联数据的记录不可物理删除，只能停用。覆盖订单、核价、合同、用户、基础数据。
• 关键操作审计日志：合同生成、核价确认/驳回、订单创建/修改/删除、用户权限变更、基础数据修改——全部记录操作人、时间、IP、变更前后值。
• 合同变更追溯：重新生成合同后保留历史版本，详情页「合同」Tab 版本号递增，历史版本可预览和下载。
• 审计日志查询界面：按操作人、操作类型、时间范围筛选（见第九章 B-10）。

15.3 性能与容量

• 列表分页标准化：订单、用户、合同等大列表统一分页（20 条/页）、排序、筛选，替换当前的客户端截断方案。一期已有基础分页，二期标准化补全。
• VIN 解析去重：当前核价时对同一 VIN 重复调用解析引擎，改为单次解析 + 缓存结果。
• 合同 PDF 输出流式化：当前 ZIP 打包时全部文件一次性加载到内存，改为流式写入，降低内存峰值。
• icontains 索引优化：客户名称、地址等文本搜索字段补充数据库索引，提升筛选响应速度。

15.4 合同文件对象存储迁移

一期合同 PDF/ZIP 存储在服务器本地磁盘（40G 容量）。随着二期合同量增长（瑞驰 2 亿订单）和文件膨胀（含印章后单套合同约 5M），本地磁盘面临容量瓶颈。此外，合同文件需长期归档（税务核查可追溯 20 年），本地单点存储存在数据丢失风险。

二期将合同、许可证、铭牌等文件迁移至阿里云对象存储 OSS：

• 私有读写 + 临时签名 URL 访问（有有效期，过期自动失效）
• 提供存量文件迁移脚本（一期已生成的全部合同批量迁入）
• OSS 自身提供三副本异地冗余，消除单点风险
• 视频文件（改装前后对比照）继续使用夸克网盘等现有外部备份，不迁入 OSS

费用说明：OSS 按量付费（存储量 + 外网下行流量），预估约 ¥2,500-3,000/年，由甲方承担，不计入软件开发费。

15.5 密码管理完善

一期已有用户管理页面。二期补全以下能力（部分已在验收后实现）：

• 管理员重置密码：管理员可为用户重置密码
• 首次登录强制修改：重置后的临时密码首次登录时强制用户自行修改
• 密码复杂度策略：最低长度、必须包含数字和字母
• 自主修改密码：已登录用户可在 Header 右侧「修改密码」入口自行修改
• 旧 Token 失效：修改密码后，该用户所有已登录的设备立即失效，需重新登录

15.6 核价历史与合同版本

一期已记录核价确认/驳回的操作历史。二期增强：

• 核价轮次详情：每次核价的完整计算快照（各环节价格、汇率、加点、费用明细）可在订单详情页查看
• 快照对比：不同核价轮次之间的差异对比（如「第 2 轮比第 1 轮：汇率从 7.15→7.18，留存 +¥320」）
• 角色视角脱敏：核价财务可见完整金额，经销商仅见外贸价，资料岗按配置可见部分价格
• 历史 ZIP 下载：可下载指定轮次核价时生成的全部合同文件

15.7 系统配置中心扩展

一期 SystemConfig 已包含部分可配参数（税率、部分公司信息）。二期扩展：

• 港口英文名、运输方式、合同条款等业务参数的配置化
• 各公司独立的订单/合同编号前缀配置
• 前台配置界面（见第九章 B-5），替代当前的后台手动改数据库
• 配置变更审计：谁在何时将什么配置从旧值改为新值

附录A：待客户确认问题清单

来源：内部《待业务确认清单 Q1-Q22》（2026-06-21 交叉验证版）+ 《内部澄清记录》（2026-06-22）+ 《二期需求挖掘与推演复核》（2026-06-23）。
状态图例：✅ 已闭环 / 🟡 部分确认（设计已就绪，剩业务点待拍板）/ 🔴 待确认

一、报关与许可证

二、财务与退税

三、流程与权限

四、数据治理与历史导入

本节问题均来自对客户现用台账《改装车出口数据.xlsx》的实际核查。该台账有「合同汇总执行」「汇总-经销商」「当日数据汇总」「年度数据汇总」四个 sheet，主执行表约 1400+ 行、31 列，每行是一条已完成合同的执行记录。下列问题是我们逐列核查后发现的真实数据现状，不是假设。

五、已内部定案，请客户过目确认

六、已闭环无需确认

附录B：Mockup 完整索引

线上原型访问地址：mockup-0-index.html

所有 mockup 页面中，具体字段值和金额数字均为示例数据，不代表真实业务数据。页面布局、交互流程和功能分区为需求确认的核心参照。

附录C：中英文术语对照表

本文档中出现的英文术语与中文对应关系如下。正文采用「中文名称（EnglishName）」的呈现方式；流程图中全部使用中文。

系统概念

订单与合同

报关与财务

币种