baiyue-firstleg/warehouse/src/main/resources/db/warehouse.sql

SET NAMES utf8mb4;
CREATE DATABASE IF NOT EXISTS baiyue_warehouse
  DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci;
USE baiyue_warehouse;

CREATE TABLE IF NOT EXISTS wh_warehouse (
  id BIGINT UNSIGNED NOT NULL COMMENT '仓库ID（雪花ID）',
  tenant_id BIGINT UNSIGNED NOT NULL COMMENT '平台公共仓库固定使用 tenant_id=0',
  warehouse_code VARCHAR(50) NOT NULL COMMENT '平台内唯一仓库编码',
  warehouse_name VARCHAR(120) NOT NULL COMMENT '仓库名称',
  warehouse_type VARCHAR(32) NOT NULL DEFAULT 'DOMESTIC' COMMENT '公共仓库类型：DOMESTIC、FBA、OVERSEAS',
  country_code CHAR(2) NOT NULL COMMENT '所在国家二字码',
  timezone VARCHAR(64) NOT NULL COMMENT '仓库所在地UTC偏移量',
  contact_name VARCHAR(64) DEFAULT NULL COMMENT '仓库联系人',
  contact_phone VARCHAR(32) DEFAULT NULL COMMENT '联系电话',
  contact_email VARCHAR(128) DEFAULT NULL COMMENT '联系邮箱',
  status VARCHAR(20) NOT NULL DEFAULT 'ACTIVE' COMMENT '仓库状态',
  remark VARCHAR(500) DEFAULT NULL COMMENT '仓库备注',
  created_by BIGINT UNSIGNED DEFAULT NULL COMMENT '创建人ID',
  created_at DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3) COMMENT '创建时间',
  updated_by BIGINT UNSIGNED DEFAULT NULL COMMENT '最后修改人ID',
  updated_at DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3) ON UPDATE CURRENT_TIMESTAMP(3) COMMENT '更新时间',
  deleted TINYINT(1) NOT NULL DEFAULT 0 COMMENT '逻辑删除标记',
  version INT NOT NULL DEFAULT 0 COMMENT '乐观锁版本号',
  PRIMARY KEY (id),
  UNIQUE KEY uk_wh_tenant_code (tenant_id, warehouse_code, deleted),
  KEY idx_wh_tenant_status (tenant_id, status, deleted),
  KEY idx_wh_tenant_type_status (tenant_id, warehouse_type, status, deleted),
  KEY idx_wh_country (tenant_id, country_code, deleted)
) ENGINE=InnoDB COMMENT='平台公共仓库主数据表：统一归属平台作用域 tenant_id=0';

CREATE TABLE IF NOT EXISTS wh_warehouse_address (
  id BIGINT UNSIGNED NOT NULL COMMENT '仓库地址ID',
  tenant_id BIGINT UNSIGNED NOT NULL COMMENT '平台公共仓库地址固定使用 tenant_id=0',
  warehouse_id BIGINT UNSIGNED NOT NULL COMMENT '所属仓库ID',
  address_type VARCHAR(20) NOT NULL DEFAULT 'OPERATING' COMMENT '地址类型，例如OPERATING或RETURN',
  country_code CHAR(2) NOT NULL COMMENT '国家二字码',
  state_province VARCHAR(100) DEFAULT NULL COMMENT '省或州',
  city VARCHAR(100) NOT NULL COMMENT '城市',
  district VARCHAR(100) DEFAULT NULL COMMENT '区县',
  postal_code VARCHAR(20) DEFAULT NULL COMMENT '邮政编码',
  address_line1 VARCHAR(255) NOT NULL COMMENT '主地址行',
  address_line2 VARCHAR(255) DEFAULT NULL COMMENT '补充地址行',
  latitude DECIMAL(10,7) DEFAULT NULL COMMENT '纬度',
  longitude DECIMAL(10,7) DEFAULT NULL COMMENT '经度',
  created_by BIGINT UNSIGNED DEFAULT NULL COMMENT '创建人ID',
  created_at DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3) COMMENT '创建时间',
  updated_by BIGINT UNSIGNED DEFAULT NULL COMMENT '最后修改人ID',
  updated_at DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3) ON UPDATE CURRENT_TIMESTAMP(3) COMMENT '更新时间',
  deleted TINYINT(1) NOT NULL DEFAULT 0 COMMENT '逻辑删除标记',
  version INT NOT NULL DEFAULT 0 COMMENT '乐观锁版本号',
  PRIMARY KEY (id),
  UNIQUE KEY uk_address_type (tenant_id, warehouse_id, address_type, deleted),
  KEY idx_address_warehouse (tenant_id, warehouse_id, deleted)
) ENGINE=InnoDB COMMENT='仓库地址表：保存运营、退货等不同用途的地址及可选经纬度';

