2026-09-28 16:01:16 +08:00
4 changed files with 11 additions and 16 deletions
@@ -23,14 +23,14 @@
 - 收敛范围包括源码结构、接口与 DTO、字段、状态机、权限、配置键、OpenAPI、数据库结构与初始化 SQL、事件、路由、页面、前端消费者、Mock/Fixture、测试和脚本；旧实现冲突时同步修改全部生产者与消费者并直接删除旧实现。
 - 禁止为旧代码、旧调用或开发环境存量保留旧接口/旧字段别名、兼容分支、双协议、双写、灰度、回滚版本、降级解析、旧行为回退、临时适配层、迁移脚本、回填脚本、清理补偿或新旧版本并行；不得以“稳妥”“兼容历史数据”或“先保留以后删除”为由延迟收敛。
 - 开发环境数据库记录、上传文件、缓存、会话、消息、搜索索引和其他运行状态均可丢弃；正常验证方式是更新最新初始化基线、重新造数或上传，并直接运行受影响回归，不模拟生产迁移。已有历史 SQL 只用于开发追溯，不构成兼容依据。
- 后端位于独立 Git 仓库 `../baiyue-firstleg/`，执行 Git 命令前确认当前工作目录。“无需兼容、直接修复”不授权自动重置数据库、删除数据/文件、执行 SQL、部署或修改环境。已登记总控和专项对测试数据库的持续授权以 `独立任务协作登记.md` 为准；未登记任务和开发/生产环境仍需用户在当前轮明确授权。
+- 后端位于独立 Git 仓库 `../baiyue-firstleg/`，执行 Git 命令前确认当前工作目录。“无需兼容、直接修复”不授权自动重置数据库、删除数据/文件、执行 SQL、部署或修改环境。测试环境授权只读 `独立任务协作登记.md`，开发五期授权只读 `开发环境独立任务协作登记.md`；未登记任务和生产环境仍需用户在当前轮明确授权。

 ## 联调、部署与数据库

 - 默认只准备代码、验证结果和人工部署步骤，不触发 Jenkins、不启动本地 Java/Nacos/数据库。开发五期总控可按 `开发环境独立任务协作登记.md` 的授权操作开发数据库、部署开发环境并执行开发环境真实 HTTP；登记专项可按 `独立任务协作登记.md` 的持续授权查询和修改用户指定的测试数据库。两类授权不得跨环境复用，也不得自动扩大到 Jenkins 或生产环境。
 - 只有用户在当前轮明确授权指定环境、服务和提交时，才可部署或执行 HTTP 验收；测试数据库的读写例外仅适用于登记表中已持续授权的总控与专项，并遵守其中的职责和破坏性操作门禁。
 - 环境地址、凭据和 Token 不写入源码或 `AGENTS.md`。接口不可用或契约不一致时记录路径、状态、错误码、`requestId`/`traceId` 和阻断原因，不回退到模拟成功。
- 具体联调脚本、服务启动和验收命令以目标项目指引及 `测试环境Jenkins部署指南.md` 为准。
+- 测试环境联调、部署和验收命令读取 `测试环境Jenkins部署指南.md`；开发五期只按 `开发环境独立任务协作登记.md` 的授权与目标项目指引执行，不把测试 Jenkins 流程当作开发部署入口。

 ## 通用工程与质量门禁

@@ -50,7 +50,7 @@
 - 跨环境调度必须先核对保存项目 projectId、任务 cwd 与环境登记表三项一致；任一不一致不得下发或执行。禁止把测试环境任务通过绝对路径提示临时改作开发环境任务，反向同样禁止。
 - 开发环境五期任务只使用 `开发环境独立任务协作登记.md`；测试环境任务只使用 `独立任务协作登记.md`。两套任务不互相复用，不在两个目录之间复制未提交文件、生成补丁、自动合并或 cherry-pick。

- 普通任务不读取协作登记。只有用户明确指定当前对话为总控，或要求检索历史任务、独立任务或跨对话通信时，才读取 `独立任务协作登记.md`。
+- 普通任务不读取协作登记。只有用户明确指定当前对话为总控，或要求检索历史任务、独立任务或跨对话通信时，才按当前保存项目与 cwd 读取唯一匹配的登记表：开发五期读 `开发环境独立任务协作登记.md`，测试环境读 `独立任务协作登记.md`；不得同时加载两表后混合选取任务。
 - 总控在接收任务时必须先做时长评估；预计单一执行链超过 15 分钟时，不得继续由一个任务从定位包办到验收，必须立即拆成可并行的“根因/契约核对、实现修复、回归验收”等独立工作包，并明确每包文件写权限和交付物。优先复用登记表中的长期专项；一次性工作使用内部子代理。该规则不自动授权创建新的用户可见任务。
 - 实际执行超过 15 分钟仍未形成可验证交付时，总控必须主动重新拆分或缩小范围，向用户报告当前阻断与并行安排，不得静默等待、继续扩展设计或把非必要兼容、迁移、补偿工作并入主修复链。
 - 用户按业务流程逐节点进行人工验收时，总控必须以“当前验收节点”为调度和完成单位，而不是以代码模块或单个 Bug 为单位。收到该节点首个问题后，应立即并行检查前端交互、后端状态与契约、数据/权限前置和自动化验收覆盖；同一节点后续问题统一并入该批次，不得连续串行追加给一个长期专项。
