Files
docs/开发环境独立任务协作登记.md
T

41 lines
5.4 KiB
Markdown
Raw Normal View History

2026-09-01 14:27:19 +08:00
# 开发环境独立任务协作登记
> 仅适用于保存项目“开发环境”(projectId `6f874ec3-d3b2-49bd-8625-327f4d685f98`)和工作目录 `C:\Users\BY-OY\Desktop\code\chongchong-global-dev`。测试环境任务不得复用本表任务,本表任务也不得访问测试目录。
## 环境隔离门禁
- 开发总控只向本表 task_id 下发五期开发工作;不得向 `C:\Users\BY-OY\Desktop\code\chongchong-global` 的测试环境任务下发,即使提示中另写开发目录也不例外。
- 每个任务必须同时满足 projectId、cwd 和登记环境一致;任一项不一致立即停止,不读取、不修改、不运行命令,也不得自行切换目录补救。
- 开发专项日常只执行源码实现、定向测试、类型检查和构建;开发数据库与开发部署只能由开发总控在代码门禁通过后按精确服务、数据库和变更清单单独下发。测试环境、测试数据库、生产环境和 Jenkins 仍禁止。
- 开发与测试目录之间不得复制未提交文件、生成补丁、自动合并或 cherry-pick;需要移交时由用户明确授权具体方向、提交和范围。
- 同一批次每个应用或服务只允许一个生产代码写入者;共享路由、导航、权限初始化、OpenAPI 和 SQL 的写入权由开发总控在下发时明确。
2026-09-01 14:46:40 +08:00
- 每次提交前必须先在目标仓库执行 `git fetch origin test dev`,保持当前分支为 `dev`,把最新 `origin/test` 合并到 `dev` 后再提交本轮改动;不得通过切换分支、rebase、force push 或跳过冲突来规避同步。发生冲突时由该仓库当前唯一 Git 集成者处理,必须同时保留 test 最新有效改动与开发总控已冻结的 dev 契约,并在提交前重跑直接受影响门禁。
2026-09-01 14:27:19 +08:00
## 开发环境操作授权
- 用户已在当前持续目标中授权本总控部署开发环境、操作开发数据库,并对开发环境执行真实 HTTP 调用。授权不扩展到测试或生产环境,也不开放 Jenkins。
- 数据库操作前必须确认开发库、精确表、业务主键或 SQL 文件和预计影响行;优先使用事务并保留执行结果。仓库已审核的开发增量 SQL、测试造数和职责范围内的数据修正可执行。
- `DROP`、`TRUNCATE`、整库重置、清空表、无明确主键范围的批量删除及其他不可恢复操作不在授权内,仍需用户当轮单独确认。
- 开发部署必须在受影响测试、类型检查或构建通过后进行,并记录精确部署单元、使用的提交或工作区状态、配置来源和部署结果。若唯一部署方式依赖 Jenkins,执行前重新取得用户对 Jenkins 的明确授权。
- 开发环境真实 HTTP 在部署和数据库变更完成后执行,可包含当前五期职责范围内的读写验收;只使用开发身份和开发数据,记录接口路径、HTTP 状态、业务码、`requestId`/`traceId` 与结果,不输出或持久化 Token、密码和敏感载荷。破坏性批量请求仍需单独确认。
## 登记表
总控:
| task_id | project_id | 展示名称 | 长期职责 |
|---|---|---|---|
| `01a05b10-a5fc-7d51-8203-c671f3a823ad` | `6f874ec3-d3b2-49bd-8625-327f4d685f98` | 【开发总控】五期开发 | 接收五期开发任务,冻结跨端契约和串行批次,协调本表专项完成实现、定向测试和构建;代码门禁通过后按本表授权操作开发数据库、部署开发环境并执行真实 HTTP 验收;不操作测试/生产环境或 Jenkins。 |
长期专项:
| task_id | parent_task_id | project_id | 展示名称 | 唯一长期职责 |
|---|---|---|---|---|
| `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。 |
2026-09-01 14:46:40 +08:00
| `01a05b78-6e28-7460-babf-3a87331f6dd4` | `01a05b10-a5fc-7d51-8203-c671f3a823ad` | `6f874ec3-d3b2-49bd-8625-327f4d685f98` | 【开发五期前端】海外PDA | `apps/pda-overseas-uniapp/` 五期排车拣货、一件代发出库、任务完成、发车入口、真实 API、恢复、扫码、幂等、测试与构建;派送不进入 PDA。 |
2026-09-01 14:27:19 +08:00
| `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 业务或前端。 |
验收与部署任务不常驻登记。只有用户明确要求开始验收、准备部署或执行验收时,才另行决定是否创建;开发任务不得代行。