-- ============================================================
-- V6: 为所有数据库表添加表注释和字段注释
-- 执行时间：2026-04-08
-- 说明：基于 INFORMATION_SCHEMA 实际列定义生成，确保类型准确
-- ============================================================

-- ============================================================
-- 一、表级别注释
-- ============================================================

ALTER TABLE t_biz_contest COMMENT='活动表';
ALTER TABLE t_biz_contest_attachment COMMENT='活动附件表';
ALTER TABLE t_biz_contest_notice COMMENT='活动公告表';
ALTER TABLE t_biz_contest_registration COMMENT='活动报名表';
ALTER TABLE t_biz_contest_registration_teacher COMMENT='活动报名老师关联表';
ALTER TABLE t_biz_contest_team COMMENT='活动团队表';
ALTER TABLE t_biz_contest_team_member COMMENT='活动团队成员表';
ALTER TABLE t_biz_contest_work COMMENT='活动作品表';
ALTER TABLE t_biz_contest_work_attachment COMMENT='活动作品附件表';
ALTER TABLE t_biz_homework COMMENT='作业表';
ALTER TABLE t_biz_homework_review_rule COMMENT='作业评审规则表';
ALTER TABLE t_biz_homework_score COMMENT='作业评分表';
ALTER TABLE t_biz_homework_submission COMMENT='作业提交表';
ALTER TABLE t_sys_config COMMENT='系统配置表';
ALTER TABLE t_sys_dict COMMENT='数据字典表';
ALTER TABLE t_sys_dict_item COMMENT='数据字典项表';
ALTER TABLE t_sys_log COMMENT='系统操作日志表';
ALTER TABLE t_sys_menu COMMENT='系统菜单表';
ALTER TABLE t_sys_permission COMMENT='系统权限表';
ALTER TABLE t_sys_role COMMENT='系统角色表';
ALTER TABLE t_sys_role_permission COMMENT='角色权限关联表';
ALTER TABLE t_sys_tenant COMMENT='系统租户表';
ALTER TABLE t_sys_tenant_menu COMMENT='租户菜单关联表';
ALTER TABLE t_sys_user COMMENT='系统用户表';
ALTER TABLE t_sys_user_role COMMENT='用户角色关联表';
ALTER TABLE t_ugc_review_log COMMENT='UGC审核日志表';
ALTER TABLE t_ugc_tag COMMENT='UGC标签表';
ALTER TABLE t_ugc_work COMMENT='UGC作品表';
ALTER TABLE t_ugc_work_comment COMMENT='作品评论表';
ALTER TABLE t_ugc_work_favorite COMMENT='作品收藏表';
ALTER TABLE t_ugc_work_like COMMENT='作品点赞表';
ALTER TABLE t_ugc_work_page COMMENT='作品页面表';
ALTER TABLE t_ugc_work_report COMMENT='作品举报表';
ALTER TABLE t_ugc_work_tag COMMENT='作品标签关联表';
ALTER TABLE t_user_child COMMENT='用户子女表';
ALTER TABLE t_user_parent_child COMMENT='家长子女关联表';


-- ============================================================
-- 二、字段级别注释（基于实际列定义）
-- ============================================================

-- ============================================================
-- 1. t_biz_contest
-- ============================================================
-- t_biz_contest：所有列已有注释，无需更新

-- ============================================================
-- 2. t_biz_contest_attachment
-- ============================================================
-- t_biz_contest_attachment：所有列已有注释，无需更新

-- ============================================================
-- 3. t_biz_contest_notice
-- ============================================================
-- t_biz_contest_notice：所有列已有注释，无需更新

-- ============================================================
-- 4. t_biz_contest_registration
-- ============================================================
-- t_biz_contest_registration：所有列已有注释，无需更新

-- ============================================================
-- 5. t_biz_contest_registration_teacher
-- ============================================================
-- t_biz_contest_registration_teacher：所有列已有注释，无需更新

-- ============================================================
-- 6. t_biz_contest_team
-- ============================================================
-- t_biz_contest_team：所有列已有注释，无需更新

-- ============================================================
-- 7. t_biz_contest_team_member
-- ============================================================
-- t_biz_contest_team_member：所有列已有注释，无需更新

-- ============================================================
-- 8. t_biz_contest_work
-- ============================================================
-- t_biz_contest_work：所有列已有注释，无需更新

-- ============================================================
-- 9. t_biz_contest_work_attachment
-- ============================================================
-- t_biz_contest_work_attachment：所有列已有注释，无需更新

-- ============================================================
-- 10. t_biz_homework
-- ============================================================
-- t_biz_homework：所有列已有注释，无需更新

