# 愈心谷（YuXinGu）

数字性格 × 中医体质。Monorepo：Go API + Vue3 H5，预留小程序。

## AI Engineering System（规范真相源）

本仓库是 **AI-first**：不用长篇《开发手册》当主约束，而用可执行的 **`.ai/`**：

```
.ai/
  ai-contract.md · constitution · architecture · domain
  file-map · workflow · forbidden · commands
  coding / api / database / ui / deployment / testing / security
  review · definition-of-done
  adr/  patterns/  examples/  playbooks/  checklists/
  prompts/   # 辅助，非核心
```

优先级：constitution → architecture → domain → patterns/examples/playbooks → review/DoD → prompts。  
Cursor 运行时：[.cursor/](.cursor/)（软链到 `.ai/`，不复制内容）。  
演进节奏：[.ai/ROADMAP.md](.ai/ROADMAP.md)（二/三阶段：anti-patterns、metrics、graph、mcp、skills…按需再加）。  
入口：[AGENTS.md](AGENTS.md) · [CLAUDE.md](CLAUDE.md) · [.ai/README.md](.ai/README.md)

产品文档（给人看）：[prd-mvp](apps/docs/prd-mvp.md) · [business-model](apps/docs/business-model.md)

## 快速开始

```bash
export GOPROXY=https://goproxy.cn,direct   # 若需要

docker compose -f deploy/docker-compose.yml up -d   # 可选
cd apps/api && go mod tidy && go run ./cmd/server
# → http://127.0.0.1:8080/api/v1/healthz

npm install && npm run dev:h5
# → http://127.0.0.1:5173
```

## 目录

| 路径 | 说明 |
|---|---|
| `.ai/` | AI 工程系统（必须遵守） |
| `apps/api` | Go 后端 |
| `apps/user-h5` | 用户 H5 |
| `apps/mini-program` | 小程序脚手架 |
| `packages/*` | sdk / types / utils / ui |
| 根目录 HTML / `server.py` | Legacy，见 [LEGACY.md](LEGACY.md) |