chore: 初始化仓库结构

- 建立 monorepo 结构:app/ + server/ + docs/
- 纳入全部需求/架构/开发计划文档
- 新增 docs/PROGRESS.md 功能状态总览
- 新增 docs/decisions/ ADR 决策记录(001-004)
- 新增根目录 README.md 含 AI 阅读指引
- 新增 .gitignore

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
2026-05-24 16:39:16 +08:00
co-authored by Claude Sonnet 4.6
commit a1561c7d43
17 changed files with 1093 additions and 0 deletions
@@ -0,0 +1,137 @@
# 🔍 需求分析 — 功能优先级与边界
> 来源:[Notion 原始文档](https://www.notion.so/36a401dc38a681d08067c046a637acdd)
## 目标用户
| 阶段 | 用户 | 说明 |
|------|------|------|
| 前期(当前) | 产品作者本人 | 自用,快速验证功能价值 |
| 中期 | 早期外部用户 | PWA 上线后逐步开放 |
| 后期 | 付费会员 | 账号体系稳定后商业化 |
---
## 功能优先级矩阵
| 功能 | 用户价值 | 实现难度 | 优先级 |
|------|---------|---------|-------|
| 目标树管理(增删改查) | 极高 | 中 | P0 - MVP |
| 每日评分 + 感受记录 | 极高 | 低 | P0 - MVP |
| AI 教练点评 | 高 | 中 | P0 - MVP |
| AI 对话教练 | 高 | 中 | P0 - MVP |
| 历史复盘与趋势图 | 高 | 中 | P0 - MVP |
| 漏打卡容错(历史空白不报错) | 高 | 低 | P0 - MVP |
| **每周复盘** | 高 | 中 | P1 |
| 跨设备数据同步 | 高 | 高 | P4(账号体系阶段) |
| 目标完成进度 checkbox | 中 | 低 | P1 |
| 目标提醒通知 | 中 | 高 | P2 |
| 目标树导出分享 | 中 | 中 | P2 |
| **初始化模版**(通用模版 + 人生方向模版) | 高 | 低 | P2(PWA 上线时) |
| 精品付费模版库 | 中 | 低 | P5(会员阶段) |
| 拖拽排序 | 低 | 高 | P6 |
---
## MVP 范围确认(P0)
### 模块一:目标树管理
**目标:** 用户能够建立和维护自己的人生目标树
**功能明细:**
- 支持 5 个层级:人生 / 年度 / 月度 / 周 / 日
- 点击文字内联编辑
- 点击 + 按钮添加子目标(自动分配下一层级)
- 点击 ✕ 删除节点(包括子树)
- 展开 / 折叠子树
- 层级配色区分:金色→橙色→蓝色→绿色→紫色
**验收标准:**
- 用户能在 3 分钟内建立一棵包含 5+ 节点的目标树
- 数据刷新后仍然保持
### 模块二:每日复盘
**目标:** 用户每晚进行目标对齐度复盘,记录感受与总结
**功能明细:**
- 1-10 分评分环(可视化进度环)
- 自由文字输入框:记录当天感受、总结、偏离情况
- 提交后 AI 自动读取目标树 + 近期复盘记录 → 生成点评和纠偏建议
- 每天只能提交一次(已提交状态展示)
- 历史复盘列表(近 14 天)
- **漏打卡容错:** 某天无记录显示为空白,不报错、不惩罚,不影响其他日期
**验收标准:**
- 提交后 3 秒内返回 AI 点评
- 评分 ≤4 显示红色,5-7 黄色,≥8 绿色
- 连续漏记 2 天后,下次打开时 AI 主动提示
### 模块三:每周复盘(Phase 1)
**目标:** 用户每周做一次整体回顾,发现规律、纠正偏离
**功能明细:**
- 显示本周每日评分趋势柱状图
- 汇总本周感受和总结关键词
- 提交本周总体反思文字
- AI 基于本周数据生成:偏离模式分析 + 下周调整建议
**验收标准:**
- 每周日(或用户手动触发)可进行周复盘
- AI 周报建议与每日点评在语气和内容上有明显区别(宏观 vs 微观)
### 模块五:初始化模版(Phase 2)
**目标:** 外部用户首次使用时快速搭建目标树,降低启动门槛
**触发时机:** 首次打开 App 且目标树为空时,进入模版选择页
**模版类型:**
| 模版 | 预填重点 | 适合人群 |
|------|---------|---------|
| 🗂️ 通用模版 | 纯结构 + 占位符,用户自填内容 | 所有人,默认推荐 |
| 🚀 职业发展 | 职位目标、技能成长、收入提升 | 上班族、想晋升/转型者 |
| 💼 创业/副业 | 产品目标、用户规模、收入里程碑 | 创业者、斜杠青年 |
| 📚 学习提升 | 技能掌握、证书考取、输出成果 | 学生、自学者 |
| 💪 健康生活 | 运动习惯、饮食、睡眠、心理状态 | 关注身心健康者 |
| 👨‍👩‍👧 家庭生活 | 家庭关系、子女教育、家庭财务 | 已婚有子女者 |
| 🌱 自由探索 | 最轻结构,留白最多 | 目标还不清晰者 |
**初始化流程:**
```
首次打开(目标树为空)
↓
欢迎页:选择启动方式
├── 从模版开始 → 选择模版 → 预览内容 → 一键载入 → 进入编辑
└── 空白开始 → 直接进入空目标树
```
**验收标准:**
- 用户从选择模版到完成初始化不超过 1 分钟
- 载入模版后可自由编辑所有内容,模版只是起点
> 💡 **付费扩展:** Phase 5 会员阶段提供精品行业模版库(更细分、更专业的模版),作为付费内容之一。
### 模块四:AI 对话教练
**目标:** 用户能随时与 AI 就目标进行对话
**功能明细:**
- AI 上下文包含:完整目标树 + 近 7 天复盘记录 + 最近一次周复盘
- 支持任务:拆解目标、分析冲突、预测偏离风险
- 对话历史在单次会话内保持
---
## 不在范围内(MVP)
- 多用户 / 团队功能
- 账号体系(MVP 阶段免登录,Phase 4+ 引入)
- 外部日历同步
- 目标分享 / 导出
- 移动端原生 App(Phase 3 Capacitor 阶段)
- 每周复盘模块(Phase 1 引入,MVP 仅做每日)
- 初始化模版(Phase 2 PWA 上线时引入,自用阶段无需)