优化

2026-08-25 11:52:28 +08:00
parent f88495778c
commit b36d9d2b2f
2 changed files with 12 additions and 4 deletions
@@ -15,7 +15,8 @@
 | 海外仓 | 尾程订单、入库单、换标单、托盘管理、库存管理；箱号管理与产品库当前暂不进入四期正式入口；Admin 入口 `../../apps/admin-web/src/modules/overseas-warehouse/` | 原型 `../悦/货代SAAS平台后台/prototype-src/modules/03-overseas-warehouse.html`；Backend `../../baiyue-firstleg/lastleg-service/`、`../../baiyue-firstleg/warehouse-overseas-service/`，经 `gateway-overseas/` |
 | 海外仓排车查询与智能预排 | 平台查看排车列表/详情，按入仓计划或已收托盘筛选候选并创建待出库预排；不开放排车编辑、取消、发车、PDA 出库或派送 | Admin `../../apps/admin-web/src/modules/overseas-warehouse/pages/DispatchesView.vue`、`api/dispatches.ts`；Backend `../../baiyue-firstleg/lastleg-service/src/main/java/com/baiyue/lastleg/dispatch/controller/DispatchQueryController.java`、`SmartDispatchController.java` |
 | 海外仓客户自助服务 | 客户工作台正式开放贴标申请、仓储转运、货物废弃和退货换标；所有查询和写入只使用登录态客户范围 | Client `../../apps/client-web/src/modules/overseas-warehouse/routes.ts`、`views/WarehouseServiceView.vue`、`api/warehouseServices.ts`；Backend `../../baiyue-firstleg/lastleg-service/` 的 `relabel/`、`transfer/`、`discard/`，经 `gateway-overseas/` |
-| 海外仓 PDA | 独立应用 `../../apps/pda-overseas-uniapp/`；四期工作台只进入到仓登记、卸柜收货、入仓上架、盘点、移库、托盘、换标和现场查询，不含出库与派送 | 页面/能力入口 `src/data/overseas-workbench.js`、`src/pages/operation/operation.vue`；入仓后端 `../../baiyue-firstleg/lastleg-service/src/main/java/com/baiyue/lastleg/inboundplan/pda/`，仓储资源 `warehouse-overseas-service/`，统一经 `gateway-overseas/` |
+| 海外仓 PDA 柜号签收与入仓 | 独立应用 `../../apps/pda-overseas-uniapp/`；当前真实前端只开放拆柜收货，完成柜号认领、三类照片、FBA 按 SKU 箱数/OVERSEAS 逐箱实收与全柜完成 | 前端 `src/api/inbound.js`、`receiving-adapter.js`、`pages/operation/operation.vue`；Backend `../../baiyue-firstleg/lastleg-service/src/main/java/com/baiyue/lastleg/inboundplan/pda/controller/ReceivingContainerController.java`、`ReceivingContainerService.java`，经 `gateway-overseas/` |
+| 海外仓 PDA 库内、托盘、换标与查询 | Lastleg 已提供 PDA 专用盘点、同仓整托移库、托盘组拆换绑、换标与库存/库位/托盘查询后端；海外 PDA 工作台入口仍禁用，前端接入前不得宣称全链路完成 | Backend `../../baiyue-firstleg/lastleg-service/src/main/java/com/baiyue/lastleg/pda/stocktake/`、`pda/move/`、`pda/warehouse/`、`palletops/`、`relabel/pda/`；契约 `src/main/resources/openapi/overseas-pda-operations-v1.yaml` |
 | 海外业务 | 本土散板、采购订单、本土卡车；Admin 入口 `../../apps/admin-web/src/modules/overseas-business/` | 原型 `../悦/货代SAAS平台后台/prototype-src/modules/07-overseas-business.html`；Backend `../../baiyue-firstleg/lastleg-service/` 的 `procurement/`、`trucking/` 及后续本土散板子域 |
 | 头程仓库主数据 | 在现有仓库类型中增加“海外仓合作仓”；实际海外仓资源独立维护 | Admin `../../apps/admin-web/src/modules/warehouses/`；国内公共主数据 `../../baiyue-firstleg/warehouse/`；海外仓资源 `../../baiyue-firstleg/warehouse-overseas-service/` |
 | 通用资料 | 海外仓报价、汇率管理、车辆列表；Admin 入口 `../../apps/admin-web/src/modules/overseas-master-data/` | `../悦/货代SAAS平台后台/prototype-src/modules/10-general.html` |
@@ -73,6 +74,6 @@
 - 海外库存、库内作业和海外本土业务已有明确服务入口：`gateway-overseas/` 是海外 API 网关，`lastleg-service/` 拥有尾程订单、入仓计划、换标、库存业务、采购和本土卡车，`warehouse-overseas-service/` 拥有海外仓库、库位、托盘及资源锁。不得把这些能力塞入国内 `firstleg/` 或 `warehouse/`。
 - 船节点是头程海运在途事实与四期海外接柜之间的衔接能力，业务聚合继续由 Firstleg 持有；到港/可提柜结果通过明确契约或跨区域事件提供给海外区域，不复制第二套轮询任务。
 - Admin、Client 仍使用统一账号体系，并按根 `AGENTS.md` 的双区域 API、海外 Token 和跨区域事件约定接入；业务页面不自行实现第二套登录。
