# 数据库【db_quote】文档

# 物流报价系统数据库说明文档

## 1. 系统概述

本数据库设计用于物流报价系统，支持采购商发起物流询价、供应商报价、订单管理等功能。系统包含用户管理、订单处理、物流运输、报价管理等核心模块。

## 2. 用户体系

### 2.1 t\_user\_buyer（采购商表）

**功能**：存储采购商基本信息

- `id`：主键，采购商ID
- `name`：联系人姓名
- `company`：公司名称
- `address`：公司地址
- `contact`：联系方式
- `mobile`：手机号码
- `token`：登录令牌（唯一）
- `tokentime`：令牌有效期
- `createtime`：创建时间

### 2.2 t\_user\_supplier（供应商表）

**功能**：存储供应商信息，与采购商关联

- `id`：主键，供应商ID
- `buyerid`：所属采购商ID
- `name`：供应商名称（同一采购商下唯一）
- `address`：供应商地址
- `contact`：联系人
- `mobile`：联系电话
- `token`：登录令牌（唯一）
- `password`：登录密码
- `disabled`：禁用状态
- `tokentime`：令牌有效期
- `createtime`：创建时间

### 2.3 t\_supply\_relationship（供应关系表）

**功能**：记录采购商与供应商的关联关系

- `buyerid`：采购商ID
- `supplierid`：供应商ID
- 联合主键：`(buyerid, supplierid)`

## 3. 订单管理模块

### 3.1 t\_order（订单主表）

**功能**：存储询价订单的核心信息

- **订单状态**：
    
    
    - 1：等待询价
    - 2：等待拼团
    - 3：等待报价
    - 4：已产生报价
    - 5：结束
- **报价类型**：
    
    
    - 0：单个报价
    - 2：批量报价
    - 3：地址报价
- **关键字段**：
    
    
    - `isgroupbuy`：是否拼团订单
    - `isbidding`：是否竞标模式
    - `weight/volume`：重量/体积
    - `days`：要求时效天数
    - `transchannel`：选择的运输渠道
    - `pricetime`：报价截止时间
    - `closetime`：订单关闭时间

### 3.2 t\_order\_supplier（订单供应商关系表）

**功能**：记录订单关联的供应商及其状态

- `status`：
    
    
    - 1：等待报价
    - 4：已提交报价
    - 5：已接受报价
- `base`：基础报价金额
- `opttime`：最后操作时间

### 3.3 t\_purchase\_order\_entry（采购订单明细表）

**功能**：存储订单中的具体商品信息

- `materialid`：物料ID
- `itemprice`：商品单价
- `orderprice`：订单价格
- `sku`：商品SKU
- `name`：商品名称
- `warehousename`：仓库名称
- `suppliername`：供应商名称
- `length/width/height/weight`：商品尺寸重量

## 4. 物流运输模块

### 4.1 t\_shipment（物流单表）

**功能**：管理物流运输单信息

- **状态**：`status`字段（具体含义需查看业务代码）
- **关键字段**：
    
    
    - `destination`：目的地
    - `area`：区域
    - `isfar`：是否偏远地区
    - `buyername/company/othername`：采购商信息
    - `groupname`：分组名称
    - `warehousename`：发货仓库
    - `country`：国家
    - `weight/volume`：总重量/体积
    - `num`：总件数
    - `remark`：询价备注

### 4.2 t\_shipment\_item（物流单商品明细表）

**功能**：记录物流单中的商品明细

- 联合主键：`(shipmentid, id)`
- 唯一约束：`(shipmentid, sku)`，确保同一物流单中SKU不重复
- 支持中英文商品名称：`name`和`ename`

### 4.3 t\_shipment\_box（物流箱信息表）

**功能**：记录物流包装箱信息

- `boxid`：包装箱ID（UUID格式）
- `shipmentid`：关联的物流单ID
- `length/width/height`：箱子尺寸
- `unit`：尺寸单位
- `weight`：箱子重量
- `wunit`：重量单位
- `operator`：操作人员ID

### 4.4 t\_shipment\_destination\_address（目的地地址表）

**功能**：存储标准化的目的地地址信息

- `code`：地址编码（13位，主键）
- `destinationType`：地址类型
- 包含完整的地址信息：街道、城市、省份、国家、邮编等
- 支持国际地址：`countryCode`（国家代码）、`stateOrProvinceCode`（省份代码）

### 4.5 t\_shipment\_summary（物流汇总表）

**功能**：按订单和目的地类型汇总物流信息

- 联合主键：`(orderid, destinationType, code)`
- `calweight`：计算重量
- `shipnum`：已发货数量
- `shipmentList`：物流单列表（JSON格式）

## 5. 运输渠道管理

### 5.1 t\_shipment\_transchannel（采购商运输渠道表）

**功能**：采购商自定义的运输渠道

- `buyerid`：采购商ID
- `name`：渠道名称（同一采购商下唯一）
- `disable`：是否禁用

### 5.2 t\_shipment\_supplier\_transchannel（供应商运输渠道表）

**功能**：供应商为特定采购商设置的运输渠道

- `supplierid`：供应商ID
- `buyerid`：采购商ID
- `channelid`：渠道ID
- `name`：渠道名称（同一供应商下唯一）
- `disable`：是否禁用

## 6. 报价管理模块

### 6.1 t\_supplier\_quotation\_price（供应商报价表）

**功能**：存储供应商的详细报价信息

