6a2632da70
将 Clover 从上层产品包旧仓库中独立出来,建立专属版本控制。 当前状态=纵切片端到端已打通(登录→选品→出文出图→审核→下载包), M1文案质量去套路化已验收。此提交作为后续按核销清单逐条修复的基线。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
1.9 KiB
1.9 KiB
Clover CLAUDE.md 三层体系说明
治理指南 L3 要求 CLAUDE.md 分层。Clover 三层落点如下，开工日按此铺到 Clover 仓库。
三层结构
~/.claude/CLAUDE.md ← 全局（倩倩姐已有，agent继承：中文/称呼/失败2次规则等）
Clover/CLAUDE.md ← 项目级（已落：架构铁律+产品红线+前端红线+源路径）
Clover/backend/CLAUDE.md ← 模块级·后端（见下§A）
Clover/frontend/CLAUDE.md ← 模块级·前端（见下§B）
覆盖规则：子级覆盖父级同名配置，不冲突的合并生效。冲突时以架构方案v0.3 + 项目级CLAUDE.md为准。
A. 模块级·后端 CLAUDE.md（开工日放 backend/）
# Clover 后端模块
## 技术栈
- 语言：Python 3.11 / 框架：FastAPI + Celery
- 数据库：MySQL（业务）+ MongoDB（AI trace）+ Redis（队列+SSE）
- 加密：cryptography.fernet，FERNET_KEY 走环境变量
## 验证步骤（改完代码必跑）
1. `ruff check .` — 无错误
2. `pytest` — 全通过
3. 契约符合：核对 启动包/API契约.md
## 架构规则
- 路由层不含业务逻辑，只做校验→service→格式化
- 所有查询带 workspace_id（多租户红线）
- key 绝不进 Celery（基石B）
- 详见 .claude/rules/api.md + db.md
B. 模块级·前端 CLAUDE.md（开工日放 frontend/）
# Clover 前端模块
## 技术栈
- 框架：Next.js 14 + TypeScript
- 样式：Tailwind / CSS Modules
- 状态：4 Store（任务/候选/审核/全局）
## 验证步骤
1. `npm run lint` — 无错误
2. `npm run build` — 构建成功
3. DTO 核对 启动包/API契约.md §3
## 红线
- 不展示 Token 余额、不做积分页
- 飞轮隐形，不做自动发布
- 详见 .claude/rules/frontend.md
开工日操作
全局级已有，项目级已落。开工日只需把 §A/§B 两段分别写入 backend/CLAUDE.md 和 frontend/CLAUDE.md。