暂存提交

2026-07-30 18:01:36 +08:00
commit 2f4e159356
368 changed files with 20370 additions and 0 deletions
@@ -0,0 +1,36 @@
+server:
+  port: ${ORDER_PORT:9204}
+spring:
+  application:
+    name: order-service
+  config:
+    import:
+      - optional:nacos:baiyue-common.yml?group=BAIYUE&refreshEnabled=true
+      - optional:nacos:${spring.application.name}.yml?group=BAIYUE&refreshEnabled=true
+  cloud:
+    nacos:
+      server-addr: ${NACOS_SERVER_ADDR:127.0.0.1:8848}
+      username: ${NACOS_USERNAME:nacos}
+      password: ${NACOS_PASSWORD:nacos}
+      discovery:
+        enabled: ${NACOS_DISCOVERY_ENABLED:true}
+        register-enabled: ${NACOS_REGISTER_ENABLED:true}
+        group: ${NACOS_GROUP:BAIYUE}
+        namespace: ${NACOS_NAMESPACE:public}
+      config.namespace: ${NACOS_NAMESPACE:public}
+  datasource:
+    driver-class-name: com.mysql.cj.jdbc.Driver
+    url: ${ORDER_DB_URL:jdbc:mysql://127.0.0.1:3306/baiyue_order?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai&rewriteBatchedStatements=true}
+    username: ${ORDER_DB_USERNAME:root}
+    password: ${ORDER_DB_PASSWORD:123456}
+management.endpoints.web.exposure.include: health,info,prometheus
+
+baiyue:
+  security:
+    jwt-secret: ${JWT_SECRET:change-me-to-at-least-32-bytes-long-before-start}
+    internal-service-token: ${INTERNAL_SERVICE_TOKEN:change-me-to-an-internal-token-at-least-32-bytes-long}
+  clients:
+    iam:
+      url: ${IAM_SERVICE_URL:}
+    warehouse:
+      url: ${WAREHOUSE_SERVICE_URL:}
@@ -0,0 +1,162 @@
+SET NAMES utf8mb4;
+-- 订单服务独占数据库。其他服务只能通过 OpenAPI 或领域事件获取订单数据。
+CREATE DATABASE IF NOT EXISTS baiyue_order
+  DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci;
+USE baiyue_order;
+
+CREATE TABLE IF NOT EXISTS ord_order (
+  id BIGINT UNSIGNED NOT NULL COMMENT '订单ID（雪花ID）',
+  tenant_id BIGINT UNSIGNED NOT NULL COMMENT '数据所属租户ID',
+  order_no VARCHAR(32) NOT NULL COMMENT '租户内唯一订单号',
+  customer_id BIGINT UNSIGNED NULL COMMENT '客户逻辑ID',
+  customer_name VARCHAR(128) NOT NULL COMMENT '下单时客户名称快照',
+  status VARCHAR(24) NOT NULL DEFAULT 'DRAFT' COMMENT '订单业务状态',
+  transport_mode VARCHAR(16) NOT NULL COMMENT '运输方式',
+  trade_term VARCHAR(16) NULL COMMENT '贸易条款',
+  destination_country_code CHAR(2) NOT NULL COMMENT '目的国家二字码',
+  destination_warehouse_id BIGINT UNSIGNED NULL COMMENT '目的仓逻辑ID',
+  destination_warehouse_name VARCHAR(128) NOT NULL COMMENT '目的仓名称快照',
+  expected_ship_date DATE NULL COMMENT '预计发运日期',
+  customer_remark VARCHAR(1000) NULL COMMENT '客户可见备注',
+  pickup_method VARCHAR(24) NULL COMMENT '取货方式',
+  receiving_warehouse_id BIGINT UNSIGNED NULL COMMENT '国内收货仓ID',
+  receiving_warehouse_name VARCHAR(128) NULL COMMENT '国内收货仓快照',
+  channel_code VARCHAR(64) NULL COMMENT '渠道编码',
+  channel_name VARCHAR(128) NULL COMMENT '渠道名称快照',
+  tax_mode VARCHAR(24) NULL COMMENT '买单或退税',
+  container_mode VARCHAR(24) NULL COMMENT '整柜或散货',
+  customs_inspection TINYINT(1) NULL COMMENT '是否商检',
+  destination_type VARCHAR(24) NULL COMMENT 'FBA/OVERSEAS/PRIVATE',
+  amazon_warehouse_code VARCHAR(32) NULL COMMENT '亚马逊仓库编码',
+  shipment_id VARCHAR(64) NULL COMMENT 'Amazon Shipment ID',
+  reference_id VARCHAR(64) NULL COMMENT 'Amazon Reference ID',
+  submitted_at DATETIME(3) NULL COMMENT '提交时间',
+  completed_at DATETIME(3) NULL COMMENT '完成时间',
+  created_by BIGINT UNSIGNED NOT NULL COMMENT '创建人ID',
+  created_at DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3) COMMENT '创建时间',
+  updated_by BIGINT UNSIGNED NOT 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_order_tenant_no (tenant_id, order_no),
+  KEY idx_order_tenant_status_time (tenant_id, status, created_at),
+  KEY idx_order_tenant_customer (tenant_id, customer_id),
+  KEY idx_order_tenant_warehouse (tenant_id, destination_warehouse_id)
+) ENGINE=InnoDB COMMENT='头程订单主表：保存商户委托、目的仓、运输方式和订单当前状态';
+
+CREATE TABLE IF NOT EXISTS ord_order_party (
+  id BIGINT UNSIGNED NOT NULL COMMENT '参与方快照ID',
+  tenant_id BIGINT UNSIGNED NOT NULL COMMENT '数据所属租户ID',
+  order_id BIGINT UNSIGNED NOT NULL COMMENT '所属订单ID',
+  party_type VARCHAR(16) NOT NULL COMMENT '参与方类型：SHIPPER或CONSIGNEE',
+  company_name VARCHAR(128) NOT NULL COMMENT '公司名称快照',
+  contact_name VARCHAR(64) NOT NULL COMMENT '联系人快照',
+  phone VARCHAR(32) NOT NULL COMMENT '联系电话快照',
+  email VARCHAR(128) NULL COMMENT '联系邮箱快照',
+  country_code CHAR(2) NOT NULL COMMENT '国家二字码',
+  province VARCHAR(64) NULL COMMENT '省/州',
+  city VARCHAR(64) NOT NULL COMMENT '城市',
+  district VARCHAR(64) NULL COMMENT '区县',
+  address_line VARCHAR(255) NOT NULL COMMENT '详细地址',
+  postal_code VARCHAR(20) NULL COMMENT '邮政编码',
+  created_by BIGINT UNSIGNED NOT NULL COMMENT '创建人ID',
+  created_at DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3) COMMENT '创建时间',
+  updated_by BIGINT UNSIGNED NOT 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_party_order_type (tenant_id, order_id, party_type),
+  CONSTRAINT fk_party_order FOREIGN KEY (order_id) REFERENCES ord_order (id)
+) ENGINE=InnoDB COMMENT='订单收发货方快照表：固化下单时发货人和收货人信息，避免主数据变化影响历史订单';
+
+CREATE TABLE IF NOT EXISTS ord_order_cargo (
+  id BIGINT UNSIGNED NOT NULL COMMENT '货物明细ID',
+  tenant_id BIGINT UNSIGNED NOT NULL COMMENT '数据所属租户ID',
+  order_id BIGINT UNSIGNED NOT NULL COMMENT '所属订单ID',
+  item_no INT NOT NULL COMMENT '订单内明细序号',
+  cargo_name VARCHAR(128) NOT NULL COMMENT '货物名称',
+  hs_code VARCHAR(20) NULL COMMENT '海关商品编码',
+  package_type VARCHAR(32) NOT NULL COMMENT '包装类型',
+  package_count INT UNSIGNED NOT NULL COMMENT '包装件数',
+  gross_weight_kg DECIMAL(18,3) NOT NULL COMMENT '毛重（千克）',
+  volume_cbm DECIMAL(18,4) NOT NULL COMMENT '体积（立方米）',
+  length_cm DECIMAL(12,2) NULL COMMENT '单件长度（厘米）',
+  width_cm DECIMAL(12,2) NULL COMMENT '单件宽度（厘米）',
+  height_cm DECIMAL(12,2) NULL COMMENT '单件高度（厘米）',
+  declared_value DECIMAL(18,2) NULL COMMENT '申报价值',
+  currency CHAR(3) NULL COMMENT '币种三字码',
+  dangerous_goods TINYINT(1) NOT NULL DEFAULT 0 COMMENT '是否危险品',
+  cargo_remark VARCHAR(500) NULL COMMENT '货物备注',
+  sku_no VARCHAR(64) NULL COMMENT 'SKU',
+  upc_no VARCHAR(64) NULL COMMENT 'UPC',
+  cargo_name_en VARCHAR(128) NULL COMMENT '英文品名',
+  customs_hs_code VARCHAR(20) NULL COMMENT '目的国清关HS CODE',
+  units_per_package INT UNSIGNED NULL COMMENT '每箱件数',
+  total_quantity INT UNSIGNED NULL COMMENT '总件数',
+  net_weight_kg DECIMAL(18,3) NULL COMMENT '净重kg',
+  unit_declared_value DECIMAL(18,2) NULL COMMENT '单件申报价值',
+  material VARCHAR(128) NULL COMMENT '材质',
+  product_usage VARCHAR(128) NULL COMMENT '用途',
+  model VARCHAR(64) NULL COMMENT '型号',
+  brand VARCHAR(64) NULL COMMENT '品牌',
+  created_by BIGINT UNSIGNED NOT NULL COMMENT '创建人ID',
+  created_at DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3) COMMENT '创建时间',
+  updated_by BIGINT UNSIGNED NOT 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_cargo_item (tenant_id, order_id, item_no),
+  KEY idx_cargo_order (tenant_id, order_id),
+  CONSTRAINT fk_cargo_order FOREIGN KEY (order_id) REFERENCES ord_order (id)
+) ENGINE=InnoDB COMMENT='订单货物明细表：记录件数、重量、体积、申报价值和危险品属性';
+
+CREATE TABLE IF NOT EXISTS ord_order_internal_note (
+  id BIGINT UNSIGNED NOT NULL COMMENT '内部备注ID',
+  tenant_id BIGINT UNSIGNED NOT NULL COMMENT '数据所属租户ID',
+  order_id BIGINT UNSIGNED NOT NULL COMMENT '所属订单ID',
+  content VARCHAR(2000) NOT NULL COMMENT '仅内部人员可见的备注内容',
+  created_by BIGINT UNSIGNED NOT NULL COMMENT '创建人ID',
+  created_at DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3) COMMENT '创建时间',
+  updated_by BIGINT UNSIGNED NOT 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),
+  KEY idx_note_order_time (tenant_id, order_id, created_at),
+  CONSTRAINT fk_note_order FOREIGN KEY (order_id) REFERENCES ord_order (id)
+) ENGINE=InnoDB COMMENT='订单内部备注表：保存平台运营或履约人员的内部协作记录，不向商户客户展示';
+
+CREATE TABLE IF NOT EXISTS ord_order_status_history (
+  id BIGINT UNSIGNED NOT NULL COMMENT '状态历史ID',
+  tenant_id BIGINT UNSIGNED NOT NULL COMMENT '数据所属租户ID',
+  order_id BIGINT UNSIGNED NOT NULL COMMENT '所属订单ID',
+  from_status VARCHAR(24) NULL COMMENT '变更前状态，首次创建可为空',
+  to_status VARCHAR(24) NOT NULL COMMENT '变更后状态',
+  action VARCHAR(24) NOT NULL COMMENT '触发状态变化的业务动作',
+  reason VARCHAR(500) NULL COMMENT '变更原因',
+  operator_id BIGINT UNSIGNED NOT NULL COMMENT '操作人ID',
+  operator_name VARCHAR(64) NULL COMMENT '操作人名称快照',
+  occurred_at DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3) COMMENT '状态变化时间',
+  PRIMARY KEY (id),
+  KEY idx_history_order_time (tenant_id, order_id, occurred_at),
+  CONSTRAINT fk_history_order FOREIGN KEY (order_id) REFERENCES ord_order (id)
+) ENGINE=InnoDB COMMENT='订单状态不可变历史表：按时间记录每次状态迁移、动作、原因和操作人';
+
+CREATE TABLE IF NOT EXISTS ord_outbox_event (
+  id BIGINT UNSIGNED NOT NULL COMMENT '领域事件全局ID，同时作为消费幂等键',
+  tenant_id BIGINT UNSIGNED NOT NULL COMMENT '事件所属租户ID',
+  aggregate_type VARCHAR(32) NOT NULL COMMENT '聚合类型，例如 ORDER',
+  aggregate_id BIGINT UNSIGNED NOT NULL COMMENT '发生变更的聚合根ID，例如订单ID',
+  event_type VARCHAR(64) NOT NULL COMMENT '领域事件类型，例如 ORDER_SUBMITTED',
+  payload_json JSON NOT NULL COMMENT '供下游消费的事件负载快照',
+  publish_status VARCHAR(16) NOT NULL DEFAULT 'PENDING' COMMENT '发布状态：PENDING、PUBLISHED或FAILED',
+  retry_count INT NOT NULL DEFAULT 0 COMMENT '投递失败后的累计重试次数',
+  next_retry_at DATETIME(3) NULL COMMENT '允许再次投递的最早时间',
+  published_at DATETIME(3) NULL COMMENT '成功发布到消息中间件的时间',
+  created_at DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3) COMMENT '事件在本地事务中的创建时间',
+  PRIMARY KEY (id),
+  KEY idx_outbox_publish (publish_status, next_retry_at, created_at)
+) ENGINE=InnoDB COMMENT='订单事务Outbox表：与订单业务变更在同一本地事务写入，供后台发布器可靠投递RocketMQ，保证数据库状态与领域事件最终一致；不是普通操作日志';
@@ -0,0 +1,16 @@
+SET NAMES utf8mb4;
+USE baiyue_order;
+-- MySQL 8 可重复执行的订单快照及履约字段迁移。
+SET @schema_name = DATABASE();
+SET @sql = IF((SELECT COUNT(*) FROM information_schema.COLUMNS WHERE TABLE_SCHEMA=@schema_name AND TABLE_NAME='ord_order' AND COLUMN_NAME='receiving_warehouse_address')=0,
+ 'ALTER TABLE ord_order ADD COLUMN receiving_warehouse_address VARCHAR(600) NULL COMMENT ''收货仓地址历史快照'' AFTER receiving_warehouse_name','SELECT 1');
+PREPARE s FROM @sql; EXECUTE s; DEALLOCATE PREPARE s;
+SET @sql = IF((SELECT COUNT(*) FROM information_schema.COLUMNS WHERE TABLE_SCHEMA=@schema_name AND TABLE_NAME='ord_order' AND COLUMN_NAME='receiving_time')=0,
+ 'ALTER TABLE ord_order ADD COLUMN receiving_time VARCHAR(100) NULL COMMENT ''收货时间历史快照'' AFTER receiving_warehouse_address','SELECT 1');
+PREPARE s FROM @sql; EXECUTE s; DEALLOCATE PREPARE s;
+SET @sql = IF((SELECT COUNT(*) FROM information_schema.COLUMNS WHERE TABLE_SCHEMA=@schema_name AND TABLE_NAME='ord_order' AND COLUMN_NAME='express_company')=0,
+ 'ALTER TABLE ord_order ADD COLUMN express_company VARCHAR(64) NULL COMMENT ''履约快递公司'' AFTER reference_id','SELECT 1');
+PREPARE s FROM @sql; EXECUTE s; DEALLOCATE PREPARE s;
+SET @sql = IF((SELECT COUNT(*) FROM information_schema.COLUMNS WHERE TABLE_SCHEMA=@schema_name AND TABLE_NAME='ord_order' AND COLUMN_NAME='express_tracking_no')=0,
+ 'ALTER TABLE ord_order ADD COLUMN express_tracking_no VARCHAR(128) NULL COMMENT ''履约快递单号'' AFTER express_company','SELECT 1');
+PREPARE s FROM @sql; EXECUTE s; DEALLOCATE PREPARE s;
@@ -0,0 +1,54 @@
+-- Phase-one first-leg order fields. Safe to run repeatedly on MySQL 8.
+USE baiyue_order;
+SET NAMES utf8mb4;
+
+DROP PROCEDURE IF EXISTS phase1_add_column;
+DELIMITER $$
+CREATE PROCEDURE phase1_add_column(
+  IN p_table_name VARCHAR(64),
+  IN p_column_name VARCHAR(64),
+  IN p_definition VARCHAR(1000)
+)
+BEGIN
+  IF NOT EXISTS (
+    SELECT 1 FROM information_schema.COLUMNS
+    WHERE TABLE_SCHEMA = DATABASE()
+      AND TABLE_NAME = p_table_name
+      AND COLUMN_NAME = p_column_name
+  ) THEN
+    SET @phase1_sql = CONCAT('ALTER TABLE `', p_table_name, '` ADD COLUMN `',
+                             p_column_name, '` ', p_definition);
+    PREPARE phase1_stmt FROM @phase1_sql;
+    EXECUTE phase1_stmt;
+    DEALLOCATE PREPARE phase1_stmt;
+  END IF;
+END$$
+DELIMITER ;
+
+CALL phase1_add_column('ord_order', 'pickup_method', "VARCHAR(24) NULL COMMENT 'Pickup method'");
+CALL phase1_add_column('ord_order', 'receiving_warehouse_id', "BIGINT UNSIGNED NULL COMMENT 'Domestic receiving warehouse ID'");
+CALL phase1_add_column('ord_order', 'receiving_warehouse_name', "VARCHAR(128) NULL COMMENT 'Domestic receiving warehouse snapshot'");
+CALL phase1_add_column('ord_order', 'channel_code', "VARCHAR(64) NULL COMMENT 'Shipping channel code'");
+CALL phase1_add_column('ord_order', 'channel_name', "VARCHAR(128) NULL COMMENT 'Shipping channel snapshot'");
+CALL phase1_add_column('ord_order', 'tax_mode', "VARCHAR(24) NULL COMMENT 'BUY_DECLARATION or TAX_REFUND'");
+CALL phase1_add_column('ord_order', 'container_mode', "VARCHAR(24) NULL COMMENT 'FULL_CONTAINER or LCL'");
+CALL phase1_add_column('ord_order', 'customs_inspection', "TINYINT(1) NULL COMMENT 'Whether customs inspection is required'");
+CALL phase1_add_column('ord_order', 'destination_type', "VARCHAR(24) NULL COMMENT 'FBA, OVERSEAS or PRIVATE'");
+CALL phase1_add_column('ord_order', 'amazon_warehouse_code', "VARCHAR(32) NULL COMMENT 'Amazon warehouse code'");
+CALL phase1_add_column('ord_order', 'shipment_id', "VARCHAR(64) NULL COMMENT 'Amazon Shipment ID'");
+CALL phase1_add_column('ord_order', 'reference_id', "VARCHAR(64) NULL COMMENT 'Amazon Reference ID'");
+
+CALL phase1_add_column('ord_order_cargo', 'sku_no', "VARCHAR(64) NULL COMMENT 'SKU number'");
+CALL phase1_add_column('ord_order_cargo', 'upc_no', "VARCHAR(64) NULL COMMENT 'UPC number'");
+CALL phase1_add_column('ord_order_cargo', 'cargo_name_en', "VARCHAR(128) NULL COMMENT 'English cargo name'");
+CALL phase1_add_column('ord_order_cargo', 'customs_hs_code', "VARCHAR(20) NULL COMMENT 'Destination customs HS code'");
+CALL phase1_add_column('ord_order_cargo', 'units_per_package', "INT UNSIGNED NULL COMMENT 'Units per carton'");
+CALL phase1_add_column('ord_order_cargo', 'total_quantity', "INT UNSIGNED NULL COMMENT 'Total units'");
+CALL phase1_add_column('ord_order_cargo', 'net_weight_kg', "DECIMAL(18,3) NULL COMMENT 'Net weight in kilograms'");
+CALL phase1_add_column('ord_order_cargo', 'unit_declared_value', "DECIMAL(18,2) NULL COMMENT 'Declared value per unit'");
+CALL phase1_add_column('ord_order_cargo', 'material', "VARCHAR(128) NULL COMMENT 'Material'");
+CALL phase1_add_column('ord_order_cargo', 'product_usage', "VARCHAR(128) NULL COMMENT 'Usage'");
+CALL phase1_add_column('ord_order_cargo', 'model', "VARCHAR(64) NULL COMMENT 'Model'");
+CALL phase1_add_column('ord_order_cargo', 'brand', "VARCHAR(64) NULL COMMENT 'Brand'");
+
+DROP PROCEDURE phase1_add_column;