@@ -9,7 +9,8 @@
 - [三期文档](三期/README.md)：智能排柜、订舱、拖车、PDA 拣货、报关协同和国内出仓闭环。
 - [四期文档](四期/README.md)：国内出仓后的船节点定时查询、海外接柜、合作仓卸货入库、库存与库内操作，以及海外采购、本土卡车和本土散板；不包含海外仓出库业务。
  - [船节点标准化契约](四期/船节点标准化契约.md)：统一船司原始状态、十个标准节点、预计/实际时间、异常事实、还柜停止规则和新增船司接入门禁。
- [独立任务协作登记](独立任务协作登记.md)：只维护总控与用户可见独立任务的稳定 `task_id`、父子关系和职责范围，不记录动态进度或归档状态。
+- [测试环境独立任务协作登记](独立任务协作登记.md)：只维护测试环境系统总控与长期专项的稳定 `task_id`、父子关系、职责和测试数据库授权。
+- [开发环境独立任务协作登记](开发环境独立任务协作登记.md)：只维护开发环境五期总控与专项的稳定 `task_id`、projectId、职责及开发数据库/部署/HTTP 授权。

 ## 跨阶段参考

@@ -9,6 +9,7 @@
 - 开发专项日常只执行源码实现、定向测试、类型检查和构建；开发数据库与开发部署只能由开发总控在代码门禁通过后按精确服务、数据库和变更清单单独下发。测试环境、测试数据库、生产环境和 Jenkins 仍禁止。
 - 开发与测试目录之间不得复制未提交文件、生成补丁、自动合并或 cherry-pick；需要移交时由用户明确授权具体方向、提交和范围。
 - 同一批次每个应用或服务只允许一个生产代码写入者；共享路由、导航、权限初始化、OpenAPI 和 SQL 的写入权由开发总控在下发时明确。
+- 每次提交前必须先在目标仓库执行 `git fetch origin test dev`，保持当前分支为 `dev`，把最新 `origin/test` 合并到 `dev` 后再提交本轮改动；不得通过切换分支、rebase、force push 或跳过冲突来规避同步。发生冲突时由该仓库当前唯一 Git 集成者处理，必须同时保留 test 最新有效改动与开发总控已冻结的 dev 契约，并在提交前重跑直接受影响门禁。

 ## 开发环境操作授权

@@ -32,7 +33,7 @@
 |---|---|---|---|---|
 | `01a05b23-bfc6-7121-a6f2-7fc14ee456a3` | `01a05b10-a5fc-7d51-8203-c671f3a823ad` | `6f874ec3-d3b2-49bd-8625-327f4d685f98` | 【开发五期前端】Admin | `apps/admin-web/` 五期海外仓排车、出库、派送、异常退回、客户回访页面、路由、API、权限消费、测试与构建；不修改 Client、PDA、后端或 SQL。 |
 | `01a05b23-c20f-7f52-8a26-543f1563f0f8` | `01a05b10-a5fc-7d51-8203-c671f3a823ad` | `6f874ec3-d3b2-49bd-8625-327f4d685f98` | 【开发五期前端】Client | `apps/client-web/` 五期客户派送页面、详情、创建表单、路由、API、权限消费、测试与构建；不修改 Admin、PDA、后端或 SQL。 |
-| `01a05b78-6e28-7460-babf-3a87331f6dd4` | `01a05b10-a5fc-7d51-8203-c671f3a823ad` | `6f874ec3-d3b2-49bd-8625-327f4d685f98` | 【开发五期前端】海外PDA-替代 | `apps/pda-overseas-uniapp/` 五期排车拣货、一件代发出库、任务完成、发车入口、真实 API、恢复、扫码、幂等、测试与构建；派送不进入 PDA。 |
+| `01a05b78-6e28-7460-babf-3a87331f6dd4` | `01a05b10-a5fc-7d51-8203-c671f3a823ad` | `6f874ec3-d3b2-49bd-8625-327f4d685f98` | 【开发五期前端】海外PDA | `apps/pda-overseas-uniapp/` 五期排车拣货、一件代发出库、任务完成、发车入口、真实 API、恢复、扫码、幂等、测试与构建；派送不进入 PDA。 |
 | `01a05b23-c5ff-77c3-8f77-ceb4f4c40de2` | `01a05b10-a5fc-7d51-8203-c671f3a823ad` | `6f874ec3-d3b2-49bd-8625-327f4d685f98` | 【开发五期后端】Lastleg | `baiyue-firstleg/lastleg-service/` 五期 dispatch、delivery、dropship、exceptionorder、customervisit、PDA 出库与发车的接口、业务、OpenAPI、SQL、权限强制和测试。 |
 | `01a05b23-c7f8-72e0-bb3c-afbbf1c7f9e7` | `01a05b10-a5fc-7d51-8203-c671f3a823ad` | `6f874ec3-d3b2-49bd-8625-327f4d685f98` | 【开发五期后端】IAM权限 | `baiyue-firstleg/iam/` 及必要 common-security 的五期平台/客户权限资源、角色初始化、授权快照、OpenAPI、SQL 和测试；不修改 Lastleg 业务或前端。 |

