数据库

分析库结构

数据库【db_amazon】文档
数据库【db_erp】文档
数据库【db_admin】文档
数据库【db_amazon_adv】文档
数据库【db_quote】文档

数据库【db_amazon】文档

一、数据库概述

数据库名称：db_amazon
数据库用途：亚马逊店铺综合管理系统，涵盖商品管理、订单管理、财务结算、库存管理、物流发货、广告监控等核心业务功能。

主要功能模块：

店铺授权管理 - 亚马逊账号授权和站点管理
商品管理 - SKU、ASIN信息、价格监控
订单管理 - 订单处理、发票、客户反馈
库存管理 - FBA/FBM库存监控
财务结算 - 账单结算、费用报表
物流管理 - 发货计划、货件跟踪
运营分析 - 销量分析、利润计算

二、核心表结构说明

1. 授权相关表

`t_amazon_auth` - 亚马逊账号授权表

主键：id
用途：存储亚马逊卖家账号授权信息
关键字段：
  - sellerid: 卖家ID
  - shop_id: 所属店铺ID
  - region: 区域（北美、欧洲等）
  - MWSAuthToken: 卖家授权令牌
  - disable: 是否禁用
  - refresh_token: OAuth刷新令牌

`t_amazon_group` - 店铺分组表

主键：id
用途：店铺分组管理（多账号分组）
关键字段：
  - name: 分组名称
  - shopid: 所属公司ID
  - profitcfgid: 默认利润方案
  - isfinance: 是否为财务账号

`t_amazonseller_market` - 卖家站点关联表

主键：sellerid, marketplace_id
用途：卖家与站点的关联关系
关键字段：
  - sellerid: 卖家ID
  - marketplace_id: 站点ID
  - country: 国家编码
  - amazonauthid: 对应的授权ID

2. 商品管理相关表

`t_product_info` - 商品基本信息表

主键：id
用途：存储商品核心信息
关键字段：
  - asin: 亚马逊标准识别号
  - sku: 卖家SKU
  - marketplaceid: 站点ID
  - name: 产品标题
  - price: 价格
  - parentAsin: 父ASIN（用于变体）
  - isparent: 是否父商品
  - invalid: 是否无效
  - amazonAuthId: 授权ID

`t_product_in_opt` - 商品运营信息表

主键：pid (关联t_product_info.id)
用途：商品运营相关配置
关键字段：
  - msku: 本地ERP系统SKU
  - owner: 运营负责人
  - status: 产品状态（0备货 1维持 2提升...）
  - presales: 手动预估销量
  - profitid: 利润计算方案
  - disable: 是否禁用
  - remark: 备注信息

`t_amz_product_refresh` - 商品刷新记录表

主键：pid
用途：记录商品信息刷新时间
关键字段：
  - detail_refresh_time: 详情刷新时间
  - price_refresh_time: 价格刷新时间
  - catalog_refresh_time: 分类刷新时间
  - notfound: 是否未找到

`t_amz_product_active` - 商品活跃状态表

主键：amazonAuthId, marketplaceid, sku
用途：记录商品活跃状态
关键字段：
  - asin: ASIN
  - openDate: 创建日期
  - price: 当前价格

3. 订单管理相关表

`t_amz_order_main` - 订单主表

主键：amazon_order_id, amazonAuthId
用途：订单基本信息
关键字段：
  - purchase_date: 购买时间
  - order_status: 订单状态
  - fulfillment_channel: 配送渠道（FBA/FBM）
  - sales_channel: 销售渠道
  - order_total: 订单总额
  - hasItem: 是否有商品明细
  - marketplaceId: 站点ID

`t_amz_order_item` - 订单商品明细表

主键：amazon_order_id, orderItemId
用途：订单商品详情
关键字段：
  - sku: 商品SKU
  - title: 商品标题
  - QuantityOrdered: 订购数量
  - QuantityShipped: 发货数量
  - item_price: 商品价格
  - item_tax: 商品税费
  - amazonAuthId: 授权ID
  - marketplaceId: 站点ID

`t_orders_report` - 订单报表表

主键：amazonAuthId, purchase_date, id
用途：订单报表数据（用于分析）
关键字段：
  - order_status: 订单状态
  - fulfillment_channel: 配送渠道
  - sales_channel: 销售渠道
  - quantity: 数量
  - item_price: 价格
  - item_tax: 税费
  - marketplaceId: 站点ID

`t_orders_summary` - 订单汇总表

主键：purchase_date, id
用途：按SKU汇总订单数据
关键字段：
  - amazonAuthId: 授权ID
  - marketplaceid: 站点ID
  - asin: ASIN
  - sku: SKU
  - quantity: 总销量
  - ordersum: 订单数量
  - orderprice: 订单金额

4. 库存管理相关表

`t_inventory_report` - 库存报表

主键：id
用途：每日库存快照
关键字段：
  - sku: SKU
  - byday: 快照日期
  - marketplaceid: 站点ID
  - afn_fulfillable_quantity: FBA可售库存
  - afn_unsellable_quantity: FBA不可售库存
  - afn_reserved_quantity: FBA预留库存
  - mfn_fulfillable_quantity: FBM可售库存
  - amazonAuthId: 授权ID

`t_amz_inventory_health` - 库存健康报告

