数据库字段设计
1. 设计策略
- 优先复用当前 Prisma 已有表。
- 新增表集中解决三个缺口:通用内容版本、文件业务绑定、作品评选。
- 不把文件内容写入数据库,只保存 OSS 元信息和业务关系。
- 前台高频读取字段尽量保留在业务主表,历史版本放
content_revisions。
2. 枚举
2.1 发布状态
| 值 |
说明 |
draft |
草稿 |
published |
已发布 |
disabled |
已下架 |
archived |
已归档 |
2.2 文件状态
| 值 |
说明 |
active |
正常 |
unused |
未绑定 |
archived |
已归档 |
deleted |
已逻辑删除 |
2.3 评审轮次状态
| 值 |
说明 |
draft |
未开始 |
open |
可评分 |
closed |
已结束 |
locked |
已锁定 |
published |
结果已发布 |
2.4 评分任务状态
| 值 |
说明 |
assigned |
已分配 |
scoring |
评分中 |
submitted |
已提交 |
locked |
已锁定 |
3. 现有表扩展建议
3.1 files
现有字段已包含 fileKey、originalName、url、mimeType、extension、size、width、height、duration、storageProvider、createdAt。
建议新增:
| 字段 |
类型 |
必填 |
说明 |
scene |
varchar(80) |
否 |
site、competition、course、work、resource |
file_category |
varchar(50) |
否 |
image、video、model、document、archive |
checksum |
varchar(128) |
否 |
文件 hash,用于去重 |
uploaded_by |
bigint |
否 |
上传管理员 ID |
status |
varchar(32) |
是 |
默认 active |
updated_at |
timestamp |
是 |
更新时间 |
3.2 competition_resources
建议新增:
| 字段 |
类型 |
必填 |
说明 |
resource_type |
varchar(50) |
是 |
pdf、zip、image、link、video |
category |
varchar(80) |
否 |
资源分类,如设计模板、文化资源、提交规范 |
external_url |
varchar(500) |
否 |
外部资源链接 |
open_at |
timestamp |
否 |
开放下载时间 |
close_at |
timestamp |
否 |
关闭下载时间 |
3.3 courses
建议新增:
| 字段 |
类型 |
必填 |
说明 |
cover_file_id |
bigint |
否 |
课程封面文件 |
video_file_id |
bigint |
否 |
OSS 视频文件 |
external_video_url |
varchar(500) |
否 |
外部视频链接 |
speaker |
varchar(255) |
否 |
主讲人 |
source_type |
varchar(32) |
是 |
oss 或 external |
3.4 works
建议新增:
| 字段 |
类型 |
必填 |
说明 |
material_status |
varchar(40) |
是 |
pending_submit、submitted、qualified、rejected |
review_status |
varchar(40) |
是 |
none、reviewing、finalist、winner、rejected |
featured |
boolean |
是 |
是否精选展示 |
award_level |
varchar(80) |
否 |
奖项等级 |
cover_file_id |
bigint |
否 |
封面文件 |
model_file_id |
bigint |
否 |
主模型文件 |
4. 新增内容表
4.1 content_pages
| 字段 |
类型 |
必填 |
说明 |
id |
bigint |
是 |
主键 |
page_key |
varchar(100) |
是 |
页面唯一键,如 home、competition-smart-fashion |
page_name |
varchar(255) |
是 |
页面名称 |
page_type |
varchar(50) |
是 |
site、competition、landing |
business_id |
bigint |
否 |
关联业务 ID,如 competitionId |
lang |
varchar(20) |
是 |
默认 zh-CN |
seo |
jsonb |
否 |
SEO 信息 |
status |
PublishStatus |
是 |
发布状态 |
created_at |
timestamp |
是 |
创建时间 |
updated_at |
timestamp |
是 |
更新时间 |
索引:
| 索引 |
字段 |
| 唯一 |
page_key, lang |
| 普通 |
page_type, business_id, status |
4.2 content_sections
| 字段 |
类型 |
必填 |
说明 |
id |
bigint |
是 |
主键 |
page_id |
bigint |
是 |
content_pages.id |
section_key |
varchar(100) |
是 |
区块键,如 hero、business、awards |
section_name |
varchar(255) |
是 |
区块显示名 |
title |
varchar(255) |
否 |
标题 |
subtitle |
varchar(500) |
否 |
副标题 |
content |
jsonb |
是 |
已发布内容 |
draft_content |
jsonb |
否 |
草稿内容 |
schema |
jsonb |
否 |
表单 schema |
sort_order |
int |
是 |
排序 |
status |
PublishStatus |
是 |
状态 |
published_at |
timestamp |
否 |
发布时间 |
created_at |
timestamp |
是 |
创建时间 |
updated_at |
timestamp |
是 |
更新时间 |
索引:
| 索引 |
字段 |
| 唯一 |
page_id, section_key |
| 普通 |
status, sort_order |
4.3 content_revisions
| 字段 |
类型 |
必填 |
说明 |
id |
bigint |
是 |
主键 |
section_id |
bigint |
是 |
content_sections.id |
revision_no |
int |
是 |
版本号 |
revision_status |
varchar(32) |
是 |
draft、published、rollback |
content_snapshot |
jsonb |
是 |
内容快照 |
created_by |
bigint |
否 |
操作人 |
publish_note |
varchar(500) |
否 |
发布说明 |
published_at |
timestamp |
否 |
发布时间 |
created_at |
timestamp |
是 |
创建时间 |
索引:
| 索引 |
字段 |
| 唯一 |
section_id, revision_no |
| 普通 |
revision_status, created_by, created_at |
5. 文件绑定表
5.1 file_bindings
| 字段 |
类型 |
必填 |
说明 |
id |
bigint |
是 |
主键 |
file_id |
bigint |
是 |
files.id |
target_type |
varchar(80) |
是 |
业务类型 |
target_id |
bigint |
是 |
业务 ID |
usage |
varchar(80) |
是 |
cover、gallery、video、model、attachment、logo |
sort_order |
int |
是 |
排序 |
created_by |
bigint |
否 |
操作人 |
created_at |
timestamp |
是 |
创建时间 |
索引:
| 索引 |
字段 |
| 普通 |
file_id |
| 普通 |
target_type, target_id |
| 普通 |
usage, sort_order |
6. 评选相关表
6.1 judge_profiles
| 字段 |
类型 |
必填 |
说明 |
id |
bigint |
是 |
主键 |
admin_user_id |
bigint |
是 |
关联管理员账号 |
name |
varchar(100) |
是 |
评委姓名 |
organization |
varchar(255) |
否 |
所属单位 |
title |
varchar(120) |
否 |
职称/身份 |
phone |
varchar(50) |
否 |
联系电话 |
email |
varchar(120) |
否 |
邮箱 |
status |
varchar(32) |
是 |
enabled、disabled |
created_at |
timestamp |
是 |
创建时间 |
updated_at |
timestamp |
是 |
更新时间 |
6.2 evaluation_rounds
| 字段 |
类型 |
必填 |
说明 |
id |
bigint |
是 |
主键 |
competition_id |
bigint |
是 |
大赛 ID |
name |
varchar(120) |
是 |
轮次名称 |
round_type |
varchar(50) |
是 |
preliminary、semi_final、final |
description |
text |
否 |
说明 |
expert_weight |
decimal(5,2) |
是 |
评委分权重,默认 80 |
public_vote_weight |
decimal(5,2) |
是 |
公众投票权重,默认 20 |
start_at |
timestamp |
否 |
开始时间 |
end_at |
timestamp |
否 |
结束时间 |
status |
varchar(32) |
是 |
轮次状态 |
created_by |
bigint |
否 |
创建人 |
created_at |
timestamp |
是 |
创建时间 |
updated_at |
timestamp |
是 |
更新时间 |
6.3 evaluation_criteria
| 字段 |
类型 |
必填 |
说明 |
id |
bigint |
是 |
主键 |
round_id |
bigint |
是 |
评审轮次 |
name |
varchar(120) |
是 |
指标名称 |
description |
varchar(500) |
否 |
指标说明 |
max_score |
decimal(6,2) |
是 |
满分 |
weight |
decimal(5,2) |
是 |
权重 |
sort_order |
int |
是 |
排序 |
created_at |
timestamp |
是 |
创建时间 |
updated_at |
timestamp |
是 |
更新时间 |
6.4 evaluation_assignments
| 字段 |
类型 |
必填 |
说明 |
id |
bigint |
是 |
主键 |
round_id |
bigint |
是 |
评审轮次 |
work_id |
bigint |
是 |
作品 ID |
judge_id |
bigint |
是 |
评委 ID |
status |
varchar(32) |
是 |
评分任务状态 |
submitted_at |
timestamp |
否 |
提交时间 |
locked_at |
timestamp |
否 |
锁定时间 |
created_at |
timestamp |
是 |
创建时间 |
updated_at |
timestamp |
是 |
更新时间 |
约束:
| 约束 |
字段 |
| 唯一 |
round_id, work_id, judge_id |
6.5 work_scores
| 字段 |
类型 |
必填 |
说明 |
id |
bigint |
是 |
主键 |
assignment_id |
bigint |
是 |
评分任务 |
criterion_id |
bigint |
是 |
评分指标 |
score |
decimal(6,2) |
是 |
得分 |
comment |
text |
否 |
指标评语 |
created_at |
timestamp |
是 |
创建时间 |
updated_at |
timestamp |
是 |
更新时间 |
约束:
| 约束 |
字段 |
| 唯一 |
assignment_id, criterion_id |
6.6 evaluation_results
| 字段 |
类型 |
必填 |
说明 |
id |
bigint |
是 |
主键 |
round_id |
bigint |
是 |
评审轮次 |
work_id |
bigint |
是 |
作品 ID |
expert_score |
decimal(8,2) |
是 |
评委加权分 |
public_vote_score |
decimal(8,2) |
是 |
投票折算分 |
final_score |
decimal(8,2) |
是 |
最终分 |
rank |
int |
否 |
排名 |
result_status |
varchar(40) |
是 |
pending、finalist、winner、rejected |
award_level |
varchar(80) |
否 |
特等奖、一等奖等 |
published_at |
timestamp |
否 |
结果发布时间 |
created_at |
timestamp |
是 |
创建时间 |
updated_at |
timestamp |
是 |
更新时间 |
约束:
| 约束 |
字段 |
| 唯一 |
round_id, work_id |
7. 字段落地优先级
| 优先级 |
表 |
| P0 |
files 扩展、file_bindings、content_pages、content_sections、content_revisions |
| P0 |
works 扩展、courses 扩展、competition_resources 扩展 |
| P0 |
judge_profiles、evaluation_rounds、evaluation_criteria、evaluation_assignments、work_scores、evaluation_results |
| P1 |
管理员真实 RBAC、操作日志细化、导出记录 |
| P2 |
内容审批流、文件物理删除任务、视频 VOD 字段 |