愈心谷（YuXinGu）

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

AI Engineering System

规范真源在 .ai/。入口：AGENTS.md。

环境分流（重要）：

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

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

快速开始（Local）

# 依赖（仅 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/	AI 工程系统
apps/api	Go 后端
apps/user-h5	用户 H5
packages/*	sdk / types / utils / ui
docker-compose.dev.yml	本地依赖服务
deploy/	部署与 env 模板
根目录 Legacy HTML	见 LEGACY.md

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