数据库【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)）