docs: M2 开工前分析 10 份报告入档 + ADR-009~015 拍板决策

- iteration-2 报告 01-08（PM 拆解/后端/Flutter 评估/现实核查/UI 规范/埋点规划/证据基线/Git 规划），04、06 已由正式角色复核定稿
- mkdocs 挂「第二迭代」导航，build --strict 通过
- ADR-009 新建 patbond-pet 模块、ADR-010 照片剪出 M2、ADR-011 dev 主干/master 发布、ADR-012 北极星与 H1-H4、ADR-013 废弃 health_record_action、ADR-014 DEBT-1 随 M2、ADR-015 照护人邀请后置

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

docs/architecture/decisions.md

@@ -98,3 +98,47 @@
 **验证**：切换当日 `./mvnw clean test` 全量 37 测试在 postgres:18（18.6）容器上通过，Flyway V1 baseline 迁移执行无兼容问题。
 
 **影响**：后续大版本变更须以新 ADR 决策并附全量测试验证；数据库特性使用以 18 为可用上限参考。
+
+## ADR-009 M2 宠物健康档案新建 patbond-pet 模块
+
+**决策**（2026-09-07）：宠物与健康档案域在 `patbond-api` 内新建独立 Maven 模块 `patbond-pet` 承载，不并入 `patbond-user`。
+
+**背景**：开工评估中 PM（iteration-2/01）建议新建模块，后端评估（iteration-2/02）建议 user 内独立包。用户裁定采用新建模块方案，为后续微服务化（ADR-002 预留方向）保持模块边界清晰。
+
+## ADR-010 照片/附件剪出 M2
+
+**决策**（2026-09-07）：宠物头像上传、疫苗证书与健康事件附件等 media 能力不进入 M2。头像 M2 阶段使用占位/预设方案。
+
+**理由**：对象存储供应商未定（第一迭代 D4 遗留）；后端 media 仅有表结构、上传流程零代码（iteration-2/02 评估）。待对象存储选型拍板后另立迭代实现。
+
+## ADR-011 分支策略：dev 为日常主干，master 为发布分支
+
+**决策**（2026-09-07）：
+
+- 日常开发一律只推 `dev` 分支。
+- `master` 保留作为发布分支：正式版本发布时由 `dev` 合并至 `master`。
+- 契约先行提交顺序沿用 iteration-2/08 规范：doc（openapi 独立提交）→ api → flutter；波次收尾三仓 commit + push + CI 绿才算闭环。
+
+**备注**：iteration-2/08 建议的「Flyway 迁移、契约破坏性变更、依赖升级、两人并行期四类改动走短命分支 + PR 合入 dev」与本决策兼容，作为推荐实践保留，PR 目标分支为 `dev`。
+
+## ADR-012 M2 北极星指标与产品假设
+
+**决策**（2026-09-07）：采纳 iteration-2/06 定稿：
+
+- 北极星 = **7 日回访记录率**（分母：当 ISO 周产生生命周期首条 `health_record_create_succeeded` 的去重用户；分子：其中在首记日之后第 1–7 个 UTC 自然日内再次创建成功者；不含首记当日；首记日 +8 天出数）。
+- 产品假设 H1–H4 及其判定阈值按 06 号报告冻结，上线前不再调整判定线。
+- M2 不启动 A/B；按 06 号报告 8 项前置条件推进，目标 M3 末全绿、M4 首实验。
+
+## ADR-013 废弃 health_record_action 保留位
+
+**决策**（2026-09-07）：从后端 EventDictionary 白名单直接移除 `health_record_action`（客户端零引用，废弃零成本）。M2 事件按字典 v2（iteration-2/06）以具体事件落地。
+
+**备注**：后续如出现新埋点需求，按 v1「结果编码进事件名」惯例新增具体事件，不复活通用 actionType 设计（多套指标共享分母、枚举扩充相互污染）。
+
+## ADR-014 设计债 DEBT-1 随 M2 偿还
+
+**决策**（2026-09-07）：TagPill 文字对比债（DEBT-1）随 M2 偿还，采用 iteration-2/05 的深变体映射方案（一行映射表 + 可选 `inkColor` 参数，既有调用零参数回归）。DEBT-2（muted 次级文字对比不足）M2 内按 05 号报告以既有正典色 `inkSoft` 局部规避，全局翻修另立决策。
+
+## ADR-015 照护人邀请流程后置出 M2
+
+**决策**（2026-09-07）：owner/caregiver/viewer 权限模型与校验进入 M2，但照护人邀请/绑定流程后置到后续迭代；M2 权限校验以测试数据覆盖三角色场景验证。