From cdc41bc843ef1b5db529b058c25e6fa3be2f1aea Mon Sep 17 00:00:00 2001 From: ouyangxq <775153912@qq.com> Date: Mon, 17 Aug 2026 17:49:06 +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 --- 独立任务协作登记.md | 10 ++- .../openapi/finance-phase1-five-pages-v1.yaml | 87 +++++++++++++++++++ 2 files changed, 93 insertions(+), 4 deletions(-) diff --git a/独立任务协作登记.md b/独立任务协作登记.md index 78b7c9c..1804be9 100644 --- a/独立任务协作登记.md +++ b/独立任务协作登记.md @@ -10,7 +10,7 @@ |---|---|---| | `01a00e42-0f41-77d2-9019-bcd2a170a6c1` | 订单入仓全流程总控 | 统筹客户下单至待分柜的完整订单链：订单创建、列表与详情、到仓、测量/OCR、测量审核、入库初算与人工调价、状态流转，以及 Admin/Client/Order/Firstleg/File/Integration 实际消费者和全链验证；以 `WAIT_SPLIT` 成功交接货柜履约为职责终点 | | `01a00e43-8fc7-7e30-8ae0-175d873a4cfd` | 货柜履约全流程总控 | 统筹 `WAIT_SPLIT` 之后至国内出仓的完整履约链：分柜、智能装柜、预装与装柜清单、订舱、船期、拖车、PDA 拣货与装柜证据、报关清关、柜次异常和出仓，并维护 Admin/Client/PDA/Firstleg/Warehouse/File 相关契约及全链验证；柜态看板暂不进入开发范围 | -| `01a00e43-b4cb-72e1-ae21-ff30c427fce9` | 财务结算全流程总控 | 统筹费用来源进入财务后的完整结算链：客户账户、应收应付、对账单、应收/应付结算单、收付款、作废重开、凭证、柜次成本与正式结算；维护 Admin/Client/Finance 及 Firstleg/File 实际契约和全链验证，不接管订单初算与货柜履约状态机 | +| `019ff601-029f-7801-851c-7c68e02804ca` | 财务结算全流程总控 | 统筹费用来源进入财务后的完整结算链：客户账户、应收应付、对账单、应收/应付结算单、收付款、作废重开、凭证、柜次成本与正式结算；维护 Admin/Client/Finance 及 Firstleg/File 实际契约和全链验证，不接管订单初算与货柜履约状态机 | | `019ff600-e924-7902-b00e-fa1ee1658e08` | 客户与平台运营总控 | 统筹客户/企业生命周期、客户详情与运营统计、平台用户和角色业务、审计日志、消息中心与通知模板，以及对应 Admin/Client/IAM/Auth/Audit 契约和验证；不负责全局菜单装配、共享布局样式或各业务域自身权限语义 | | `019ff8dc-8700-7d93-a29b-3175b026a2ab` | 仓储与基础资料总控 | 统筹平台仓库、库位、托盘、国内整柜、供应商、快递公司、往来单位、费用项目、尺寸配置、价格表、下载中心等相对独立的仓储与主数据页面；负责 Warehouse/File 相关契约、原型收敛和组合验收，不再承担订单测量、审核和入库状态流转 | | `019ff8e7-aa4a-7ee0-b856-ee5db7ae525f` | Admin 平台治理总控 | 统一维护 Admin 应用壳层与跨模块治理：登录装配、首页框架、全局导航、根路由、菜单/路由/API 权限一致性、IAM 菜单权限初始化、共享组件与样式边界、全局响应式和跨模块测试门禁；业务字段、状态机和领域页面功能仍归对应业务总控，其他总控不得覆盖已确认的共享装配与权限语义 | @@ -21,16 +21,18 @@ |---|---|---|---| | `019ff9ad-9bd1-7393-a561-a2b2df6d4eec` | `019ff8e7-aa4a-7ee0-b856-ee5db7ae525f` | 全量测试门禁脚本修复 | 修复菜单/权限相关全量合同测试、后端回归覆盖及统一 SQL 快照门禁 | | `019ff905-bd45-71a1-a5f5-b40b620fcc83` | `01a00e42-0f41-77d2-9019-bcd2a170a6c1` | 头程后台｜国内仓测量｜独立列表与审核待办 | 实现国内仓订单测量独立筛选页与测量数据审核独立待办页，复用现有真实接口和权限 | +| `01a00f0e-e9c9-7cc3-8378-957eeb01029a` | `01a00e42-0f41-77d2-9019-bcd2a170a6c1` | Admin 订单列表与批量审核 | 长期维护 Admin 头程订单列表、订单审核操作、批量操作及其 API 消费、权限、响应式和自动化测试；不接管测量 OCR、货柜履约、全局导航、IAM 权限初始化或 Java 状态机 | | `019ff905-c5e9-7631-a64e-79f7644ffce8` | `019ff8dc-8700-7d93-a29b-3175b026a2ab` | 头程后台｜供应商管理后端｜公共供应商契约 | 建设独立于往来单位的平台公共供应商后端模型、权限、接口、审计和 OpenAPI | | `019ff905-ca76-7123-af57-5825b5773d2b` | `019ff8dc-8700-7d93-a29b-3175b026a2ab` | 头程后台｜国内整柜后端｜入出库库存契约 | 建设国内整柜入库、出库、库存和详情交易记录的独立后端契约与状态流 | -| `019ff905-a055-7723-b05e-598399fc183e` | `01a00e43-b4cb-72e1-ae21-ff30c427fce9` | 财务五页-客户账户与应收应付 | 按已确认财务一期契约和原型补齐客户账户、账户流水、费用来源列表与独立详情页功能 | -| `019ff905-a477-7a03-b806-953ba598d305` | `01a00e43-b4cb-72e1-ae21-ff30c427fce9` | 财务五页-客户对账单 | 按已确认财务一期契约和原型补齐客户对账单筛选、主表、明细与支付历史联动功能 | -| `019ff905-a8d5-7802-bf31-29919070a312` | `01a00e43-b4cb-72e1-ae21-ff30c427fce9` | 财务五页-应收应付结算单 | 按已确认财务一期契约和原型补齐应收、应付结算单汇总、筛选、详情、收付款及作废重开功能 | +| `019ff905-a055-7723-b05e-598399fc183e` | `019ff601-029f-7801-851c-7c68e02804ca` | 财务五页-客户账户与应收应付 | 按已确认财务一期契约和原型补齐客户账户、账户流水、费用来源列表与独立详情页功能 | +| `019ff905-a477-7a03-b806-953ba598d305` | `019ff601-029f-7801-851c-7c68e02804ca` | 财务五页-客户对账单 | 按已确认财务一期契约和原型补齐客户对账单筛选、主表、明细与支付历史联动功能 | +| `019ff905-a8d5-7802-bf31-29919070a312` | `019ff601-029f-7801-851c-7c68e02804ca` | 财务五页-应收应付结算单 | 按已确认财务一期契约和原型补齐应收、应付结算单汇总、筛选、详情、收付款及作废重开功能 | | `019ff90b-9b45-7191-b68f-c3b52567e3e4` | `01a00e43-8fc7-7e30-8ae0-175d873a4cfd` | 货柜管理后端扩展契约 | 补齐清关报关与 DO/PU 文件查看下载、货柜异常及历史、运输轨迹日志和柜次 PDA 作业摘要的后端契约、权限、OpenAPI、SQL 与测试 | | `01a00e91-2124-7960-95d6-e0d0f81959f9` | `01a00e43-8fc7-7e30-8ae0-175d873a4cfd` | 预装清单动态增量后端契约 | 维护智能装柜与预装清单在 PDA 最终完成前的动态增量编排、计划与明细可编辑能力、PDA 同任务增量同步、版本并发及对应 OpenAPI 和后端测试；不接管 PDA 最终完成、拖车门禁或 LOADED 状态事务 | | `019ff90b-a037-79b0-b945-8f88bdbde9c5` | `01a00e43-8fc7-7e30-8ae0-175d873a4cfd` | 货柜管理 Admin 功能补齐 | 补齐货柜与装柜清单的文件闭环、异常处理、更多操作、运输轨迹日志、PDA 摘要和必要列表字段，不含柜态看板 | | `019ff90b-a72d-7000-abdf-e5363357a564` | `01a00e43-8fc7-7e30-8ae0-175d873a4cfd` | 货柜管理全链验收与状态数据 | 维护货柜管理全流程契约测试、真实验收脚本、各状态人工可点击数据矩阵和验收证据，不修改业务源码 | | `01a00037-08c8-7883-b76d-5c22b88e2329` | `01a00e43-8fc7-7e30-8ae0-175d873a4cfd` | PDA 拣货与装柜取证 | 维护 PDA 拣货、批量提交、任务恢复、装柜证据、状态提示及现场交互，并同步 PDA 本地契约测试；不修改 Admin、Client 或 Java 业务源码 | +| `01a00ef2-e190-7a32-a624-9e4d6ff09e55` | `01a00e43-8fc7-7e30-8ae0-175d873a4cfd` | PDA 样式与真机视觉优化 | 维护 PDA 页面视觉、布局、触控尺寸、窄屏适配、加载/空态/错误态、图片缩略图与预览样式及真机视觉验收；不修改后端、Admin/Client、业务状态机、HTTP 契约或数据库，不接管 PDA 拣货业务逻辑 | | `019ffef3-cc5e-78a1-affa-bcc98abfcc9e` | `01a00e42-0f41-77d2-9019-bcd2a170a6c1` | 国内仓订单-称重图片 OCR 与总重量 | 建设测量环节称重图片上传、OCR 重量识别、人工确认及订单总重量汇总的 Admin、Firstleg、File/Integration 契约与自动化测试，不改变审核直达待分柜和费用非阻塞规则 | | `019fff79-cdba-74f1-a591-3086119a94ed` | `01a00e42-0f41-77d2-9019-bcd2a170a6c1` | Warehouse 托盘主数据去资源化 | 将托盘收敛为可复用标识与主数据，维护托盘容量、皮重及内部只读快照契约，移除托盘动态占用释放语义，同时保持库位预占、占用、释放和 PDA 结算资源状态机 | | `019fff79-d2bd-74f1-9342-aaf677cb480d` | `01a00e42-0f41-77d2-9019-bcd2a170a6c1` | Admin 称重托盘与真实错误态 | 维护 Admin 入仓称重的托盘选择、毛重皮重净重展示、真实业务错误呈现及相关响应式和自动化测试，消费 Firstleg 最终称重去皮契约 | diff --git a/财务管理/openapi/finance-phase1-five-pages-v1.yaml b/财务管理/openapi/finance-phase1-five-pages-v1.yaml index 95ef934..52f6e78 100644 --- a/财务管理/openapi/finance-phase1-five-pages-v1.yaml +++ b/财务管理/openapi/finance-phase1-five-pages-v1.yaml @@ -92,6 +92,44 @@ paths: oneOf: - $ref: '#/components/schemas/FeeSourceEventResultEnvelope' - $ref: '#/components/schemas/ErrorEnvelope' + /internal/exports/v1/{exportType}/batches: + post: + servers: + - url: / + operationId: provideFinanceExportBatch + summary: 向 File 下载中心提供 Finance 导出批次 + description: >- + 仅供 File Service 使用；按任务、申请人、完整筛选参数签名并校验 snapshotToken。 + exportType 固定业务方向，参数不得包含 page、pageSize 或 direction（费用来源列表除外）。 + x-authentication: X-Internal-Service-Token + parameters: + - $ref: '#/components/parameters/InternalServiceToken' + - name: exportType + in: path + required: true + schema: + type: string + enum: + - FINANCE_CUSTOMER_ACCOUNT_LIST + - FINANCE_CUSTOMER_ACCOUNT_LEDGER + - FINANCE_FEE_SOURCE_LIST + - FINANCE_RECONCILIATION_STATEMENT_LIST + - FINANCE_RECEIVABLE_SETTLEMENT_LIST + - FINANCE_RECEIVABLE_SETTLEMENT_DETAIL + - FINANCE_PAYABLE_SETTLEMENT_LIST + - FINANCE_PAYABLE_SETTLEMENT_DETAIL + requestBody: + required: true + content: + application/json: + schema: {$ref: '#/components/schemas/FinanceExportBatchRequest'} + responses: + '200': + description: 版本化导出批次；首批返回 columns、totalRows 和 snapshotToken。 + content: + application/json: + schema: {$ref: '#/components/schemas/FinanceExportBatchEnvelope'} + '403': {description: 内部服务令牌无效。} /platform/finance/v1/accounts: get: operationId: listDerivedCustomerAccounts @@ -589,6 +627,55 @@ components: schema: {type: string, minLength: 1, maxLength: 128} description: 完整规范化 method/path/customer/body 哈希；同参重放，异参冲突。 schemas: + FinanceExportBatchRequest: + type: object + required: [taskId, tenantId, appCode, requestedBy, dispatchVersion, parameters, limit] + properties: + taskId: {type: string, pattern: '^[1-9][0-9]*$'} + tenantId: {type: string, enum: ['0']} + appCode: {type: string, enum: [PLATFORM]} + requestedBy: {type: string, pattern: '^[1-9][0-9]*$'} + dispatchVersion: {type: integer, minimum: 1} + parameters: + type: object + description: >- + ACCOUNT_LIST: customerId?, status?；ACCOUNT_LEDGER: customerId, businessType?, startDate?, endDate?； + FEE_SOURCE_LIST: customerId?, direction?, status?, reviewStatus?, settlementIncluded?, statementGenerated?, + businessDateFrom?, businessDateTo?, keyword?；RECONCILIATION_STATEMENT_LIST: customerId?, status?, billNo?, + containerNo?, periodStartFrom?, periodStartTo?, periodEndFrom?, periodEndTo?, settled?, lastPaymentFrom?, + lastPaymentTo?, createdFrom?, createdTo?；AR_LIST: customerId?, status?, settlementNo?；AP_LIST 另含 + supplierName?；所有 DETAIL 仅 settlementId。业务 ID 为十进制字符串，日期为 YYYY-MM-DD。 + additionalProperties: true + cursor: {type: string, nullable: true, description: 非负十进制偏移量。} + snapshotToken: {type: string, nullable: true, description: 首批为空，后续批次必须原样回传。} + limit: {type: integer, minimum: 1, maximum: 500} + FinanceExportColumn: + type: object + required: [key, title, type] + properties: + key: {type: string} + title: {type: string} + type: {type: string, enum: [STRING, INTEGER, DECIMAL, BOOLEAN, DATE, DATETIME]} + width: {type: integer, nullable: true} + FinanceExportBatch: + type: object + required: [schemaVersion, schemaHash, snapshotToken, columns, rows, nextCursor, hasMore] + properties: + schemaVersion: {type: integer, enum: [1]} + schemaHash: {type: string} + snapshotToken: {type: string} + columns: {type: array, items: {$ref: '#/components/schemas/FinanceExportColumn'}} + rows: {type: array, items: {type: object, additionalProperties: true}} + nextCursor: {type: string} + hasMore: {type: boolean} + totalRows: {type: integer, format: int64, nullable: true} + FinanceExportBatchEnvelope: + type: object + required: [code, message, data] + properties: + code: {type: string, example: '200'} + message: {type: string} + data: {$ref: '#/components/schemas/FinanceExportBatch'} Id: type: string pattern: '^[1-9][0-9]*$'