优化

2026-08-17 17:49:06 +08:00
parent 50d9d81740
commit cdc41bc843
2 changed files with 93 additions and 4 deletions
@@ -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 最终称重去皮契约 |
@@ -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]*$'