refactor(ECR-001): 接入 ESS 并完成结构对齐 Phase A–E

绑定 ESS 双轨治理,拆分超大 H5 页与 Go 引擎,抽出 membership 服务,
并将 star/fortune 重命名为 outlook(JSON 双写兼容);同时修复 /psy API 代理与首页 + 菜单层级。

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
jackyu66git
2026-08-05 17:51:40 +08:00
co-authored by Cursor
parent 583133dd09
commit 19d3cd5945
75 changed files with 4199 additions and 2505 deletions
+60
View File
@@ -0,0 +1,60 @@
# Project Profile — 愈心谷 (YuXinGu)
> Agent **第一次**读这个文件。不要重新猜技术栈;偏离见 Forbidden + ADR。
> 产品/领域/完成标准权威仍在 `.ai/`;本文件只锁定栈与 ESS 流程入口。
## Type
`saas-web` + AI Agent(心理洞察 / 画像 / 关系 / 问答陪伴)
## Dual-track governance
| Layer | Authority | Path |
|-------|-----------|------|
| Product · Domain · Lexicon · Feature Spec · DoD | **`.ai/`** | `.ai/product/` · `.ai/domain.md` · `.ai/definition-of-done.md` |
| Architecture · Forbidden · ADR | **`.ai/`** | `.ai/architecture.md` · `.ai/forbidden.md` · `.ai/adr/` |
| Change process · ECR · Task · Handoff · Roles | **ESS** | `docs/ECR/` · `docs/TASKS/` · `docs/HANDOFF/` · `docs/STATE/` |
| Stack lock (mirror) | ESS + `.ai/` | 本文 + `.ai/tech-stack.md` |
冲突时:领域与完成标准以 `.ai/` 为准;变更分级与角色门禁以 ESS 为准。
## Stack Lock
| Layer | Choice |
|-------|--------|
| Language (API) | Go 1.22+ |
| Backend | gin · Handler → Service → Repository |
| Database | PostgreSQL · migrations under `apps/api/migrations/` |
| Frontend | Vue 3 + TypeScript (`strict`) + Vite · Pinia |
| Shared | npm workspaces · `@yuxingu/sdk` · `@yuxingu/types` |
| Mini-program | Scaffold only until tasked |
| Local run | Host Go + ViteDocker **仅** Postgres`docker-compose.dev.yml` |
| Deployment | Docker Compose / images — never `latest` in prod |
| Architecture Pattern | Monorepo · layered API · REST `{code,message,data}` |
## Forbidden(无 ADR 禁止)
- 换后端语言 / 以 GraphQL·gRPC 替代主 REST
- 无 ADR 拆微服务
- Handler 直连 DBUI 直连 DB;页面内裸 `fetch`
- Docker-only 日常开发(每次改代码重建应用镜像)
- 无 Active Feature Spec`.ai/product/feature-spec/`)实现新行为
- L2+ 行为变更无 Approved ECR`docs/ECR/`
- 复制整棵 ESS 进本仓
- 扩展已清理的 Legacy 根 HTML(见 `LEGACY.md`
## Active anchors
- ECR: **ECR-001** structural realignmentApproved
- EXP: (无)
- STATE: `docs/STATE/ECR-001.md` → owner engineer
- TRACEABILITY: `docs/TRACEABILITY.md`
- ADR: `.ai/adr/0007-ess-ai-dual-track.md`
- Product status: `.ai/product/p1-status.md`**P1 Complete**
## Pointers
- Rules: `docs/PROJECT_RULES.md`
- Stack detail: `docs/TECH_STACK.md``.ai/tech-stack.md`
- ESS root: `.ess-root` 或环境变量 `ESS_ROOT`
- Agent entry: `AGENTS.md` · `CLAUDE.md`