6a2632da70
将 Clover 从上层产品包旧仓库中独立出来,建立专属版本控制。 当前状态=纵切片端到端已打通(登录→选品→出文出图→审核→下载包), M1文案质量去套路化已验收。此提交作为后续按核销清单逐条修复的基线。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
50 lines
1.9 KiB
Markdown
50 lines
1.9 KiB
Markdown
---
|
||
paths:
|
||
- "src/models/**"
|
||
- "alembic/**"
|
||
- "migrations/**"
|
||
---
|
||
|
||
# 数据库规则（Clover · MySQL + Alembic）
|
||
|
||
> 承接架构方案v0.3 第三章（16表）。一期建14张，matrix_accounts/preference_profile 二期预留。
|
||
|
||
## 迁移
|
||
- 每次 schema 变更创建迁移文件，不手动改数据库
|
||
- 迁移文件不可修改已提交的，只能新增
|
||
- 迁移必须包含 up 和 down
|
||
- 按序：001(banana搬3张) → 002(多租户基础) → 003(业务7张) → 004(飞轮)
|
||
|
||
## 查询
|
||
- 禁止 SELECT *，明确列出字段
|
||
- 大表查询必须有索引支撑，新增查询模式时同步加索引
|
||
- N+1 问题：关联查询用 JOIN 或批量加载
|
||
- 飞轮聚合走 MySQL JOIN（MongoDB 只存 AI debug trace，业务不依赖）
|
||
|
||
## 命名
|
||
- 表名：snake_case 复数（users, generation_tasks, preference_events）
|
||
- 字段名：snake_case（created_at, workspace_id）
|
||
- 索引名：idx_表名_字段名
|
||
|
||
## 关键约束（架构方案）
|
||
- 任务主键：自增 BIGINT + mongo_trace_id VARCHAR(24)
|
||
- user_api_keys：UNIQUE(user_id, workspace_id, provider)
|
||
- 所有业务表必须有 workspace_id（多租户逻辑隔离）
|
||
- preference_events 必须有 workspace_id + product_id（跨公司隔离+按产品分开学）
|
||
|
||
## 状态机（generation_tasks.status）
|
||
pending → generating → pending_selection → pending_review → approved/rejected → archived
|
||
- 打回后回到 pending_selection
|
||
- 非法流转返错误码 40901
|
||
|
||
## 字段红线
|
||
- API Key 字段：encrypted_key（Fernet），**不存 url 字段**（token站固定自家站）
|
||
- users 表：删除 banana 的 credits 字段
|
||
- eval_score：留 NULL（不接 banana 假评分）
|
||
- data_ownership：client_data / platform_asset（洞7分层归属）
|
||
- banned_words.level：auto_fix / soft_warn / hard_block（三级）
|
||
|
||
## 枚举约束
|
||
- DB 枚举约束要有对应代码侧常量文件（消除三套命名打架）
|
||
- 品类（products.category）是纯数据字段，禁止任何品类枚举常量
|