From b1cfae2d0ffe9d3484af660180d071f04063288d Mon Sep 17 00:00:00 2001 From: ouyangxq <775153912@qq.com> Date: Wed, 19 Aug 2026 09:14:33 +0800 Subject: [PATCH] =?UTF-8?q?=E4=BC=98=E5=8C=96?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- 三期/货柜履约原型字段验收矩阵-2026-08-17.md | 3 ++- 独立任务协作登记.md | 23 ++++++++++++++----- .../openapi/finance-phase1-five-pages-v1.yaml | 8 +++---- 财务管理/财务一期五页产品与接口验收契约.md | 2 ++ 4 files changed, 25 insertions(+), 11 deletions(-) diff --git a/三期/货柜履约原型字段验收矩阵-2026-08-17.md b/三期/货柜履约原型字段验收矩阵-2026-08-17.md index bb3ade0..161bd57 100644 --- a/三期/货柜履约原型字段验收矩阵-2026-08-17.md +++ b/三期/货柜履约原型字段验收矩阵-2026-08-17.md @@ -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 时不得伪造名称。 diff --git a/独立任务协作登记.md b/独立任务协作登记.md index 0b41bd1..321216e 100644 --- a/独立任务协作登记.md +++ b/独立任务协作登记.md @@ -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 | diff --git a/财务管理/openapi/finance-phase1-five-pages-v1.yaml b/财务管理/openapi/finance-phase1-five-pages-v1.yaml index d1aad5f..65d2707 100644 --- a/财务管理/openapi/finance-phase1-five-pages-v1.yaml +++ b/财务管理/openapi/finance-phase1-five-pages-v1.yaml @@ -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} diff --git a/财务管理/财务一期五页产品与接口验收契约.md b/财务管理/财务一期五页产品与接口验收契约.md index 980f3dc..f9c4c77 100644 --- a/财务管理/财务一期五页产品与接口验收契约.md +++ b/财务管理/财务一期五页产品与接口验收契约.md @@ -22,6 +22,8 @@ 所有金额只使用 CNY。原型中的 USD、汇率、开票日期、利润审批、利润金额仅为历史原型字段，一期删除。 +客户对账单、应收结算单、应付结算单统一使用短业务编号：`REC-YYMMDD-NNNN`、`AR-YYMMDD-NNNN`、`AP-YYMMDD-NNNN`。日期按北京时间的单据创建日计算，各单据类型分别按日从 `0001` 递增；编号生成后不可修改，作废也不回收。 + ## 2. 客户账户冲突处理（已确认） 原型客户账户是“预充值余额 + 冻结 + 可用余额 + 手动充值”的钱包模型，与此前确认的“不做钱包/预收”冲突。产品已确认按以下方案处理，不再等待额外产品结论：