init

docs/database/10-audit/wms_api_log.sql

@@ -0,0 +1,22 @@
+-- 表：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 日志';