- 海外仓 PDA 使用独立 `apps/pda-overseas-uniapp/` 工程和发布身份，但账号仍由国内 Auth 唯一签发；真实作业请求必须经海外 Gateway 的显式 PDA 路由。当前工作台/通用作业页是静态原型时不得据此宣称 Lastleg 或 Warehouse Overseas 已完成设备联调。
+- 海外仓 PDA 使用独立 `apps/pda-overseas-uniapp/` 工程和发布身份，但账号仍由国内 Auth 唯一签发；真实作业请求必须经海外 Gateway 的显式 PDA 路由。当前拆柜收货已接真实 API；库内、托盘、换标和查询仍按工作台禁用状态管理，即使 Lastleg Controller 已存在也不得据此宣称设备端联调完成。
 - 海外 PDA 的实际收货仓是 `warehouse-overseas-service` 中 `customer_id=0`、类型为 `OVERSEAS`、启用 `RECEIVING` 能力的平台共享物理仓，并由 `WAREHOUSE_PICKER` 的 Token Claim 固定；PDA 不接收仓库 ID，也不能切换柜号。海外 Gateway 对每个 `/api/pda/**` 请求在本地验签后向 Auth 实时核对账号 `token_version` 与当前仓绑定，换仓或清空绑定后旧 Token 立即失效，Auth 不可用时拒绝请求。待收柜在首次准备时原子认领到该仓，入仓计划、尾程订单和收货会话冻结实际仓 ID/名称；国内装柜事件的仓库仅作为来源仓快照，目的仓/FBA 仓也不得冒充实际收货仓。
 - 新增实际代码模块、API、权限、OpenAPI 或数据库入口后，同步更新根 `AGENTS.md`、对应应用/服务 `AGENTS.md` 和本文件；不把排期、完成比例或临时任务状态写入快速索引。
@@ -4,8 +4,8 @@

 ## 当前状态

- 当前已启用财务改造、四期前端页面和四期后端缺口三个平级总控；只按下方登记的稳定 `task_id` 协作。
- 财务总控下登记五个长期专项，四期前端总控下登记五个长期专项，四期后端总控下登记五个长期专项；各总控继续统一集成共享契约与跨专项回归。
+- 当前已启用财务改造、四期前端页面、四期后端缺口和 Java 架构改善四个平级总控；只按下方登记的稳定 `task_id` 协作。
+- 财务总控下登记五个长期专项，四期前端总控下登记五个长期专项，四期后端总控下登记五个长期专项，Java 架构改善总控下登记六个长期专项；各总控继续统一集成共享契约与跨专项回归。
 - 其他普通工作仍采用“一个任务、一个对话、逐项修复”的方式，不根据历史名称或旧职责向未登记对话下发。
 - 侧栏其他旧任务不属于本轮已登记协作，是否归档由用户人工决定，Codex 不自动归档、解档或恢复。

@@ -26,6 +26,7 @@
 | `01a01490-08e6-7b11-b16f-0085e232d04c` | 财务改造总控 | 冻结财务共享产品契约、状态机、OpenAPI、权限与数据库边界；协调五个财务专项并统一集成共享导航、权限 SQL、跨任务回归和验收结论 |
 | `01a018cb-a435-7c61-91ca-4f3e484dca75` | 四期前端页面总控 | 负责四期 Admin 前端页面的统一规划、实现与集成：国内出仓后船节点查询、海外仓尾程订单/入库/换标/托盘/箱号/产品/库存、海外采购/本土卡车/本土散板、海外仓合作仓类型、海外仓报价/汇率/车辆；统一维护四期前端路由、导航、权限、原型还原和回归，不承接海外仓出库业务或后端实现 |
 | `01a0194a-259c-7171-8967-074731a27618` | 四期后端缺口总控 | 负责四期后端缺口的统一盘点、契约收口、实现集成与回归：海外区域 Gateway、尾程与海外仓服务，海外接柜入仓、库存与库内操作，海外采购/本土卡车/本土散板，合作仓与报价/汇率/车辆主数据，国内出仓后船节点定时查询，以及所需 IAM、海外 Token、OpenAPI、初始化 SQL 和跨区域事件契约；向四期前端总控提供稳定 API，涉及 Finance 口径时交由财务总控冻结；不承接海外仓出库、海外派送、前端页面或财务状态机 |
