39 lines
2.4 KiB
Markdown
39 lines
2.4 KiB
Markdown
# A1–A2 串行实施计划（全自动执行）
|
||
|
||
> 由技术负责人指定：串行推进、自动完成。每步都必须带可验证证据，做完即提交。
|
||
|
||
## 前置状态
|
||
|
||
| 项 | 状态 |
|
||
| --- | --- |
|
||
| A0 | 已完成：7 份 ADR（含 0008/0009/0010）、术语表、资产盘点 26 条、评审结论、两份设计文档入库 |
|
||
| A1 | 5/8：A1.1 骨架、A1.2 依赖方向检查、A1.3 server 最小闭环、A1.7 协议、A1.8 HTTP 契约 |
|
||
| 测试 | 21 条：契约 7 + 依赖方向 8 + 服务端冒烟 6（`pnpm test`） |
|
||
|
||
## 步骤
|
||
|
||
| # | 任务 | 做什么 | 验收证据 |
|
||
| --- | --- | --- | --- |
|
||
| 1 | B0 前置 | `aps/` 目录 + ADR-0010（开发期同仓形态）+ 边界规则 | ADR 提交、目录说明 |
|
||
| 2 | A1.6 CI 基线 | eslint + prettier 基线、跨库访问检查、能力描述检查、APS/平台 CI 分流 | 本地 `pnpm lint` 通过；CI 工作流含全部检查 |
|
||
| 3 | A1.4 client 最小界面 | Vite + React 三栏骨架：左会话列表、中对话流（SSE）、右工作区占位；连接状态；用协议 v1 类型 | `pnpm --filter @aps/client-app build` 通过；服务端托管构建产物后能打开 |
|
||
| 4 | A1.5 一键启动 | `pnpm dev` 同时起服务端与前端；`pnpm start` 构建后单端口托管 | 实测两条命令可用；文档写清前置条件 |
|
||
| 5 | A2.1 Provider SDK | manifest / execute / status 接口 + 能力分级 + 错误分类 | 类型编译 + 契约测试 |
|
||
| 6 | A2.2 Core.invoke | 最小执行入口：幂等键、超时、执行记录、回执 | 单测：幂等重放、超时未知、错误分类 |
|
||
| 7 | A2.3/A2.4 | 内存假 Provider + 契约测试套件 | 契约套件对假 Provider 全绿 |
|
||
| 8 | A2.7 | 问法评测集跑通（假引擎） | 六项指标输出并记录 |
|
||
|
||
## 纪律
|
||
|
||
1. 每步一个提交，提交信息写清任务号与证据
|
||
2. `contracts/` 单点负责：本计划期间由主线改
|
||
3. 每个新规则都要有会真失败的用例（依赖方向、契约漂移都已是这个标准）
|
||
4. 做完一步就更新任务表，不攒到最后
|
||
|
||
## 风险
|
||
|
||
| 风险 | 应对 |
|
||
| --- | --- |
|
||
| 前端引入 React/Vite 后 CI 变慢 | 只在 client 相关 job 跑构建；其余 job 不受影响 |
|
||
| eslint 首次接入报大量历史问题 | 当前代码是新的，问题量小；真有问题分文件修，不整体关闭规则 |
|
||
| A2.2 与 A3.1 的接口边界重叠 | A2.2 只做 `Core.invoke` 与执行记录；引擎接口归 A3.1，二者不互相引用 | |