# ADR 0001: Monorepo + Go API + Vue H5

## 状态

已采纳（2026-08-02）

## 背景

愈心谷需从静态 HTML 原型演进为可多端扩展的产品，并引入 AI 辅助开发；需统一规范与清晰边界。

## 决策

- 采用 npm workspaces Monorepo（`apps/*` + `packages/*`）。
- 后端唯一实现：Go（gin）于 `apps/api`。
- 当前主客户端：Vue3 + TS H5（`apps/user-h5`）；小程序仅脚手架。
- 多端网络层：`packages/sdk` 适配器模式。
- Git：Trunk-Based + Conventional Commits。

## 后果

- 新功能不得继续堆在根目录 legacy HTML。
- 共享类型与 SDK 降低后续小程序迁移成本。
- 需维护 workspace 与 Go module 两套依赖工具链。