# 愈心谷（YuXinGu）

个人成长平台 · Monorepo：Go API + Vue3 H5（预留小程序）。

## AI Engineering System

规范真源在 [`.ai/`](.ai/)。入口：[AGENTS.md](AGENTS.md)。

**环境分流（重要）：**

| 文档 | 用途 |
|---|---|
| [.ai/environment.md](.ai/environment.md) | Local / CI / Prod 总原则 |
| [.ai/development.md](.ai/development.md) | 本地：本机 Go + Vite |
| [.ai/docker.md](.ai/docker.md) | Docker：依赖服务 + 部署，非日常写代码 |
| [.ai/deployment.md](.ai/deployment.md) | 生产：不可变镜像 |

本地追求**分钟级反馈**；生产追求**环境一致**。二者禁止混用。

## 快速开始（Local）

```bash
# 依赖（仅 Postgres）
docker compose -f docker-compose.dev.yml up -d

# API — 本机
export GOPROXY=https://goproxy.cn,direct   # 如需要
cd apps/api && go run ./cmd/server
# → http://127.0.0.1:8080/api/v1/healthz

# H5 — 本机（另开终端）
npm install && npm run dev:h5
# → http://127.0.0.1:5173
```

不要用 `docker build` 跑日常 Go/Vue 开发。命令详表：[.ai/commands.md](.ai/commands.md)。

## 目录

| 路径 | 说明 |
|---|---|
| `.ai/` | AI 工程系统 |
| `apps/api` | Go 后端 |
| `apps/user-h5` | 用户 H5 |
| `packages/*` | sdk / types / utils / ui |
| `docker-compose.dev.yml` | 本地依赖服务 |
| `deploy/` | 部署与 env 模板 |
| 根目录 Legacy HTML | 见 [LEGACY.md](LEGACY.md) |

产品文档：[apps/docs](apps/docs/) · 语言契约：[.ai/product/lexicon.md](.ai/product/lexicon.md)