主键：authid, marketplaceid, sku
用途：亚马逊库存健康报告
关键字段：
  - sales_rank: 销售排名
  - inv_age_0to90days: 0-90天库龄
  - inv_age_91to180days: 91-180天库龄
  - weeks_of_cover_t30: 30天库存周转周数
  - total_quantity: 总库存数量
  - sellable_quantity: 可销售数量
  - unsellable_quantity: 不可售数量

`t_inventory_report_his` - 库存历史表

主键：byday, id
用途：历史库存数据存档
关键字段：同t_inventory_report

5. 财务结算相关表

`t_amz_settlement_report` - 结算报表

主键：amazonAuthId, posted_date, id
用途：详细结算明细
关键字段：
  - settlement_id: 结算ID
  - transaction_type: 交易类型
  - order_id: 订单ID
  - marketplace_name: 站点名称
  - amount_type: 费用类型
  - amount_description: 费用描述
  - amount: 金额
  - currency: 币种
  - sku: SKU

`t_amz_settlement_summary_sku` - SKU结算汇总

主键：amazonAuthId, posted_date, id
用途：按SKU汇总结算数据
关键字段：
  - sku: SKU
  - marketplace_name: 站点名称
  - posted_date: 记账日期
  - order_amount: 订单量
  - sales: 销量
  - principal: 销售额
  - commission: 销售佣金
  - fbafee: FBA费用
  - refund: 退款金额
  - tax: 税费

`t_amz_settlement_summary_sku_month` - SKU月度汇总

主键：posted_date, id
用途：SKU月度数据汇总
关键字段：
  - amazonAuthId: 授权ID
  - sku: 平台SKU
  - msku: 本地SKU
  - groupid: 分组ID
  - posted_date: 月份（日期格式）
  - principal: 销售额
  - profit: 利润
  - profit_local_shipmentfee: 本地运费
  - profit_vat: VAT增值税

`t_amz_fin_account` - 财务账户表

主键：groupid, amazonAuthid
用途：财务账户信息
关键字段：
  - amazonAuthid: 授权ID
  - groupid: 分组ID
  - currency: 币种
  - financial_event_group_start: 财务事件组开始时间
  - financial_event_group_end: 财务事件组结束时间
  - processing_status: 处理状态
  - original_total: 原始总金额

6. 物流管理相关表

`t_erp_ship_inboundplan` - 入库计划表

主键：id
用途：FBA入库计划管理
关键字段：
  - name: 计划名称
  - number: 计划编号
  - amazongroupid: 店铺分组ID
  - marketplaceid: 站点ID
  - warehouseid: 仓库ID
  - auditstatus: 审核状态
  - createtime: 创建时间
  - creator: 创建人

`t_erp_ship_inboundshipment` - 入库货件表

主键：ShipmentId
用途：FBA入库货件详情
关键字段：
  - ShipmentId: 货件ID
  - DestinationFulfillmentCenterId: 目的FC
  - inboundplanid: 计划ID
  - ShipmentStatus: 货件状态
  - status: 系统状态
  - TotalUnits: 总单位数
  - carrier: 承运人
  - boxnum: 箱数
  - shiped_date: 发货日期

`t_erp_ship_inbounditem` - 入库货件商品表

主键：id
用途：货件商品明细
关键字段：
  - ShipmentId: 货件ID
  - SellerSKU: 卖家SKU
  - QuantityShipped: 发货数量
  - QuantityReceived: 接收数量
  - materialid: 物料ID
  - msku: 本地SKU
  - unitcost: 单位成本
  - totalcost: 总成本

`t_erp_ship_v2_inboundplan` - V2版本入库计划

主键：id
用途：新版入库计划管理
关键字段：
  - inbound_pland_id: 亚马逊计划ID
  - name: 计划名称
  - number: 计划编号
  - groupid: 分组ID
  - amazonauthid: 授权ID
  - marketplaceid: 站点ID
  - auditstatus: 审核状态（1已提交 2待配货 3待装箱...）
  - shipping_date: 预计发货日期
  - transtype: 运输方式

7. 运营分析相关表

`t_orders_summary` - 订单汇总（日）

主键：purchase_date, id
用途：每日SKU销量汇总
关键字段：
  - amazonAuthId: 授权ID
  - marketplaceid: 站点ID
  - purchase_date: 日期
  - asin: ASIN
  - sku: SKU
  - quantity: 销量
  - ordersum: 订单数
  - orderprice: 订单金额

`t_orders_summary_month` - 订单汇总（月）

主键：purchase_date, id
用途：月度SKU销量汇总
关键字段：同t_orders_summary

`t_amz_product_sales_plan` - 商品销售计划

主键：id
用途：商品销售预测和补货计划
关键字段：
  - sku: 平台SKU
  - msku: 本地SKU
  - shopid: 店铺ID
  - marketplaceid: 站点ID
  - groupid: 分组ID
  - amazonauthid: 授权ID
  - shipday: 发货周期
  - avgsales: 日均销量
  - needship: 待发货数量
  - needpurchase: 待采购数量

`t_profitcfg` - 利润计算方案

主键：id
用途：利润计算配置方案
关键字段：
  - shop_id: 店铺ID
  - isSystem: 是否系统内置
  - name: 方案名称
  - sales_channel: 销售渠道
  - sellerPlan: 销售计划
  - shipmentStyle: 运费计算方式
  - isDefault: 是否默认方案

`t_profitcfgcountry` - 利润计算国家配置

