docs(migration): record stage 2 acceptance evidence

2026-07-30 01:02:40 +08:00
parent d969d2c092
commit 2ff35eb6df
1 changed files with 7 additions and 2 deletions
@@ -112,7 +112,7 @@ HTTP/后台任务 -> 业务服务 -> Repository/DataGateway/LLMGateway -> 基础
 |---:|---|---|---|
 | 0 | 产品规格、迁移章程、旧系统只读基线 | 文档检查、Git节点 | 已完成 |
 | 1 | `next/`最小可运行骨架与工具链 | 前后端启动、健康检查、基础测试 | 已完成 |
-| 2 | 配置、错误、日志、数据库迁移、Repository基础 | 迁移回退和错误契约测试 | 未开始 |
+| 2 | 配置、错误、日志、数据库迁移、Repository基础 | 迁移回退和错误契约测试 | 已完成 |
 | 3 | 账户、会话、权限、会员和系统配置 | 权限矩阵与跨账号测试 | 未开始 |
 | 4 | 前端Shell、路由、状态、API、弹窗、主题和令牌 | 1080P/4K/390px Shell截图 | 未开始 |
 | 5 | 数据网关、日期、快照、图表和搜索 | 来源/时间/缺失/降级测试 | 未开始 |
@@ -182,5 +182,10 @@ HTTP/后台任务 -> 业务服务 -> Repository/DataGateway/LLMGateway -> 基础
 - 前端门禁：类型检查通过，Vitest为1个文件/2项通过，Vite生产构建通过；依赖安装审计为0个已知漏洞。
 - 运行验收：`8780/api/health`返回开发环境健康状态，`5173`代理访问成功；1280x720浏览器实测无控制台错误、无横向溢出。
 - 减法证据：删除未使用的`jsdom`及37个传递依赖；禁止TypeScript生成重复JavaScript测试产物；未复制旧`server.py`、`app.js`或CSS覆盖层。
- 新系统已进入阶段2，旧系统保持原状，生产容器未切换。
+- 阶段2已完成，代码提交为`d969d2c`：配置从环境唯一加载，SQLite连接启用WAL/外键/忙等待，迁移支持前进、显式回退、原子失败、校验和和连续历史校验。
+- Repository基础只建立被健康检查真实使用的数据库状态Repository，未创建通用CRUD或空业务目录；数据库维护CLI支持状态、升级及需二次确认的回退。
+- HTTP错误统一为`code/message/request_id`，404、验证错误、业务错误和未知异常均通过安全契约；请求编号同时写入响应头，未知异常不向前端泄露原文。
+- 日志采用结构化JSON、`Asia/Shanghai`时间、10MB/3份轮转和嵌套/字符串敏感值脱敏；运行健康检查可区分进程和数据库状态。
+- 阶段2门禁：Ruff通过，pytest为20项通过，前端2项测试、类型检查和生产构建通过；真实服务健康响应、请求编号及`+08:00`启动日志通过运行验收。
+- 新系统已进入阶段3，阶段2未建立任何业务表；账户相关表只在阶段3随真实功能切片建立。
 - 生产切换明确保留为最终人工确认项。