-- ============================================================
-- 表单中心 T2 · 定义域 DDL（MySQL 5.7 兼容复核版）
-- 范围：契约 §10 九表中的定义域四表 = form / form_version / form_dict / form_dict_item
--       （answer / answer_index / status_log / answer_op_log / fill_quota 属 T3）
-- 用途：本文件是**评审与生产脚本底稿**，不是应用启动依赖。
--       开发期由 spring.jpa.hibernate.ddl-auto=update 自动建表（application.yml）；
--       生产建议 ddl-auto=none + 按本脚本升级（P10：160 生产 MySQL 版本待核，按 5.7 保守写）。
-- 5.7 复核要点：①无 CTE/WITH；②无函数索引/生成列；③utf8mb4（5.7 默认 utf8mb3 会截断 emoji/生僻字）；
--       ④复合唯一键字节长 (8+64*4+64*4)=520 < 767，两个 uk 均不需要前缀长度；
--       ⑤TEXT/LONGTEXT 列不写 DEFAULT（5.7 不允许）；⑥无物理外键（方案 §7.7 逻辑外键约定）。
-- P5 裁决：实体继承 BaseEntity，实际表=契约 §10 草案 + create_by/update_by 两列（不改 §10 文本）。
--       审计两列在 BaseEntity 未标 nullable=false，故本脚本按建表实态写 DEFAULT NULL
--       （FormCenterAuditListener 恒写 now()，业务上不会为空）——差异记问题单 P15。
-- 本机取证：MySQL 8.0.45 / 库 bsch_formcenter 由 ddl-auto=update 建表后 SHOW CREATE TABLE 逐列比对一致。
-- ============================================================

