From 85fab9daf5e650b85aaa5b3219875b258b0c7b28 Mon Sep 17 00:00:00 2001 From: zh Date: Wed, 23 Sep 2026 10:43:15 +0800 Subject: [PATCH] =?UTF-8?q?docs(adr):=20=E6=8C=89=E2=80=9C=E5=BC=80?= =?UTF-8?q?=E5=8F=91=E9=98=B6=E6=AE=B5=E6=97=A0=E5=AE=A2=E6=88=B7=E6=95=B0?= =?UTF-8?q?=E6=8D=AE=E2=80=9D=E4=BF=AE=E8=AE=A2=20ADR-0001/0003=EF=BC=8C?= =?UTF-8?q?=E5=8E=BB=E6=8E=89=E8=BF=81=E7=A7=BB=E4=B8=8E=E5=85=BC=E5=AE=B9?= =?UTF-8?q?=E5=81=87=E8=AE=BE?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/adr/0001-tech-stack-and-repo.md | 6 +++--- docs/adr/0003-data-scope-and-authority.md | 4 +++- 2 files changed, 6 insertions(+), 4 deletions(-) diff --git a/docs/adr/0001-tech-stack-and-repo.md b/docs/adr/0001-tech-stack-and-repo.md index e01e492..a9a20a3 100644 --- a/docs/adr/0001-tech-stack-and-repo.md +++ b/docs/adr/0001-tech-stack-and-repo.md @@ -9,7 +9,7 @@ 现有仓库是「APS 产品 + 内嵌智能体层」的混合实现：网关一个文件 5232 行、数据库 18 张表混装平台与 APS 数据、APS 领域有 14 个文件反向依赖智能体层。重构的目标是把平台与 APS 拆开，平台从零重写。 -同时有两项硬约束：APS 的求解依赖 Python 生态（OR-Tools CP-SAT 在 TS 侧没有等价实现），所以 APS 只能搬迁适配、不能重写；旧系统仍在生产使用，切换必须可回退。 +同时有两项硬约束：APS 的求解依赖 Python 生态（OR-Tools CP-SAT 在 TS 侧没有等价实现），所以 APS 只能搬迁适配、不能重写；项目仍在开发阶段、无客户试用数据，因此不需要考虑与既有数据或接口的兼容，旧代码的作用只剩「搬迁时查证」。 ## 选项 @@ -21,7 +21,7 @@ ## 结论 -选 C。同一仓库建孤儿分支 `rewrite/platform`：工作区从 `main` 的内容出发，但提交历史从首个提交 `b878fd6` 开始，不继承旧历史。切换时以本分支强推覆盖 `main`（`--force-with-lease`），切换前把 `main` 备份为 `legacy/main` 并设为只读。 +选 C。同一仓库建孤儿分支 `rewrite/platform`：工作区从 `main` 的内容出发，但提交历史从首个提交 `b878fd6` 开始，不继承旧历史。切换时以本分支强推覆盖 `main`（`--force-with-lease`），切换前把 `main` 备份为 `legacy/main` 并设为只读——保留它不是为了回退生产，而是因为 APS 搬迁时要反复查证旧实现。 理由是两条同时满足：既保留原仓库的 issue、CI、权限与制品通道，又让新分支的历史真正从零开始。 @@ -34,6 +34,6 @@ ## 遗留 -- `legacy/main` 备份分支的创建与只读设置：切换前执行，见 A0.2 +- `legacy/main` 备份分支的创建与只读设置：切换前执行，见 A0.2。作用是保留旧代码供搬迁查证；无生产数据，不考虑回退 - 孤儿历史**不会**减小仓库体积（旧对象仍在对象库）；要体积归零只能另立仓库，本次不做 - 移植旧逻辑时在提交信息里写明 `移植自 main:`，否则 `git blame` 追不到来源 diff --git a/docs/adr/0003-data-scope-and-authority.md b/docs/adr/0003-data-scope-and-authority.md index e5fa111..afd69ce 100644 --- a/docs/adr/0003-data-scope-and-authority.md +++ b/docs/adr/0003-data-scope-and-authority.md @@ -9,6 +9,8 @@ 引擎会在开发或部署期被替换，业务系统会被拆出去独立演进。数据归属如果跟着变，每次调整都要迁数据。所以要在重构开始前把两件事定死：会话的作用域怎么划分，以及每类数据的权威方是谁。 +这条决定与「兼容旧数据」无关：项目仍在开发阶段，没有客户试用数据，不需要迁移或兼容任何历史数据。它管的是新系统内部的归属，作用是让将来的替换与拆分不需要迁数据。 + ## 选项 | 选项 | 做法 | 代价 | 不选的理由 | @@ -41,4 +43,4 @@ ## 遗留 - APS 独立后要自带项目与租户概念（任务 B2） -- 既有审批数据里有在途状态，处置方式见 ADR-0005 +- 无历史数据需要迁移，原「在途审批数据处置」一项取消