lixi
23ce404548
CI / docs-build (push) Successful in 57s
- iteration-2/index.md 进展看板：三波交付纪年、测试与契约演进表、遗留清单 - feature-checklist 去掉「第一迭代」限定，新增第 7~9 节（宠物域后端 13 条/ 客户端 10 条/埋点体系 7 条），状态以 dev + 门禁全绿为准 - 待 E2E 收官后补：T2-18 证据归档与 M2 收官总结报告 Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
57 lines
4.2 KiB
Markdown
57 lines
4.2 KiB
Markdown
# 第二迭代进展看板
|
||
|
||
> 目标：M2 宠物健康档案——宠物 CRUD + owner/caregiver/viewer 权限 + 体重/疫苗/健康事件/提醒 + 档案聚合，Flutter 档案页全量替换 demo 数据，依据[开发实施计划](../../development-plan.md)第 7 节。
|
||
> 更新日期：2026-09-08（第三波收口，待第四波 E2E 收官）。本页是团队共享的进度事实来源，每波工作交付后更新。
|
||
|
||
## 当前状态一览
|
||
|
||
| 状态 | 内容 |
|
||
| --- | --- |
|
||
| ✅ 第一波 | 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 偿还 |
|
||
| 🔜 第四波 | T2-18 E2E 烟囱收官战（需真机/联调配合）→ T2-19 收官总结 |
|
||
| ⚠️ 遗留 | 真机补验（Android 事件落库 + SessionTracker 30min，第一波方案 A 挂起）；T2-12 §8 三项交互待拍板；auth 域契约测试；埋点队列完善（30s 定时冲刷/退避/anonymousId 持久化） |
|
||
|
||
## 测试与契约演进
|
||
|
||
| 时点 | 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（契约测试锁定零漂移） |
|
||
|
||
## 已完成（附提交）
|
||
|
||
**开工分析（报告 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）
|