主键：id
用途：各国利润计算参数
关键字段：
  - profitid: 方案ID
  - country: 国家
  - taxRate: 进口关税费率
  - lostRate: 汇率损耗比率
  - sellerRate: 市场营销占比
  - vat_rate: VAT增值税费率
  - corporate_InRate: 企业所得税率

8. 报表相关表

`t_report_requestrecord` - 报表请求记录

主键：id
用途：存储亚马逊报表请求记录
关键字段：
  - sellerid: 卖家ID
  - marketPlaceId: 站点ID
  - reportType: 报表类型
  - reportId: 报表ID
  - reportRequestId: 报表请求ID
  - startDate: 开始时间
  - endDate: 结束时间
  - report_processing_status: 处理状态
  - isrun: 是否正在运行

`t_fba_storage_fee_report` - FBA仓储费报表

主键：amazonauthid, country, month, asin, fulfillment_center, fnsku
用途：FBA月度仓储费明细
关键字段：
  - asin: ASIN
  - fnsku: FNSKU
  - fulfillment_center: 履约中心
  - country: 国家
  - month: 月份
  - average_quantity_on_hand: 日均库存
  - monthly_storage_fee: 月度仓储费
  - currency: 币种

`t_fba_longterm_storage_fee_report` - 长期仓储费报表

主键：snapshot_date, sku, surcharge_age_tier, country, amazonauthid
用途：长期仓储费明细
关键字段：
  - snapshot_date: 快照日期
  - sku: SKU
  - condition: 商品状况
  - qty_charged_12month: 超过12个月收费数量
  - qty_charged_6month: 超过6个月收费数量
  - amount_charged: 收费金额
  - currency: 币种

9. 其他重要表

`t_erp_shipcycle` - 发货周期配置

主键：id
用途：SKU发货周期配置
关键字段：
  - sku: SKU
  - marketplaceid: 站点ID
  - groupid: 分组ID
  - transtype: 运输类型
  - stockingCycle: 安全库存周期
  - min_cycle: 最小发货周期
  - first_leg_charges: 头程运输成本

`t_erp_estimated_sales` - 预估销量表

主键：id
用途：手动维护日均销量
关键字段：
  - sku: SKU
  - marketplaceid: 站点ID
  - groupid: 分组ID
  - presales: 手动输入日均销量
  - startTime: 开始生效时间
  - endTime: 结束生效时间
  - isInvalid: 是否有效

`t_erp_market_priority` - 站点优先级

主键：marketplaceid, groupid
用途：发货计划中站点优先级配置
关键字段：
  - marketplaceid: 站点ID
  - groupid: 分组ID
  - priority: 优先级（数字越小优先级越高）

`t_exchangerate` - 汇率表

主键：id
用途：汇率信息
关键字段：
  - name: 币种名称
  - price: 汇率
  - symbol: 符号
  - utctime: 更新时间

`t_exchangerate_customer` - 客户自定义汇率

主键：id
用途：客户自定义汇率
关键字段：
  - shopid: 店铺ID
  - name: 币种
  - price: 自定义汇率

`t_holiday` - 节假日表

主键：id
用途：节假日数据
关键字段：
  - shopid: 店铺ID
  - day: 日期
  - name: 节日名称
  - type: 节假日类型（0工作日 1周末 2节日 3调休）
  - week: 星期几

三、数据关系说明

1. 核心业务关系链

店铺授权 (t_amazon_auth)
    ↓
店铺分组 (t_amazon_group)
    ↓
商品信息 (t_product_info)
    ├── 运营信息 (t_product_in_opt)
    ├── 刷新记录 (t_amz_product_refresh)
    ├── 销售计划 (t_amz_product_sales_plan)
    └── 订单汇总 (t_orders_summary)
        ↓
    订单明细 (t_amz_order_item)
        ↓
    结算明细 (t_amz_settlement_report)
        ↓
    SKU汇总 (t_amz_settlement_summary_sku)

2. 物流发货关系链

入库计划 (t_erp_ship_inboundplan / t_erp_ship_v2_inboundplan)
    ↓
入库货件 (t_erp_ship_inboundshipment / t_erp_ship_v2_inboundshipment)
    ↓
货件商品 (t_erp_ship_inbounditem)

3. 财务结算关系链

结算报表 (t_amz_settlement_report)
    ↓
SKU日汇总 (t_amz_settlement_summary_sku)
    ↓
SKU月汇总 (t_amz_settlement_summary_sku_month)

四、索引设计说明

1. 主要索引策略

商品相关索引：

t_product_info: (marketplaceid, amazonAuthId, isparent, invalid, disable) - 商品查询主索引
t_product_info: (asin) - ASIN查询索引
t_product_info: (parentAsin, marketplaceid, amazonAuthId) - 变体查询索引

订单相关索引：

t_amz_order_main: (amazonAuthId, purchase_date, hasItem) - 订单时间范围查询
t_amz_order_item: (amazonAuthId, marketplaceId, purchase_date) - 订单明细时间查询
t_orders_report: (amazonAuthId, purchase_date) - 报表时间查询

库存相关索引：

t_inventory_report: (marketplaceid, amazonAuthId, sku) - 库存SKU查询
t_inventory_report_his: (amazonAuthId, marketplaceid, sku, byday) - 历史库存查询

结算相关索引：

