lixi
209021e7d2
- 新增 development/iterations/iteration-1/：15 份角色报告 + 进展看板（已完成/未闭环/下一步），作为双人协作的进度事实来源 - 新增 ADR-006：测试与交付容器化策略（Testcontainers / 交付 Docker 包 / 本机库仅个人联调） - Git 工作流规范补充：敏感信息只进忽略文件或 sample、测试数据不入库、测试代码限标准测试目录 - 门禁：mkdocs build --strict 通过（零警告）
3.3 KiB
3.3 KiB
第一迭代进展看板
目标：真实登录纵切（注册 → 登录 → 获取当前用户 → 退出），依据开发实施计划第 8 节。 更新日期：2026-09-04。本页是团队共享的进度事实来源，每波工作交付后更新。
当前状态一览
| 状态 | 内容 |
|---|---|
| ✅ 已完成 | 开工分析（报告 01-06）、工程基线（第一波）、持久化纵切（第二波）、Git 工作流建章 |
| 🔜 下一步 | 第三波：JWT + refresh 会话 → /internal 鉴权 → OpenAPI 冻结 → Flutter 登录页拼装 → 端到端用例 |
| ⚠️ 未闭环 | token 仍为随机串（表已就绪）、/internal 无鉴权、CI 载体缺失、UI 待修 FIX-1/FIX-2、Flutter README 门禁参数（m2） |
已完成（附提交）
第一波：工程基线
- 后端升级 Spring Boot 3.5.16 / JDK 17，移除 Nacos（ADR-001/002），common 瘦身，Maven Wrapper，测试 0 → 21（
patbond-api@c7ddaec，报告 07）。 - Flutter 迁移珊瑚橙主题（ADR-005），新增 5 个认证组件 + 6 个 widget 测试（
patbond-flutter@af002ed，报告 08）。 - ADR-001~005 入档（
patbond-doc@ca8cb72，见技术决策记录）。
第二波：持久化纵切
- Flyway V1 baseline（identity/media）、用户 UUIDv7 持久化到 PostgreSQL、统一异常与错误码透传（修复错误码折叠），测试 21 → 37，全部经 Testcontainers 验证（
patbond-api@bd20adc，报告 10）。 - 独立复核确认第一波声明属实（报告 11）；UI 设计 QA + 登录/注册/Splash 组装稿（报告 12）；埋点工程规范含 OpenAPI/DDL 草案（报告 13）；mkdocs 门禁打通（报告 14）。
- Git 工作流规范入档（
patbond-doc@027876a，见 Git 工作流规范），报告 15。
下一步（第三波，未启动）
- T4 JWT + refresh 会话：按 ADR-003（access 15 分钟 / refresh 30 天轮换 / 多设备），
identity.auth_sessions表已随 V1 就绪；同时保护/internal/**、整改expiresAt时区。 - T6a OpenAPI 冻结：错误码契约（报告 10）+ token 字段定型后出契约文档。
- Flutter 登录页拼装：照报告 12 组装稿实现，顺带修 FIX-1（促销卡渐变对比度）、FIX-2（helperStyle）、m2（README 门禁参数）；接入
--dart-define注入 API 地址。 - 端到端用例：注册 → 登录 → 获取当前用户 → 退出，进 CI。
启动条件已满足（持久化纵切完成 + 复核无否决）。
环境与构建（新成员必读）
- 后端构建：
JAVA_HOME=/usr/lib/jvm/java-17-openjdk ./mvnw clean test（本机默认 JDK 版本过高，必须显式指 17；需 Docker 供 Testcontainers 起 postgres:16）。 - Flutter 门禁：
dart format --output=none --set-exit-if-changed lib test/flutter analyze/flutter test。 - 文档门禁：
mkdocs build --strict。 - 测试数据库策略见 ADR-006：自动化测试一律 Testcontainers，个人手动联调用本机 PostgreSQL（环境变量注入连接信息）。
报告目录
01-06 为开工前六角色分析（任务分解/技术评估/现状核实/UI 规范/埋点规划/质量审计），07-08 第一波交付，09-15 第二波交付与复核。文件名编号即时间顺序，各报告首节均有摘要。