+| `01a036f9-1d1c-77a0-a4d4-a99bb0d2532a` | Java架构改善总控 | 负责 Java 后端共享架构治理、改善路线和统一门禁：Firstleg/Lastleg 内部模块化、同步依赖治理、Event Bridge 传输与可靠性口径、数据库版本化演进、OpenAPI/ArchUnit/覆盖率/静态质量、GitLab/Jenkins 服务清单一致性、Trace/事件堆积/业务 SLO 可观测性及架构文档同步；协调后续架构专项并统一集成结论，不替代财务、四期前端或四期后端业务总控，不自行部署、执行 SQL 或修改环境数据 |

 长期独立任务：

@@ -46,3 +47,9 @@
 | `01a01e56-bed3-75f3-ba02-cc28479cd8ee` | `01a0194a-259c-7171-8967-074731a27618` | 四期后端专项三：海外入仓与库存 | 负责 Lastleg 与 Warehouse Overseas 的尾程订单、接柜、入仓计划、卸货入库、换标、平台公共托盘、SKU 库存和库内操作后端；排除箱号平台、产品库、海外出库、退货出库、海外派送，不向 Admin 暴露 PDA 或内部事件端点 |
 | `01a01e56-c0f2-71f1-9c74-02f6709233f1` | `01a0194a-259c-7171-8967-074731a27618` | 四期后端专项四：海外本土业务 | 负责 Lastleg 海外采购订单、本土卡车、本土散板完整后端，以及客户/仓库候选、字段清空语义、流水、平台写接口、权限、OpenAPI、SQL 和测试；排除采购出库、海外仓出库、退货出库与海外派送 |
 | `01a01e56-c30b-7513-be9e-03262a387696` | `01a0194a-259c-7171-8967-074731a27618` | 四期后端专项五：船节点自动查询 | 负责国内确认出仓后至还柜的 CarrierScheduleQuery 自动任务、租约、幂等、退避、十个标准节点、异常事实、预计/实际时间、人工补录、还柜停止条件、Integration 供应商适配、查询尝试与历史、货柜 DTO 及跨区衔接；不新建重复轮询体系，不承接海外派送、PDA 或前端页面 |
+| `01a03702-e35b-7202-a395-62643ab77ec2` | `01a036f9-1d1c-77a0-a4d4-a99bb0d2532a` | Java架构专项一：拓扑与质量门禁 | 负责 22 Maven 模块、15 个可运行服务的拓扑合同，POM、service-map、GitLab 制品、Jenkins、Compose、Nacos 清单一致性，以及 Maven、OpenAPI、JaCoCo、静态分析和 ArchUnit 共享质量门禁；不修改业务状态机、不部署，海外基础设施内容与四期后端基础设施专项协调 |
+| `01a03702-e52e-7503-8c4e-b24ebf6aa925` | `01a036f9-1d1c-77a0-a4d4-a99bb0d2532a` | Java架构专项二：同步依赖与失败传播 | 负责 Java 后端 Feign/HTTP 同步调用图，双向依赖、调用链深度、超时、重试、熔断、幂等、错误映射和失败传播治理；不擅自改变财务或四期业务状态机，不以默认成功、空数据或静默降级掩盖远端失败 |
+| `01a03702-e749-7ce1-9c50-25961c7dfc83` | `01a036f9-1d1c-77a0-a4d4-a99bb0d2532a` | Java架构专项三：Event Bridge可靠传输 | 负责当前 HTTP+DB 跨区事件链路的 common-event-contract、Event Bridge、Firstleg、Lastleg 和 IAM Outbox/Inbox、租约、退避、投递记录、死信、人工补投、幂等冲突、文档口径和链路测试；不定义财务或四期业务语义，不承接部署基础设施 |
+| `01a03702-e92c-7b12-815d-5e02f1e1adf0` | `01a036f9-1d1c-77a0-a4d4-a99bb0d2532a` | Java架构专项四：Firstleg内部模块化 | 负责 Firstleg 同一部署单元内入库、测量计价、分柜装柜、订舱报关拖车、出仓、船节点、客户统计和财务集成切片的应用 Port、依赖方向与 ArchUnit 治理；不拆新微服务、不扩大业务范围、不替代财务总控 |
+| `01a03702-ebbd-74d0-a109-54bbd7628050` | `01a036f9-1d1c-77a0-a4d4-a99bb0d2532a` | Java架构专项五：Lastleg内部模块化 | 负责 Lastleg 同一部署单元内尾程交接、入仓/PDA、库存、排车/派车、换标、转运、废弃、一件代发、采购/卡车/散板和海外主数据切片的应用 Port、依赖方向与 ArchUnit 治理；不拆新微服务，不扩大海外出库、退货出库或海外派送范围 |
+| `01a03702-edaa-79b1-bed0-bbe85d6aeac5` | `01a036f9-1d1c-77a0-a4d4-a99bb0d2532a` | Java架构专项六：Trace指标与业务SLO | 负责统一 Trace、X-Request-Id/X-Trace-Id 与 traceparent 传播、Feign/HTTP/事件上下文、通用指标、事件积压与死信指标，以及跨区关键业务链 SLI/SLO 和告警合同；只维护代码、测试、配置模板和文档，不搭建或部署监控环境 |