t_amz_settlement_report: (amazonAuthId, posted_date) - 按时间结算查询
t_amz_settlement_summary_sku: (amazonAuthId, posted_date) - SKU汇总时间查询

2. 复合索引设计原则

查询频率：高频查询字段放在前面
字段选择性：高选择性字段（如ID）放在前面
查询模式：按照业务实际查询模式设计
排序需求：需要排序的字段考虑在索引中

五、数据维护说明

1. 数据清理策略

库存历史数据：保留30天
仓储费报表：保留30天
结算报表：保留365天
其他报表：保留3天

2. 数据同步机制

商品刷新：通过事件自动刷新
库存同步：每日自动同步
订单同步：定时抓取
结算同步：定期获取结算报告

3. 性能优化建议

分区策略：对于大表（如订单表）考虑按时间分区
归档策略：定期归档历史数据到历史表
索引维护：定期检查索引使用情况并优化
查询优化：避免全表扫描，使用覆盖索引

六、业务规则说明

1. 商品状态规则

0: 备货
1: 维持
2: 提升
3: 促销
4: 停售
5: 清仓
6: 删除

2. 货件状态规则

-1: 已驳回
0: 取消货件
1: 待审核
2: 配货（已确认货件）
3: 装箱
4: 物流信息确认
5: 已发货
6: 已完成发货

3. 入库计划审核状态

1: 已提交（待审核）
2: 待配货
3: 待装箱
4: 待发货
7: 已发货
11: 已驳回
12: 已取消

七、安全注意事项

1. 敏感数据

授权令牌：t_amazon_auth.MWSAuthToken
刷新令牌：t_amazon_auth.refresh_token
API密钥：t_amazon_auth.access_key_id, t_amazon_auth.secret_key

2. 数据权限

按shopid进行数据隔离
按amazonAuthId进行账号隔离
敏感操作需要记录操作日志

3. 备份策略

每日完整备份
事务日志定期备份
重要表单独备份

八、常见问题排查

1. 数据不同步问题

检查t_amz_product_refresh刷新时间
检查t_report_requestrecord报表状态
检查事件autoRefreshInsert执行情况

2. 性能问题

检查大表的索引使用情况
检查查询是否使用正确索引
检查是否有全表扫描操作

3. 数据一致性问题

检查主从复制状态
检查事务完整性
检查外键约束

文档版本：1.0
更新日期：2024年
适用范围：数据库设计、开发、运维人员

数据库【db_erp】文档

1. 概述

本文档详细描述了db_erp数据库的结构设计，该数据库服务于企业资源计划（ERP）系统，涵盖采购、库存、销售、财务管理等核心业务模块。

2. 数据库核心表结构

2.1 基础维度表

`t_dimensions` 尺寸规格表

字段	类型	说明
id	bigint unsigned	主键ID
length	decimal(15,2)	长度
length_units	char(15)	长度单位
width	decimal(15,2)	宽度
width_units	char(15)	宽度单位
height	decimal(15,2)	高度
height_units	char(15)	高度单位
weight	decimal(15,2)	重量
weight_units	char(15)	重量单位

2.2 产品物料管理

`t_erp_material` 产品物料主表

核心字段说明：

sku - 产品SKU编码
name - 产品名称
shopid - 所属店铺/公司
groupid - 店铺分组
categoryid - 产品分类
issfg - 产品类型：0单独成品/1组装成品/2半成品
supplier - 供应商
price - 采购单价
price_wavg - 加权平均价

`t_erp_assembly` 产品组装关系表

记录成品与子产品的组装关系

`t_erp_material_consumable` 耗材表

记录产品的耗材使用关系

2.3 库存管理

`t_erp_inventory` 库存实时表

实时记录各仓库物料库存状态

`t_erp_inventory_his` 库存历史表

按天记录库存历史变化

`t_erp_inventory_record` 库存操作记录表

详细记录所有库存变动操作

2.4 采购管理

`t_erp_purchase_form` 采购订单主表

记录采购订单基本信息

`t_erp_purchase_form_entry` 采购订单明细表

记录具体采购物料明细

`t_erp_purchase_plan` 采购计划表

记录采购计划信息

2.5 仓库管理

`t_erp_warehouse` 仓库主表

ftype - 仓库类型
flevel - 仓库级别
parentid - 上级仓库ID
country - 所在国家
groupid - 所属店铺分组

`t_erp_warehouse_shelf` 货架表

管理仓库内的货架存储单元

2.6 销售订单管理

`t_erp_order` 销售订单表

记录销售订单信息

`t_erp_order_summary` 订单汇总表

按日汇总销售数据

2.7 财务管理

`t_erp_fin_account` 账户表

记录资金账户信息

`t_erp_fin_journalaccount` 流水账表

记录资金流水明细

`t_erp_fin_project` 财务项目分类表

2.8 供应商/客户管理

`t_erp_customer` 客户表

记录客户信息

2.9 单据管理

各类表单表：

t_erp_inwh_form - 入库单
t_erp_outwh_form - 出库单
t_erp_dispatch_form - 调拨单
t_erp_assembly_form - 组装单

2.10 系统配置表

`t_erp_formtype` 单据类型表

定义系统各类单据类型

`t_parameterconfig` 参数配置表

存储系统配置参数

3. 关键业务关系

3.1 库存状态流转

inbound（待收货） → fulfillable（可用） → outbound（待发运）

