docs: harness 工程文档

This commit is contained in:
AndyChen1024
2026-09-03 19:03:35 +08:00
parent 914daa19ac
commit 1b6f6d53ad
11 changed files with 388 additions and 0 deletions

35
docs/progress.md Normal file
View File

@@ -0,0 +1,35 @@
# 工作状态
> 本文件是跨会话的工作状态快照。变更后请更新。
## 当前状态
- ✅ 基础建设:多模块骨架(9 core + 7 feature + app)、约定插件(`mcl.*`)、版本目录、`verifyArchitecture`、Spotless/Lint、验证脚本、CI、文档、DESIGN_NOTES。
- ✅ 验证通过:`./gradlew :app:assembleDebug`、`test`/`testDebugUnitTest`、`verifyArchitecture` 全绿。
- ⬜ 各 feature 为占位屏(`<Feature>Screen` + 空 `<Feature>ViewModel`),无业务逻辑。
## 已完成
- [x] build-logic 约定插件 + 版本目录 + 根配置
- [x] 17 个模块骨架 + app 组合根(Hilt + Navigation)
- [x] 主题迁入 `core:designsystem`(`MingyuanTheme`)
- [x] `verifyArchitecture` 架构检查任务
- [x] AGENTS.md / README / docs/* / DESIGN_NOTES
- [x] scripts/verify.sh + CI workflow
## 已阻塞
- 无。
## 下一步计划
1. 接入真实后端:`core:network` 定义 Retrofit API + DTO(对应 wechat-backend 的 `/api/v1/*`),`core:data` 实现 Repository,`app` 补齐 DI 聚合。
2. `core:database`/`core:datastore` 落地本地存储 schema。
3. 逐个 feature 实现业务逻辑(checkin/plan/course/survey/feedback/profile/auth)。
4. 发布前:签名 + R8 混淆 + 图标/品牌。
## 遗留项(暂缓)
- Roborazzi 截图测试、WorkManager、Gradle Managed Devices —— 有真实 UI/后台任务时再接入。
- `docs/api.md`、`docs/data-model.md` —— 后端接线时再建。
- app 尚未直接依赖 `core:network`/`core:database`/`core:datastore`;接入 DI 时补上(已在 `verifyArchitecture` allow-list 中放行)。