Files
life_goals/docs/decisions/001-monorepo单仓库结构.md
T
adminandClaude Sonnet 4.6 a1561c7d43 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>
2026-05-24 16:39:16 +08:00

1.0 KiB
Raw Blame History

ADR-001 采用 Monorepo 单仓库管理 app / server / docs

状态: 已采纳 ✅
日期: 2026-05-24


背景

项目包含前端(app)、后端(server,Phase 4 启动)、文档(docs)三部分,需要决定是用一个 git 仓库还是多个仓库管理。

决策

所有代码和文档放在同一个 git 仓库,采用 monorepo 结构:

life_goals/
├── app/
├── server/
└── docs/

原因

  • 小团队 / 个人项目:管理一个仓库比同步多个仓库负担小得多
  • 前后端强耦合:同一个功能(如账号体系)需要同时改 app 和 server,monorepo 可以一个 commit 完成
  • AI 协作友好:AI 在同一仓库内能同时看到代码和文档,理解更准确
  • 文档即代码:需求变更和代码变更在同一条时间线,不会出现文档滞后

影响

  • server/ 目前为占位目录,Phase 4 再填充内容
  • 如未来 server 需要被多个产品复用,再考虑拆出独立仓库