-- ============================================================
-- 11. t_biz_homework_review_rule
-- ============================================================
ALTER TABLE t_biz_homework_review_rule
    MODIFY COLUMN `tenant_id` int NOT NULL COMMENT '租户ID',
    MODIFY COLUMN `name` varchar(191) NOT NULL COMMENT '规则名称',
    MODIFY COLUMN `description` text DEFAULT NULL COMMENT '规则描述',
    MODIFY COLUMN `criteria` json NOT NULL COMMENT '评分标准（JSON数组）',
    MODIFY COLUMN `creator` int DEFAULT NULL COMMENT '创建人ID',
    MODIFY COLUMN `modifier` int DEFAULT NULL COMMENT '修改人ID',
    MODIFY COLUMN `create_time` datetime(3) NOT NULL COMMENT '创建时间',
    MODIFY COLUMN `modify_time` datetime(3) NOT NULL COMMENT '修改时间',
    MODIFY COLUMN `valid_state` int NOT NULL COMMENT '有效状态：1-有效，2-失效';

-- ============================================================
-- 12. t_biz_homework_score
-- ============================================================
ALTER TABLE t_biz_homework_score
    MODIFY COLUMN `tenant_id` int NOT NULL COMMENT '租户ID',
    MODIFY COLUMN `submission_id` int NOT NULL COMMENT '提交ID',
    MODIFY COLUMN `reviewer_id` int NOT NULL COMMENT '评审人ID',
    MODIFY COLUMN `dimension_scores` json NOT NULL COMMENT '各维度得分（JSON）',
    MODIFY COLUMN `total_score` decimal(10,2) NOT NULL COMMENT '总分',
    MODIFY COLUMN `comments` text DEFAULT NULL COMMENT '评语',
    MODIFY COLUMN `score_time` datetime(3) NOT NULL COMMENT '评分时间',
    MODIFY COLUMN `creator` int DEFAULT NULL COMMENT '创建人ID',
    MODIFY COLUMN `modifier` int DEFAULT NULL COMMENT '修改人ID',
    MODIFY COLUMN `create_time` datetime(3) NOT NULL COMMENT '创建时间',
    MODIFY COLUMN `modify_time` datetime(3) NOT NULL COMMENT '修改时间',
    MODIFY COLUMN `valid_state` int NOT NULL COMMENT '有效状态：1-有效，2-失效';

-- ============================================================
-- 13. t_biz_homework_submission
-- ============================================================
ALTER TABLE t_biz_homework_submission
    MODIFY COLUMN `tenant_id` int NOT NULL COMMENT '租户ID',
    MODIFY COLUMN `homework_id` int NOT NULL COMMENT '作业ID',
    MODIFY COLUMN `student_id` int NOT NULL COMMENT '学生ID',
    MODIFY COLUMN `work_no` varchar(191) DEFAULT NULL COMMENT '作品编号',
    MODIFY COLUMN `work_name` varchar(191) NOT NULL COMMENT '作品名称',
    MODIFY COLUMN `work_description` text DEFAULT NULL COMMENT '作品描述',
    MODIFY COLUMN `files` json DEFAULT NULL COMMENT '作品文件（JSON）',
    MODIFY COLUMN `attachments` json DEFAULT NULL COMMENT '附件（JSON）',
    MODIFY COLUMN `submit_time` datetime(3) NOT NULL COMMENT '提交时间',
    MODIFY COLUMN `status` varchar(191) NOT NULL COMMENT '状态：pending/reviewed',
    MODIFY COLUMN `total_score` decimal(10,2) DEFAULT NULL COMMENT '总分',
    MODIFY COLUMN `creator` int DEFAULT NULL COMMENT '创建人ID',
    MODIFY COLUMN `modifier` int DEFAULT NULL COMMENT '修改人ID',
    MODIFY COLUMN `create_time` datetime(3) NOT NULL COMMENT '创建时间',
    MODIFY COLUMN `modify_time` datetime(3) NOT NULL COMMENT '修改时间',
    MODIFY COLUMN `valid_state` int NOT NULL COMMENT '有效状态：1-有效，2-失效';

-- ============================================================
-- 14. t_sys_config
-- ============================================================
-- t_sys_config：所有列已有注释，无需更新

-- ============================================================
-- 15. t_sys_dict
-- ============================================================
-- t_sys_dict：所有列已有注释，无需更新

-- ============================================================
-- 16. t_sys_dict_item
-- ============================================================
-- t_sys_dict_item：所有列已有注释，无需更新

-- ============================================================
-- 17. t_sys_log
-- ============================================================
-- t_sys_log：所有列已有注释，无需更新

