Test #1
@@ -1,12 +1,13 @@
|
||||
# 货柜履约原型字段验收矩阵
|
||||
|
||||
> 更新时间：2026-08-17
|
||||
> 更新时间：2026-08-18
|
||||
> 范围：货柜、预装/装柜清单、订舱、船期、拖车、报关协同与国内出仓列表。
|
||||
> 口径：原型只提供字段与交互参考；当前确认契约、后端 DTO/OpenAPI 和已落地 Admin 优先。`UNKNOWN` 不生成假值、不改名借用其他字段，也不以空值通过验收。
|
||||
|
||||
## 跨列表统一门禁
|
||||
|
||||
- 操作列必须是第一业务列并固定左侧；原型中拖车、预装把操作列放在末尾的布局由当前统一表格规则覆盖。
|
||||
- 平台内部业务单号统一为 `前缀-YYMMDD-NNNN`，按北京时间创建日、单据类型分别从 `0001` 递增：订舱 `OB`、派车单 `TA`、内部货柜登记 `CB`、稳定柜次 `CAB`、预装/装柜清单 `LP`。预装确认后沿用同一 `LP` 编号，不因状态变化更换身份；真实集装箱号、提单号等外部编号不适用本规则。
|
||||
- `柜号/cabinetNo` 是平台稳定柜次编号，`集装箱号/containerNo` 是真实物理柜号，两者不得互换。模拟柜可以没有 `containerNo`，真实柜、完成装柜清单和国内出仓聚合必须有。
|
||||
- 客户、仓库、渠道、船公司、订舱/拖车/报关供应商名称只能来自服务端冻结快照或正式主数据，不由 fixture 自造名称。
|
||||
- ID 使用正整数；数量、重量和体积为非负数；关键时间必须可按 ISO-8601 解析；有供应商 ID 时名称必须非空，无 ID 时不得伪造名称。
|
||||
|
||||
+17
-6
@@ -4,10 +4,9 @@
|
||||
|
||||
## 当前状态
|
||||
|
||||
- 当前没有启用中的总控。
|
||||
- 当前没有登记为长期复用的用户独立任务。
|
||||
- 现阶段采用“一个任务、一个对话、逐项修复”的方式；普通工作在用户当前对话直接完成，不根据历史名称、旧职责或旧总控关系向其他对话下发。
|
||||
- 原有总控和独立任务登记已清空，不再作为寻址、复用、汇总或职责判断依据。侧栏旧任务是否归档由用户人工决定，Codex 不自动归档、解档或恢复。
|
||||
- 财务改造已启用一个总控和四个长期独立任务；只按下方登记的稳定 `task_id` 协作。
|
||||
- 其他普通工作仍采用“一个任务、一个对话、逐项修复”的方式，不根据历史名称或旧职责向未登记对话下发。
|
||||
- 侧栏其他旧任务不属于本轮财务协作，是否归档由用户人工决定，Codex 不自动归档、解档或恢复。
|
||||
|
||||
## 重新启用门禁
|
||||
|
||||
@@ -19,6 +18,18 @@
|
||||
|
||||
## 登记表
|
||||
|
||||
总控：无。
|
||||
总控：
|
||||
|
||||
长期独立任务：无。
|
||||
| task_id | 展示名称 | 长期职责 |
|
||||
|---|---|---|
|
||||
| `01a01490-08e6-7b11-b16f-0085e232d04c` | 财务改造总控 | 冻结财务共享产品契约、状态机、OpenAPI、权限与数据库边界；协调四个财务专项并统一集成共享导航、权限 SQL、跨任务回归和验收结论 |
|
||||
|
||||
长期独立任务：
|
||||
|
||||
| task_id | parent_task_id | 展示名称 | 唯一长期职责 |
|
||||
|---|---|---|---|
|
||||
| `01a0149b-961c-7411-ad0c-5658d70491d8` | `01a01490-08e6-7b11-b16f-0085e232d04c` | 财务专项一：费用来源与编辑审核 | 负责费用来源从业务端到 Finance 的统一审核、编辑、调整、作废与自动进入结算候选流程，移除“参与结算/是否结算”业务开关及其消费者 |
|
||||
| `01a0149b-97e0-7133-a9c3-8cfb3e05517e` | `01a01490-08e6-7b11-b16f-0085e232d04c` | 财务专项二：对账单客户确认 | 负责客户对账单从平台出账到客户确认的状态、接口、Client/Admin 交互、隔离、幂等和审计闭环 |
|
||||
| `01a0149b-9a33-7373-af3a-b7ded4f2cbbb` | `01a01490-08e6-7b11-b16f-0085e232d04c` | 财务专项三：应收付款凭证 | 负责应收结算单付款凭证的上传、查看、校验、确认及其与正式收款记录的关系；上传主体与确认口径由财务总控冻结后实施 |
|
||||
| `01a0149b-9bae-75d3-867e-f600d862122c` | `01a01490-08e6-7b11-b16f-0085e232d04c` | 财务专项四：应收款统计表 | 负责 CNY 应收款统计接口、指标勾稽、Admin 页面、打印和异步 Excel 导出；减免口径及渠道分类由财务总控冻结后实施 |
|
||||
| `01a014d1-182e-7df1-90c0-b14463626152` | `01a01490-08e6-7b11-b16f-0085e232d04c` | 财务专项五：Admin供应商选择 | 只负责 Admin 入库费用与柜次费用的供应商选择、类别筛选、表单校验和前端测试；不修改 Finance/Firstleg 后端、共享 SQL、IAM 或 OpenAPI |
|
||||
|
||||
@@ -961,7 +961,7 @@ components:
|
||||
required: [statementId, statementNo, customerId, customerName, periodStart, periodEnd, creditDays, currency, lineCount, sourceCount, sourceAmount, adjustmentAmount, totalReceivable, receivedAmount, outstandingAmount, settled, status, version, createdBy, createdAt, updatedBy, updatedAt]
|
||||
properties:
|
||||
statementId: {$ref: '#/components/schemas/Id'}
|
||||
statementNo: {type: string}
|
||||
statementNo: {type: string, pattern: '^REC-\d{6}-\d{4}$', example: REC-260818-0001}
|
||||
customerId: {$ref: '#/components/schemas/Id'}
|
||||
customerName: {type: string}
|
||||
periodStart: {type: string, format: date}
|
||||
@@ -1091,7 +1091,7 @@ components:
|
||||
properties:
|
||||
id: {$ref: '#/components/schemas/Id'}
|
||||
customerId: {$ref: '#/components/schemas/Id'}
|
||||
settlementNo: {type: string}
|
||||
settlementNo: {type: string, pattern: '^AR-\d{6}-\d{4}$', example: AR-260818-0001}
|
||||
billDate: {type: string, format: date}
|
||||
dueDate: {type: string, format: date}
|
||||
receivableAmount: {$ref: '#/components/schemas/Money'}
|
||||
@@ -1106,7 +1106,7 @@ components:
|
||||
properties:
|
||||
id: {$ref: '#/components/schemas/Id'}
|
||||
customerId: {$ref: '#/components/schemas/Id'}
|
||||
settlementNo: {type: string}
|
||||
settlementNo: {type: string, pattern: '^AP-\d{6}-\d{4}$', example: AP-260818-0001}
|
||||
costType: {type: string, enum: [SINGLE_ORDER, CONTAINER_SHARED]}
|
||||
orderId: {$ref: '#/components/schemas/Id'}
|
||||
inboundId: {$ref: '#/components/schemas/Id'}
|
||||
@@ -1178,7 +1178,7 @@ components:
|
||||
required: [settlementId, settlementNo, direction, currency, totalAmount, paidAmount, outstandingAmount, generatedDate, dueDate, paymentStatus, status, version]
|
||||
properties:
|
||||
settlementId: {$ref: '#/components/schemas/Id'}
|
||||
settlementNo: {type: string}
|
||||
settlementNo: {type: string, pattern: '^(AR|AP)-\d{6}-\d{4}$', example: AR-260818-0001}
|
||||
direction: {$ref: '#/components/schemas/FeeDirection'}
|
||||
customerId: {$ref: '#/components/schemas/Id'}
|
||||
customerName: {type: string}
|
||||
|
||||
@@ -22,6 +22,8 @@
|
||||
|
||||
所有金额只使用 CNY。原型中的 USD、汇率、开票日期、利润审批、利润金额仅为历史原型字段，一期删除。
|
||||
|
||||
客户对账单、应收结算单、应付结算单统一使用短业务编号：`REC-YYMMDD-NNNN`、`AR-YYMMDD-NNNN`、`AP-YYMMDD-NNNN`。日期按北京时间的单据创建日计算，各单据类型分别按日从 `0001` 递增；编号生成后不可修改，作废也不回收。
|
||||
|
||||
## 2. 客户账户冲突处理（已确认）
|
||||
|
||||
原型客户账户是“预充值余额 + 冻结 + 可用余额 + 手动充值”的钱包模型，与此前确认的“不做钱包/预收”冲突。产品已确认按以下方案处理，不再等待额外产品结论：
|
||||
|
||||
Reference in New Issue
Block a user