doc-forge-reds/docs/数据库设计.md

数据库设计

ER 图（核心关系）

• templates (1) ——> (N) generation_points
• generation_points (N) ——> (1) models
• templates (1) ——> (N) generation_tasks

表结构详细

1. models（AI 模型配置）

字段名	类型	约束	说明
id	UUID	PRIMARY KEY	主键
name	VARCHAR(100)	NOT NULL	模型名称
provider	VARCHAR(50)	NOT NULL	供应商：openai, azure, custom
endpoint	VARCHAR(255)	NOT NULL	接口地址
api_key	TEXT	NOT NULL	加密存储（Fernet 对称加密）
extra_params	JSONB	DEFAULT '{}'	扩展参数，如 max_tokens, temperature
is_enabled	BOOLEAN	DEFAULT TRUE	是否启用
remark	TEXT		备注
created_at	TIMESTAMP	DEFAULT NOW()
updated_at	TIMESTAMP	DEFAULT NOW()

2. templates（模板文档）

字段名	类型	约束	说明
id	UUID	PRIMARY KEY
name	VARCHAR(200)	NOT NULL	模板名称
file_path	VARCHAR(500)	NOT NULL	原始 .docx 文件存储路径
html_content	TEXT		转换后的 HTML 内容（供前端编辑）
created_at	TIMESTAMP	DEFAULT NOW()
updated_at	TIMESTAMP	DEFAULT NOW()

3. generation_points（AI 生成点）

字段名	类型	约束	说明
id	UUID	PRIMARY KEY
template_id	UUID	FOREIGN KEY	关联模板
position	JSONB	NOT NULL	在 HTML 中的选区信息，如 {start: 100, end: 200} 或 XPath
prompt	TEXT	NOT NULL	用户编写的提示词
model_id	UUID	FOREIGN KEY	指定使用的模型，若为空则使用全局默认模型
ref_file_path	VARCHAR(500)		参考文件存储路径（可选）
created_at	TIMESTAMP	DEFAULT NOW()
updated_at	TIMESTAMP	DEFAULT NOW()

4. generation_tasks（生成任务）

字段名	类型	约束	说明
id	UUID	PRIMARY KEY
template_id	UUID	FOREIGN KEY	关联模板
status	VARCHAR(20)	NOT NULL	pending / processing / done / failed
result_file_path	VARCHAR(500)		生成后的 .docx 文件路径
error_msg	TEXT		任务失败时的错误信息
celery_task_id	VARCHAR(100)		Celery 任务 ID，便于追踪
created_at	TIMESTAMP	DEFAULT NOW()
finished_at	TIMESTAMP		完成时间

5. system_config（系统配置，可选）

存储全局默认模型 ID 等键值对。

字段名	类型	约束	说明
key	VARCHAR(50)	PRIMARY	配置键
value	TEXT		配置值（JSON 格式）
description	VARCHAR(200)		描述

索引建议

• templates：在 created_at 上建索引，便于按时间排序。
• generation_points：在 template_id 上建外键索引，提高关联查询速度。
• generation_tasks：在 template_id,status 上建索引，优化列表查询。