lixi
fcac68daf2
CI / docs-build (push) Successful in 51s
- 28 E2E 烟囱：11/11 场景全绿、契约偏差 0、四条验收标准全过（真机两项方案 A 挂起） - 29 收官总结：终态对照开工基线（测试 82/34→191/272、契约 5→18 路径冻结、 ADR 001~015、生产埋点从零到贯通）、遗留清单与 M3 方向输入 - 看板终态更新 Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
58 lines
4.3 KiB
Markdown
58 lines
4.3 KiB
Markdown
# 第二迭代进展看板
|
||
|
||
> 目标：M2 宠物健康档案——宠物 CRUD + owner/caregiver/viewer 权限 + 体重/疫苗/健康事件/提醒 + 档案聚合，Flutter 档案页全量替换 demo 数据，依据[开发实施计划](../../development-plan.md)第 7 节。
|
||
> 更新日期：2026-09-08（**M2 收官，验收 PASSED**）。本页是团队共享的进度事实来源。
|
||
|
||
## 当前状态一览
|
||
|
||
| 状态 | 内容 |
|
||
| --- | --- |
|
||
| ✅ 第一波 | M1 遗留埋点清偿（接线/SessionTracker/page_viewed/持久化队列前置）+ 契约补录 events + Flyway V3/V4 + patbond-pet 骨架 |
|
||
| ✅ 第二波 | 后端接口纵切 T2-03~08（pets 域 18 操作）+ 契约冻结 v1.2.0 + 契约一致性测试入 CI |
|
||
| ✅ 第三波 | Flutter 页面接入 T2-11~14（档案 demo 数据消亡、四态齐备）+ 埋点字典 v2 端到端 + DEBT-1 偿还 |
|
||
| ✅ 第四波 | E2E 烟囱 11/11 全绿、契约偏差 0、M2 四条验收标准全过（报告 28）；收官总结见报告 29 |
|
||
| ⚠️ 遗留 | 真机补验（Android 事件落库 + SessionTracker 30min，方案 A 挂起）；T2-12 §8 三项交互待拍板；auth 域契约测试；埋点队列完善——完整清单见报告 29 §4 |
|
||
|
||
## 测试与契约演进
|
||
|
||
| 时点 | patbond-api | patbond-flutter | openapi.yaml |
|
||
| --- | --- | --- | --- |
|
||
| M2 开工基线 | 82 | 34 | v1.0.0（5 路径） |
|
||
| 第一波收口 | 95 | 51 | v1.1.0（+events） |
|
||
| 第二波收口 | 182 | 64 | **v1.2.0 冻结**（18 路径/24 操作/45 schema） |
|
||
| 第三波收口 | 191 | 272 | v1.2.0（契约测试锁定零漂移） |
|
||
| **收官（E2E 后）** | **191** | **272**（+E2E 烟囱脚本） | v1.2.0（E2E 逐场景核验偏差 0） |
|
||
|
||
## 已完成（附提交）
|
||
|
||
**开工分析（报告 01~08）**：八角色并行评估，Reality Checker 裁定 CONDITIONAL PASS（5 项放行条件），ADR-009~015 拍板入档（`patbond-doc@1891d9b`）。
|
||
|
||
**第一波：埋点修复 + 后端地基（报告 09~12）**
|
||
|
||
- 契约补录 `POST /api/v1/events`（v1.1.0，`patbond-doc@2ceab6b`，关闭 D-1）。
|
||
- Flutter 埋点链修复：生产接线、eventId v7、SessionTracker、page_viewed、events 端口纠正（8082）、离开前台冲刷、毒丸批次防护，34→51 测试（`patbond-flutter@1afec6a`）；桌面端全链路实测打通——生产事件流自 M1 以来首次非零。
|
||
- Flyway V3 pet_health 8 表（4 条跨 schema FK 剥离标注 M5 补回）+ V4 字典种子（28 品种/10 疫苗）+ patbond-pet 模块骨架（ADR-009）+ health_record_action 移除（ADR-013），82→95 测试（`patbond-api@58576f8`）。
|
||
- E2E 脚本 7/7 回归通过；注册页 +86 前缀体验修复。真机验证按方案 A 挂起不阻塞。
|
||
|
||
**第二波：后端纵切 + 契约冻结（报告 13~21）**
|
||
|
||
- T2-03 宠物 CRUD + `PetAccessService` 三档权限闸口 + 防枚举 404（`patbond-api@8fbf444`）。
|
||
- T2-04~07 体重/疫苗/健康事件/提醒接口：cursor 分页正典、疫苗状态机 + 剂次唯一、幂等键派生主键、六类事件 + 四类提醒、新错误码 40903/40904/42201/42202（`825dde3`→`3b27f9f`）。
|
||
- T2-08 摘要四聚合口径定型（tz 参数）（`00f7dbd`）。
|
||
- T2-09 契约冻结 v1.2.0（草案 22 项修正全有实现依据，`patbond-doc@511617b`）+ 契约一致性测试（字节级快照 + mutation 自证，抓修 1 项漂移，`patbond-api@d026f2f`）。
|
||
- 并行：埋点持久化队列（分段 at-least-once，51→64 测试，`patbond-flutter@33b993c`）。
|
||
|
||
**第三波：Flutter 页面接入（报告 22~27）**
|
||
|
||
- T2-11 pets 数据层：契约 18 操作全覆盖 + 8 错误码类型化（`patbond-flutter@7fb9031`）。
|
||
- T2-12 宠物列表/详情/表单：四态齐备、40902 自动重提、DEBT-1 偿还、pet 域埋点（`97a1f46`）。
|
||
- T2-13 体重/疫苗模块 + summary 接数替换 demo；跨设备验收实测通过（`c91f18a`）。
|
||
- T2-14 时间线/提醒页 + 月度花费 tz + T2-13 遗留全消化（`ba50332`）。
|
||
- 埋点白名单 v2 +10 事件（`patbond-api@64c9b72`）；三次 compose 实测均无契约偏差。
|
||
|
||
## 相关文档
|
||
|
||
- [后端模块结构与职责](../../../architecture/backend-modules.md)（M2 起新增的权威速览）
|
||
- [技术决策记录](../../../architecture/decisions.md)（ADR-009~015 为 M2 决策）
|
||
- 契约：`docs/api/openapi.yaml` v1.2.0（冻结纪律见报告 19）
|