3.2 采购流程

采购计划 → 采购订单 → 入库验收 → 付款结算

3.3 销售发货流程

销售订单 → 出库单 → 物流发货

4. 主要索引说明

4.1 产品表索引

skurepeat - SKU+店铺唯一约束
shop_delete_sku_color - 常用查询组合索引

4.2 库存表索引

index_w_s_m_s - 仓库+物料+店铺+状态唯一索引
shopid_opttime - 按时间查询优化

4.3 订单表索引

purchase_date - 按购买日期查询

5. 数据结构特点

5.1 ID设计

使用bigint unsigned作为主键类型
保留oldid字段用于兼容旧系统ID

5.2 状态管理

使用明确的status字段管理单据状态
审计状态字段（auditstatus）统一管理审批流程

5.3 审计字段

每张表包含以下审计字段：

operator - 操作人
opttime - 操作时间
creator - 创建人
createdate - 创建时间

5.4 店铺隔离

shopid字段实现多店铺数据隔离
联合索引确保店铺内数据唯一性

6. 技术规格

6.1 字符集和排序规则

使用utf8mb4字符集
utf8mb4_bin排序规则，区分大小写

6.2 存储引擎

主要使用InnoDB存储引擎
ROW_FORMAT=DYNAMIC优化存储

6.3 数据类型选择

金额字段：decimal(10,2) ~ decimal(20,6)
数量字段：int类型
状态字段：char类型

7. 维护建议

7.1 定期维护

清理历史表数据
优化索引统计信息
监控大表增长情况

7.2 性能优化

重点关注库存操作记录表
优化联合查询性能
合理分区大表

8. 版本说明

8.1 版本兼容

V2/V3表结构支持新功能
保留oldid支持旧数据迁移

8.2 扩展性设计

预留扩展字段
支持模块化功能扩展
考虑国际化支持

9. 安全注意事项

9.1 数据权限

通过shopid实现店铺隔离
操作日志记录完整审计轨迹

9.2 备份策略

重要业务表需要定期备份
交易类数据保留时间应符合法规要求

文档最后更新：2026年1月8日

数据库【db_admin】文档

1. 数据库概述

数据库名称: db_admin
服务器版本: MySQL 8.0.36
字符集: utf8mb4
排序规则: utf8mb4_bin
用途: Wimoor 电商管理系统后台数据库，包含用户管理、权限控制、店铺管理、订阅管理等功能

2. 主要功能模块

2.1 权限管理系统

核心表: t_authority, t_role, t_role_authority, t_user_role, t_permission
功能: 基于角色的权限控制(RBAC)，支持菜单权限、操作权限等

2.2 菜单管理系统

核心表: t_menu, t_menu_group, t_sys_menu, t_role_menu, t_sys_role_menu
功能: 多级菜单管理，支持菜单收藏、权限分配

2.3 用户管理系统

核心表: t_user, t_userinfo, t_user_role, t_user_shop
功能: 用户账户管理、个人信息、角色分配、店铺绑定

2.4 店铺管理系统

核心表: t_shop, t_manager_limit, t_user_shop
功能: 店铺基本信息、权限限制、用户绑定

2.5 套餐订阅系统

核心表:
- t_sys_tariff_packages - 套餐定义
- t_manager_limit - 店铺限制配置
- t_sys_customer_order - 客户订单
- t_sys_customer_discount - 折扣管理
功能: 套餐管理、订单处理、折扣优惠

2.6 通知系统

核心表: t_sys_notify, t_sys_usernotify, t_sys_message_template
功能: 系统通知、消息推送、用户订阅

2.7 标签系统

核心表: t_sys_tags, t_sys_tags_groups, t_sys_role_tag
功能: 标签管理、分组、权限分配

2.8 应用商店系统

核心表:
- t_sys_app_store_group - 应用分组
- t_sys_app_store_company - 服务商信息
- t_sys_app_store_detail - 服务详情
功能: 应用服务展示、服务商管理

2.9 工具模块

核心表:
- t_sys_tool_deepseek_chat_* - AI聊天功能
- t_sys_tool_notepad - 记事本
- t_sys_tool_large_file - 大文件管理
功能: 内置工具集

2.10 系统管理

核心表:
- t_sys_operationlog - 操作日志
- t_sys_importrecord - 导入记录
- t_sys_dict - 字典管理
- t_sys_quartz_task - 定时任务
功能: 系统监控、日志记录、配置管理

3. 重要表结构说明

3.1 用户相关表

-- t_user: 用户主表
-- 包含账户信息、密码、状态、上级关系等
-- 支持Google验证、微信绑定等

-- t_userinfo: 用户详细信息
-- 包含姓名、性别、联系方式等

3.2 权限相关表

-- t_role: 角色定义
-- 支持系统角色和自定义角色

-- t_authority: 操作权限定义
-- URL级别的权限控制

-- t_permission: 权限项管理
-- 按钮级别的权限控制

3.3 店铺限制表 (`t_manager_limit`)

-- 关键字段说明:
-- maxShopCount: 最大店铺数
-- maxProductCount: 最大商品数
-- maxOrderCount: 最大订单处理数
-- maxMember: 最大子用户数
-- tariffpackage: 套餐类型(0-基础版,1-标准版,2-专业版,3-独享版,4-自定义)
-- losingEffect: 失效时间

3.4 订单和发票表

