# 数据库 分析库结构 # 数据库【db_amazon】文档 ## 一、数据库概述 **数据库名称**：`db_amazon` **数据库用途**：亚马逊店铺综合管理系统，涵盖商品管理、订单管理、财务结算、库存管理、物流发货、广告监控等核心业务功能。 ### 主要功能模块： 1. **店铺授权管理** - 亚马逊账号授权和站点管理 2. **商品管理** - SKU、ASIN信息、价格监控 3. **订单管理** - 订单处理、发票、客户反馈 4. **库存管理** - FBA/FBM库存监控 5. **财务结算** - 账单结算、费用报表 6. **物流管理** - 发货计划、货件跟踪 7. **运营分析** - 销量分析、利润计算 ## 二、核心表结构说明 ### 1. 授权相关表 #### `t_amazon_auth` - 亚马逊账号授权表
sql
``` 主键：id 用途：存储亚马逊卖家账号授权信息 关键字段： - sellerid: 卖家ID - shop_id: 所属店铺ID - region: 区域（北美、欧洲等） - MWSAuthToken: 卖家授权令牌 - disable: 是否禁用 - refresh_token: OAuth刷新令牌 ``` #### `t_amazon_group` - 店铺分组表
sql
``` 主键：id 用途：店铺分组管理（多账号分组） 关键字段： - name: 分组名称 - shopid: 所属公司ID - profitcfgid: 默认利润方案 - isfinance: 是否为财务账号 ``` #### `t_amazonseller_market` - 卖家站点关联表
sql
``` 主键：sellerid, marketplace_id 用途：卖家与站点的关联关系 关键字段： - sellerid: 卖家ID - marketplace_id: 站点ID - country: 国家编码 - amazonauthid: 对应的授权ID ``` ### 2. 商品管理相关表 #### `t_product_info` - 商品基本信息表
sql
``` 主键：id 用途：存储商品核心信息 关键字段： - asin: 亚马逊标准识别号 - sku: 卖家SKU - marketplaceid: 站点ID - name: 产品标题 - price: 价格 - parentAsin: 父ASIN（用于变体） - isparent: 是否父商品 - invalid: 是否无效 - amazonAuthId: 授权ID ``` #### `t_product_in_opt` - 商品运营信息表
sql
``` 主键：pid (关联t_product_info.id) 用途：商品运营相关配置 关键字段： - msku: 本地ERP系统SKU - owner: 运营负责人 - status: 产品状态（0备货 1维持 2提升...） - presales: 手动预估销量 - profitid: 利润计算方案 - disable: 是否禁用 - remark: 备注信息 ``` #### `t_amz_product_refresh` - 商品刷新记录表
sql
``` 主键：pid 用途：记录商品信息刷新时间 关键字段： - detail_refresh_time: 详情刷新时间 - price_refresh_time: 价格刷新时间 - catalog_refresh_time: 分类刷新时间 - notfound: 是否未找到 ``` #### `t_amz_product_active` - 商品活跃状态表
sql
``` 主键：amazonAuthId, marketplaceid, sku 用途：记录商品活跃状态 关键字段： - asin: ASIN - openDate: 创建日期 - price: 当前价格 ``` ### 3. 订单管理相关表 #### `t_amz_order_main` - 订单主表
sql
``` 主键：amazon_order_id, amazonAuthId 用途：订单基本信息 关键字段： - purchase_date: 购买时间 - order_status: 订单状态 - fulfillment_channel: 配送渠道（FBA/FBM） - sales_channel: 销售渠道 - order_total: 订单总额 - hasItem: 是否有商品明细 - marketplaceId: 站点ID ``` #### `t_amz_order_item` - 订单商品明细表
sql
``` 主键：amazon_order_id, orderItemId 用途：订单商品详情 关键字段： - sku: 商品SKU - title: 商品标题 - QuantityOrdered: 订购数量 - QuantityShipped: 发货数量 - item_price: 商品价格 - item_tax: 商品税费 - amazonAuthId: 授权ID - marketplaceId: 站点ID ``` #### `t_orders_report` - 订单报表表
sql
``` 主键：amazonAuthId, purchase_date, id 用途：订单报表数据（用于分析） 关键字段： - order_status: 订单状态 - fulfillment_channel: 配送渠道 - sales_channel: 销售渠道 - quantity: 数量 - item_price: 价格 - item_tax: 税费 - marketplaceId: 站点ID ``` #### `t_orders_summary` - 订单汇总表
sql
``` 主键：purchase_date, id 用途：按SKU汇总订单数据 关键字段： - amazonAuthId: 授权ID - marketplaceid: 站点ID - asin: ASIN - sku: SKU - quantity: 总销量 - ordersum: 订单数量 - orderprice: 订单金额 ``` ### 4. 库存管理相关表 #### `t_inventory_report` - 库存报表
sql
``` 主键：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` - 库存健康报告
sql
``` 主键：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` - 库存历史表
sql
``` 主键：byday, id 用途：历史库存数据存档 关键字段：同t_inventory_report ``` ### 5. 财务结算相关表 #### `t_amz_settlement_report` - 结算报表
sql
``` 主键：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结算汇总
sql
``` 主键：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月度汇总
sql
``` 主键：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` - 财务账户表
sql
``` 主键：groupid, amazonAuthid 用途：财务账户信息 关键字段： - amazonAuthid: 授权ID - groupid: 分组ID - currency: 币种 - financial_event_group_start: 财务事件组开始时间 - financial_event_group_end: 财务事件组结束时间 - processing_status: 处理状态 - original_total: 原始总金额 ``` ### 6. 物流管理相关表 #### `t_erp_ship_inboundplan` - 入库计划表
sql
``` 主键：id 用途：FBA入库计划管理 关键字段： - name: 计划名称 - number: 计划编号 - amazongroupid: 店铺分组ID - marketplaceid: 站点ID - warehouseid: 仓库ID - auditstatus: 审核状态 - createtime: 创建时间 - creator: 创建人 ``` #### `t_erp_ship_inboundshipment` - 入库货件表
sql
``` 主键：ShipmentId 用途：FBA入库货件详情 关键字段： - ShipmentId: 货件ID - DestinationFulfillmentCenterId: 目的FC - inboundplanid: 计划ID - ShipmentStatus: 货件状态 - status: 系统状态 - TotalUnits: 总单位数 - carrier: 承运人 - boxnum: 箱数 - shiped_date: 发货日期 ``` #### `t_erp_ship_inbounditem` - 入库货件商品表
sql
``` 主键：id 用途：货件商品明细 关键字段： - ShipmentId: 货件ID - SellerSKU: 卖家SKU - QuantityShipped: 发货数量 - QuantityReceived: 接收数量 - materialid: 物料ID - msku: 本地SKU - unitcost: 单位成本 - totalcost: 总成本 ``` #### `t_erp_ship_v2_inboundplan` - V2版本入库计划
sql
``` 主键：id 用途：新版入库计划管理 关键字段： - inbound_pland_id: 亚马逊计划ID - name: 计划名称 - number: 计划编号 - groupid: 分组ID - amazonauthid: 授权ID - marketplaceid: 站点ID - auditstatus: 审核状态（1已提交 2待配货 3待装箱...） - shipping_date: 预计发货日期 - transtype: 运输方式 ``` ### 7. 运营分析相关表 #### `t_orders_summary` - 订单汇总（日）
sql
``` 主键：purchase_date, id 用途：每日SKU销量汇总 关键字段： - amazonAuthId: 授权ID - marketplaceid: 站点ID - purchase_date: 日期 - asin: ASIN - sku: SKU - quantity: 销量 - ordersum: 订单数 - orderprice: 订单金额 ``` #### `t_orders_summary_month` - 订单汇总（月）
sql
``` 主键：purchase_date, id 用途：月度SKU销量汇总 关键字段：同t_orders_summary ``` #### `t_amz_product_sales_plan` - 商品销售计划
sql
``` 主键：id 用途：商品销售预测和补货计划 关键字段： - sku: 平台SKU - msku: 本地SKU - shopid: 店铺ID - marketplaceid: 站点ID - groupid: 分组ID - amazonauthid: 授权ID - shipday: 发货周期 - avgsales: 日均销量 - needship: 待发货数量 - needpurchase: 待采购数量 ``` #### `t_profitcfg` - 利润计算方案
sql
``` 主键：id 用途：利润计算配置方案 关键字段： - shop_id: 店铺ID - isSystem: 是否系统内置 - name: 方案名称 - sales_channel: 销售渠道 - sellerPlan: 销售计划 - shipmentStyle: 运费计算方式 - isDefault: 是否默认方案 ``` #### `t_profitcfgcountry` - 利润计算国家配置
sql
``` 主键：id 用途：各国利润计算参数 关键字段： - profitid: 方案ID - country: 国家 - taxRate: 进口关税费率 - lostRate: 汇率损耗比率 - sellerRate: 市场营销占比 - vat_rate: VAT增值税费率 - corporate_InRate: 企业所得税率 ``` ### 8. 报表相关表 #### `t_report_requestrecord` - 报表请求记录
sql
``` 主键：id 用途：存储亚马逊报表请求记录 关键字段： - sellerid: 卖家ID - marketPlaceId: 站点ID - reportType: 报表类型 - reportId: 报表ID - reportRequestId: 报表请求ID - startDate: 开始时间 - endDate: 结束时间 - report_processing_status: 处理状态 - isrun: 是否正在运行 ``` #### `t_fba_storage_fee_report` - FBA仓储费报表
sql
``` 主键：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` - 长期仓储费报表
sql
``` 主键：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` - 发货周期配置
sql
``` 主键：id 用途：SKU发货周期配置 关键字段： - sku: SKU - marketplaceid: 站点ID - groupid: 分组ID - transtype: 运输类型 - stockingCycle: 安全库存周期 - min_cycle: 最小发货周期 - first_leg_charges: 头程运输成本 ``` #### `t_erp_estimated_sales` - 预估销量表
sql
``` 主键：id 用途：手动维护日均销量 关键字段： - sku: SKU - marketplaceid: 站点ID - groupid: 分组ID - presales: 手动输入日均销量 - startTime: 开始生效时间 - endTime: 结束生效时间 - isInvalid: 是否有效 ``` #### `t_erp_market_priority` - 站点优先级
sql
``` 主键：marketplaceid, groupid 用途：发货计划中站点优先级配置 关键字段： - marketplaceid: 站点ID - groupid: 分组ID - priority: 优先级（数字越小优先级越高） ``` #### `t_exchangerate` - 汇率表
sql
``` 主键：id 用途：汇率信息 关键字段： - name: 币种名称 - price: 汇率 - symbol: 符号 - utctime: 更新时间 ``` #### `t_exchangerate_customer` - 客户自定义汇率
sql
``` 主键：id 用途：客户自定义汇率 关键字段： - shopid: 店铺ID - name: 币种 - price: 自定义汇率 ``` #### `t_holiday` - 节假日表
sql
``` 主键：id 用途：节假日数据 关键字段： - shopid: 店铺ID - day: 日期 - name: 节日名称 - type: 节假日类型（0工作日 1周末 2节日 3调休） - week: 星期几 ``` ## 三、数据关系说明 ### 1. 核心业务关系链
text
``` 店铺授权 (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. 物流发货关系链
text
``` 入库计划 (t_erp_ship_inboundplan / t_erp_ship_v2_inboundplan) ↓ 入库货件 (t_erp_ship_inboundshipment / t_erp_ship_v2_inboundshipment) ↓ 货件商品 (t_erp_ship_inbounditem) ``` ### 3. 财务结算关系链
text
``` 结算报表 (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. 复合索引设计原则 1. **查询频率**：高频查询字段放在前面 2. **字段选择性**：高选择性字段（如ID）放在前面 3. **查询模式**：按照业务实际查询模式设计 4. **排序需求**：需要排序的字段考虑在索引中 ## 五、数据维护说明 ### 1. 数据清理策略 - 库存历史数据：保留30天 - 仓储费报表：保留30天 - 结算报表：保留365天 - 其他报表：保留3天 ### 2. 数据同步机制 - 商品刷新：通过事件自动刷新 - 库存同步：每日自动同步 - 订单同步：定时抓取 - 结算同步：定期获取结算报告 ### 3. 性能优化建议 1. **分区策略**：对于大表（如订单表）考虑按时间分区 2. **归档策略**：定期归档历史数据到历史表 3. **索引维护**：定期检查索引使用情况并优化 4. **查询优化**：避免全表扫描，使用覆盖索引 ## 六、业务规则说明 ### 1. 商品状态规则
text
``` 0: 备货 1: 维持 2: 提升 3: 促销 4: 停售 5: 清仓 6: 删除 ``` ### 2. 货件状态规则
text
``` -1: 已驳回 0: 取消货件 1: 待审核 2: 配货（已确认货件） 3: 装箱 4: 物流信息确认 5: 已发货 6: 已完成发货 ``` ### 3. 入库计划审核状态
text
``` 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. 数据不同步问题 1. 检查`t_amz_product_refresh`刷新时间 2. 检查`t_report_requestrecord`报表状态 3. 检查事件`autoRefreshInsert`执行情况 ### 2. 性能问题 1. 检查大表的索引使用情况 2. 检查查询是否使用正确索引 3. 检查是否有全表扫描操作 ### 3. 数据一致性问题 1. 检查主从复制状态 2. 检查事务完整性 3. 检查外键约束 --- **文档版本**：1.0 **更新日期**：2024年 **适用范围**：数据库设计、开发、运维人员 # 数据库【db_erp】文档 # ## 1. 概述 本文档详细描述了`db_erp`数据库的结构设计，该数据库服务于企业资源计划（ERP）系统，涵盖采购、库存、销售、财务管理等核心业务模块。 ## 2. 数据库核心表结构 ### 2.1 基础维度表 #### `t_dimensions` 尺寸规格表
字段类型说明
idbigint unsigned主键ID
lengthdecimal(15,2)长度
length\_unitschar(15)长度单位
widthdecimal(15,2)宽度
width\_unitschar(15)宽度单位
heightdecimal(15,2)高度
height\_unitschar(15)高度单位
weightdecimal(15,2)重量
weight\_unitschar(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 库存状态流转
text
``` inbound（待收货） → fulfillable（可用） → outbound（待发运） ```
### 3.2 采购流程
text
``` 采购计划 → 采购订单 → 入库验收 → 付款结算 ```
### 3.3 销售发货流程
text
``` 销售订单 → 出库单 → 物流发货 ```
## 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 用户相关表
sql
``` -- t_user: 用户主表 -- 包含账户信息、密码、状态、上级关系等 -- 支持Google验证、微信绑定等 -- t_userinfo: 用户详细信息 -- 包含姓名、性别、联系方式等 ```
### 3.2 权限相关表
sql
``` -- t_role: 角色定义 -- 支持系统角色和自定义角色 -- t_authority: 操作权限定义 -- URL级别的权限控制 -- t_permission: 权限项管理 -- 按钮级别的权限控制 ```
### 3.3 店铺限制表 (`t_manager_limit`)
sql
``` -- 关键字段说明: -- maxShopCount: 最大店铺数 -- maxProductCount: 最大商品数 -- maxOrderCount: 最大订单处理数 -- maxMember: 最大子用户数 -- tariffpackage: 套餐类型(0-基础版,1-标准版,2-专业版,3-独享版,4-自定义) -- losingEffect: 失效时间 ```
### 3.4 订单和发票表
sql
``` -- 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 用户权限流程 1. 用户登录 → 验证账户状态 2. 查询用户角色 → 获取权限集合 3. 加载菜单权限 → 显示可用菜单 4. 操作时检查权限 → 验证操作权限 ### 5.2 套餐订阅流程 1. 选择套餐 → 生成订单 2. 支付订单 → 更新支付状态 3. 应用套餐 → 更新店铺限制 4. 失效处理 → 自动降级或提醒续费 ### 5.3 店铺限制检查 - 创建店铺时检查店铺数量限制 - 添加商品时检查商品数量限制 - 添加子用户时检查用户数量限制 - 开启广告时检查广告组限制 ## 6. 索引优化建议 ### 6.1 建议添加的索引
sql
``` -- 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 **功能**: 1. 杀死运行时间超过20秒的SELECT查询 2. 从 `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 **功能**: 1. 更新未使用的广告授权状态 2. 同步群组、汇率数据 ## 三、数据表结构 ### 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 数据保留策略 1. **报告数据**: 根据事件 `delete_long_data` 的清理规则 - SP广告报告保留8天 - 其他广告报告保留65天 - 快照数据保留2天 - 汇总数据保留7天 2. **数据同步**: 通过定时事件同步群组和汇率数据 ### 4.3 性能优化 1. **长查询处理**: 通过 `db_timeout_process_kill` 事件自动终止长时间运行的SELECT查询 2. **索引策略**: 所有主表都有合理的索引配置 3. **分区策略**: 部分报告表按日期分区 ## 五、表关系说明 ### 5.1 核心关系链
text
``` 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 报告数据流
text
``` t_amz_adv_report_request (请求报告) ↓ t_amz_adv_snapshot (生成快照) ↓ t_amz_adv_rpt2_* (存储报告数据) ↓ t_amz_advert_report_summary (汇总统计) ```
## 六、维护建议 ### 6.1 监控建议 1. 监控事件执行状态 2. 监控长查询数量 3. 监控磁盘空间使用情况 4. 监控数据同步延迟 ### 6.2 备份策略 1. 业务数据每天备份 2. 配置数据变更时立即备份 3. 报告数据可根据业务重要性制定备份策略 ### 6.3 性能优化 1. 定期分析慢查询日志 2. 监控索引使用效率 3. 根据业务增长调整事件调度频率 ## 七、注意事项 ### 7.1 数据一致性 1. 广告授权状态与账户配置需保持同步 2. 群组数据需通过事件同步，避免直接修改 3. 汇率数据需定期更新 ### 7.2 业务限制 1. 广告报告数据有保留期限，业务查询需注意时间范围 2. 定时任务的状态管理需要监控 3. 警告规则的配置需要合理设置阈值 ### 7.3 扩展性考虑 1. 新增广告类型时需要扩展相应的表结构 2. 报告类型增加时需要更新配置表 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 订单流程 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)）