22fcf694a6
- 新增 SQL 脚本统一表与列字符集为 utf8mb4_unicode_ci - 移除建表语句冗余 COLLATE 子句，由全局配置控制 - 将挑战起止时间字段由 Date 改为 BIGINT 时间戳，避免时区与精度问题 - 补充 Winston 日志追踪挑战详情查询性能 - 数据库模块新增 charset 与 collate 全局配置，确保后续表一致性 BREAKING CHANGE: challenge.startAt/endAt 由 Date 变更为 number(毫秒时间戳)，调用方需同步调整类型
56 lines
3.6 KiB
SQL
56 lines
3.6 KiB
SQL
-- Challenges feature DDL
|
||
-- Creates core tables required by the challenge listing, participation, and progress tracking flows.
|
||
|
||
CREATE TABLE IF NOT EXISTS t_challenges (
|
||
id CHAR(36) NOT NULL PRIMARY KEY,
|
||
title VARCHAR(255) NOT NULL COMMENT '挑战标题',
|
||
image VARCHAR(512) DEFAULT NULL COMMENT '挑战封面图',
|
||
start_at DATETIME NOT NULL COMMENT '挑战开始时间',
|
||
end_at DATETIME NOT NULL COMMENT '挑战结束时间',
|
||
period_label VARCHAR(128) DEFAULT NULL COMMENT '周期标签，例如「21天挑战」',
|
||
duration_label VARCHAR(128) NOT NULL COMMENT '持续时间标签，例如「持续21天」',
|
||
requirement_label VARCHAR(255) NOT NULL COMMENT '挑战要求标签，例如「每日练习 1 次」',
|
||
summary TEXT DEFAULT NULL COMMENT '挑战概要说明',
|
||
target_value INT NOT NULL COMMENT '挑战目标值（例如需要完成的天数）',
|
||
progress_unit VARCHAR(64) NOT NULL DEFAULT '天' COMMENT '进度单位，用于展示排行榜指标',
|
||
ranking_description VARCHAR(255) DEFAULT NULL COMMENT '排行榜描述，例如「连续打卡榜」',
|
||
highlight_title VARCHAR(255) NOT NULL COMMENT '高亮标题',
|
||
highlight_subtitle VARCHAR(255) NOT NULL COMMENT '高亮副标题',
|
||
cta_label VARCHAR(128) NOT NULL COMMENT 'CTA 按钮文字',
|
||
created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
|
||
updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP
|
||
) ENGINE=InnoDB
|
||
|
||
CREATE TABLE IF NOT EXISTS t_challenge_participants (
|
||
id CHAR(36) NOT NULL PRIMARY KEY,
|
||
challenge_id CHAR(36) NOT NULL COMMENT '挑战 ID',
|
||
user_id VARCHAR(64) NOT NULL COMMENT '用户 ID',
|
||
progress_value INT NOT NULL DEFAULT 0 COMMENT '当前进度值',
|
||
target_value INT NOT NULL COMMENT '目标值，通常与挑战 target_value 相同',
|
||
status ENUM('active', 'completed', 'left') NOT NULL DEFAULT 'active' COMMENT '参与状态',
|
||
joined_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '加入时间',
|
||
left_at DATETIME DEFAULT NULL COMMENT '退出时间',
|
||
last_progress_at DATETIME DEFAULT NULL COMMENT '最近一次更新进度的时间',
|
||
created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
|
||
updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
|
||
CONSTRAINT fk_challenge_participant_challenge FOREIGN KEY (challenge_id) REFERENCES t_challenges (id) ON DELETE CASCADE ON UPDATE CASCADE,
|
||
CONSTRAINT fk_challenge_participant_user FOREIGN KEY (user_id) REFERENCES t_users (id) ON DELETE CASCADE ON UPDATE CASCADE,
|
||
CONSTRAINT uq_challenge_participant UNIQUE KEY (challenge_id, user_id)
|
||
) ENGINE=InnoDB
|
||
|
||
CREATE INDEX idx_challenge_participants_status_progress
|
||
ON t_challenge_participants (challenge_id, status, progress_value DESC, updated_at ASC);
|
||
|
||
CREATE TABLE IF NOT EXISTS t_challenge_progress_reports (
|
||
id CHAR(36) NOT NULL PRIMARY KEY,
|
||
challenge_id CHAR(36) NOT NULL COMMENT '挑战 ID',
|
||
user_id VARCHAR(64) NOT NULL COMMENT '用户 ID',
|
||
report_date DATE NOT NULL COMMENT '自然日，确保每日仅上报一次',
|
||
increment_value INT NOT NULL DEFAULT 1 COMMENT '本次上报的进度增量',
|
||
reported_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '上报时间戳',
|
||
created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
|
||
updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
|
||
CONSTRAINT fk_challenge_progress_reports_challenge FOREIGN KEY (challenge_id) REFERENCES t_challenges (id) ON DELETE CASCADE ON UPDATE CASCADE,
|
||
CONSTRAINT fk_challenge_progress_reports_user FOREIGN KEY (user_id) REFERENCES t_users (id) ON DELETE CASCADE ON UPDATE CASCADE,
|
||
CONSTRAINT uq_challenge_progress_reports_day UNIQUE KEY (challenge_id, user_id, report_date)
|
||
) ENGINE=InnoDB |