-- t_sys_customer_order: 客户订单
-- 支持套餐购买、附加包购买

-- t_sys_customer_invoice: 发票信息
-- 支持普票、专票等类型

4. 数据字典说明

4.1 套餐类型 (tariffpackage)

值	名称	说明
0	基础版	基础功能套餐
1	标准版	标准功能套餐
2	专业版	专业功能套餐
3	独享版	独享服务套餐
4	自定义	自定义套餐

4.2 订单类型 (ftype)

值	说明
package	套餐订单
append	附加包订单

4.3 发票类型 (ivctype)

值	说明
normal	普通发票
special	专用发票

5. 业务逻辑说明

5.1 用户权限流程

用户登录 → 验证账户状态
查询用户角色 → 获取权限集合
加载菜单权限 → 显示可用菜单
操作时检查权限 → 验证操作权限

5.2 套餐订阅流程

选择套餐 → 生成订单
支付订单 → 更新支付状态
应用套餐 → 更新店铺限制
失效处理 → 自动降级或提醒续费

5.3 店铺限制检查

创建店铺时检查店铺数量限制
添加商品时检查商品数量限制
添加子用户时检查用户数量限制
开启广告时检查广告组限制

6. 索引优化建议

6.1 建议添加的索引

-- t_sys_operationlog 表
CREATE INDEX idx_oplog_user_time ON t_sys_operationlog(userid, time);

-- t_sys_customer_order 表
CREATE INDEX idx_order_shop_status ON t_sys_customer_order(shopid, paystatus);

-- t_manager_limit 表
CREATE INDEX idx_limit_shop_status ON t_manager_limit(shopId, losingEffect);

6.2 现有索引分析

大部分表已有主键索引
关联查询字段多数已建索引
时间范围查询建议添加复合索引

7. 数据维护建议

7.1 定期清理

操作日志按时间归档
过期通知清理
临时文件清理

7.2 备份策略

每日全量备份
事务日志实时备份
重要表单独备份

8. 安全注意事项

8.1 敏感数据

用户密码使用盐值加密
支付信息加密存储
密钥信息单独管理

8.2 访问控制

数据库访问权限分级
生产环境最小权限原则
操作审计日志记录

9. 扩展性考虑

9.1 分表策略

操作日志按时间分表
订单数据按店铺分表
通知消息按用户分表

9.2 读写分离

主库：写操作、重要查询
从库：读操作、报表查询

10. 常见问题处理

10.1 性能问题

大表查询优化
索引失效处理
连接池配置优化

10.2 数据一致性问题

事务使用规范
异常处理机制
数据修复流程

文档版本: V1.0
更新日期: 2024年
适用版本: MySQL 8.0+
备注: 本文档基于提供的数据库结构分析，实际使用时请结合具体业务需求调整。

数据库【db_amazon_adv】文档

一、数据库概述

1.1 基本信息

数据库名称: db_amazon_adv
服务器版本: 8.0.36
服务器操作系统: Linux
字符集: utf8mb4
排序规则: utf8mb4_bin

1.2 数据库用途

这是一个亚马逊广告管理系统的数据库，主要用于：

存储亚马逊广告相关的数据（SP、SD、HSA广告）
管理广告活动、广告组、关键词、产品定位等广告实体
存储广告报告数据和性能指标
管理广告账户授权和配置
支持广告警告和提醒功能
数据同步和清理维护

二、事件（EVENTS）

2.1 `db_timeout_process_kill`

调度规则: 每天执行一次，起始时间：2024-06-14 16:44:41
功能:

杀死运行时间超过20秒的SELECT查询
从 db_plum.t_amazon_group 同步数据到 t_amazon_group

2.2 `delete_long_data`

调度规则: 每天执行一次，起始时间：2024-06-14 16:45:01
功能: 清理历史数据

删除65天前的广告报告请求数据（SP广告保留8天）
删除2天前的快照数据
删除7天前的汇总数据

2.3 `groupSync`

调度规则: 每分钟执行一次，起始时间：2025-02-17 11:22:13
功能: 从 db_amazon.t_amazon_group 同步群组数据到 db_amazon_adv.t_amazon_group

2.4 `syncData`

调度规则: 每天执行一次，起始时间：2024-06-14 16:45:40
功能:

更新未使用的广告授权状态
同步群组、汇率数据

三、数据表结构

3.1 广告实体表

3.1.1 广告活动相关

t_amz_adv_campaigns: SP广告活动表
t_amz_adv_campaigns_hsa: HSA广告活动表
t_amz_adv_campaigns_sd: SD广告活动表

3.1.2 广告组相关

t_amz_adv_adgroups: SP广告组表
t_amz_adv_adgroups_hsa: HSA广告组表
t_amz_adv_adgroups_sd: SD广告组表

3.1.3 关键词相关

t_amz_adv_keywords: SP关键词表
t_amz_adv_keywords_hsa: HSA关键词表
t_amz_adv_keywords_negativa: 否定关键词表

3.1.4 产品广告相关

t_amz_adv_productads: SP产品广告表
t_amz_adv_productads_sd: SD产品广告表
t_amz_adv_product_targe: 产品定位表

3.2 广告报告表

3.2.1 SP广告报告

t_amz_adv_rpt2_sp_compaigns: 广告活动报告
t_amz_adv_rpt2_sp_adgroups: 广告组报告
t_amz_adv_rpt2_sp_keywords: 关键词报告
t_amz_adv_rpt2_sp_productads: 产品广告报告

