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,27 @@
# ADR-002 PWA 优先验证市场,再做 Capacitor 原生打包
**状态:** 已采纳 ✅
**日期:** 2026-05-24
---
## 背景
App 需要在手机上使用,面临两个选择:直接打包成原生 App,或先做 PWA 验证需求。
## 决策
**Phase 2 先做 PWA**,让用户在手机浏览器「添加到主屏幕」使用。确认产品有市场价值后,**Phase 3 再用 Capacitor 打包** Android APK / iOS IPA。
## 原因
- PWA 只需加 `manifest.json` + Service Worker,改动极小
- Capacitor 打包需要引入 Vite、替换存储方案、配置 Android Studio / Xcode,成本高
- 先用 PWA 以最低成本验证:用户留存率、复盘频率、AI 功能使用率
- 验证有价值后再投入打包成本,避免过早优化
## 影响
- Artifact Storage API 是 Claude 平台专属,PWA 独立部署后需替换为 localStorage
- iOS Safari 对 PWA 支持有限,是已知限制,PWA 阶段接受
- Capacitor 打包触发条件:Phase 2 验证指标达标