-- ============================================================
-- 表单中心 T10 · 管理员体系 DDL（MySQL 5.7 兼容复核版）
-- 范围：《管理员体系方案-20261015》§4 三笔 = school_admin / form_admin / answer 加列+加索引
-- 用途：生产 ddl-auto=none 时的升级脚本；开发期（本机 bsch_formcenter，ddl-auto=update）由 Hibernate
--       自动追加，本脚本同时是"实表应当长什么样"的评审权威（沿 t2/t3 先例）。
-- 5.7 复核要点：①无 CTE/WITH、无函数索引、无生成列、无 CHECK 约束；②utf8mb4 显式写 CHARSET/COLLATE；
--       ③InnoDB、无物理外键（方案 §7.7 逻辑外键约定：user_id→UserBase、form_uuid→form.uuid 都不建 FK）；
--       ④可空列一律写 DEFAULT NULL，TEXT 类不出现（本脚本无大字段）。
-- P5/P15 裁决：实体继承 BaseEntity → 实表=方案 §4 草案 + create_by/update_by 两审计列；
--       审计列在基类未标 nullable=false，故按建表实态写 DEFAULT NULL（FormCenterAuditListener 恒写 now()）。
-- 重跑口径：MySQL 5.7 无 ADD COLUMN IF NOT EXISTS，本脚本【不是幂等的】——执行前先用
--       `SHOW COLUMNS FROM answer LIKE 'submitter_sch_id'` 确认列不存在；两表若已建则只跑第三条 ALTER。
-- 存量：生产零存量（H2 尚未执行、160 在线仍是 T5 旧版），无需回填；本地/perf 库的测试数据不强推
--       （NULL 行天然不匹配 SCHOOL 谓词=fail-closed，方案 §4 存量条款）。
--       部署说明已同步补"加列"一笔（《表单中心160部署Runbook》§0）。
-- ============================================================

-- ① 校级表单管理员：数据范围扩展载体，取代已退役的 UserBase 侧 customId 权限锚点行（方案 §4①/§7）
CREATE TABLE `school_admin` (
  `id`          BIGINT       NOT NULL AUTO_INCREMENT,
  `sch_id`      BIGINT       NOT NULL COMMENT '租户键（=会话校；超管代查时=显式目标校）',
  `user_id`     INT          NOT NULL COMMENT 'UserBase 用户主键（BoaUser.id），逻辑外键不建 FK',
  `user_name`   VARCHAR(64)  NOT NULL COMMENT '姓名快照（列表展示免回查，权威在 UserBase）',
  `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_school_admin` (`sch_id`, `user_id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci
  COMMENT='校级表单管理员（方案 §5.1：本校表单范围=全部，基础表单范围=本校提交）';

-- ② 单表单管理员：指定表单的数据查看+导出（D3 裁决：不含编辑权）
CREATE TABLE `form_admin` (
  `id`          BIGINT       NOT NULL AUTO_INCREMENT,
  `form_uuid`   VARCHAR(32)  NOT NULL COMMENT '授权表单 uuid（跨版本不变，契约 §1）',
  `sch_id`      BIGINT       NOT NULL COMMENT '冗余表单租户域（form.sch_id，基础表单=0），落库域复核用',
  `user_id`     INT          NOT NULL,
  `user_name`   VARCHAR(64)  NOT NULL COMMENT '姓名快照（列表展示免回查，权威在 UserBase）',
  `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_admin` (`form_uuid`, `user_id`),
  KEY `idx_form_admin_user` (`user_id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci
  COMMENT='单表单管理员（方案 §5.1：指定表单=全部，基础表单上=本校提交）';

-- ③ 答卷加列：填报人会话学校（D2=B 的落点，SCHOOL 范围的谓词列）
--    NULL=未记录（存量行），按"不参与校级范围匹配"处理；updatable=false（落值后不随改）
ALTER TABLE `answer`
  ADD COLUMN `submitter_sch_id` BIGINT NULL DEFAULT NULL
    COMMENT '填报人会话学校（提交时从会话 currentRole.schId 落值；NULL=未记录，不参与校级范围匹配）'
    AFTER `submitter_id`;

ALTER TABLE `answer` ADD KEY `idx_answer_submitter_sch` (`submitter_sch_id`);

-- 自验（执行后逐条核对，V47）：
--   SHOW CREATE TABLE answer\G           -- 应含 submitter_sch_id bigint NULL + KEY idx_answer_submitter_sch
--   EXPLAIN SELECT id FROM answer WHERE sch_id=3260 AND app_code='form-center' AND code='x'
--         AND is_deleted=0 AND submitter_sch_id=3260;   -- SCHOOL 谓词应能走 key 列（V47 探针口径）
--   SELECT COUNT(*) FROM school_admin;   -- 期望 0（新库）
--   SELECT COUNT(*) FROM form_admin;     -- 期望 0（新库）