-- 表：wms_order
-- 用途：统一订单。与具体电商平台解耦的履约订单。
-- 约定：InnoDB / utf8mb4 / 无外键，表间按业务编码关联。详见 docs/database/00-conventions.md
-- 说明：核心订单只保存统一字段。平台特有属性留在连接器，不在本表加 Amazon、TikTok 等专用列。订单状态表示履约进度，仓库作业状态以 wms_outbound.status 为准。

CREATE TABLE `wms_order` (
  `id` BIGINT UNSIGNED NOT NULL AUTO_INCREMENT COMMENT '内部主键',
  `tenant_code` VARCHAR(32) NOT NULL COMMENT '租户编码',
  `order_no` VARCHAR(64) NOT NULL COMMENT '订单号，租户内唯一',
  `customer_code` VARCHAR(32) NOT NULL COMMENT '货主编码',
  `warehouse_code` VARCHAR(32) NOT NULL DEFAULT '' COMMENT '指定仓库；拆到多个仓库时为空，以出库单为准',
  `order_channel` VARCHAR(32) NOT NULL COMMENT '来源渠道：manual、api、erp、amazon、shopify、tiktok_shop、temu、shopee、mirakl',
  `order_source` VARCHAR(32) NOT NULL COMMENT '进入方式：manual 手工，open_api 开放接口，connector 平台连接器',
  `external_order_no` VARCHAR(64) NULL COMMENT '外部订单号；手工单必须为 NULL',
  `shop_code` VARCHAR(64) NOT NULL DEFAULT '' COMMENT '店铺编码，非平台单为空',
  `status` VARCHAR(32) NOT NULL DEFAULT 'draft' COMMENT 'draft 草稿，confirmed 已确认，processing 作业中，partially_shipped 部分发货，shipped 已发货，completed 已完成，cancelled 已取消',
  `currency` CHAR(3) NOT NULL DEFAULT 'CNY' COMMENT '申报金额币种',
  `required_ship_at` DATETIME(3) NULL COMMENT '要求发货时间',
  `ship_name` VARCHAR(64) NOT NULL DEFAULT '' COMMENT '收件人',
  `ship_phone` VARCHAR(32) NOT NULL DEFAULT '' COMMENT '收件电话',
  `ship_country_code` CHAR(2) NOT NULL DEFAULT '' COMMENT '收件国家',
  `ship_province` VARCHAR(64) NOT NULL DEFAULT '' COMMENT '收件省或州',
  `ship_city` VARCHAR(64) NOT NULL DEFAULT '' COMMENT '收件城市',
  `ship_district` VARCHAR(64) NOT NULL DEFAULT '' COMMENT '收件区县',
  `ship_address` VARCHAR(255) NOT NULL DEFAULT '' COMMENT '收件详细地址',
  `ship_postcode` VARCHAR(32) NOT NULL DEFAULT '' COMMENT '收件邮编',
  `remark` VARCHAR(500) NOT NULL DEFAULT '' COMMENT '备注',
  `created_by` VARCHAR(64) NOT NULL DEFAULT '' COMMENT '创建人 user_code，系统任务为空',
  `updated_by` VARCHAR(64) NOT NULL DEFAULT '' COMMENT '更新人 user_code',
  `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_order_no` (`tenant_code`, `order_no`),
  UNIQUE KEY `uk_tenant_channel_external` (`tenant_code`, `order_channel`, `external_order_no`),
  KEY `idx_tenant_status_created` (`tenant_code`, `status`, `created_at`),
  KEY `idx_tenant_customer` (`tenant_code`, `customer_code`),
  KEY `idx_tenant_shop` (`tenant_code`, `shop_code`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci COMMENT='统一订单';