docs: 更新项目文档与架构说明

docs/progress.md

@@ -0,0 +1,31 @@
+# 工作状态
+
+> 跨会话状态快照，变更后请更新。
+
+## 当前状态
+
+- ✅ 四主入口 Tab（首页 / 打卡 / 计划 / 我的）+ 登录页 + 提交计划页，全部 SwiftUI 实现。
+- ✅ 数据层为 Fake 实现（进程内 mock），对齐 android-client 的简化形态。
+- ✅ 登录态驱动：`SessionRepository`（Combine `CurrentValueSubject`）+ 各页 `loggedOut` 态。
+- ✅ `swift build` 与模拟器 `xcodebuild` 均通过。
+
+## 已完成
+
+- [x] CoreModel 领域模型（Home / Checkin / Plan / Profile / Auth-Session）
+- [x] CoreDomain Repository 协议 + UseCase（Home / Checkin / Plan / Profile / Session）
+- [x] CoreRepository Fake 实现（含可提交的 checkin / plan、会话）
+- [x] FeatureHome（落地页）/ FeatureCheckin / FeaturePlan（+提交页）/ FeatureProfile / FeatureAuth
+- [x] DesignSystem 品牌 tokens；AppContainer DI + AppRootView 导航（Tab + sheet 登录 + 推入提交页）
+
+## 下一步
+
+1. 接入真实后端：CoreNetwork 定义 API + DTO（对应 wechat-backend `/api/v1/*`），CoreRepository 替换为 OfflineFirst。
+2. CoreDatabase 落地 SwiftData schema（打卡 / 计划 / 用户）。
+3. 真实图片上传（计划附件、头像）与隐私协议跳转页。
+4. 单元测试（ViewModel / UseCase / Fake 仓库）。
+
+## 遗留项（暂缓）
+
+- 计划附件上传、头像上传仍是占位（与 android 一致）。
+- `webview`（H5）能力未引入，首页为纯原生落地页。
+- 未跑 `swiftlint`（本机未安装）。