34 lines
1.0 KiB
Markdown
34 lines
1.0 KiB
Markdown
 
|
# 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 需要被多个产品复用，再考虑拆出独立仓库
|