3.2.2 SD广告报告

t_amz_adv_rpt2_sd_campaigns: SD广告活动报告
t_amz_adv_rpt2_sd_adgroups: SD广告组报告
t_amz_adv_rpt2_sd_product_targets: SD产品定位报告

3.2.3 HSA广告报告

t_amz_adv_rpt2_hsa_campaigns: HSA广告活动报告
t_amz_adv_rpt2_hsa_adgroups: HSA广告组报告
t_amz_adv_rpt2_hsa_keywords: HSA关键词报告

3.3 基础配置表

3.3.1 授权和账户

t_amz_adv_auth: 广告授权表
t_amz_adv_profile: 广告账户配置表
t_amz_advert_invoices: 广告发票表

3.3.2 广告物料

t_amz_adv_assets: 广告素材表
t_amz_adv_brand: 品牌表
t_amz_adv_media_hsa: HSA媒体表

3.4 业务管理表

3.4.1 警告和提醒

t_advert_warning_keywords_data: 关键词警告数据
t_advert_warning_product_data: 产品警告数据
t_amz_adv_remind: 广告提醒表

3.4.2 定时任务

t_amz_adv_schedule_plan: 广告定时计划
t_amz_adv_schedule_plandata: 计划数据
t_amz_adv_schedule_planitem: 计划项

3.5 系统管理表

3.5.1 运营管理

t_amz_adv_operate_log: 操作日志表
t_amz_adv_remark: 广告备注表
t_amz_adv_serch_history: 搜索历史

3.5.2 数据同步

t_amazon_group: 亚马逊群组表
t_amz_adv_group: 广告群组表
t_exchangerate: 汇率表

3.6 报表和快照

3.6.1 报告管理

t_amz_adv_report_request: 报告请求表
t_amz_adv_report_request_type: 报告类型配置
t_amz_adv_snapshot: 快照表

3.6.2 数据汇总

t_amz_advert_report_summary: 广告报告汇总
t_amz_adv_sumalltype: 类型汇总统计
t_amz_adv_sumpdtads: 产品广告汇总

四、关键业务逻辑

4.1 广告类型说明

SP: 商品推广广告
SD: 展示型广告
HSA: 品牌推广广告

4.2 数据保留策略

报告数据: 根据事件 delete_long_data 的清理规则
- SP广告报告保留8天
- 其他广告报告保留65天
- 快照数据保留2天
- 汇总数据保留7天
数据同步: 通过定时事件同步群组和汇率数据

4.3 性能优化

长查询处理: 通过 db_timeout_process_kill 事件自动终止长时间运行的SELECT查询
索引策略: 所有主表都有合理的索引配置
分区策略: 部分报告表按日期分区

五、表关系说明

5.1 核心关系链

t_amz_adv_auth (授权)
    ↓
t_amz_adv_profile (账户配置)
    ↓
t_amz_adv_campaigns (广告活动)
    ↓
t_amz_adv_adgroups (广告组)
    ↓
t_amz_adv_keywords / t_amz_adv_productads (关键词/产品广告)

5.2 报告数据流

t_amz_adv_report_request (请求报告)
    ↓
t_amz_adv_snapshot (生成快照)
    ↓
t_amz_adv_rpt2_* (存储报告数据)
    ↓
t_amz_advert_report_summary (汇总统计)

六、维护建议

6.1 监控建议

监控事件执行状态
监控长查询数量
监控磁盘空间使用情况
监控数据同步延迟

6.2 备份策略

业务数据每天备份
配置数据变更时立即备份
报告数据可根据业务重要性制定备份策略

6.3 性能优化

定期分析慢查询日志
监控索引使用效率
根据业务增长调整事件调度频率

七、注意事项

7.1 数据一致性

广告授权状态与账户配置需保持同步
群组数据需通过事件同步，避免直接修改
汇率数据需定期更新

7.2 业务限制

广告报告数据有保留期限，业务查询需注意时间范围
定时任务的状态管理需要监控
警告规则的配置需要合理设置阈值

7.3 扩展性考虑

新增广告类型时需要扩展相应的表结构
报告类型增加时需要更新配置表
业务量增长时需要考虑分库分表策略

文档版本: 1.0
*最后更新: 2024-06-14*

数据库【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 订单流程

采购商创建订单（t_order）
添加商品明细（t_purchase_order_entry）
关联物流单（t_order_shipment）
邀请供应商参与（t_order_supplier）
供应商提交报价（t_supplier_quotation_price）
采购商确认报价，订单完成

9.2 物流流程

创建物流单（t_shipment）
添加商品（t_shipment_item）
配置包装箱（t_shipment_box）
设置目的地地址（t_shipment_destination_address）
生成物流汇总（t_shipment_summary）

9.3 阿里巴巴集成流程

同步阿里订单（t_purchase_alibaba_order）
解析商品信息（t_purchase_alibaba_order_item）
获取收货地址（t_purchase_alibaba_receiver）
关联系统用户（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)）

数据库

数据库【db_amazon】文档

一、数据库概述

主要功能模块：

二、核心表结构说明

1. 授权相关表

t_amazon_auth - 亚马逊账号授权表

t_amazon_group - 店铺分组表

t_amazonseller_market - 卖家站点关联表

2. 商品管理相关表