-- ============================================================
-- 18. t_sys_menu
-- ============================================================
-- t_sys_menu：所有列已有注释，无需更新

-- ============================================================
-- 19. t_sys_permission
-- ============================================================
-- t_sys_permission：所有列已有注释，无需更新

-- ============================================================
-- 20. t_sys_role
-- ============================================================
-- t_sys_role：所有列已有注释，无需更新

-- ============================================================
-- 21. t_sys_role_permission
-- ============================================================
-- t_sys_role_permission：所有列已有注释，无需更新

-- ============================================================
-- 22. t_sys_tenant
-- ============================================================
-- t_sys_tenant：所有列已有注释，无需更新

-- ============================================================
-- 23. t_sys_tenant_menu
-- ============================================================
-- t_sys_tenant_menu：所有列已有注释，无需更新

-- ============================================================
-- 24. t_sys_user
-- ============================================================
-- t_sys_user：所有列已有注释，无需更新

-- ============================================================
-- 25. t_sys_user_role
-- ============================================================
-- t_sys_user_role：所有列已有注释，无需更新

-- ============================================================
-- 26. t_ugc_review_log
-- ============================================================
ALTER TABLE t_ugc_review_log
    MODIFY COLUMN `target_type` varchar(191) NOT NULL COMMENT '目标类型',
    MODIFY COLUMN `target_id` int NOT NULL COMMENT '目标ID',
    MODIFY COLUMN `work_id` int DEFAULT NULL COMMENT '作品ID',
    MODIFY COLUMN `action` varchar(191) NOT NULL COMMENT '操作动作',
    MODIFY COLUMN `reason` text DEFAULT NULL COMMENT '原因',
    MODIFY COLUMN `note` text DEFAULT NULL COMMENT '备注',
    MODIFY COLUMN `operator_id` int NOT NULL COMMENT '操作人ID',
    MODIFY COLUMN `create_time` datetime(3) NOT NULL COMMENT '创建时间';

-- ============================================================
-- 27. t_ugc_tag
-- ============================================================
ALTER TABLE t_ugc_tag
    MODIFY COLUMN `name` varchar(50) NOT NULL COMMENT '标签名称',
    MODIFY COLUMN `category` varchar(50) DEFAULT NULL COMMENT '标签分类',
    MODIFY COLUMN `sort` int NOT NULL COMMENT '排序',
    MODIFY COLUMN `status` varchar(191) NOT NULL COMMENT '状态',
    MODIFY COLUMN `usage_count` int NOT NULL COMMENT '使用次数',
    MODIFY COLUMN `create_time` datetime(3) NOT NULL COMMENT '创建时间',
    MODIFY COLUMN `modify_time` datetime(3) NOT NULL COMMENT '修改时间',
    MODIFY COLUMN `color` varchar(20) DEFAULT NULL COMMENT '标签颜色';

-- ============================================================
-- 28. t_ugc_work
-- ============================================================
ALTER TABLE t_ugc_work
    MODIFY COLUMN `user_id` int NOT NULL COMMENT '用户ID',
    MODIFY COLUMN `title` varchar(200) NOT NULL COMMENT '作品标题',
    MODIFY COLUMN `cover_url` text DEFAULT NULL COMMENT '封面图URL',
    MODIFY COLUMN `description` text DEFAULT NULL COMMENT '作品描述',
    MODIFY COLUMN `visibility` varchar(191) NOT NULL COMMENT '可见范围',
    MODIFY COLUMN `review_note` text DEFAULT NULL COMMENT '审核备注',
    MODIFY COLUMN `review_time` datetime(3) DEFAULT NULL COMMENT '审核时间',
    MODIFY COLUMN `reviewer_id` int DEFAULT NULL COMMENT '审核人ID',
    MODIFY COLUMN `machine_review_result` varchar(191) DEFAULT NULL COMMENT '机审结果',
    MODIFY COLUMN `machine_review_note` text DEFAULT NULL COMMENT '机审备注',
    MODIFY COLUMN `is_recommended` tinyint(1) NOT NULL COMMENT '是否推荐',
    MODIFY COLUMN `view_count` int NOT NULL COMMENT '浏览数',
    MODIFY COLUMN `like_count` int NOT NULL COMMENT '点赞数',
    MODIFY COLUMN `favorite_count` int NOT NULL COMMENT '收藏数',
    MODIFY COLUMN `comment_count` int NOT NULL COMMENT '评论数',
    MODIFY COLUMN `share_count` int NOT NULL COMMENT '分享数',
    MODIFY COLUMN `original_image_url` text DEFAULT NULL COMMENT '原图URL',
    MODIFY COLUMN `voice_input_url` text DEFAULT NULL COMMENT '语音输入URL',
    MODIFY COLUMN `text_input` text DEFAULT NULL COMMENT '文本输入',
    MODIFY COLUMN `ai_meta` json DEFAULT NULL COMMENT 'AI元数据（JSON）',
    MODIFY COLUMN `publish_time` datetime(3) DEFAULT NULL COMMENT '发布时间',
    MODIFY COLUMN `is_deleted` int NOT NULL COMMENT '是否删除：0-未删除，1-已删除',
    MODIFY COLUMN `create_time` datetime(3) NOT NULL COMMENT '创建时间',
    MODIFY COLUMN `modify_time` datetime(3) NOT NULL COMMENT '修改时间';

