-- 表：wms_api_log
-- 用途：API 日志。接口访问记录，不保存完整报文。
-- 约定：InnoDB / utf8mb4 / 无外键，表间按业务编码关联。详见 docs/database/00-conventions.md
-- 说明：数据量大，允许按月归档。不作为业务事实来源。

CREATE TABLE `wms_api_log` (
  `id` BIGINT UNSIGNED NOT NULL AUTO_INCREMENT COMMENT '内部主键',
  `tenant_code` VARCHAR(32) NOT NULL DEFAULT '' COMMENT '租户编码，未认证请求为空',
  `user_code` VARCHAR(64) NOT NULL DEFAULT '' COMMENT '用户编码',
  `request_id` VARCHAR(64) NOT NULL COMMENT '请求 ID',
  `method` VARCHAR(8) NOT NULL COMMENT 'HTTP 方法',
  `path` VARCHAR(255) NOT NULL COMMENT '请求路径，不含查询串中的敏感参数',
  `http_status` SMALLINT UNSIGNED NOT NULL COMMENT 'HTTP 状态码',
  `ip` VARCHAR(45) NOT NULL DEFAULT '' COMMENT '来源 IP',
  `duration_ms` INT UNSIGNED NOT NULL DEFAULT 0 COMMENT '耗时毫秒',
  `summary` VARCHAR(500) NOT NULL DEFAULT '' COMMENT '脱敏后的摘要',
  `created_at` DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3) COMMENT '创建时间',
  `updated_at` DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3) ON UPDATE CURRENT_TIMESTAMP(3) COMMENT '更新时间',
  PRIMARY KEY (`id`),
  KEY `idx_request` (`request_id`),
  KEY `idx_tenant_time` (`tenant_code`, `created_at`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci COMMENT='API 日志';