CREATE TABLE `form` (
  `id`                BIGINT       NOT NULL AUTO_INCREMENT,
  `uuid`              VARCHAR(32)  NOT NULL COMMENT '数据面运行时身份：建草稿即生成、跨版本不变（契约 §1）',
  `sch_id`            BIGINT       NOT NULL COMMENT '租户键；0=平台级表单（U5/U6，超管上下文建）',
  `app_code`          VARCHAR(64)  NOT NULL DEFAULT 'form-center' COMMENT '归属应用：中心/平台级挂 form-center，快应用挂其 app_code',
  `code`              VARCHAR(64)  NOT NULL COMMENT '入口寻址+配置期引用；同校同 app_code 内唯一；发布后不可改',
  `name`              VARCHAR(128) NOT NULL,
  `current_version`   INT          DEFAULT NULL COMMENT '当前发布版本指针，NULL=从未发布（resolve 只认它）',
  `status`            TINYINT      NOT NULL DEFAULT 0 COMMENT '0 草稿 / 1 已发布 / 2 停用（停用只断填报入口，数据可读可导）',
  `status_defs`       TEXT         COMMENT '状态定义 JSON [{code,label,is_deleted}]；NULL=默认待处理/已处理（V12）',
  `audience`          TINYINT      NOT NULL DEFAULT 1 COMMENT '1 面向学生 / 2 面向教师（数据范围默认矩阵输入）',
  `fill_limit`        TINYINT      NOT NULL DEFAULT 0 COMMENT '0 不限 / 1 限一次（去重维度按 subject→submitter 推导）',
  `deadline`          DATETIME     DEFAULT NULL COMMENT '收集截止，datetime 粒度（只选日期时补当日 23:59:59）',
  `answer_no_enabled` TINYINT      NOT NULL DEFAULT 0 COMMENT '报名号开关，默认关',
  `group_tag`         VARCHAR(64)  DEFAULT NULL COMMENT '多表单快应用的菜单分组标签',
  `is_deleted`        TINYINT      NOT NULL DEFAULT 0 COMMENT '软删=唯一删除形态（有答卷的表单禁物理删除）',
  `create_by`         VARCHAR(255) DEFAULT NULL,
  `create_time`       DATETIME     DEFAULT NULL,
  `update_by`         VARCHAR(255) DEFAULT NULL,
  `update_time`       DATETIME     DEFAULT NULL,
  PRIMARY KEY (`id`),
  UNIQUE KEY `uk_form_uuid` (`uuid`),
  UNIQUE KEY `uk_form` (`sch_id`, `app_code`, `code`),
  KEY `idx_form_app` (`sch_id`, `app_code`, `status`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='表单头表（方案 §5.1）';

CREATE TABLE `form_version` (
  `id`          BIGINT       NOT NULL AUTO_INCREMENT,
  `form_id`     BIGINT       NOT NULL COMMENT '逻辑外键 → form.id（无物理 FK）',
  `sch_id`      BIGINT       NOT NULL,
  `app_code`    VARCHAR(64)  NOT NULL,
  `code`        VARCHAR(64)  NOT NULL,
  `version`     INT          NOT NULL COMMENT '只增不改（契约 §1）',
  `schema_json` LONGTEXT     NOT NULL COMMENT '结构快照：{"groups":[{key,label,fields:[…]}]}，数组序即展示序、无 orderNum',
  `change_log`  VARCHAR(500) DEFAULT NULL COMMENT '升版改动说明',
  `publish_time` DATETIME    DEFAULT NULL COMMENT 'NULL=未发布草稿行；发布动作只补这一列，内容列从此冻结（V7）',
  `create_by`   VARCHAR(255) DEFAULT NULL,
  `create_time` DATETIME     DEFAULT NULL,
  `update_by`   VARCHAR(255) DEFAULT NULL,
  `update_time` DATETIME     DEFAULT NULL,
  PRIMARY KEY (`id`),
  UNIQUE KEY `uk_form_ver` (`sch_id`, `app_code`, `code`, `version`),
  KEY `idx_ver_form` (`form_id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci
  COMMENT='版本行：行不可变（方案 §3.2）——已发布行禁止就地修改，改版=新增行';

CREATE TABLE `form_dict` (
  `id`          BIGINT       NOT NULL AUTO_INCREMENT,
  `sch_id`      BIGINT       NOT NULL DEFAULT 0 COMMENT '0=平台级（学校可见可用不可改）；其余=校级（仅本校表单可引用）',
  `code`        VARCHAR(64)  NOT NULL COMMENT 'schema 里 options.source="dict:{code}" 的引用键，建后不可改',
  `name`        VARCHAR(128) NOT NULL,
  `is_deleted`  TINYINT      NOT NULL DEFAULT 0,
  `create_by`   VARCHAR(255) DEFAULT NULL,
  `create_time` DATETIME     DEFAULT NULL,
  `update_by`   VARCHAR(255) DEFAULT NULL,
  `update_time` DATETIME     DEFAULT NULL,
  PRIMARY KEY (`id`),
  UNIQUE KEY `uk_dict` (`sch_id`, `code`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='选项字典（契约 §2.1）';

CREATE TABLE `form_dict_item` (
  `id`         BIGINT       NOT NULL AUTO_INCREMENT,
  `dict_id`    BIGINT       NOT NULL COMMENT '逻辑外键 → form_dict.id',
  `value`      VARCHAR(64)  NOT NULL COMMENT '答案存储值：建一次即不可变（实体 updatable=false + 本 uk）',
  `label`      VARCHAR(128) NOT NULL COMMENT '展示名，可随便改（改名不打穿历史答卷）',
  `sort`       INT          NOT NULL DEFAULT 0 COMMENT '展示顺序（同值按 id 稳定排）',
  `is_deleted` TINYINT      NOT NULL DEFAULT 0 COMMENT '软删：设计器不可新选，但 value 仍通过提交校验（V38）',
  `create_by`  VARCHAR(255) DEFAULT NULL,
  `create_time` DATETIME    DEFAULT NULL,
  `update_by`  VARCHAR(255) DEFAULT NULL,
  `update_time` DATETIME    DEFAULT NULL,
  PRIMARY KEY (`id`),
  UNIQUE KEY `uk_dict_item` (`dict_id`, `value`),
  KEY `idx_dict_item_sort` (`dict_id`, `sort`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='字典条目（契约 §2.1）';