t_product_info - 商品基本信息表

t_product_in_opt - 商品运营信息表

t_amz_product_refresh - 商品刷新记录表

t_amz_product_active - 商品活跃状态表

3. 订单管理相关表

t_amz_order_main - 订单主表

t_amz_order_item - 订单商品明细表

t_orders_report - 订单报表表

t_orders_summary - 订单汇总表

4. 库存管理相关表

t_inventory_report - 库存报表

t_amz_inventory_health - 库存健康报告

t_inventory_report_his - 库存历史表

5. 财务结算相关表

t_amz_settlement_report - 结算报表

t_amz_settlement_summary_sku - SKU结算汇总

t_amz_settlement_summary_sku_month - SKU月度汇总

t_amz_fin_account - 财务账户表

6. 物流管理相关表

t_erp_ship_inboundplan - 入库计划表

t_erp_ship_inboundshipment - 入库货件表

t_erp_ship_inbounditem - 入库货件商品表

t_erp_ship_v2_inboundplan - V2版本入库计划

7. 运营分析相关表

t_orders_summary - 订单汇总（日）

t_orders_summary_month - 订单汇总（月）

t_amz_product_sales_plan - 商品销售计划

t_profitcfg - 利润计算方案

t_profitcfgcountry - 利润计算国家配置

8. 报表相关表

t_report_requestrecord - 报表请求记录

t_fba_storage_fee_report - FBA仓储费报表

t_fba_longterm_storage_fee_report - 长期仓储费报表

9. 其他重要表

t_erp_shipcycle - 发货周期配置

t_erp_estimated_sales - 预估销量表

t_erp_market_priority - 站点优先级

t_exchangerate - 汇率表

t_exchangerate_customer - 客户自定义汇率

t_holiday - 节假日表

三、数据关系说明

1. 核心业务关系链

2. 物流发货关系链

3. 财务结算关系链

四、索引设计说明

1. 主要索引策略

2. 复合索引设计原则

五、数据维护说明

1. 数据清理策略

2. 数据同步机制

3. 性能优化建议

六、业务规则说明

1. 商品状态规则

2. 货件状态规则

3. 入库计划审核状态

七、安全注意事项

1. 敏感数据

2. 数据权限

3. 备份策略

八、常见问题排查

1. 数据不同步问题

2. 性能问题

3. 数据一致性问题

数据库【db_erp】文档

1. 概述

2. 数据库核心表结构

2.1 基础维度表

t_dimensions 尺寸规格表

2.2 产品物料管理

t_erp_material 产品物料主表

`t_amazon_auth` - 亚马逊账号授权表

`t_amazon_group` - 店铺分组表

`t_amazonseller_market` - 卖家站点关联表

`t_product_info` - 商品基本信息表

`t_product_in_opt` - 商品运营信息表

`t_amz_product_refresh` - 商品刷新记录表

`t_amz_product_active` - 商品活跃状态表

`t_amz_order_main` - 订单主表

`t_amz_order_item` - 订单商品明细表

`t_orders_report` - 订单报表表

`t_orders_summary` - 订单汇总表

`t_inventory_report` - 库存报表

`t_amz_inventory_health` - 库存健康报告

`t_inventory_report_his` - 库存历史表

`t_amz_settlement_report` - 结算报表

`t_amz_settlement_summary_sku` - SKU结算汇总

`t_amz_settlement_summary_sku_month` - SKU月度汇总

`t_amz_fin_account` - 财务账户表

`t_erp_ship_inboundplan` - 入库计划表

`t_erp_ship_inboundshipment` - 入库货件表

`t_erp_ship_inbounditem` - 入库货件商品表

`t_erp_ship_v2_inboundplan` - V2版本入库计划

`t_orders_summary` - 订单汇总（日）

`t_orders_summary_month` - 订单汇总（月）

`t_amz_product_sales_plan` - 商品销售计划

`t_profitcfg` - 利润计算方案

`t_profitcfgcountry` - 利润计算国家配置

`t_report_requestrecord` - 报表请求记录

`t_fba_storage_fee_report` - FBA仓储费报表

`t_fba_longterm_storage_fee_report` - 长期仓储费报表

`t_erp_shipcycle` - 发货周期配置

`t_erp_estimated_sales` - 预估销量表

`t_erp_market_priority` - 站点优先级

`t_exchangerate` - 汇率表

`t_exchangerate_customer` - 客户自定义汇率

`t_holiday` - 节假日表

`t_dimensions` 尺寸规格表

`t_erp_material` 产品物料主表

`t_erp_assembly` 产品组装关系表

`t_erp_material_consumable` 耗材表

`t_erp_inventory` 库存实时表

`t_erp_inventory_his` 库存历史表

`t_erp_inventory_record` 库存操作记录表

`t_erp_purchase_form` 采购订单主表

`t_erp_purchase_form_entry` 采购订单明细表

`t_erp_purchase_plan` 采购计划表

`t_erp_warehouse` 仓库主表

`t_erp_warehouse_shelf` 货架表

`t_erp_order` 销售订单表

`t_erp_order_summary` 订单汇总表

`t_erp_fin_account` 账户表

`t_erp_fin_journalaccount` 流水账表

`t_erp_fin_project` 财务项目分类表

`t_erp_customer` 客户表

`t_erp_formtype` 单据类型表

`t_parameterconfig` 参数配置表