init

2026-09-30 11:11:54 +08:00
parent cb9b7a4bd4
commit 2fb57ec490
160 changed files with 14764 additions and 53 deletions
@@ -0,0 +1,19 @@
+-- 表：wms_platform_shop
+-- 用途：平台店铺。第三方平台连接。新增平台不改订单表。
+-- 约定：InnoDB / utf8mb4 / 无外键，表间按业务编码关联。详见 docs/database/00-conventions.md
+-- 说明：连接器在 Infrastructure/Platforms 下按平台实现，本表只提供找凭证和租户的入口。Webhook 先用凭证确定租户，再进入业务。
+
+CREATE TABLE `wms_platform_shop` (
+  `id` BIGINT UNSIGNED NOT NULL AUTO_INCREMENT COMMENT '内部主键',
+  `tenant_code` VARCHAR(32) NOT NULL COMMENT '租户编码',
+  `platform` VARCHAR(32) NOT NULL COMMENT '平台标识：amazon、shopify、tiktok_shop、temu、shopee、mirakl',
+  `shop_code` VARCHAR(64) NOT NULL COMMENT '店铺编码，同一平台下租户内唯一',
+  `shop_name` VARCHAR(128) NOT NULL COMMENT '店铺名称',
+  `status` VARCHAR(32) NOT NULL DEFAULT 'active' COMMENT 'active 启用，disabled 停用',
+  `credential_cipher` TEXT NOT NULL COMMENT '加密后的凭证，禁止明文',
+  `extra_json` JSON NULL 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`),
+  UNIQUE KEY `uk_tenant_platform_shop` (`tenant_code`, `platform`, `shop_code`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci COMMENT='平台店铺';
@@ -0,0 +1,23 @@
+-- 表：wms_sync_task
+-- 用途：同步任务。订单、库存、轨迹等拉取任务的进度。
+-- 约定：InnoDB / utf8mb4 / 无外键，表间按业务编码关联。详见 docs/database/00-conventions.md
+-- 说明：由队列执行。任务载荷带 tenant_code。同一店铺同一类型避免重叠执行。
+
+CREATE TABLE `wms_sync_task` (
+  `id` BIGINT UNSIGNED NOT NULL AUTO_INCREMENT COMMENT '内部主键',
+  `tenant_code` VARCHAR(32) NOT NULL COMMENT '租户编码',
+  `sync_no` VARCHAR(64) NOT NULL COMMENT '同步任务号，租户内唯一',
+  `shop_code` VARCHAR(64) NOT NULL COMMENT '店铺编码',
+  `platform` VARCHAR(32) NOT NULL COMMENT '平台标识',
+  `sync_type` VARCHAR(32) NOT NULL COMMENT 'order 订单，inventory 库存，tracking 轨迹',
+  `status` VARCHAR(32) NOT NULL DEFAULT 'pending' COMMENT 'pending 待执行，running 执行中，success 成功，failed 失败',
+  `cursor_value` VARCHAR(255) NOT NULL DEFAULT '' COMMENT '增量游标',
+  `error_message` VARCHAR(500) NOT NULL DEFAULT '' COMMENT '失败原因，不得包含凭证',
+  `started_at` DATETIME(3) NULL COMMENT '开始时间',
+  `finished_at` DATETIME(3) NULL 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`),
+  UNIQUE KEY `uk_tenant_sync_no` (`tenant_code`, `sync_no`),
+  KEY `idx_tenant_shop_type_status` (`tenant_code`, `shop_code`, `sync_type`, `status`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci COMMENT='同步任务';
@@ -0,0 +1,22 @@
+-- 表：wms_webhook_log
+-- 用途：Webhook 日志。平台回调的接收与处理结果，用于验签后的幂等。
+-- 约定：InnoDB / utf8mb4 / 无外键，表间按业务编码关联。详见 docs/database/00-conventions.md
+-- 说明：先校验签名和时间戳再入库。重复 event_id 直接返回成功，不重复建单。
+
+CREATE TABLE `wms_webhook_log` (
+  `id` BIGINT UNSIGNED NOT NULL AUTO_INCREMENT COMMENT '内部主键',
+  `tenant_code` VARCHAR(32) NOT NULL COMMENT '租户编码',
+  `shop_code` VARCHAR(64) NOT NULL COMMENT '店铺编码',
+  `platform` VARCHAR(32) NOT NULL COMMENT '平台标识',
+  `event_id` VARCHAR(128) NOT NULL COMMENT '平台事件 ID',
+  `event_type` VARCHAR(64) NOT NULL DEFAULT '' COMMENT '事件类型',
+  `process_status` VARCHAR(32) NOT NULL DEFAULT 'pending' COMMENT 'pending 待处理，processed 已处理，failed 处理失败',
+  `payload` JSON NULL COMMENT '报文体，不得包含密钥明文',
+  `error_message` VARCHAR(500) NOT NULL DEFAULT '' COMMENT '处理失败原因',
+  `received_at` DATETIME(3) NOT NULL 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`),
+  UNIQUE KEY `uk_tenant_shop_event` (`tenant_code`, `shop_code`, `event_id`),
+  KEY `idx_tenant_status` (`tenant_code`, `process_status`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci COMMENT='Webhook 日志';