@@ -1,16 +1,15 @@
-# 独立任务协作登记
+# 测试环境独立任务协作登记

-> 仅供用户明确要求启用总控、检索历史任务或跨对话通信时读取。普通任务和子代理不读取、不登记。
+> 仅适用于保存项目“测试环境”（projectId `c64729ff-6710-43c6-8ef2-d84e9666cc1e`）和工作目录 `C:\Users\BY-OY\Desktop\code\chongchong-global`。开发环境任务不得复用本表任务，本表任务也不得访问开发目录。普通任务和子代理不读取、不登记。

 ## 当前状态

- 当前启用一个“【总控】系统调度”作为整个系统缺陷、需求、联调和跨端契约问题的唯一用户入口，并启用一个下级“【开发总控】五期开发”负责开发环境五期实现协调；只按下方登记的稳定 `task_id` 协作。
- 环境职责严格分离：开发总控只在 `C:\Users\BY-OY\Desktop\code\chongchong-global-dev` 协调源码、测试和构建，不操作测试环境、测试数据库、Jenkins、部署或真实 HTTP；测试环境 `C:\Users\BY-OY\Desktop\code\chongchong-global` 的部署、数据库和真实验收仍由系统总控在用户当轮明确触发后单独调度，不设置常驻测试总控。
+- 当前只启用一个“【总控】系统调度”作为测试环境缺陷、联调、部署批次和验收问题的唯一入口；只按下方登记的稳定 `task_id` 协作，不登记或调度开发环境五期任务。
 - 四期总控只负责接单、归属判断、契约冻结、任务分发、共享冲突协调、统一质量门禁和结果汇总；不得直接承担可由长期专项执行的业务源码、页面、测试脚本或接口实现，也不得用临时子代理代替应当登记的稳定专项。现有长期专项无法覆盖稳定职责时，总控必须先向用户申请新增独立任务，明确精确数量、职责和所属总控，获得确认后才能创建。
 - 总控与长期专项采用单向调度：只允许总控主动向专项下发工作。专项完成、阻断或取得测试结果后，只在自己的任务中保留状态和最终结论，不主动跨任务向总控发送消息或委托回传；总控需要进度时主动使用任务读取/等待能力获取。除总控明确发起当次查询外，专项不得以“回传总控”为由持续唤醒总控任务。
 - 四期总控接单时执行 15 分钟评估门禁：预计超过 15 分钟或实际执行超过 15 分钟仍无可验证交付，必须立即拆分根因、实现和验收工作包并行下发；共享文件只允许一个实现专项写入，其他工作包只读诊断或独立验证。
 - 用户逐节点人工验收期间，四期总控按“当前验收节点”建立临时并行批次：相关长期专项只承担其稳定边界，其他一次性根因、数据与自动化工作使用内部子代理；同一节点的新问题继续加入该批次，节点真实通过后再统一结束，不为每个 Bug 新建长期任务。
- 系统总控保留十八个长期专项的登记所有权，其中五个前端专项、十三个后端专项；五期开发批次可整体委托开发总控，由开发总控在同一配额内选择一个前端、最多三个相关后端下发，不默认启动全部专项。验收任务不常驻登记，只有用户明确要求时才恢复。
+- 系统总控直接管理十八个测试环境长期专项，其中五个前端专项、十三个后端专项；每个节点按一个前端、最多三个相关后端的配额下发，不默认启动全部专项。验收任务不常驻登记，只有用户明确要求时才恢复。
 - 其他普通工作仍采用“一个任务、一个对话、逐项修复”的方式，不根据历史名称或旧职责向未登记对话下发。
 - 侧栏其他旧任务不属于本轮已登记协作，是否归档由用户人工决定，Codex 不自动归档、解档或恢复。

@@ -49,12 +48,6 @@
 |---|---|---|
 | `01a0194a-259c-7171-8967-074731a27618` | 【总控】系统调度 | 作为整个系统缺陷、需求、联调和跨端契约问题的唯一入口，按当前节点选择一个前端和最多三个相关后端；负责优先级、职责归属、共享契约、文件写入权、部署批次和结果汇总，不直接承担业务实现、普通测试、HTTP、数据库或 Jenkins 操作。 |

-环境总控：
-
-| task_id | parent_task_id | 展示名称 | 唯一长期职责 |
-|---|---|---|---|
-| `01a05b10-a5fc-7d51-8203-c671f3a823ad` | `01a0194a-259c-7171-8967-074731a27618` | 【开发总控】五期开发 | 只负责 `chongchong-global-dev` 五期开发批次的跨端契约冻结、实现专项调度、共享文件写入权、定向测试/构建门禁和可部署清单汇总；不操作测试环境、测试数据库、Jenkins、部署或真实 HTTP 验收。 |
-
 长期前端专项：

 | task_id | parent_task_id | 展示名称 | 唯一长期职责 |