-- ============================================================
-- 29. t_ugc_work_comment
-- ============================================================
ALTER TABLE t_ugc_work_comment
    MODIFY COLUMN `work_id` int NOT NULL COMMENT '作品ID',
    MODIFY COLUMN `user_id` int NOT NULL COMMENT '用户ID',
    MODIFY COLUMN `parent_id` int DEFAULT NULL COMMENT '父评论ID',
    MODIFY COLUMN `content` text NOT NULL COMMENT '评论内容',
    MODIFY COLUMN `status` varchar(191) NOT NULL COMMENT '状态',
    MODIFY COLUMN `create_time` datetime(3) NOT NULL COMMENT '创建时间';

-- ============================================================
-- 30. t_ugc_work_favorite
-- ============================================================
ALTER TABLE t_ugc_work_favorite
    MODIFY COLUMN `user_id` int NOT NULL COMMENT '用户ID',
    MODIFY COLUMN `work_id` int NOT NULL COMMENT '作品ID',
    MODIFY COLUMN `create_time` datetime(3) NOT NULL COMMENT '创建时间';

-- ============================================================
-- 31. t_ugc_work_like
-- ============================================================
ALTER TABLE t_ugc_work_like
    MODIFY COLUMN `user_id` int NOT NULL COMMENT '用户ID',
    MODIFY COLUMN `work_id` int NOT NULL COMMENT '作品ID',
    MODIFY COLUMN `create_time` datetime(3) NOT NULL COMMENT '创建时间';

-- ============================================================
-- 32. t_ugc_work_page
-- ============================================================
ALTER TABLE t_ugc_work_page
    MODIFY COLUMN `work_id` int NOT NULL COMMENT '作品ID',
    MODIFY COLUMN `page_no` int NOT NULL COMMENT '页码',
    MODIFY COLUMN `image_url` text DEFAULT NULL COMMENT '图片URL',
    MODIFY COLUMN `text` text DEFAULT NULL COMMENT '文本内容',
    MODIFY COLUMN `audio_url` text DEFAULT NULL COMMENT '音频URL';

-- ============================================================
-- 33. t_ugc_work_report
-- ============================================================
ALTER TABLE t_ugc_work_report
    MODIFY COLUMN `reporter_id` int NOT NULL COMMENT '举报人ID',
    MODIFY COLUMN `target_type` varchar(191) NOT NULL COMMENT '目标类型',
    MODIFY COLUMN `target_id` int NOT NULL COMMENT '目标ID',
    MODIFY COLUMN `target_user_id` int DEFAULT NULL COMMENT '被举报用户ID',
    MODIFY COLUMN `reason` varchar(200) NOT NULL COMMENT '举报原因',
    MODIFY COLUMN `description` text DEFAULT NULL COMMENT '举报描述',
    MODIFY COLUMN `status` varchar(191) NOT NULL COMMENT '状态',
    MODIFY COLUMN `handle_action` varchar(191) DEFAULT NULL COMMENT '处理动作',
    MODIFY COLUMN `handle_note` text DEFAULT NULL COMMENT '处理备注',
    MODIFY COLUMN `handler_id` int DEFAULT NULL COMMENT '处理人ID',
    MODIFY COLUMN `handle_time` datetime(3) DEFAULT NULL COMMENT '处理时间',
    MODIFY COLUMN `create_time` datetime(3) NOT NULL COMMENT '创建时间';

-- ============================================================
-- 34. t_ugc_work_tag
-- ============================================================
ALTER TABLE t_ugc_work_tag
    MODIFY COLUMN `work_id` int NOT NULL COMMENT '作品ID',
    MODIFY COLUMN `tag_id` int NOT NULL COMMENT '标签ID';

-- ============================================================
-- 35. t_user_child
-- ============================================================
-- t_user_child：所有列已有注释，无需更新

-- ============================================================
-- 36. t_user_parent_child
-- ============================================================
-- t_user_parent_child：所有列已有注释，无需更新
