【交易】快递发货

> 省略 creator/create_time/updater/update_time/deleted/tenant_id 等通用字段
> CREATE TABLE `trade_delivery_express` (
 `id` bigint NOT NULL AUTO_INCREMENT COMMENT '编号',
 `code` varchar(64) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '快递公司编码',
 `name` varchar(64) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '快递公司名称',
 `logo` varchar(256) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '快递公司 logo',
 `sort` int NOT NULL DEFAULT '0' COMMENT '排序',
 `status` tinyint NOT NULL DEFAULT '0' COMMENT '状态',
 PRIMARY KEY (`id`) USING BTREE
) ENGINE=InnoDB AUTO_INCREMENT=5 DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='快递公司';

### 1.2 管理后台
对应 [商城系统 -> 订单中心 -> 配送管理 -> 快递发货 -> 快递公司] 菜单，对应 dtpc-ui-admin-vue3 项目的 views/mall/trade/delivery/express 目录。如下图所示：

![](/media/202408/2024-08-28_163301_516065.png)

### 1.3 物流信息
由 dtpc-module-trade-biz 后端模块的 ExpressClient 实现，已对接快递鸟、快递 100 等快递查询接口。

## 2. 快递运费模板
### 2.1 表结构
运费模版，由 dtpc-module-trade-biz 后端模块的 delivery 包的 DeliveryExpressTemplateService 实现，包括一个主表 + 两个子表：

![](/media/202408/2024-08-28_163344_186839.png)

2.1.1 运费模版表
> 省略 creator/create_time/updater/update_time/deleted/tenant_id 等通用
> CREATE TABLE `trade_delivery_express_template` (
 `id` bigint NOT NULL AUTO_INCREMENT COMMENT '编号',
 `name` varchar(64) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '模板名称',
 `charge_mode` tinyint NOT NULL COMMENT '配送计费方式',
 `sort` int NOT NULL DEFAULT '0' COMMENT '排序',
 PRIMARY KEY (`id`) USING BTREE
) ENGINE=InnoDB AUTO_INCREMENT=5 DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='快递运费模板';

比较简单，关键信息都在两个子表中。
唯一需要注意的是，charge_mode 字段，表示配送计费方式，由 DeliveryExpressChargeModeEnum 枚举，有三种：按件、按重量、按体积。

### 2.1.2 运费模板【计费】配置表
> CREATE TABLE `trade_delivery_express_template_charge` (
 `id` bigint NOT NULL AUTO_INCREMENT COMMENT '编号，自增',
 `template_id` bigint NOT NULL COMMENT '快递运费模板编号',
 `charge_mode` tinyint NOT NULL COMMENT '配送计费方式',
 `area_ids` text CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '配送区域 id',
 `start_count` double NOT NULL COMMENT '首件数量',
 `start_price` int NOT NULL COMMENT '起步价，单位：分',
 `extra_count` double NOT NULL COMMENT '续件数量',
 `extra_price` int NOT NULL COMMENT '额外价，单位：分',
 PRIMARY KEY (`id`) USING BTREE
) ENGINE=InnoDB AUTO_INCREMENT=15 DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='快递运费模板计费配置';

① template_id 字段：关联 trade_delivery_express_template 表的 id 字段，表示该计费配置属于哪个运费模版。而 charge_mode 字段，只是进行冗余存储，减少查询次数。

② area_ids 字段：配送区域 id 数组，存储的区级别。如下图所示：

![](/media/202408/2024-08-28_163446_053131.png)
③ start_count、start_price、extra_count、extra_price 字段：配送计费的具体配置。

### 2.1.3 运费模板【包邮】配置
### 2.2 管理后台
对应 [商城系统 -> 交易系统 -> 快递发货 -> 快递发货 -> 运费模版] 菜单，对应 dtpc-ui-admin-vue3 项目的 views/mall/trade/delivery/expressTemplate 目录。如下图所示：

![](/media/202408/2024-08-28_163541_058767.png)

### 2.3 运费计算
由 yudao-module-trade-biz 后端模块的 TradeDeliveryPriceCalculator 实现订单的运费计算。

### 3. 配送配置

![](/media/202408/2024-08-28_163609_740632.png)
- SQL 对应 trade_config 表的 delivery_ 开头的字段。
- 前端对应 yudao-ui-admin-vue3 项目的 views/mall/trade/config/index.vue 目录
- 后端对应 yudao-module-trade-biz 项目的 TradeConfigController 类

## 1. 快递公司
### 1.1 表结构
快递公司，由 dtpc-module-trade-biz 后端模块的 delivery 包的 DeliveryExpressService 实现，只有一个表：