-- =====================================================================
-- Migration: add audit log columns (2026-04-21)
-- Change: add-audit-log-reliability
-- Purpose: 为审计日志表新增 model / duration_ms / finish_reason 三列，
--          便于按模型、耗时、失败原因做分析和定位。
--
-- 执行者：@柴进（在 RDS 上执行，必须早于新版本下发）
-- 执行后：客户端新版启动时 preflight 会校验这三列存在，否则拦截启动。
-- =====================================================================

USE `saas_user`;

ALTER TABLE `nano_banana_user_use_log`
    ADD COLUMN `model`         VARCHAR(64) NULL COMMENT '本次生成使用的 Gemini 模型 ID',
    ADD COLUMN `duration_ms`   INT         NULL COMMENT 'Worker start 到 emit 的耗时(毫秒)',
    ADD COLUMN `finish_reason` VARCHAR(64) NULL COMMENT 'Gemini 响应 candidates[0].finish_reason';

-- 回滚（仅开发 / 灰度回退场景，生产不建议删列）：
-- ALTER TABLE `nano_banana_user_use_log`
--     DROP COLUMN `model`,
--     DROP COLUMN `duration_ms`,
--     DROP COLUMN `finish_reason`;