order-monitoring-module-design.md 5.9 KB
订单监测模块设计文档
1. 文档范围
本文档说明当前系统中订单监测模块的功能设计、实现逻辑、数据来源以及与其他模块的关联关系。
文档内容基于当前代码和数据库已有能力整理，覆盖订单价值分析、店铺价值分析、渠道贡献、关联购买、支付转化、运营报表等已接入的功能。
2. 模块定位
订单监测模块用于对订单和店铺销售数据进行统计分析，辅助业务人员观察订单规模、销售贡献、支付效率、退款流失、渠道表现和商品组合关系。
模块当前主要面向两类数据：
- 订单明细数据：来自订单主表，用于 GMV、Top 商品、退款流失、支付耗时、支付漏斗、关联购买等分析。
- 店铺销售数据：来自店铺价值明细表，用于平台、渠道、事业部、商品销售贡献和运营报表分析。
3. 功能设计
3.1 数据上传
订单监测保留数据上传入口，用于将外部订单或销售文件导入数据库。
当前已实现的上传能力包括：
- 订单数据上传：导入订单主表数据。
- 店铺销售数据上传：导入店铺价值明细数据。
- 上传后由后端解析文件并写入对应业务表，前端分析页面再从数据库读取统计结果。
3.2 订单价值分析
订单价值分析围绕订单主表进行统计，支持按日期范围筛选。
当前功能包括：
- GMV 统计：统计指定日期范围内的实付金额合计。
- Top5 商品销售额：按商品编码汇总销售额并取前五名。
- Top5 销售占比：计算 Top5 商品销售额占整体销售额的比例。
- R 大客户或高价值订单分析：根据订单金额分布识别高价值订单区间。
- 平均支付时长：计算下单时间到支付时间的平均耗时。
- 退款流失率：结合退款金额与成功支付金额计算订单流失情况。
- 支付决策漏斗：按支付耗时区间统计用户支付转化过程。
3.3 关联购买分析
关联购买分析用于识别同一支付单或同一购买行为下经常一起出现的商品组合。
当前逻辑以支付单号作为购买行为标识，按商品编码组合统计共同出现次数，输出高频商品组合列表。该结果可用于搭配销售、组合推荐或商品运营分析。
3.4 店铺价值分析
店铺价值分析基于店铺销售明细数据，面向平台、渠道、事业部和商品维度进行统计。
当前功能包括：
- 平台订单数和销售额统计。
- 渠道销量、销售额贡献统计。
- 事业部销量和销售额贡献统计。
- Top 商品销售贡献分析。
- 跨平台销售商品识别。
- 事业部效率分析。
- 渠道商品多样性分析。
- 渠道 ROI 数值查询。
3.5 运营报表
运营报表用于按日期、月份或年份聚合店铺销售数据，输出平台、渠道、订单数、销量、销售额、客单价等指标。
当前支持：
- 报表列表查询。
- 按周期聚合。
- 报表导出。
4. 数据与业务逻辑
4.1 数据来源
当前订单监测主要使用以下数据库表：
- 订单主表：保存订单编号、商品编码、商品名称、价格、数量、应付金额、实付金额、退款金额、下单时间、支付时间、支付单号等信息。
- 店铺价值明细表：保存平台、渠道、事业部、商品编码、销量、销售额、统计日期等信息。
- 产品基础表：在部分分析中作为商品编码、商品名称等基础信息补充来源。
4.2 日期筛选
订单分析使用订单创建时间作为日期筛选口径。
店铺价值分析使用统计日期作为日期筛选口径；当统计日期为空时，系统会通过年、月、日字段组合出统计日期。
4.3 金额口径
订单价值类分析优先使用实付金额。部分支付金额分布和流失分析中，当实付金额为空或小于等于 0 时，会使用应付金额作为补充口径。
店铺价值类分析使用店铺销售明细表中的销售金额字段进行汇总。
4.4 支付效率口径
平均支付时长以订单创建时间和支付时间的时间差计算。
支付决策漏斗将订单划分为：
- 5 分钟内支付。
- 5 到 30 分钟内支付。
- 30 分钟后支付。
- 未支付。
4.5 退款流失口径
退款流失分析从订单主表中读取退款金额，并与成功支付金额进行对比，用于衡量订单成交后的金额流失情况。
4.6 关联购买口径
关联购买使用支付单号聚合同一次购买行为中的商品。系统会对同一支付单下不同商品编码进行组合，统计共同出现次数，并按次数降序输出。
5. 与其他模块的关联关系
5.1 数据上传模块
订单监测依赖数据上传模块完成原始订单和店铺销售文件入库。只有数据入库后，分析页面才能从数据库中读取统计结果。
5.2 产品基础数据
订单监测以商品编码作为核心分析对象，部分场景需要结合产品基础信息补充商品名称或分类信息。
5.3 生命周期模块
生命周期模块同样使用订单和商品销售数据。订单监测偏重订单规模、支付转化、渠道贡献和销售表现；生命周期模块偏重商品经营阶段识别和阶段性运营判断。
5.4 供应监测模块
订单监测输出的是销售端和订单端表现，供应监测输出的是供应商成本、交付和账期表现。两者可通过商品编码关联，用于判断某个商品在销售表现和供应能力上的综合情况。
6. 当前实现说明
当前模块已经接入 Java 后端和数据库，主要接口由订单分析控制器、店铺数据控制器和运营报表控制器提供。
前端页面中已有多个订单分析页面文件，实际展示入口受系统菜单和路由配置控制。本文档只描述当前代码和接口中已经存在的功能，不包含尚未实现的规划能力。