6a2632da70
将 Clover 从上层产品包旧仓库中独立出来,建立专属版本控制。 当前状态=纵切片端到端已打通(登录→选品→出文出图→审核→下载包), M1文案质量去套路化已验收。此提交作为后续按核销清单逐条修复的基线。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
61 lines
1.9 KiB
Markdown
61 lines
1.9 KiB
Markdown
# 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/）
|
||
|
||
```markdown
|
||
# 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/）
|
||
|
||
```markdown
|
||
# 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。
|