-- =============================================================================
-- 增量补列（幂等）：CR-02 表 3-32 / §12 表 10-6 / §13 表 11-7 / §14 表 12-7~12-9
-- 用法：先执行 00_common.sql 建立 apt_add_column_if_missing，再执行本文件。
-- 说明：本轮 apt_rev01 为空库，01~06 已把补列直接建在表内，本文件为空操作（no-op）；
--       它服务于「已有旧库的后续迭代」与阶段二冻结评审后的增量迁移，重复执行不报错。
-- Q-20 / Q-40 / Q-43 / Q-48 未决项：一律不新增列，按表 13-10 用 JSON 兜底
--       （duty_operation_log.detail / apt_local_task.request_payload / PL_JOB_*）。
-- =============================================================================
CALL apt_add_column_if_missing('gy_jcxx', 'call_mode',
    "call_mode VARCHAR(20) NOT NULL DEFAULT 'SIP' COMMENT 'SIP / TABLET'");
CALL apt_add_column_if_missing('gy_jcxx', 'dispatch_seq',
    'dispatch_seq BIGINT NULL COMMENT ''平板派发序号''');
CALL apt_add_column_if_missing('apt_report_outbox', 'retry_batch_id',
    'retry_batch_id VARCHAR(64) NULL COMMENT ''续报批次''');
CALL apt_add_column_if_missing('apt_master_room', 'building',
    'building VARCHAR(64) NULL COMMENT ''楼栋；Q-20 未决前列存在但不启用''');

CALL apt_add_column_if_missing('apt_master_person', 'photo_ref',
    'photo_ref VARCHAR(512) NULL COMMENT ''照片引用''');
CALL apt_add_column_if_missing('apt_master_person', 'feature_ref',
    'feature_ref VARCHAR(512) NULL COMMENT ''特征值引用''');
CALL apt_add_column_if_missing('apt_master_person', 'face_sync_state',
    "face_sync_state VARCHAR(20) NOT NULL DEFAULT 'PENDING'");

CALL apt_add_column_if_missing('apt_local_task', 'apply_id',
    'apply_id VARCHAR(64) NULL COMMENT ''入住申请 ID''');
CALL apt_add_column_if_missing('apt_local_task', 'checkin_state',
    "checkin_state VARCHAR(24) NOT NULL DEFAULT 'SUBMITTED'");
CALL apt_add_column_if_missing('apt_local_task', 'request_payload',
    'request_payload JSON NULL COMMENT ''Q-40 冻结前 JSON 兜底''');

CALL apt_add_column_if_missing('gy_ykt_remainder', 'local_balance_version',
    'local_balance_version BIGINT NOT NULL DEFAULT 1');
CALL apt_add_column_if_missing('gy_sb', 'face_scope_type',
    'face_scope_type VARCHAR(20) NULL COMMENT ''§12 人脸设备范围''');

-- 未决项显式留痕（不做 DDL）：
--   Q-20 楼栋字段启用            -> apt_master_room.building 已建但不参与筛选
--   Q-40 apt_local_task 补列冻结 -> request_payload JSON 兜底
--   Q-43 账务补列冻结            -> 04_domain_04_ledger.sql 只建结构，不开放读写
--   Q-48 平台统计表冻结          -> 平台库 pl_apt_stat_* 本轮不建（延后域）