# 第一迭代进展看板

> 目标：真实登录纵切（注册 → 登录 → 获取当前用户 → 退出），依据[开发实施计划](../../development-plan.md)第 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`，见[技术决策记录](../../../architecture/decisions.md)）。

**第二波：持久化纵切**

- 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 工作流规范](../../git-workflow.md)），报告 15。

## 下一步（第三波，未启动）

1. **T4 JWT + refresh 会话**：按 ADR-003（access 15 分钟 / refresh 30 天轮换 / 多设备），`identity.auth_sessions` 表已随 V1 就绪；同时保护 `/internal/**`、整改 `expiresAt` 时区。
2. **T6a OpenAPI 冻结**：错误码契约（报告 10）+ token 字段定型后出契约文档。
3. **Flutter 登录页拼装**：照报告 12 组装稿实现，顺带修 FIX-1（促销卡渐变对比度）、FIX-2（helperStyle）、m2（README 门禁参数）；接入 `--dart-define` 注入 API 地址。
4. **端到端用例**：注册 → 登录 → 获取当前用户 → 退出，进 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 第二波交付与复核。文件名编号即时间顺序，各报告首节均有摘要。