- **唯一约束**：`(orderid, supplierid, shipmentid, destination)`，防止重复报价
- **报价组成**：
    
    
    - `base`：基础费用
    - `unitprice`：单价
    - `tax`：税费
    - `otherfee`：其他费用
    - `shipfee`：运输费
    - `totalfee`：总费用
- **状态控制**：
    
    
    - `confirm`：是否确认
    - `disabled`：是否禁用
- `pricetime`：报价时间
- `remark`：报价备注

### 6.2 t\_order\_shipment（订单物流单关联表）

**功能**：建立订单与物流单的多对多关系

- 联合主键：`(orderid, shipmentid)`

## 7. 阿里巴巴采购集成模块

### 7.1 t\_purchase\_alibaba\_order（阿里巴巴采购订单表）

**功能**：同步阿里巴巴平台的采购订单

- `formid`：阿里订单表单ID
- `sellerID/buyerID`：阿里卖家和买家ID
- `sysbuyerid`：系统采购商ID
- `remark`：订单备注

### 7.2 t\_purchase\_alibaba\_order\_item（阿里订单商品表）

**功能**：存储阿里订单的商品明细

- `skuID/productID`：阿里商品ID
- `productCargoNumber`：货号
- `status/statusStr`：商品状态

### 7.3 t\_purchase\_alibaba\_receiver（阿里收货人信息表）

**功能**：存储阿里订单的收货地址

- 包含完整的收货地址信息：省市区、详细地址、联系人、电话、邮编

### 7.4 t\_purchase\_alibaba\_buyer/seller（阿里买家/卖家信息表）

**功能**：存储阿里巴巴平台的买家和卖家信息

- `buyerLoginId/sellerLoginId`：阿里登录ID
- `shopName`：店铺名称
- `companyName`：公司名称

### 7.5 t\_purchase\_quote\_form（采购报价单表）

**功能**：采购报价单信息

- `weight`：总重量
- `boxnum`：箱数
- `number`：报价单号

## 8. 序列号管理

### 8.1 t\_erp\_serial\_num（序列号管理表）

**功能**：生成和管理各种业务单据的序列号

- **唯一约束**：`(prefix_date, ftype, shopid)`，确保每日每类型每店铺的序列号唯一
- `ftype`：业务类型编码
- `seqno`：当前序列号
- `shopid`：店铺ID
- `prefix_date`：日期前缀

## 9. 关键业务关系

### 9.1 订单流程

1. 采购商创建订单（t\_order）
2. 添加商品明细（t\_purchase\_order\_entry）
3. 关联物流单（t\_order\_shipment）
4. 邀请供应商参与（t\_order\_supplier）
5. 供应商提交报价（t\_supplier\_quotation\_price）
6. 采购商确认报价，订单完成

### 9.2 物流流程

1. 创建物流单（t\_shipment）
2. 添加商品（t\_shipment\_item）
3. 配置包装箱（t\_shipment\_box）
4. 设置目的地地址（t\_shipment\_destination\_address）
5. 生成物流汇总（t\_shipment\_summary）

### 9.3 阿里巴巴集成流程

1. 同步阿里订单（t\_purchase\_alibaba\_order）
2. 解析商品信息（t\_purchase\_alibaba\_order\_item）
3. 获取收货地址（t\_purchase\_alibaba\_receiver）
4. 关联系统用户（t\_purchase\_alibaba\_buyer）

## 10. 索引优化策略

### 10.1 常用查询索引

- **订单查询**：`buyerid + createtime` 组合索引
- **物流单查询**：`buyerid + opttime + status` 组合索引
- **供应商报价查询**：`orderid + supplierid` 组合索引
- **物流单商品查询**：`shipmentid + sku` 唯一索引

### 10.2 唯一性约束

- 用户令牌：确保登录令牌唯一
- 供应商名称：同一采购商下供应商名称唯一
- 运输渠道：同一用户下渠道名称唯一
- 供应商报价：防止对同一订单、物流单、目的地重复报价

## 11. 数据一致性保证

### 11.1 外键关系

- `t_order_supplier.orderid` → `t_order.id`
- `t_shipment_item.shipmentid` → `t_shipment.shipmentid`
- `t_shipment_box.shipmentid` → `t_shipment.shipmentid`
- `t_order_shipment` 关联 `t_order.id` 和 `t_shipment.shipmentid`

### 11.2 业务约束

- 订单状态流转控制
- 报价唯一性约束
- 用户权限隔离（采购商只能看到自己的供应商）

## 12. 扩展性设计

### 12.1 多店铺支持

- `t_erp_serial_num.shopid` 支持多店铺序列号管理
- 用户体系支持多采购商多供应商架构

### 12.2 国际化支持

- 国家代码标准化（ISO 3166）
- 省份代码支持
- 中英文商品名称

### 12.3 渠道扩展

- 支持自定义运输渠道
- 供应商可针对不同采购商设置不同渠道
- 渠道禁用机制

## 13. 性能优化

### 13.1 存储引擎

- 所有表使用InnoDB引擎，支持事务和行级锁
- ROW\_FORMAT=DYNAMIC，优化变长字段存储

### 13.2 数据类型优化

- 金额字段：`decimal(20,6)` 保证精度
- ID字段：`bigint unsigned` 支持大数据量
- 状态字段：`tinyint` 节省存储空间
- 日期字段：合理使用`date`和`datetime`

### 13.3 大字段处理

- `t_shipment_summary.shipmentList` 使用LONGTEXT存储JSON数据
- 备注字段合理设置长度（varchar(500) 或 varchar(1000)）