-- =====================================================================
-- 应收模块枚举中文说明迁移
--
-- 目的：为数据库中的状态/日志枚举补充中文业务含义，方便运维和数据排查。
-- 说明：本脚本只修改字段 COMMENT，不修改字段类型、历史数据、索引或业务状态值。
--       ALTER TABLE ... MODIFY COLUMN 可重复执行；已执行过旧注释脚本的环境也可直接执行。
-- =====================================================================
SET NAMES utf8mb4;

ALTER TABLE ar_balance_writeoff
  MODIFY COLUMN status VARCHAR(30) NOT NULL
    COMMENT '状态：EFFECTIVE=有效（已扣减客户余额），CANCELLED=已反核销（已回补客户余额）';

ALTER TABLE ar_bill
  MODIFY COLUMN status VARCHAR(30) NOT NULL
    COMMENT '状态：DRAFT=草稿，CONFIRMED=已确认，PARTIAL_WRITTEN_OFF=部分核销，WRITTEN_OFF=已核销，VOID=已作废';

ALTER TABLE ar_bill_export
  MODIFY COLUMN export_status VARCHAR(30) NOT NULL
    COMMENT '导出状态：PROCESSING=生成中，SUCCESS=成功（可下载），FAILED=失败';

ALTER TABLE ar_bill_log
  MODIFY COLUMN object_type VARCHAR(40) NOT NULL
    COMMENT '对象类型：BILL=应收账单，EXPORT=账单导出，BALANCE_WRITEOFF=余额核销；历史值可能包含已下线模块类型',
  MODIFY COLUMN operation_type VARCHAR(40) NOT NULL
    COMMENT '操作类型：CREATE=生成账单，GENERATE=生成校验，CONFIRM=确认账单，VOID=作废账单，EXPORT=导出账单，BALANCE_WRITEOFF=余额核销，CANCEL_BALANCE_WRITEOFF=取消余额核销',
  MODIFY COLUMN operation_source VARCHAR(30) NOT NULL
    COMMENT '操作来源：WEB=网页端，API=接口，JOB=定时任务，IMPORT=数据导入',
  MODIFY COLUMN result VARCHAR(20) NOT NULL
    COMMENT '执行结果：SUCCESS=成功，FAILED=失败';