USE zhiyuantong;

ALTER TABLE data_sources COMMENT='数据来源与原始资料存档信息',
  MODIFY source_id BIGINT UNSIGNED NOT NULL AUTO_INCREMENT COMMENT '数据来源记录自增主键',
  MODIFY source_type VARCHAR(32) NOT NULL COMMENT '来源类型，如官方XLS、官方网页、官方PDF或人工核验',
  MODIFY publisher VARCHAR(128) NOT NULL COMMENT '数据发布机构名称',
  MODIFY title VARCHAR(255) NOT NULL COMMENT '来源文件或网页标题',
  MODIFY landing_page_url VARCHAR(1024) NULL COMMENT '来源发布页网址',
  MODIFY file_url VARCHAR(1024) NULL COMMENT '原始附件或数据文件下载网址',
  MODIFY published_on DATE NULL COMMENT '来源资料发布日期或数据截止日期',
  MODIFY retrieved_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '本系统获取来源资料的时间',
  MODIFY sha256 CHAR(64) NOT NULL COMMENT '原始文件SHA-256摘要，用于去重和完整性校验',
  MODIFY raw_file_path VARCHAR(1024) NULL COMMENT '原始文件在本地数据目录中的保存路径',
  MODIFY notes TEXT NULL COMMENT '来源范围、授权限制或其他补充说明';

ALTER TABLE ingestion_runs COMMENT='数据采集和导入任务审计记录',
  MODIFY ingestion_run_id CHAR(36) NOT NULL COMMENT '本次导入任务UUID',
  MODIFY source_id BIGINT UNSIGNED NOT NULL COMMENT '本次导入使用的数据来源ID',
  MODIFY dataset_name VARCHAR(128) NOT NULL COMMENT '导入的数据集名称',
  MODIFY dataset_year SMALLINT UNSIGNED NOT NULL COMMENT '数据所属年度',
  MODIFY started_at DATETIME NOT NULL COMMENT '导入开始时间',
  MODIFY finished_at DATETIME NULL COMMENT '导入完成或失败时间',
  MODIFY status VARCHAR(20) NOT NULL COMMENT '导入状态，如running、success或failed',
  MODIFY rows_read INT UNSIGNED NOT NULL DEFAULT 0 COMMENT '从来源读取的总行数',
  MODIFY rows_inserted INT UNSIGNED NOT NULL DEFAULT 0 COMMENT '本次新增的记录数',
  MODIFY rows_updated INT UNSIGNED NOT NULL DEFAULT 0 COMMENT '本次更新的记录数',
  MODIFY rows_rejected INT UNSIGNED NOT NULL DEFAULT 0 COMMENT '因校验失败被拒绝的记录数',
  MODIFY message TEXT NULL COMMENT '导入结果、错误信息或校验摘要';

ALTER TABLE schools COMMENT='全国普通高校当前基础信息主表',
  MODIFY school_id CHAR(36) NOT NULL COMMENT '系统内部稳定学校UUID，不随名称和招生代码变化',
  MODIFY moe_school_code CHAR(10) NOT NULL COMMENT '教育部全国唯一且原则上长期不变的十位学校标识码',
  MODIFY official_name VARCHAR(255) NOT NULL COMMENT '教育部当前公布的学校正式名称',
  MODIFY province_name VARCHAR(64) NOT NULL COMMENT '学校所属省级行政区名称',
  MODIFY city_name VARCHAR(128) NOT NULL COMMENT '教育部名单公布的学校所在地城市',
  MODIFY authority_name VARCHAR(255) NOT NULL COMMENT '学校主管部门',
  MODIFY education_level VARCHAR(32) NOT NULL COMMENT '办学层次，如本科或专科',
  MODIFY source_remark VARCHAR(255) NULL COMMENT '教育部原始名单中的备注内容',
  MODIFY ownership_type VARCHAR(32) NOT NULL DEFAULT '待核验' COMMENT '办学性质，如公办、民办、合作办学或境外办学',
  MODIFY school_status VARCHAR(32) NOT NULL DEFAULT 'active' COMMENT '学校当前状态，如active或inactive',
  MODIFY official_website VARCHAR(1024) NULL COMMENT '经核验的学校官方网站',
  MODIFY admission_website VARCHAR(1024) NULL COMMENT '经核验的学校招生官方网站',
  MODIFY first_seen_year SMALLINT UNSIGNED NOT NULL COMMENT '该学校首次进入本系统年度名单的年份',
  MODIFY last_seen_year SMALLINT UNSIGNED NOT NULL COMMENT '该学校最近一次出现在教育部年度名单中的年份',
  MODIFY source_id BIGINT UNSIGNED NOT NULL COMMENT '当前学校基础信息对应的数据来源ID',
  MODIFY created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '记录创建时间',
  MODIFY updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '记录最近更新时间';

