# A0-G 设计评审结论

- **评审日期**：2026-09-23
- **参与人**：技术负责人（决策人）
- **方式**：追认式。不另开评审会——七项决策在本轮设计中已逐条与决策人确认，本文把确认结果落成记录；每份 ADR 的出处见下表
- **材料包版本**：`rewrite/platform`，含 ADR-0007（提交 `0981004`）；本结论随本文件提交
- **结论**：**通过**

本结论的效力来自「逐条确认 + 提交可查」，不来自会议签字。若后续需要会签记录，另附会议纪要即可，不改变这里的判定。

## 1 逐份 ADR

| 编号 | 结论 | 决策方式与出处 |
| --- | --- | --- |
| ADR-0001 技术栈与仓库形态 | 接受 | 逐条确认（原地重写、孤儿分支、工作区以 `main` 内容为起点）；提交 `7806e41`，`85fab9d` 修订（去掉迁移假设） |
| ADR-0002 引擎与 Provider 部署形态 | 接受 | 决策 D1；提交 `8d261af` |
| ADR-0003 数据作用域与权威数据源 | 接受 | 决策 D2；提交 `8d261af`，`85fab9d` 修订（无历史数据需迁移） |
| ADR-0004 桌面端与本地能力边界 | 接受 | 决策 D4；提交 `8d261af` |
| ADR-0005 直接切换，不并行、不迁移 | 接受 | 决策 D7；提交 `6fb5310` |
| ADR-0006 引擎以长驻子进程运行 | 接受 | 决策 D10；提交 `e144429` |
| ADR-0007 数据存储选型与双形态一致规则 | 接受 | 决策 D11；提交 `0981004` |

无异议，无退回项。要改结论仍按 `docs/adr/README.md` 的规则：新写一份 ADR 取代，不改原文。

追认三项在材料包定稿后落地的结论（均已写入决策台账与盘点表）：

- 持久层拆分收敛为**平台 7 张 / APS 6 张**，平台表不带 `aps_` 前缀（原写 12 张）
- **工艺路线模型归 APS**，平台不建模板库
- 业务数据（主数据、工艺、排产结果）权威方是业务系统，平台只存引用，避免第二事实源

## 2 遗留项认领

| # | 遗留项 | 责任人 | 时限 | 处置 |
| --- | --- | --- | --- | --- |
| 1 | Pi 扩展桥鉴权（nonce 轮换、端口预留） | 平台侧 | A3.11 设计时 | 随 A3.11 出方案 |
| 2 | 引擎进程复用策略 | 平台侧 | A3.10 之后，观察实际进程数 | 首版不做 |
| 3 | SQLite 驱动最终确认 | 平台侧 | A3.7（会话落库）之前 | 实测 `better-sqlite3` 与 `node:sqlite`，二选一 |
| 4 | 单机版备份与导出入口 | 客户端 | A6 | 随界面设计定入口 |
| 5 | APS 侧数据库选型 | APS 侧 | B2 | APS 自主决定，平台不干预 |
| 6 | 跨进程 Provider 启动条件 | 平台侧 | A8 或更晚 | 第三方接入或需独立发版时评估 |
| 7 | `legacy/main` 备份分支与只读设置 | 平台侧 | 切换前（A0.2 执行） | 强推覆盖 `main` 之前必须完成 |
| 8 | 是否另立仓库让体积归零 | 技术负责人 | 已决 | 不另立：孤儿历史不减体积可接受（ADR-0001 遗留） |
| 9 | 《实施设计》1.4 补 SQLite 路径与主键、时间约定 | 平台侧 | A0.10 | 随设计文档入库一起做 |

时限调整：#3 原定 A1.1，A1.1 只建骨架、未引入数据库，改到 A3.7 之前；#2 从"观察后评估"明确为 A3.10 之后。

## 3 门槛判定

| 通过标准 | 结论 | 说明 |
| --- | --- | --- |
| 七份 ADR 无异议，或异议已记录处置方式 | 通过 | 七份全部接受，无异议 |
| 遗留项每项有责任人与时限 | 通过 | 九项已认领，#8 当场关闭 |
| 通过后可直接进入 A0.10 与 A1 | 通过 | A1.1、A1.2 已完成并提交；A0.10 待做 |

## 4 后续

- **A0.10 入库范围**：两份设计文档（架构设计、实施设计）转入仓库 `docs/`，同时补《实施设计》1.4 的存储细节
- **A1 启动条件**：已满足。已完成 A1.1（monorepo 骨架）、A1.2（依赖方向检查接入 CI）。建议顺序：A1.7（协议与事件模型）→ A1.3（server 最小闭环）→ A1.4（client 最小界面）→ A1.5（一键启动）→ A1.6（补齐 lint 与测试矩阵）
- **需新增或调整的任务**：无（A2.6 能力描述规范、A2.7 问法评测集已在评审前按讨论补入 A2 阶段）