jackyu66gitandCursor
879bf70cb7
新增独立鉴权的 /api/v1/admin 与 Vue 控制台；会员授予与审计同事务，并补集成/单测。 Co-authored-by: Cursor <cursoragent@cursor.com>
36 lines
1.6 KiB
Markdown
36 lines
1.6 KiB
Markdown
# Project Rules — 愈心谷
|
||
|
||
Inherits: `$ESS_ROOT/product-governance/PROJECT_RULES.md`（流程）
|
||
Product/DoD 权威：`.ai/`（不在此复制长文）
|
||
|
||
## Domain invariants
|
||
|
||
1. 语言契约：只用 `.ai/product/lexicon.md` 中的愈心谷用词；禁止竞品品牌词与恐吓/吉凶话术。
|
||
2. API 信封固定为 `{code,message,data}`；不发明表名、端点、领域同义词。
|
||
3. 调用链：UI → `@yuxingu/sdk` → Handler → Service → Repository → DB。
|
||
4. 新功能 / 扩行为：必须有 Active `.ai/product/feature-spec/<id>.md`；L2+ 另须 Approved `docs/ECR/`；**涉后台**另须 Approved `docs/BACKEND_DESIGN/`。
|
||
5. 本地默认：本机 `go run` + Vite；compose 只起 DB。
|
||
6. Done ≠ build 通过：须过 `.ai/definition-of-done.md` 并输出 Review Report。
|
||
|
||
## Change levels（映射）
|
||
|
||
| ESS | 本仓要求 |
|
||
|-----|----------|
|
||
| L0 | 文档/注释/无行为；可无 ECR |
|
||
| L1 | 明确 bugfix；可无新 Feature Spec，但不得扩行为 |
|
||
| L2 | 功能行为变更 → Feature Spec Active + ECR Approved + HANDOFF |
|
||
| L3 | 栈/包边界/架构 → ADR（`.ai/adr/`）+ ECR + ENGINEERING_SPEC |
|
||
|
||
## Forbidden（extra）
|
||
|
||
- 猜需求继续写（ASK FIRST）
|
||
- Architect 角色改 `apps/` / `packages/` 生产实现
|
||
- 无 Human 批准把实验当 Live 行为推广
|
||
- 提交 `config.local.yaml`、`.env`、密钥
|
||
|
||
## Completion
|
||
|
||
1. ESS gate（有 ECR 时）：`python scripts/ess-validate.py --phase <phase> --ecr ECR-xxx`
|
||
2. 本仓 DoD：`.ai/definition-of-done.md` + `.ai/review.md`
|
||
3. 有行为变更时更新/尊重 `.ai/product/p1-status.md` 标签
|