ALTER TABLE school_names COMMENT='学校正式名称、曾用名和别名历史',
  MODIFY school_name_id BIGINT UNSIGNED NOT NULL AUTO_INCREMENT COMMENT '学校名称记录自增主键',
  MODIFY school_id CHAR(36) NOT NULL COMMENT '关联schools表的学校UUID',
  MODIFY school_name VARCHAR(255) NOT NULL COMMENT '学校正式名称、曾用名、简称或英文名',
  MODIFY name_type VARCHAR(32) NOT NULL COMMENT '名称类型，如official、former、alias或english',
  MODIFY valid_from_year SMALLINT UNSIGNED NULL COMMENT '该名称开始适用的年份',
  MODIFY valid_to_year SMALLINT UNSIGNED NULL COMMENT '该名称停止适用的年份，空值表示当前仍适用',
  MODIFY source_id BIGINT UNSIGNED NOT NULL COMMENT '证明该名称及有效期的数据来源ID',
  MODIFY created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '名称记录创建时间';

ALTER TABLE school_external_codes COMMENT='学校在省级招生等外部系统中的年度代码映射',
  MODIFY external_code_id BIGINT UNSIGNED NOT NULL AUTO_INCREMENT COMMENT '外部代码映射记录自增主键',
  MODIFY school_id CHAR(36) NOT NULL COMMENT '关联schools表的学校UUID',
  MODIFY code_system VARCHAR(64) NOT NULL COMMENT '代码所属体系，如甘肃招生院校代码或阳光高考内部代码',
  MODIFY external_code VARCHAR(64) NOT NULL COMMENT '外部系统使用的院校代码',
  MODIFY province_name VARCHAR(64) NOT NULL DEFAULT '' COMMENT '该代码适用的招生省份，空字符串表示全国通用',
  MODIFY admission_year SMALLINT UNSIGNED NOT NULL DEFAULT 0 COMMENT '该代码适用的招生年度，0表示不限定年度',
  MODIFY admission_batch VARCHAR(64) NOT NULL DEFAULT '' COMMENT '该代码适用的录取批次，空字符串表示不限定批次',
  MODIFY admission_type VARCHAR(128) NOT NULL DEFAULT '' COMMENT '该代码适用的招生类型，如普通类、中外合作或专项计划',
  MODIFY campus_name VARCHAR(255) NULL COMMENT '代码对应的特定校区或办学地点',
  MODIFY source_id BIGINT UNSIGNED NOT NULL COMMENT '外部代码的数据来源ID',
  MODIFY created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '映射记录创建时间',
  MODIFY updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '映射记录最近更新时间';

ALTER TABLE school_campuses COMMENT='学校校区、地址及地理位置基础信息',
  MODIFY campus_id CHAR(36) NOT NULL COMMENT '系统内部稳定校区UUID',
  MODIFY school_id CHAR(36) NOT NULL COMMENT '关联schools表的学校UUID',
  MODIFY campus_name VARCHAR(255) NOT NULL COMMENT '校区正式名称或常用名称',
  MODIFY province_name VARCHAR(64) NULL COMMENT '校区所在省级行政区名称',
  MODIFY city_name VARCHAR(128) NULL COMMENT '校区所在城市名称',
  MODIFY district_name VARCHAR(128) NULL COMMENT '校区所在区县名称',
  MODIFY address_text VARCHAR(512) NULL COMMENT '经官方来源核验的校区详细地址',
  MODIFY longitude DECIMAL(10, 7) NULL COMMENT '校区经度，采用WGS84或约定坐标系并在来源中说明',
  MODIFY latitude DECIMAL(10, 7) NULL COMMENT '校区纬度，采用WGS84或约定坐标系并在来源中说明',
  MODIFY is_main_campus BOOLEAN NOT NULL DEFAULT FALSE COMMENT '是否为学校主校区，1是、0否',
  MODIFY verification_status VARCHAR(32) NOT NULL DEFAULT 'pending' COMMENT '校区信息核验状态，如pending、verified或rejected',
  MODIFY source_id BIGINT UNSIGNED NOT NULL COMMENT '校区名称、地址和坐标的数据来源ID',
  MODIFY created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '校区记录创建时间',
  MODIFY updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '校区记录最近更新时间';

ALTER TABLE stg_moe_schools COMMENT='教育部全国高校名单导入暂存表',
  MODIFY ingestion_run_id CHAR(36) NOT NULL COMMENT '关联本次导入任务UUID',
  MODIFY source_row_number INT UNSIGNED NOT NULL COMMENT '记录在教育部原始文件中的行号',
  MODIFY moe_school_code CHAR(10) NOT NULL COMMENT '原始文件中的教育部十位学校标识码',
  MODIFY official_name VARCHAR(255) NOT NULL COMMENT '原始文件中的学校正式名称',
  MODIFY province_name VARCHAR(64) NOT NULL COMMENT '从原始文件省份分组标题解析出的省级行政区',
  MODIFY city_name VARCHAR(128) NOT NULL COMMENT '原始文件中的学校所在地',
  MODIFY authority_name VARCHAR(255) NOT NULL COMMENT '原始文件中的学校主管部门',
  MODIFY education_level VARCHAR(32) NOT NULL COMMENT '原始文件中的办学层次',
  MODIFY source_remark VARCHAR(255) NULL COMMENT '原始文件中的备注内容';