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

README.md

@@ -1,6 +1,10 @@
 # ios-client
 
-SwiftUI + MVVM 单向数据流的 iOS「打卡/习惯追踪」客户端，采用 SPM 多 target 模块化，架构对齐 Android NIA（`core/*` + `feature/*`）。
+SwiftUI + MVVM 单向数据流的 iOS「打卡/计划管理」客户端，采用 SPM 多 target 模块化，架构对齐 Android NIA（`core/*` + `feature/*`），功能对齐 `wechat-clock-mini`（小程序）与 `android-client`（Android 端）。
+
+## 功能
+
+四个主入口 Tab：**首页 / 打卡 / 计划 / 我的**，另有独立**登录页**（手机号 + 短信验证码）与**提交计划页**。当前数据层为 Fake 实现（进程内 mock），尚未接真实后端。
 
 ## 架构
 
@@ -10,7 +14,7 @@ App（组合根）──► feature/* ──► core/*
                  └──► CoreRepository ──► CoreNetwork / CoreDatabase / CoreDomain
 ```
 
-依赖单向无环，由 SPM target 依赖天然强制（import 不到即编不过）。
+依赖单向无环，由 SPM target 依赖天然强制（import 不到即编不过）。详见 [docs/architecture.md](docs/architecture.md)。
 
 ## 模块
 
@@ -22,10 +26,13 @@ App（组合根）──► feature/* ──► core/*
 | CoreRepository | Repository 实现（Fake / OfflineFirst）|
 | CoreNetwork | DTO + URLSession APIClient |
 | CoreDatabase | SwiftData（`@Model` + `ModelContainer`）|
-| DesignSystem | 设计 tokens（颜色/间距/圆角）|
+| DesignSystem | 设计 tokens（颜色/渐变/间距/圆角）|
 | CoreUI | 可复用 SwiftUI 组件 |
-| FeatureHome | 首页（打卡列表）|
-| FeatureAuth | 登录 / 我的（占位）|
+| FeatureHome | 首页（落地页：Hero + 模块卡 + 产品介绍）|
+| FeatureCheckin | 打卡（状态卡 + 状态 pill + 小组/个人记录）|
+| FeaturePlan | 计划（周/月/年 + 小组统计 + 提交计划页）|
+| FeatureProfile | 我的（资料 + 小组分组 + 退出登录）|
+| FeatureAuth | 登录（手机号 + 短信验证码）|
 | App | 组合根（DI + 导航）|
 
 ## 环境要求
@@ -48,9 +55,9 @@ brew install swiftlint   # 首次
 swiftlint lint
 ```
 
-## 目录与协作规范
+## 文档与协作规范
 
-见 [CLAUDE.md](CLAUDE.md) 与 [CONTRIBUTING.md](CONTRIBUTING.md)。
+见 [CLAUDE.md](CLAUDE.md)、[docs/architecture.md](docs/architecture.md)、[docs/progress.md](docs/progress.md) 与 [CONTRIBUTING.md](CONTRIBUTING.md)。
 
 ## License