baseline: Clover 独立仓库首次基线提交
将 Clover 从上层产品包旧仓库中独立出来,建立专属版本控制。 当前状态=纵切片端到端已打通(登录→选品→出文出图→审核→下载包), M1文案质量去套路化已验收。此提交作为后续按核销清单逐条修复的基线。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
60
启动包/CLAUDE.md三层说明.md
Normal file
60
启动包/CLAUDE.md三层说明.md
Normal file
@@ -0,0 +1,60 @@
|
||||
# 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。
|
||||
Reference in New Issue
Block a user