CREATE TABLE IF NOT EXISTS wh_service_capability (
  id BIGINT UNSIGNED NOT NULL COMMENT '服务能力ID',
  tenant_id BIGINT UNSIGNED NOT NULL COMMENT '平台公共仓库服务能力固定使用 tenant_id=0',
  warehouse_id BIGINT UNSIGNED NOT NULL COMMENT '所属仓库ID',
  capability_code VARCHAR(50) NOT NULL COMMENT '能力编码：RECEIVING、STORAGE、PICK_PACK、RETURN等',
  capability_name VARCHAR(100) NOT NULL COMMENT '能力名称',
  enabled TINYINT(1) NOT NULL DEFAULT 1 COMMENT '是否启用',
  cutoff_time TIME DEFAULT NULL COMMENT '当日作业截单时间',
  description VARCHAR(500) DEFAULT NULL COMMENT '能力说明',
  created_by BIGINT UNSIGNED DEFAULT NULL COMMENT '创建人ID',
  created_at DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3) COMMENT '创建时间',
  updated_by BIGINT UNSIGNED DEFAULT NULL COMMENT '最后修改人ID',
  updated_at DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3) ON UPDATE CURRENT_TIMESTAMP(3) COMMENT '更新时间',
  deleted TINYINT(1) NOT NULL DEFAULT 0 COMMENT '逻辑删除标记',
  version INT NOT NULL DEFAULT 0 COMMENT '乐观锁版本号',
  PRIMARY KEY (id),
  UNIQUE KEY uk_capability (tenant_id, warehouse_id, capability_code, deleted),
  KEY idx_capability_query (tenant_id, warehouse_id, enabled, deleted)
) ENGINE=InnoDB COMMENT='仓库服务能力表：声明仓库可提供的收货、仓储、拣包、退货等能力及截单时间';

-- 不使用跨服务数据库外键；仓库聚合内的归属由服务代码通过 tenant_id 与 warehouse_id 共同校验。

CREATE TABLE IF NOT EXISTS wh_overseas_storage_fee_rule (
  id BIGINT UNSIGNED NOT NULL COMMENT '海外仓费用规则ID（雪花ID）',
  tenant_id BIGINT UNSIGNED NOT NULL COMMENT '客户ID和数据隔离键；客户费用规则不得使用0',
  customer_name VARCHAR(128) NOT NULL COMMENT '客户名称快照',
  currency CHAR(3) NOT NULL DEFAULT 'USD' COMMENT '费用币种三字码；首版为USD',
  initialization_key VARCHAR(191) NULL COMMENT '初始化或导入幂等键',
  created_by BIGINT UNSIGNED NULL COMMENT '创建人ID',
  created_at DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3) COMMENT '创建时间',
  updated_by BIGINT UNSIGNED NULL COMMENT '最后修改人ID',
  updated_at DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3) ON UPDATE CURRENT_TIMESTAMP(3) COMMENT '更新时间',
  deleted TINYINT(1) NOT NULL DEFAULT 0 COMMENT '逻辑删除标记：0未删除、1已删除',
  version INT NOT NULL DEFAULT 0 COMMENT '乐观锁版本号',
  active_customer_id BIGINT UNSIGNED GENERATED ALWAYS AS (CASE WHEN deleted=0 THEN tenant_id ELSE NULL END) STORED COMMENT '未删除规则的客户唯一索引值',
  PRIMARY KEY(id), UNIQUE KEY uk_overseas_fee_active_customer(active_customer_id), KEY idx_overseas_fee_page(deleted,updated_at,id)
) ENGINE=InnoDB COMMENT='客户海外仓费用规则';

CREATE TABLE IF NOT EXISTS wh_overseas_storage_fee_tier (
  id BIGINT UNSIGNED NOT NULL COMMENT '海外仓费用阶梯ID（雪花ID）',
  tenant_id BIGINT UNSIGNED NOT NULL COMMENT '客户ID和数据隔离键；与规则归属一致',
  rule_id BIGINT UNSIGNED NOT NULL COMMENT '所属海外仓费用规则ID',
  start_day SMALLINT UNSIGNED NOT NULL COMMENT '计费阶梯起始存储天数，含边界',
  end_day SMALLINT UNSIGNED NULL COMMENT '计费阶梯结束存储天数，含边界；NULL表示以上',
  fee_type VARCHAR(32) NOT NULL DEFAULT 'STORAGE' COMMENT '费用类型；首版为STORAGE仓储费',
  billing_unit VARCHAR(16) NOT NULL DEFAULT 'CBM' COMMENT '计费单位；首版为CBM立方米',
  unit_price DECIMAL(18,6) NOT NULL COMMENT '每计费单位单价，非负',
  sort_no SMALLINT UNSIGNED NOT NULL COMMENT '阶梯展示和计算顺序',
  created_by BIGINT UNSIGNED NULL COMMENT '创建人ID',
  created_at DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3) COMMENT '创建时间',
  updated_by BIGINT UNSIGNED NULL COMMENT '最后修改人ID',
  updated_at DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3) ON UPDATE CURRENT_TIMESTAMP(3) COMMENT '更新时间',
  deleted TINYINT(1) NOT NULL DEFAULT 0 COMMENT '逻辑删除标记：0未删除、1已删除',
  version INT NOT NULL DEFAULT 0 COMMENT '乐观锁版本号',
  active_start_day SMALLINT UNSIGNED GENERATED ALWAYS AS (CASE WHEN deleted=0 THEN start_day ELSE NULL END) STORED COMMENT '未删除阶梯的起始天唯一索引值',
  PRIMARY KEY(id), UNIQUE KEY uk_overseas_fee_tier_start(rule_id,fee_type,active_start_day), KEY idx_overseas_fee_tier_rule(tenant_id,rule_id,deleted,sort_no,id),
  CONSTRAINT chk_overseas_fee_tier_days CHECK (start_day>=1 AND (end_day IS NULL OR end_day>=start_day)),
  CONSTRAINT chk_overseas_fee_tier_price CHECK (unit_price>=0)
) ENGINE=InnoDB COMMENT='客户海外仓费用阶梯';