← 返回平台
🔍 Ctrl K
V2.14 文档

数据管理平台 · 操作手册

全佑健康管理内部 ERP 系统，涵盖商品、库存、采购、订单、售后、淘宝闪购、京东到家、美团买药、客服聊天、聚水潭同步、AI 智能问答等全链路业务管理。

📅 2026年8月 · V2.7 🌐 https://www.pcyiliao.com 📝 适用人员：运营、采购、仓储、客服、管理 📊 47 个功能页面

目录

  1. 平台简介
  2. 登录与界面导航
  3. 仪表盘
  4. 商品管理
  5. 库存管理
  6. 采购与入库管理
  7. 订单管理
  8. 售后管理
  9. 报表看板
  10. 淘宝闪购模块
  11. 京东到家模块
  12. 美团买药数据看板
  13. 平台商品明细与每日同步
  14. BI看板与A/B缺货率计算逻辑
  15. 库存仓龄分析
  16. 客服聊天记录
  17. 聚水潭 API 对接
  18. AI 智能问答
  19. 数据质量监控
  20. 权限管理
  21. API 参考手册
  22. 数据库表结构
  23. 常见问题
  24. 术语表
  25. 版本更新记录

1. 平台简介

全佑健康管理 · 数据管理平台（MyStore）是企业内部 ERP 系统，统一管理多平台电商业务的全链路数据。

系统整合淘宝天猫、淘宝闪购、京东到家、美团买药等四大平台的商品、库存、订单、售后、客服等业务数据，并提供聚水潭 ERP 数据同步、AI 智能问答、数据质量监控等高级功能。

🎯核心功能

📊
数据仪表盘
门店营收排名、商家收入趋势、利润/损耗排行
📦
商品管理
商品资料、供应商、SKU、销量分析
🏭
库存管理
实时库存、安全库存、预警规则、曹庄仓独立管理
🔄
采购入库
采购单、入库单、聚水潭同步
🛒
订单管理
多平台订单聚合、售后退款、统一订单看板
⚡
淘宝闪购
服务/经营/流量/推广/订单/评价 7 大维度
🚀
京东到家
订单/流量/履约/门店/评价/售后/体检/违规 8 维度
🛵
美团买药
订单/退款/履约/评价/服务分/后台数据 9 维度
💬
客服聊天
4 大平台聊天记录、AI 解析
🔗
聚水潭对接
订单、商品、库存、退款 API 同步
✦
AI 智能问答
评价解析、聊天意图识别、自然语言查询
👥
权限管理
用户、角色、模块权限、细粒度授权

⚙️技术架构

层级技术说明
前端原生 JavaScript + Chart.jsSPA 单页应用，19 个 JS 模块
后端Python Flaskmystore_server.py 主程序 + api_restful.py API 模块
数据库MySQL 8 + SQLite主库存 75 张表，SQLite 用于本地备份
反向代理NginxHTTPS 终端，反向代理 8090 端口
进程管理systemdmystore.service 自启动
鉴权JWT + sha25624 小时有效期，sessionStorage 存储
部署阿里云 ECSAlibaba Cloud Linux 3

📁数据来源与同步路径

系统内所有平台报表数据由 RPA 定时抓取，落地到本机 D:\rpa_transer\ 各平台目录，再由每日定时任务上传解析入 MySQL 数据库，最终呈现在各业务页面。整体链路：

平台商家后台 → RPA 抓取 → D:\rpa_transer\ 报表目录 → rpa_sync.py 上传（POST /api/auto-sync）→ MySQL mystore 库 → 页面展示

① 三平台报表来源对照

平台报表目录（本机 D:\rpa_transer\）数据库表对应页面
京东到家京东\京东流量概览jd_traffic_overview11.2 流量
京东\京东履约分析jd_fulfillment11.3 履约
京东\京东评价分析jd_review11.5 评价
京东\京东售后分析jd_aftersale11.6 售后
京东\京东体检分jd_health_check11.7 体检
京东\京东违规单jd_violation11.8 违规
淘宝闪购淘宝闪购\淘宝订单tb_flash_orders10.6 订单数据
淘宝闪购\服务数据tb_flash_service10.2 服务数据
淘宝闪购\经营数据tb_flash_business10.3 经营数据
淘宝闪购\流量数据tb_flash_traffic10.4 流量数据
淘宝闪购\推广数据tb_flash_promotion10.5 推广数据
淘宝闪购\评价tb_flash_review10.7 评价数据
美团买药美团\美团后台数据mt_backend_data12.1 订单
美团\美团服务分mt_service_score12.5 服务分
美团\美团门店评分mt_store_rating12.4 评价
美团\美团服务分析mt_service_analysis12.6 服务分析
美团\美团客服响应数据customer_service12 美团看板（客服）
美团\美团评论（特殊宽表格式）mt_review12.4 评价
美团\美团聊天记录（AI 解析）chats15 客服聊天记录
美团\美团订单\商品活动分摊 / 商品详情 / 提现详情 / 账单详情 / 返利详情mt_order_product_activity / mt_order_product_detail / mt_order_withdrawal / mt_order_bill / mt_order_rebate12.1 订单
美团\美团履约（递归子目录）mt_fulfillment12.3 履约
美团\美团商责（递归子目录）mt_responsibility12.2 退款

② 其他数据来源

数据来源路径 / 同步脚本数据库表对应页面
美团订单sync_mt_orders_v2_fixed.py（本机 D:\rpa_transer\）mt_orders、mt_order_items12.1 订单
电话转写记录D:\rpa_transer\电话转写记录\processed\ → sync_phone_transcriptions.pychats（platform='phone'）15 客服聊天记录
聚水潭订单（统一订单）服务器 jst_sync_cron.sh（每 10 分钟调用 /api/jst/sync-orders）+ 内置线程每 30 分钟；unified_sync_cron.sh 每 15 分钟汇总unified_orders 等14 BI看板、3 仪表盘
聚水潭采购 / 入库sync_jst_api.py（本机）+ 服务器 JST 同步purchases、purchase_in6 采购与入库、14 仓龄分析
仓库 / 门店库存库存报表 → sync_inventory.py → POST /api/inventory/importinventory（warehouse=曹庄/分仓）5 库存管理、14 BI看板 A/B缺货率
商品 / 订单 / 售后基础数据系统内维护 + 各平台订单导入（sync_jd_orders.py 等）products、orders、aftersales 等4 商品管理、7 订单管理

③ 同步执行方式

本机 Windows 任务计划每天定时执行 D:\rpa_transer\rpa_sync_scheduled.bat，按序运行 5 个步骤：rpa_sync.py（三平台报表上传）→ sync_mt_orders_v2_fixed.py（美团订单）→ sync_phone_transcriptions.py（电话转写）→ sync_jst_api.py（聚水潭采购入库）→ sync_inventory.py（仓库/门店库存）。

日志位置：本机 D:\rpa_transer\logs\（rpa_sync_日期.log、scheduled_task.log 等）；服务器 /opt/mystore/unified_sync.log、/opt/mystore/jst_sync.log、/opt/mystore/logs/（服务日志）。

平台商品明细每日同步（05:30）： 另有两个独立计划任务 MeituanDailySync / TaobaoDailySync（本机 WorkBuddy 工作区），每日 05:30 自动将 美团 / 淘宝闪购 门店商品信息合并上传至服务器 /opt/mystore/meituan_products_YYYYMMDD.csv、taobao_products_YYYYMMDD.csv（详见 13.2 节），并同步刷新主快照 platform_products.csv 与同步状态 sync_status.json（看板数据源）。

📐报表字段计算公式

系统内报表字段分为两类：平台直采字段（RPA 从商家后台抓取的原始值，入库后直接展示，不经过二次计算）与系统计算字段（由原始字段按固定公式计算得出）。本节汇总各报表页面的核心计算公式与取值口径，便于核对数据与排查口径差异。

① 通用计算指标

指标计算公式适用场景 / 口径说明
点击率点击率 = 访客量 ÷ 曝光量 × 100%美团由系统计算；淘宝、京东该字段（进店转化率）为平台直采
转化率转化率 = 下单访客数 ÷ 总访客数 × 100%三平台均为平台直采字段（下单转化率 / order_rate），未二次计算
付费依赖度付费依赖度 = 付费花费 ÷ GMV × 100%淘宝、美团由系统计算；京东无推广数据
客单价客单价 = GMV ÷ 下单量淘宝直采 avg_price；京东 = 去重GMV ÷ 去重订单数；美团 = 实际金额 ÷ 订单数
商责退款率商责退款率 = 商家责任退款单数 ÷ 支付订单数 × 100%美团由系统计算；京东为平台直采 refund_rate；淘宝无此数据
取消单量取消单量 = 顾客取消单数 + 商家取消单数美团：customer_cancel_orders + merchant_cancel_orders
环比变化率变化率 = (今日值 − 对比值) ÷ |对比值| × 100%BI看板 环比/周环比/同比 通用；变化幅度超过 ±200% 时封顶显示 ±200%

② BI 看板指标 · 三平台取值口径

字段淘宝闪购京东美团
GMV直采：tb_flash_business.total_deal_amount计算：jd_orders 按订单号去重后 SUM(订单金额)直采：mt_backend_data.original_amount
访客量直采：total_store_visits直采：enter_people直采：entry_count
曝光量直采：total_exposure直采：exposure_people直采：exposure_count
点击率直采：store_conversion_rate直采：enter_rate计算：entry_count ÷ exposure_count
转化率直采：order_conversion_rate直采：order_rate直采：order_rate
付费花费直采：merchant_subsidy无数据直采：merchant_subsidy
付费依赖度计算：付费花费 ÷ GMV无数据计算：付费花费 ÷ GMV
评分直采：store_rating无数据直采：avg_store_score
A/B缺货率计算：unified_orders 近30天销量分档 + inventory 库存判断（详见 14.2 节）
履约达标率直采：on_time_rate直采：delivery_on_time_rate直采：on_time_score（显示为分数）
商责退款率无数据直采：refund_rate计算：商责退款单数 ÷ 支付订单数
取消订单量无数据无数据计算：顾客取消 + 商家取消
营业时长无数据直采：avg_business_hours直采：avg_daily_online_hours
客单价直采：avg_price计算：去重GMV ÷ 去重订单数计算：actual_amount ÷ order_qty

③ 其他报表计算字段

报表 / 页面字段计算公式
京东履约汇总退款率退款订单数 ÷ 支付订单数 × 100%
配送完成率配送完成订单数 ÷ 支付订单数 × 100%
配送超时率 / 好评率超时订单数 ÷ 支付订单数 × 100%；好评数 ÷ 评论总数 × 100%
美团订单汇总客单价商品总价合计 ÷ 订单总数
美团服务分析（漏斗）入店率 / 新客率入店人数 ÷ 曝光人数 × 100%；新客人数 ÷ 曝光人数 × 100%
库存价值报表期末库存价值期末库存量 × 成本价
BI看板（A/B缺货率）A类 / B类缺货率缺货SKU数 ÷ 该类SKU总数 × 100%（详见 14.2 节）
库存仓龄分析仓龄统计基准日 − 最后入库日期（详见 15.2 节）
速记：凡是「率」类字段，优先看平台报表是否直接提供（直采字段），未提供才由系统按公式计算；GMV 除京东需按订单号去重外，其余平台均为报表直采金额。

🗃基础维度数据总览

系统全部基础维度数据按存储位置分为五大类：MySQL 数据库表（服务器）、平台商品 CSV 快照（服务器）、进销存报表产出（服务器 exports 目录）、本地 RPA 源数据（本机 D 盘）、定时任务调度（服务器 cron + 本机计划任务）。以下逐一列明。

① MySQL 数据库表（92 张表 · 数据库 mystore）

服务器地址：pcyiliao.com（内网 127.0.0.1:3306），数据库名 mystore，连接配置见 /opt/mystore/agg_sales_api.py 第 28 行 DB_CONF。按业务域分类如下：

业务域表名行数说明
商品主数据products2,359商品资料主表（SKU/名称/分类/价格/成本/供应商）
suppliers8供应商信息
sku_cost_dict1,711SKU 成本价字典（手动维护 / 聚水潭同步）
库存数据inventory_daily1,379,590库存每日快照（按 snapshot_date 追加，142.7 MB）
inventory87,496当前库存（含可售/锁定/安全/在途/库龄等 50+ 字段）
store_inventory79,490门店库存（含销售趋势/补货建议）
jst_inventory54,027聚水潭库存同步（每 10 分钟）
inventory_live22,560实时库存（前端展示用缓存表）
订单数据orders696,902销售订单主表（358.9 MB）
unified_orders359,146统一订单（三平台汇总，每 15 分钟同步）
jst_order_ext350,694聚水潭订单扩展（每 10 分钟同步）
jst_sales_out267,300聚水潭销售出库单
tb_flash_orders34,342淘宝闪购订单
mt_orders / jd_orders27,679 / 7,730美团订单 / 京东订单
聚水潭单据jst_sales_daily73,576聚水潭销售日报（每日 03:30 生成，含 50 字段）
jst_alloc20,663调拨单（每 30 分钟同步）
jst_other_out15,386其他出库单
jst_stock_count14,897盘点单
jst_inventory54,027聚水潭库存同步
采购入库purchases85,612采购单主表
purchase_in52,075入库单
补货计算replenish_suggest234,327补货建议（每日 03:30 计算，含 XYZ 分类/安全库存/建议采购量）
平台报表mt_backend_data2,005美团后台数据（曝光/订单/履约/评价等 50+ 字段）
mt_fulfillment366,162美团履约明细
mt_responsibility92,537美团商责退款
mt_review17,140美团评论
tb_flash_business / tb_flash_service / tb_flash_traffic / tb_flash_promotion / tb_flash_review1,689 / 2,156 / 2,066 / 1,395 / 347淘宝闪购五大报表
jd_traffic_overview / jd_fulfillment / jd_review / jd_aftersale / jd_health_check / jd_violation / jd_store_detail907 / 1,602 / 1,444 / 1,430 / 926 / 0 / 35京东到家七大报表
mt_service_score / mt_store_rating / mt_service_analysis1,197 / 1,080 / 3,517美团服务分 / 门店评分 / 服务分析
售后/评价refunds19,917退款记录
mt_order_items / mt_order_product_activity / mt_order_product_detail54,717 / 51,336 / 49,592美团订单子表
mt_order_bill / mt_order_rebate / mt_order_withdrawal1,679 / 34 / 146美团账单 / 返利 / 提现
客服聊天chats3,236聊天记录（含美团 + 电话转写）
phone_transcriptions851电话转写记录
customer_service20,192客服响应数据
门店费用store_expense106门店费用（租金/水电/人员工资等 15 项）
数据质量dq_check_log638巡检记录（每日 06:00 / 18:00）
dq_anomaly_detail1,106异常明细
dq_score_snapshot10质量评分快照
dq_alert_rule7告警规则
dq_null_rate_log0空值率日志
dq_sync_lag_log0同步延迟日志
权限系统sys_users5用户账号
sys_roles4角色
sys_permissions21权限项
sys_role_permissions / sys_user_permissions / sys_user_roles39 / 11 / 2角色-权限 / 用户-权限 / 用户-角色关联

注：行数为 information_schema 估计值，实际行数可能有偏差；完整表结构详见第 22 章「数据库表结构」。

② 平台商品 CSV 快照（服务器 /opt/mystore/）

文件名说明每日更新保留
meituan_products_YYYYMMDD.csv美团 36 店商品明细（约 80,000 行 x 23 字段，~22 MB）05:30 MeituanDailySync15 天滚动
taobao_products_YYYYMMDD.csv淘宝闪购 36 店商品明细（约 97,000 行 x 18 字段，~20 MB）05:30 TaobaoDailySync15 天滚动
jd_products_YYYYMMDD.csv京东 36 店商品明细（约 93,000 行 x 19 字段，~18 MB）05:30 JdDailySync15 天滚动
platform_products.csv主快照（取最新平台数据，~20 MB）同步时刷新始终最新
meituan_manifest.json / taobao_manifest.json / jd_manifest.json各平台日期清单（latest + dates[]，keepDays=15）同步时刷新—
sync_status.json同步状态记录（10 个任务 x 90 天，看板数据源）各同步脚本 + sync_health.py（每半小时）90 天
jst_sync_state.json聚水潭同步状态（最后同步时间 / 增量 / 全量标记）每 10 分钟—

③ 进销存报表产出（服务器 /opt/mystore/exports/）

文件命名规则说明生成时间
进销存_起始日期_结束日期.xlsx进销存报表主文件（15 列：期初/入库/出库/期末/销售等）每日 03:00（gen_psv.py）
进销存_*.xlsx.json报表概要元数据（行列数 / 日期范围 / 门店数）同上
进销存_*.xlsx.rows.json行级数据缓存（前端在线预览用）同上
库存清单_YYYYMMDD_xxxxxxxx.xlsx库存清单快照（聚水潭导出，历史归档）手动导入

④ 本地 RPA 源数据目录（D:\rpa_transer\）

平台 / 数据本机源路径数据格式同步方式
美团商品D:\rpa_transer\美团\美团商品信息\YYYY-MM-DD\日期文件夹内 xlsxMeituanDailySync 05:30
淘宝闪购商品D:\rpa_transer\淘宝闪购\商品信息\全店YYYY-M-DD.zip 或 商品信息.zip（内含 xlsx）TaobaoDailySync 05:30
京东商品D:\rpa_transer\京东\京东商品明细\京东商品明细M-D.zip文件名带日期的 zip（每天新文件）JdDailySync 05:30
京东报表（6 类）D:\rpa_transer\京东\京东流量概览\ 等 6 个子目录CSV / xlsxrpa_sync.py（rpa_sync_scheduled.bat）
淘宝闪购报表（6 类）D:\rpa_transer\淘宝闪购\淘宝订单\ 等 6 个子目录CSV / xlsx同上
美团报表（10+ 类）D:\rpa_transer\美团\美团后台数据\ 等子目录CSV / xlsx（含递归子目录）同上
美团订单D:\rpa_transer\（脚本目录内）API 同步sync_mt_orders_v2_fixed.py
电话转写D:\rpa_transer\电话转写记录\processed\JSONsync_phone_transcriptions.py
聚水潭采购/入库D:\rpa_transer\（脚本目录内）API 同步sync_jst_api.py
仓库/门店库存D:\rpa_transer\（库存报表文件）xlsxsync_inventory.py

本机定时任务：D:\rpa_transer\rpa_sync_scheduled.bat 按序执行 5 步（rpa_sync.py -> sync_mt_orders -> sync_phone -> sync_jst_api -> sync_inventory），日志位于 D:\rpa_transer\logs\。

⑤ 定时任务调度清单

服务器 crontab（root 用户） — 位于 /var/spool/cron/root，可通过 crontab -l 查看：

频率脚本说明日志
每 10 分钟jst_sync_cron.sh聚水潭订单同步（调 /api/jst/sync-orders）/opt/mystore/jst_sync.log
每 15 分钟unified_sync_cron.shorders -> unified_orders 增量汇总/opt/mystore/unified_sync.log
每 30 分钟jst_extra_sync_cron.sh入库单 / 盘点单 / 调拨单同步/opt/mystore/jst_extra_sync.log
每日 03:00gen_psv.py进销存报表生成（15 列）/tmp/psv_cron.log
每日 03:30agg_sales_cron.sh销售汇总 / 补货建议计算/opt/mystore/agg_sales_cron.log
每日 06:00 / 18:00dq_check_cron.sh数据质量巡检（6 维度评分）/opt/mystore/dq_check.log
每半小时（12,42 分）sync_health.py全任务状态采集 -> sync_status.json/opt/mystore/sync_health.log

本机 Windows 计划任务 — 通过 install_task.bat（管理员运行）注册：

任务名频率脚本说明
MeituanDailySync每日 05:30meituan_daily_sync.bat -> meituan_daily_sync.py美团商品信息合并上传 + manifest + sync_status 更新
TaobaoDailySync每日 05:30taobao_daily_sync.bat -> taobao_daily_sync.py淘宝闪购商品信息合并上传 + manifest + sync_status 更新
JdDailySync每日 05:30jd_daily_sync.bat -> jd_daily_sync.py京东商品明细合并上传 + manifest + sync_status 更新
数据流转全景图：
平台商家后台 -> RPA 抓取 -> D:\rpa_transer\ 本地目录 -> rpa_sync.py / *_daily_sync.py 上传 -> 服务器 /opt/mystore/ (MySQL + CSV) -> 页面展示
聚水潭 API -> 服务器 jst_sync_cron.sh -> MySQL jst_* 表 -> unified_orders 汇总 -> BI 看板 / 仪表盘

2. 登录与界面导航

🔑登录

访问地址： https://www.pcyiliao.com

登录方式： 用户名 + 密码（管理员账号由系统管理员分配）

⚠️ 安全提示： 系统强制 HTTPS，HTTP 自动跳转 HTTPS。密码经 SHA-256 加密存储，登录成功后颁发 JWT Token（24 小时有效期），保存在浏览器 sessionStorage 中。

登录流程

访问网址

浏览器打开 https://www.pcyiliao.com

输入账号

填写用户名和密码（区分大小写）

点击登录

系统校验通过后跳转到主界面，Token 写入 sessionStorage

权限加载

根据用户角色加载可见菜单模块

🗺界面结构

区域位置说明
顶部导航栏页面顶部品牌标识、当前时间筛选、数据库连接状态指示
侧边菜单左侧分组折叠式菜单，按业务模块分组
主内容区右侧主体根据所选菜单展示对应功能页面
状态栏顶部右上当前用户、登出按钮、操作手册入口

📂侧边栏导航结构

侧边栏按业务模块分组，共 9 大组 / 47 个页面：

分组页面页面代码
📊 数据看板仪表盘dashboard
库存仪表盘dashboard-inv
📦 商品管理商品资料products
商品销量product-sales
供应商product-supplier
🏭 库存管理商品库存inv-stock
库存预警inv-alert
曹庄仓库存inv-caozhuang
📋 采购管理采购单purchases
入库单purchase-in
🔄 订单管理销售订单order-sales
售后订单order-aftersale
📊 报表看板销售报表rpt-sales
库存价值rpt-inv-value
补货看板rpt-replenish
排行榜rpt-ranking
门店费用rpt-expense
⚡ 淘宝闪购数据概览tbflash-dashboard
服务数据tbflash-service
经营数据tbflash-business
流量数据tbflash-traffic
推广数据tbflash-promotion
订单数据tbflash-orders
评价数据tbflash-review
🚀 京东到家订单jd-orders
流量jd-traffic
履约jd-fulfillment
门店详情jd-store-detail
评价jd-review
售后jd-aftersale
体检jd-health-check
违规jd-violation
🛵 美团买药订单mt-orders
退款mt-refund
履约mt-fulfill
评价mt-review
服务分mt-service-score
服务分析mt-service-analysis
后台数据mt-backend-data
后台仪表盘mt-backend-dashboard
责任响应mt-response
💬 聊天记录淘宝天猫chat-taobao
淘宝闪购chat-flash
京东到家chat-jd
美团买药chat-meituan
🚀 系统设置聚水潭配置jst-settings
👥 系统管理用户管理sys-users

3. 仪表盘

仪表盘是登录后的默认首页，提供业务全局概览。包含两个子页面：主仪表盘（dashboard）和 库存仪表盘（dashboard-inv）。

📊3.1 主仪表盘

📅 时间筛选

页面顶部提供日期范围选择器，可筛选指定时间段的数据。默认展示最近 30 天数据。

📊 展示内容

模块API说明
整体统计/api/dashboard/stats总订单数、总金额、总退款、净收入等核心指标
渠道分布/api/dashboard/channel按渠道（淘宝/京东/美团）展示订单与金额占比
近期订单/api/dashboard/recent最新订单流水
后台统计/api/dashboard/backend-stats后台门店、商品、订单数据汇总
门店营收排名/api/dashboard/store-ranking按门店营收降序排名
商家收入趋势/api/dashboard/merchant-income-trend商家收入随时间变化折线图
门店利润排名/api/dashboard/store-profit-ranking按利润排名的门店列表
门店损耗排名/api/dashboard/store-loss-ranking按损耗排名的门店列表
淘宝闪购服务/api/dashboard/tbflash-service淘宝闪购服务评分概览
未收货采购/api/dashboard/unreceived-purchases待收货入库的采购单列表
概览/api/dashboard/overview多维度数据总览卡片
聊天汇总/api/dashboard/chat-summary客服聊天数据汇总

🏭3.2 库存仪表盘

库存仪表盘（dashboard-inv）聚焦库存健康度，展示：

  • 总库存商品数 / 总库存价值
  • 低库存预警商品列表
  • 近 7/15 天销量 TOP 商品
  • 周转率分析
  • 各仓库库存分布

4. 商品管理

📦4.1 商品资料

页面代码： products　API： /api/products　数据表： products

商品资料是商品 SKU 的主数据管理页面，支持增删改查、批量导入、分类管理。

字段说明

字段类型说明示例
skuvarchar(100)商品 SKU 编码，唯一PCY-2024-001
namevarchar(255)商品名称维生素 C 1000mg
categoryvarchar(100)一级分类保健品
subcategoryvarchar(100)二级分类维生素类
specvarchar(200)规格100粒/瓶
colorvarchar(50)颜色/口味橙子味
pricedecimal(10,2)销售价89.00
cost_pricedecimal(10,2)成本价45.00
costdecimal(12,2)最新成本（含运费分摊）48.50
unitvarchar(20)单位瓶
tagsvarchar(500)标签，逗号分隔热销,新品
statusvarchar(20)状态：在售/下架/缺货在售
supplier_idint供应商 ID1
channelvarchar(50)主销售渠道美团买药
imagetext商品图片 URL/images/prod/001.jpg
descriptiontext商品描述...

操作说明

新增商品

点击"新增"按钮 → 填写 SKU、名称、分类、规格、价格等 → 保存

编辑商品

列表中点击商品行 → 进入编辑模式 → 修改字段 → 保存

批量导入

点击"批量导入" → 下载模板 → 填写数据 → 上传 Excel（/api/products/batch-import）

批量删除

勾选多个商品 → 点击"批量删除"（/api/products/batch-delete）

SKU 查重

新增前可调用 /api/products/check-sku 检查 SKU 是否已存在

分类管理

查看 /api/products/categories 获取所有分类；调用 /api/products/update-category 修改分类

💡 提示： 商品资料是订单、库存、采购等模块的基础数据，SKU 一旦创建不可修改，删除前请确认无关联订单和库存。

📈4.2 商品销量

页面代码： product-sales　API： /api/report/product-sales

按商品维度统计销量、销售额、退货率、毛利等指标，支持时间范围筛选和门店筛选。

核心指标

  • 销售数量、销售金额、退货数量、退货率
  • 毛利、毛利率
  • 动销率（有销售 SKU 数 / 总 SKU 数）
  • 销量趋势图（按日/周/月）

🏭4.3 供应商信息

页面代码： product-supplier　API： /api/suppliers　数据表： suppliers

管理供应商档案，包含联系人、联系方式、主营品类等。

操作

  • 增删改查供应商
  • 批量导入（/api/suppliers/batch-import）
  • 关联商品查看（通过 supplier_id 关联 products 表）

5. 库存管理

◧5.1 商品库存

页面代码： inv-stock　API： /api/inventory　数据表： inventory

实时库存查询页面，支持多仓库、多门店的库存查看与修改。

筛选与查看

筛选项说明
仓库名称下拉选择仓库，/api/inventory/warehouses 获取
商品名称/SKU支持模糊搜索
门店多选
标签按商品标签筛选
库存状态充足/偏低/缺货

表格字段（关键字段）

字段说明
qty_available可用库存
qty_actual实际库存
qty_locked锁定库存（已下单未发货）
purchase_in_transit在途采购
safety_stock安全库存阈值
sales_yesterday / 7d / 15d昨日/7日/15日销量
suggest_purchase建议采购量
near_expired近效期数量
damaged_stock损坏库存

修改库存

点击编辑

列表行点击"修改"按钮

调整数量

输入新的可用库存数（/api/inventory/<id> PUT）

保存

系统记录修改时间（update_time）

⚠5.2 库存预警

页面代码： inv-alert

列出所有低于安全库存或近效期的商品，触发预警条件。

自定义规则

支持自定义预警规则，例如：

  • 当可用库存 < 安全库存时触发
  • 当商品距过期 < 30/60/90 天时触发（严重条件可分级）
  • 当销量 7 日环比下降超 50% 时触发

📍5.3 曹庄仓库存

页面代码： inv-caozhuang

独立的曹庄仓库存管理页面。曹庄仓作为独立仓库，库存数据单独维护，与主仓库互不影响。该页面与"商品库存"页面操作方式一致，但仅展示 warehouse="曹庄仓" 的记录。

📅5.4 历史快照（按日期追加记录）

适用页面： inv-stock（商品库存）与 inv-caozhuang（曹庄仓库存）

快照表： inventory_daily　API： /api/inventory/daily?date=YYYY-MM-DD、/api/inventory/dates

自 V2.1 起，两个库存页面均支持按日期查看历史库存快照。系统在每次聚水潭同步时，自动将当前库存追加写入 inventory_daily 表（按 SKU + 仓库 + 日期去重），主表 inventory 仍保持覆盖更新以反映实时库存。历史快照永不丢失，可追溯任意日期的库存状态。

工具栏新增控件

控件位置作用
📅 日期选择器商品库存 / 曹庄仓库存 工具栏左侧选择历史日期查看当日快照
「今天」按钮日期选择器右侧一键回到今日实时库存视图

查看历史库存

选择日期

在日期选择器中点击目标日期（仅显示有快照的日期）

查看快照

表格自动加载该日库存：可用库存、实际库存、锁定库存等全部字段均显示当日数值

返回实时

点击「今天」按钮或清空日期选择器，恢复为实时库存视图

⚠ 注意事项

  • 历史快照为只读：选择历史日期时，「修改」按钮不可用，无法编辑历史记录
  • 当日去重：同一 SKU 同一仓库同一天多次同步，仅保留最后一次的快照
  • 实时视图不变：今日库存仍走 /api/inventory，与 V2.1 行为完全一致
  • 首次启用：V2.1 部署时已回填当日初始快照（约 9 万行），次日起新增完整日期历史

数据流示意

步骤动作inventory 主表inventory_daily 快照表
1聚水潭同步INSERT ON DUPLICATE KEY UPDATE（覆盖）INSERT（按 SKU+仓库+日期去重追加）
2查看今日库存读取实时数据不参与
3查看历史日期不参与读取该日期快照

📈5.5 进销存报表

入口： 库存管理 → 进销存报表（独立子网页 psv.html，新窗口打开，与门店补货同模式）　API： POST /api/export/psv（生成） / GET /api/export/psv/list（列表） / POST /api/export/psv/delete（删除） / POST /api/export/psv/store-summary（预览）　数据表： inventory_daily / purchase_in / orders / jst_sales_daily

页面包含两套能力：① 在线预览（门店进销存预览区）：按筛选日期直接实时查询数据库，默认 门店 × SKU 维度，无需先生成报表，支持维度切换 / 门店筛选 / 出库类型筛选 / 分页；② 导出报表：按「门店 × 日期 × 商品」维度生成进销存明细 Excel，每天 03:00 自动生成（默认最近 30 天），也可在页面选择起止日期后点击「🔄 生成并下载」手动生成；生成完成后在历史报表列表下载。

导出结构已与《进销存_daily_purchase_sales_inventory_template》模板对齐。

在线预览（门店进销存预览区）

预览区不依赖预生成报表，按所选日期范围直接查询数据库实时聚合，默认展示 SKU 维度（每家门店 × 每个 SKU），可切换 门店维度（每店一行汇总）。

维度列数说明
SKU 维度（默认）12 列门店编码 / 门店名称 / SKU / 商品名称 / 期初库存 / 进货数量·金额 / 销售数量·金额 / 退货数量·金额 / 期末库存；30 天全量约 7.2 万行（36 家 × 2,000+ SKU），按 50 条/页分页，表格底部带合计行与汇总条
门店维度10 列门店编码 / 门店名称 / 期初库存 / 进货数量·金额 / 销售数量·金额 / 退货数量·金额 / 期末库存（每店一行，36 家）

预览区字段口径（SKU 维度 12 列 / 门店维度 10 列）

#字段取值口径
1门店编码归一化门店名（去渠道前缀/仓库后缀），与导出报表口径一致
2门店名称仓库原始名称（含渠道前缀，如「全佑美团-青浦」），取最近支付时间对应的门店名
3SKU聚水潭商品编码（仅 SKU 维度有）
4商品名称商品主数据名称（products 表兜底，缺失回退快照/入库/销售的 goods_name；仅 SKU 维度有）
5期初库存窗口内最早库存快照日（或窗口前最近快照）的 qty_available 合计
6 / 7进货数量 / 进货金额窗口内采购入库数量 / 金额合计（purchase_in，按 io_date 聚合）
8 / 9销售数量 / 销售金额窗口内订单销售数量 / 金额合计（orders，按创建时间聚合；金额取 merchant_income，为 0 时回退 total_amount）。total_amount = 聚水潭整单实付金额按商品标价（price×qty）占比分摊到每行（同步时自动分摊，历史数据已一次性回填）；已取消 / 异常订单不参与统计
10 / 11退货数量 / 退货金额窗口内退货数量 / 金额合计（jst_sales_daily.refund_qty / refund_amount，京东渠道除外）
12期末库存窗口内最晚库存快照日（或窗口后最近快照）的 qty_available 合计
⏱ 数据实时性： 预览区每次点「查询」均实时读取数据库。销售 / 退货 来自 orders / jst_sales_daily，其中 orders 表由聚水潭 每 10 分钟自动同步（crontab */10 * * * * jst_sync_cron.sh），因此销售数量最多落后真实下单约 10 分钟，刷新页面或重新查询即可看到最新值；期初 / 期末 来自 inventory_daily 每日库存快照（每日更新）；进货 来自 purchase_in。出库类型筛选：全部 / 仅进货 / 仅销售 / 仅退货 / 仅变动（进货或销售或退货）/ 仅快照（无变动）。
🏬 门店范围（白名单）： 预览与导出均按《美团门店名称.xlsx》的 36 家门店白名单过滤；公共仓（含「新苗禾医疗器械 / 曹庄保留 / 次品 / 过期 / 差异 / 破损」等关键词）与京东线上渠道（含 JD 英文变体）自动排除。

历史报表管理

所有已生成的进销存报表按修改时间倒序展示在页面「📁 历史报表」列表中，可随时「⬇ 下载」。不再需要的旧报表可点击右侧「🗑 删除」按钮清理（弹窗确认后不可恢复），删除操作会一并清理对应的 .xlsx / .xlsx.json / .xlsx.rows.json 三个文件，释放磁盘空间。系统每日 03:00 自动清理超过 7 天的旧报表。

导出文件结构（8 个 Sheet）

Sheet内容
每日进销存明细主明细表，15 列，按 门店×日期×商品 逐行展示（超 100 万行自动拆分多个同名 Sheet）
门店配置表门店维度配置：门店编码（归一化门店名）、门店名称（原始仓库名）、城市、门店等级、开业日期、状态
商品配置表商品维度配置：商品编码、商品名称、品类、成本价、售价、SKU 规格、状态
字段说明主明细表 15 个字段的取值口径说明（模板结构）
数据规范5 条数据规范（模板结构，按系统实际口径标注）
门店进销存汇总附录：按门店汇总期初/进货/销售/退货/期末
每日入库销售附录：每日入库与销售明细
每日库存快照附录：每日库存快照

每日进销存明细 · 15 列字段口径

#字段取值口径
1日期业务日期（YYYY-MM-DD）
2门店编码归一化门店名（去渠道前缀/仓库后缀），系统暂无独立编码体系，以此作为门店唯一标识
3门店名称仓库原始名称（含渠道前缀，如「全佑美团-青浦」），取最近支付时间对应的门店名
4商品编码聚水潭 SKU（文本格式，防 Excel 截断）
5商品名称商品主数据名称
6品类商品品类（products.category；缺失时回退聚水潭日销品类，当前源数据为空则导出为空）
7期初库存当日 00:00 库存快照（inventory_daily）；窗口首日取窗口前最近快照，后续缺失日由前一日递推锚点接力
8进货数量当日采购入库数量（purchase_in）
9进货金额当日采购入库金额
10销售数量当日订单销售数量（orders）
11销售金额当日订单销售金额（整单实付按商品标价占比分摊到每行；已取消 / 异常订单不参与）
12退货数量当日退货数量（聚水潭日销 jst_sales_daily.refund_qty，按 日期+门店+SKU 聚合，京东渠道除外）
13退货金额当日退货金额（jst_sales_daily.refund_amount）
14期末库存当日有快照取快照值；无快照日按「期初 + 进货 − 销售」推算并在备注标注「推算」
15备注「快照」/「推算」/「快照; 结存差异N(快照缺失期/调拨/退换/盘点)」，见下方说明
⚠ 备注标记口径：「快照」= 期末取真实库存快照；「推算」= 当日无快照，期末由 期初+进货−销售 推算补齐缺失日；「快照; 结存差异N」= 快照值与该公式推算值相差 N（差异来源：快照缺失期、调拨、退换、盘点），差异在备注中说明。

6. 采购与入库管理

📦6.1 采购单

页面代码： purchases　数据表： purchases

管理采购订单全流程：创建 → 待确认 → 已确认 → 待收货 → 已收货 → 已入库。

统计卡片

页面顶部展示：本月采购总额、待收货单数、本月已入库单数、采购商品总数。

筛选项

筛选项说明
采购单号精确/模糊搜索
供应商下拉多选
状态待确认/已确认/待收货/已收货/已入库
下单日期日期范围

列表字段

采购单号、供应商、商品数、采购总额、预计到货日、实际到货日、状态、创建时间。

查看明细

点击单条采购单可展开查看商品明细（SKU、数量、单价、金额、备注）。

状态说明

状态说明下一步
待确认采购单已创建，未确认确认 → 已确认
已确认已审核，等待供应商发货发货 → 待收货
待收货供应商已发货，等待入库收货 → 已收货
已收货已到货，等待入库登记入库 → 已入库
已入库库存已增加，流程结束—

手动同步

采购单支持从聚水潭 ERP 同步（参见 第 17章 聚水潭对接）。

🏭6.2 入库单

页面代码： purchase-in　数据表： purchase_in

记录实际入库明细，包括入库时间、入库数量、仓库、批号、生产日期、有效期等。

筛选项

入库日期范围、仓库、供应商、商品 SKU、状态（已确认/待收货入库）。

列表字段

入库单号、采购单号、商品 SKU、商品名称、入库数量、仓库、批号、生产日期、有效期、状态、入库时间。

7. 订单管理

📋7.1 销售订单

页面代码： order-sales　API： /api/orders　数据表： orders（14 万+ 条）

多平台销售订单聚合页面，支持淘宝/京东/美团等渠道订单的统一查询和管理。

📋 筛选与查找

筛选项说明
订单号精确搜索
平台/渠道下拉多选，/api/orders/channels
仓库下拉多选，/api/orders/warehouses
门店下拉多选
订单状态已付款/已发货/已完成/已退款/已取消
下单时间日期范围
金额范围最小/最大金额

📥 导入订单

选择平台

点击"导入订单"按钮，选择来源平台

上传文件

上传 Excel/CSV 文件（/api/import-orders）

字段映射

系统自动映射列，必要时手动调整

确认导入

预览无误后确认，系统批量插入数据库

📤 导出订单

支持按当前筛选条件导出 Excel 文件。

🏷 大额订单标识

金额超过阈值（默认 1000 元）的订单会高亮显示，便于重点跟进。

🔄7.2 售后订单

页面代码： order-aftersale　API： /api/refunds　数据表： refunds（2 万条）

统一管理售后退款单，与销售订单关联。

🔄 筛选项

退款单号、订单号、门店、渠道、退款时间范围、退款金额范围、退款原因。

📊 字段说明

字段说明
refund_id退款单号
order_id原订单号
apply_time / success_time申请时间 / 退款成功时间
reason退款原因
total_amount / refund_amount订单总额 / 退款金额
is_biz是否商家责任
apply_qty / actual_return_qty申请退货数 / 实际退货数

8. 售后管理

售后管理涵盖退款、评价、客服等多个维度，提供完整的售后业务闭环。除第 7.2 节的售后订单外，还包括：

  • 评价管理： /api/reviews - 多平台商品/服务评价（数据表 reviews、mt_review、tb_flash_review、jd_review）
  • 评价统计： /api/reviews/stats - 评分分布、评价数趋势
  • 评分分布： /api/reviews/score-distribution - 1-5 星分布
  • 履约失败： /api/fulfillment - 履约异常单据（数据表 fulfillment_fails）
  • 客服服务： /api/customer-service - 客服绩效与服务记录

📊评价钻取分析

系统支持多维度数据钻取（drilldown），从总览到明细：

钻取维度API
订单钻取/api/drilldown/orders
履约钻取/api/drilldown/fulfillment
退款钻取/api/drilldown/refunds
评价钻取/api/drilldown/reviews
后台门店钻取/api/drilldown/backend-stores

9. 报表看板

报表看板模块提供多维度的数据分析与报表导出能力，包含 5 个子页面。

📊9.1 销售报表

页面代码： rpt-sales　API： /api/reports/sales、/api/report/sales-by-warehouse、/api/report/product-sales

按时间/仓库/商品/渠道维度展示销售汇总。支持趋势图、对比图、TOP 排行。

📦9.2 库存价值报表

页面代码： rpt-inv-value　API： /api/reports/inventory-value

按仓库/分类展示库存总价值（成本价 × 数量），用于资产盘点与库存周转分析。

🔄9.3 补货看板

页面代码： rpt-replenish　API： /api/reports/replenish、/api/reports/replenish-by-warehouse

按《全佑补货系统 V7.2》算法，为每个 门店 × 商品 组合自动计算「建议补货量」，帮助采购人员快速回答三个问题：哪些店、哪些货、该补多少。页面为只读建议（账面口径），实际下单请结合促销、新品、节假日等业务信息。

V2.7 重要变更：页面「库存位置」三列（现货 / 在途 / 有效库存）自 2026-08-17 起改为通过 聚水潭 inventory.query API 实时查询（数据表 inventory_live），确保库存数据准确、实时，不再依赖每日库存快照。每日 03:30 系统自动执行「实时库存拉取 → 销量聚合 → 补货重算」全链路，打开页面即为最新计算结果。

补货看板 - 补货建议明细字段

分组字段说明
门店门店 / 等级门店名称；S/A/B/C 等级按近 30 天净销售额排名（S 顶流 → C 长尾）
商品 SKU / 名称补货目标商品
近 30 天销量特征日均 / 有效天 / 30 天销量近 30 天逐日净销量（销售 − 退货）统计，有效天不足 15 天时 XYZ 显示「数据不足」
σ / CV销量波动标准差与变异系数，σ 越大越不稳，CV 用于 XYZ 分档
XYZ销量稳定度：X 稳定 / Y 波动 / Z 偶尔；「数据不足」按 Y 档参数兜底
趋势 / 预警增长 / 稳定 / 衰退判定；「⚠两周下滑」= 本周均值 < 上周 < 前周（需 ≥21 天有效销量）
库存位置现货当前可用库存（聚水潭 API 实时查询 qty）
在途已下单未到货数量（聚水潭 API purchase_qty）
有效库存有效库存 = 现货 + 在途；显示「未知」= 该门店 × SKU 暂无最新库存数据，仅按销量给建议
成本价聚水潭商品成本价（估算口径），实际采购金额以供应商报价为准
补货计算输出补货目标目标 = 日均 × T + Z × σ × √T（系统参考线）
触发线触发线 = 日均 × T × K；有效库存 < 触发线才建议补货
建议量建议量 = min(目标 − 有效库存, 近 30 天销量 × M, 近 30 天销量 × 0.5)，向上取整；0 或空 = 无需补货
补货金额建议量 × 成本价（估算口径）
说明为什么这样建议（库存低于触发线 / 不动销 / 衰退熔断等）
策略参数T / Z / K / M算法参数：T 补货周期、Z 服务水平系数、K 触发系数、M 补货倍数上限（可在门店级配置，保存后需点「重新计算」生效）

数据来源与更新频率

数据项来源更新方式
销量窗口jst_sales_daily（聚水潭 API 聚合）近 30 天净销量每日 03:30 自动聚合，无需手工导入
现货 / 在途 / 有效库存聚水潭 inventory.query API 实时查询（inventory_live 表，按门店真实分仓编码拉取）每日 03:30 自动拉取全量（约 2.4 万行 / 36 家门店），数据准确实时
成本 / 名称聚水潭商品成本价与商品名随销量聚合同步刷新
注意事项：① 若页面大量商品「有效库存」显示「未知」，说明该日实时库存拉取未成功，请检查服务器 agg_sales_cron.log 中 fetch_inventory_api.py 步骤是否报错（常见原因：聚水潭接口限流，脚本已内置指数退避自动重试）；② 库存三列仅在补货看板生效，商品库存 / 曹庄仓库存页面仍使用原库存数据链路。

🏆9.4 排行榜

页面代码： rpt-ranking　API： /api/reports/ranking、/api/reports/review

商品销量排行、门店营收排行、评价排行等多维排行榜。

💸9.5 门店费用

页面代码： rpt-expense　API： /api/store-expense、/api/store-expense/stats　数据表： store_expense

记录各门店运营费用，支持按门店/费用类型/时间维度统计。

支持的操作

  • 批量导入费用数据（/api/store-expense/batch-import）
  • 按门店删除费用（/api/store-expense/delete-by-store）
  • 费用统计汇总（/api/store-expense/stats）

10. 淘宝闪购模块

淘宝闪购（TB Flash）模块对接淘宝闪购业务，提供 7 个子页面的全方位数据分析能力。所有数据通过 Excel 批量导入，支持导出。

数据导入方式： Excel 批量导入　支持导出： 是

📊10.1 数据概览

页面代码： tbflash-dashboard

聚合展示淘宝闪购的所有维度数据：服务、经营、流量、推广、订单、评价的关键指标卡片与趋势图。

📋10.2 服务数据

页面代码： tbflash-service　API： /api/tb-flash/service　数据表： tb_flash_service

展示门店服务评分数据：准时率、门店评分、服务时长等。

核心字段

字段说明
date_from / date_to数据周期
supplier_name / store_name供应商/门店名称
on_time_rate准时率
store_rating门店评分

🏭10.3 经营数据

页面代码： tbflash-business　API： /api/tb-flash/business　数据表： tb_flash_business

经营指标数据：GMV、订单量、客单价、复购率、转化率等。

📈10.4 流量数据

页面代码： tbflash-traffic　API： /api/tb-flash/traffic　数据表： tb_flash_traffic

流量数据：访客数、浏览量、跳失率、平均停留时长等。

🎯10.5 推广数据

页面代码： tbflash-promotion　API： /api/tb-flash/promotion　数据表： tb_flash_promotion

推广投放数据：花费、展现、点击、ROI、CPC、CPM 等。

🛒10.6 订单数据

页面代码： tbflash-orders　API： /api/tb-flash/orders/list　数据表： tb_flash_orders（1.1 万条）

淘宝闪购订单明细，支持：

  • 订单列表查询（分页、筛选）
  • 订单汇总（/api/tb-flash/orders/summary）
  • 订单导入（/api/tb-flash/orders/import）
  • 清空数据（/api/tb-flash/orders/clear）
  • 导出 Excel（/api/tb-flash/orders/export）

⭐10.7 评价数据

页面代码： tbflash-review　API： /api/tb-flash/review/list　数据表： tb_flash_review

淘宝闪购用户评价，支持汇总（summary）、筛选（options）、导入、清空、导出。

11. 京东到家模块

京东到家（JD）模块提供 8 个子页面，全面覆盖订单、流量、履约、门店、评价、售后、体检、违规等业务维度。

🛒11.1 订单

页面代码： jd-orders　API： /api/jd-orders/list　数据表： jd_orders、jd_order_ext

京东到家订单管理，支持列表、汇总、选项筛选、导入、清空、导出。

📈11.2 流量

页面代码： jd-traffic　API： /api/jd-traffic/list　数据表： jd_traffic_overview

流量数据看板，含访客、浏览、转化漏斗。支持 Excel/CSV 上传（/api/jd-traffic/upload）。

📋11.3 履约

页面代码： jd-fulfillment　API： /api/jd-fulfillment/list　数据表： jd_fulfillment

履约数据：发货及时率、妥投率、平均履约时长等。支持导入与上传。

🏪11.4 门店详情

页面代码： jd-store-detail　API： /api/jd/store-detail/list　数据表： jd_store_detail

门店维度详情，含门店评分、库存周转、营业时间等。

⭐11.5 评价

页面代码： jd-review　API： /api/jd/review/list　数据表： jd_review

京东到家评价数据，支持上传、清空、导出。

🔄11.6 售后

页面代码： jd-aftersale　API： /api/jd/aftersale/list　数据表： jd_aftersale

京东到家售后单，含退款、退货、换货等。

🚑11.7 体检

页面代码： jd-health-check　API： /api/jd/health-check/list　数据表： jd_health_check

门店健康度体检，综合评分各项运营指标。

⚠️11.8 违规

页面代码： jd-violation　API： /api/jd/violation/list　数据表： jd_violation

京东到家平台违规记录：违规类型、扣分、处罚等。支持上传、清空、导出。

⚠️ 注意： 违规记录会影响店铺评分和流量分配，建议及时处理。

12. 美团买药数据看板

美团买药（MT）模块是数据量最大的业务模块，提供 9 个子页面。涉及订单、退款、履约、评价、服务分、服务分析、后台数据、后台仪表盘、责任响应等维度，关联 16 张数据表。

🛒12.1 订单

页面代码： mt-orders　API： /api/mt/orders　数据表： mt_orders、mt_order_ext、mt_order_items、mt_order_bill、mt_order_withdrawal、mt_order_rebate、mt_order_product_activity、mt_order_product_detail

美团买药订单全数据视图，含订单、商品、活动、退款、结算、提现等多维数据。

支持的操作

💸12.2 退款

页面代码： mt-refund　API： /api/refunds?channel=美团买药

美团买药退款单，关联 refunds 主表。

📋12.3 履约

页面代码： mt-fulfill　数据表： mt_fulfillment（9.7 万条，最大数据表）

美团履约数据：发货时效、配送时长、妥投率等。

⭐12.4 评价

页面代码： mt-review　API： /api/mt/review　数据表： mt_review

美团买药评价数据，支持批量导入、删除、导出。

🏅12.5 服务分

页面代码： mt-service-score　API： /api/mt/service-score　数据表： mt_service_score

美团门店服务评分数据。

📊12.6 服务分析

页面代码： mt-service-analysis　API： /api/mt/service-analysis　数据表： mt_service_analysis

服务评分趋势分析、对比分析。

📊12.7 后台数据

页面代码： mt-backend-data　API： /api/mt/backend-data　数据表： mt_backend_data

美团后台数据导出后的存储与查询。

📊12.8 后台仪表盘

页面代码： mt-backend-dashboard

美团后台数据可视化看板：按日汇总，展示多维度数据趋势。

📋12.9 责任响应

页面代码： mt-response　数据表： mt_responsibility（2.9 万条）

美团责任响应数据：责任归属、响应时效、处理结果等。

13. 平台商品明细与每日同步

🛒13.1 平台商品明细

页面代码： platform-products.html　进入方式： 主系统侧边栏「商品信息 → 平台商品明细」（新窗口打开）

汇总展示淘宝闪购、美团与京东三个平台的门店商品明细，用于核对各平台上架商品、价格、库存与销量。

门店口径： 按美团门店口径统一过滤，仅保留 36 家门店（其余门店数据不展示，与进销存报表口径一致）。

三平台 Tab： 页面顶部切换「淘宝闪购」（蓝色）/「美团」（橙色）/「京东」（红色），各平台独立加载。

数据日期下拉： 选择最近 15 天内的任意快照日期（默认最新），切换后表格、统计卡片、导出文件名自动联动。

搜索与筛选： 支持按 门店 / 商品名称 / 条码 / SKU / 类目 组合搜索（京东支持 SKU编码 / 商家编号），库存为 0 标红显示；京东额外展示 会员价 / 实时价 / 可用库存 / 库存状态（可售/不可售）/ 小时达医保。

导出 CSV： 右上角导出按钮，文件名自动携带平台与日期。

⏰13.2 每日自动同步

本机 Windows 计划任务每天 05:30 自动执行三个商品同步任务（RPA 每日 05:00 下载数据后）：

计划任务数据源（本机）生成文件（服务器 /opt/mystore）保留
MeituanDailySync（美团）D:\rpa_transer\美团\美团商品信息\YYYY-MM-DD\meituan_products_YYYYMMDD.csv（约 80,165 行 × 36 店 × 23 字段）15 天
TaobaoDailySync（淘宝闪购）D:\rpa_transer\淘宝闪购\商品信息\商品信息.ziptaobao_products_YYYYMMDD.csv（约 97,280 行 × 36 店 × 18 字段）15 天
JdDailySync（京东）D:\rpa_transer\京东\京东商品明细\京东商品明细M-D.zipjd_products_YYYYMMDD.csv（约 93,924 行 × 36 店 × 19 字段）15 天

淘宝同步完成后会同时刷新主快照 platform_products.csv（供旧页面与导出使用，刷新前自动备份 .bak_prev）。超过 15 天的历史文件自动清理，并更新日期清单 manifest 供页面下拉读取。

幂等机制： 已上传过的日期自动跳过，不会重复上传；支持 --force 强制重传。

📊13.3 同步看板

页面代码： sync-dashboard.html　进入方式： 主系统侧边栏「商品信息 → 同步看板」（新窗口打开）

查看全部 10 个每日同步任务每天是否正常运行，分两组展示：

分组任务执行节奏
商品数据（本机）美团商品 / 淘宝闪购 / 京东商品 / 主快照每天 05:30（本机计划任务，数据保留 15 天）
服务器同步任务聚水潭订单（每10分钟）/ 单据同步（每30分钟）/ 统一订单（每15分钟）/ 进销存报表（03:00）/ 销售汇总（03:30）/ 质量巡检（06:00/18:00）服务器 crontab 自动执行，状态由 sync_health.py 每半小时采集
状态颜色含义
✓ 已上传 / ✓ 正常绿当日任务已成功运行；点击行可展开查看 文件 / 行数 / 门店数 / 大小 / 运行时间等详情
✗ 缺失 / ✗ 未运行红当日该任务无成功记录（商品任务多为 RPA 未生成数据；服务器任务多为脚本异常）
⏳ 待执行灰当天尚未到 05:30 执行时间且暂无任何记录
— 无记录浅灰该任务上线之前的日期（如商品数据早于 2026-08-24）

时间范围： 右上角可切换 近 7 / 15 / 30 / 90 天（服务器任务状态可回溯最近 30 天）。

排查指引： 商品数据缺失 → 先确认本机 RPA 是否生成当日数据文件，再确认计划任务 MeituanDailySync / TaobaoDailySync / JdDailySync 是否正常运行；服务器任务未运行 → 在服务器上查看对应日志（jst_sync.log / unified_sync.log / jst_extra_sync.log / agg_sales_cron.log / dq_check.log / /tmp/psv_cron.log）并手动重跑对应 cron 脚本。

14. BI看板与A/B缺货率计算逻辑

📊14.1 三平台BI看板概述

三平台BI看板是统一的跨平台数据对比页面，覆盖淘宝闪购、京东、美团三个平台的36家门店，共108行数据。

默认只显示单平台36行，点击顶部平台标签可切换查看。页面提供日期筛选、门店筛选、CSV导出功能。

BI看板15个核心指标

#字段说明数据来源
1GMV(元)当日成交总额各平台报表
2访客量当日门店访客数各平台报表
3曝光量当日门店曝光次数各平台报表
4点击率点击量/曝光量各平台报表
5转化率下单访客/总访客各平台报表
6付费花费(元)当日推广消耗各平台报表
7付费依赖度付费花费/GMV计算字段
8评分门店综合评分各平台报表
9A类缺货率高销量SKU缺货比例（详见14.2）unified_orders + inventory
10B类缺货率中销量SKU缺货比例（详见14.2）unified_orders + inventory
11履约达标率按时送达订单比例各平台报表
12商责退款率商家责任退款占比各平台报表
13取消订单量当日取消订单数各平台报表
14营业时长(h)当日营业小时数各平台报表
15客单价GMV/下单量计算字段

📦14.2 A/B缺货率计算逻辑

核心概念：A/B缺货率用于衡量不同销量层级商品的缺货情况。将SKU按近30天销量分档，计算各档位中库存为零的SKU占比。

数据源

数据表用途关键字段
unified_orders 聚水潭API统一订单表，三平台SKU级销量数据 platform, shop_name, goods_sku, goods_quantity, pay_time, create_time
inventory 实时库存表，提供各门店SKU库存数（2026-08-11 起由 store_inventory 切换） warehouse, sku, qty_available

三平台时间字段差异

平台（unified_orders.platform）BI看板显示名时间字段格式
美团美团pay_time标准 datetime
京东到家京东create_time标准 datetime
淘宝闪购淘宝闪购create_time中文格式（如 2025年07月10日 14:30:00），需 STR_TO_DATE 转换
注意：京东到家在 unified_orders 中的 platform 值为"京东到家"，但在BI看板中显示为"京东"，代码中做了名称映射。

计算流程（7步）

Step 1：预加载库存表

从 inventory 查询所有 warehouse 含「全佑」的记录，构建内存字典 inv_map。Key 为 {城市}_{SKU}，Value 为 qty_available。城市通过 SUBSTRING_INDEX(warehouse, '-', -1) 提取（如"全佑健康-嘉兴" → "嘉兴"）。

Step 2：按平台分别查询订单

对三个平台各执行一次 SQL，从 unified_orders 查询近30天、按 shop_name + goods_sku 分组的销量汇总：

SELECT shop_name, goods_sku,
       SUM(COALESCE(goods_quantity, 1)) as sales_count
FROM unified_orders
WHERE platform = '{平台名}'
  AND {时间过滤条件}
  AND goods_sku IS NOT NULL AND goods_sku != ''
  AND shop_name IS NOT NULL
GROUP BY shop_name, goods_sku
Step 3：城市匹配

对每条记录的 shop_name，用36城白名单做关键词匹配。例如"全佑美团—嘉兴"匹配到"嘉兴"。匹配不到的记录直接跳过，不参与统计。

白名单36城：松江、鹿城路、静安、白云、宝安、珠海、陆家嘴、中山、常熟、常州、江阴、嘉定、惠南、无锡、湖州、绍兴、丽水、温州、柯桥、义乌、金华、泗泾、青浦、南桥、周浦、金山、嘉兴、闵行、花桥、城南、临平、镇江、扬州、太仓、虹口、临港。

Step 4：库存查询

用 {城市}_{SKU} 在 inv_map 中查找库存值：

  • stock == 0 → 该 SKU 缺货
  • stock > 0 → 该 SKU 正常
  • stock == -1（inv_map 中无记录）→ 该 SKU 忽略，不计入总数也不计入缺货数
Step 5：A/B 分类

按 sales_count（近30天销量）分档：

档位条件含义
A类sales ≥ 20高销量 SKU
B类10 ≤ sales ≤ 19中销量 SKU
忽略sales < 10低销量，不统计
Step 6：缺货率计算

对每个 {平台}_{城市} 组合分别统计：

A类缺货率 = A类缺货SKU数 / A类总SKU数 × 100%
B类缺货率 = B类缺货SKU数 / B类总SKU数 × 100%

结果为百分比字符串（如 "12.5%"），该城市无 A/B 类数据则为 null（页面显示为空）。

Step 7：输出与渲染

返回字典，Key 格式为 {平台}_{城市}，例如：

{
  "美团_嘉兴": {"a_rate": "0.0%", "b_rate": "21.1%"},
  "京东_嘉兴": {"a_rate": null, "b_rate": null},
  "淘宝闪购_中山": {"a_rate": "12.5%", "b_rate": "8.3%"}
}

BI看板三个平台区块分别用对应前缀的 key 取值渲染。

🔧14.3 计算示例

示例：美团嘉兴店

A类（销量 ≥ 20）：共 2 个 SKU

SKU近30天销量库存缺货
YNWDFXDY100ML2221否
BSWSBK75755227否

A类缺货率 = 0 / 2 = 0.0%

B类（销量 10~19）：共 19 个 SKU，其中 4 个缺货

SKU近30天销量库存
YGLLJYDBFL10140（缺货）
KEBTHS30130（缺货）
RXJFML10110（缺货）
HNKQKYM12110（缺货）
... 其余15个SKU库存正常

B类缺货率 = 4 / 19 = 21.1%

示例：京东嘉兴店（无数据场景）

京东到家嘉兴店近30天有51个SKU有销量，但最高单SKU销量仅5单，未达到B类门槛（10单），因此：

这种情况在BI看板上显示为空白，表示该门店该平台销量不足以生成缺货率指标。

📈14.4 当前数据覆盖情况

平台A类有数据门店B类有数据门店说明
淘宝闪购17/3626/36部分门店销量未达门槛
京东2/3615/36京东到家单SKU月销达20单的门店较少
美团28/3635/36覆盖最完整
数据更新频率：A/B缺货率随BI看板API实时计算，每次刷新页面时从 unified_orders 和 inventory 重新查询。unified_orders 数据由聚水潭API定时同步，inventory 由RPA定时任务每日同步（2026-08-11 起由 store_inventory 切换）。

15. 库存仓龄分析

⏳15.1 功能概述

页面代码： inv-age　API： /api/inventory/age-analysis　数据表： inventory + purchase_in

库存仓龄分析用于识别「长期未进货」的 SKU，帮助采购与运营发现滞销/积压库存。

入口：左侧菜单「库存管理 → ⏳ 库存仓龄分析」。

默认展示 当前有库存（可用库存 > 0）且仓龄 ≥ 20 天 的 SKU，按仓龄从大到小排序。

🧮15.2 仓龄计算公式

核心公式：仓龄(天) = 统计基准日(base_date) − 最后入库日期(last_in_date)

名词解释

名词含义
统计基准日仓龄计算的时间锚点，页面顶部「统计基准日」选择器，默认 2026-08-11。统计时间从基准日开始，基准日当天入库的记录不计入仓龄。
最后入库日期该 SKU 在该门店的全部采购入库单（purchase_in 表）中 最大的入库日期，即 MAX(io_date)；仅统计 io_date ≤ 基准日 的入库记录。
仓龄(天)基准日 − 最后入库日期，单位：天。
入库次数该 SKU 在该门店累计的入库单数量，即 COUNT(DISTINCT io_id)。
最后入库单号最近一次入库对应的入库单号（io_id），按入库日期降序取最新一条。

仓库匹配规则

注意：purchase_in.warehouse 带有「主仓/进货仓」后缀，匹配 inventory.warehouse 时需先去掉后缀。
例如：入库单「嘉兴主仓」→ 门店「嘉兴」；「嘉兴进货仓」→ 门店「嘉兴」。
SQL 实现：REPLACE(REPLACE(warehouse,'主仓',''),'进货仓','')

筛选条件

条件说明
当前有库存qty_available > 0（无库存的不参与仓龄展示）
仓龄 ≥ 阈值last_in_date ≤ 基准日 − min_age 天，min_age 默认 20，可调
统计时间范围仅统计 io_date ≤ 基准日 的入库记录

📋15.3 表格字段说明（10列）

#列名字段说明
1门店warehouse门店名称（仓库名）
2SKUsku商品编码
3商品名称name商品名称（优先 inventory.product_name，为空取 products.name）
4可用库存qty_available当前可用库存数
5订单占有qty_locked已下单未发货的锁定数量
6最后入库时间last_in_date最近一次入库日期（MAX(io_date)）
7最后入库单号last_io_id最近一次入库的入库单号
8仓龄(天)age_days基准日 − 最后入库日期（DATEDIFF）
9入库次数batch_cnt累计入库单数量（COUNT(DISTINCT io_id)）
10成本价cost_price商品成本价

🎨15.4 仓龄颜色分级

仓龄范围颜色提示
≥ 45 天红色严重积压，需重点关注
30 ~ 44 天橙色偏高，建议尽快补货/促销
20 ~ 29 天黄色超过阈值，持续观察

🔧15.5 API 参数说明

接口：GET /api/inventory/age-analysis

参数默认值说明
base_date2026-08-11统计基准日（仓龄 = 基准日 − 最后入库日期）
min_age20最小仓龄（天），只显示仓龄 ≥ 该值的 SKU
warehouse空按门店筛选
sku空按 SKU / 商品名称模糊搜索
page1页码
size50每页条数（最大 500）

核心 SQL（入库聚合子查询）

SELECT sku,
       REPLACE(REPLACE(warehouse,'主仓',''),'进货仓','') AS wh,
       MAX(io_date) AS last_in_date,
       COUNT(DISTINCT io_id) AS batch_cnt,
       SUBSTRING_INDEX(GROUP_CONCAT(io_id ORDER BY io_date DESC, id DESC SEPARATOR '|'), '|', 1) AS last_io_id
FROM purchase_in
WHERE io_date IS NOT NULL AND io_date <= 基准日 AND sku != ''
GROUP BY sku, REPLACE(REPLACE(warehouse,'主仓',''),'进货仓','')
说明：MariaDB 10.5 不支持 COUNT(DISTINCT) OVER(...) 窗口函数，故入库次数用 COUNT(DISTINCT io_id) 分组聚合，最后入库单号用 GROUP_CONCAT + SUBSTRING_INDEX 取最新一条。

16. 客服聊天记录

客服聊天记录模块按平台分为 4 个子页面，存储客服与客户的对话记录。系统支持 AI 智能解析聊天意图。

💬15.1 各平台聊天

平台页面代码筛选参数
淘宝天猫聊天记录-淘宝天猫chat-taobaoplatform=淘宝天猫
淘宝闪购聊天记录-淘宝闪购chat-flashplatform=淘宝闪购
京东到家聊天记录-京东到家chat-jdplatform=京东到家
美团买药聊天记录-美团买药chat-meituanplatform=美团买药

统一 API： /api/chats?platform=<平台>　数据表： chats、chat_messages、chat_summary

每个平台支持的操作

表格字段

字段说明
会话 ID聊天会话唯一标识
客户昵称买家昵称
客服昵称客服账号
开始/结束时间会话时间
消息数对话消息总数
客服首响首次响应时长
平均响应平均响应时长
AI 意图AI 解析的聊天意图

17. 聚水潭 API 对接

聚水潭（JST）是公司使用的 ERP 系统，本平台通过聚水潭 OpenAPI 实现订单、商品、库存、退款的双向同步。

页面代码： jst-settings　配置位置： 侧边栏「系统设置 → 聚水潭配置」

🔗16.1 接口设置页面

手动操作按钮

按钮API说明
测试连接/api/jst/test-connection验证 API 凭证是否有效
同步订单/api/jst/sync-orders从聚水潭拉取订单到本地
同步商品/api/jst/sync-products同步商品主数据
同步库存/api/jst/sync-inventory同步库存数据
同步退款/api/jst/sync-refunds同步退款单据
查看状态/api/jst/status查看上次同步时间和结果
查看配置/api/jst/config获取当前配置（脱敏）
更新配置/api/jst/update-config修改 API 凭证

API 凭证配置

需要在聚水潭开放平台获取以下凭证：

  • app_key： 应用 Key
  • app_secret： 应用密钥
  • access_token： 访问令牌（定期刷新）
  • shop_id： 店铺 ID（多店铺时配置）
⚠️ 安全提示： access_token 有有效期，过期后需重新获取。建议配置自动刷新机制。

同步日志

同步日志位于 /opt/mystore/jst_sync.log，可查看每次同步的详细记录。

18. AI 智能问答

系统内置 AI 智能问答功能，支持自然语言查询业务数据、解析评价情感、识别聊天意图。

已接入《操作手册》24 章知识库：除数据查询外，还可回答操作流程类问题（如"怎么新增用户"、"仓龄怎么计算"、"如何导出报表"），系统自动按问题关键词检索手册相关章节。

✦17.1 使用步骤

打开 AI 面板

页面右下角悬浮按钮，点击展开 AI 对话框

输入问题

用自然语言提问，例如："上月销售额最高的商品是什么？"

AI 解析

系统调用 /api/ai-chat 解析意图，自动生成 SQL 查询并执行

展示结果

结果以表格、图表或自然语言描述返回

内置快捷问题

问题说明
本月销售概况展示本月订单数、销售额、退货率等
库存预警商品列出所有低于安全库存的商品
近 7 天销量 TOP 10销量最高的 10 个商品
各门店营收排名按营收排名的门店列表
售后率最高的商品退货率高的商品 TOP 10
怎么新增用户操作手册：权限管理 — 新建用户步骤
仓龄怎么计算操作手册：库存仓龄分析计算公式

✦17.2 AI 评价解析

API： /api/ai-parse-review

AI 自动解析用户评价内容，提取：

  • 情感倾向（正面/负面/中性）
  • 关键问题分类（物流/商品/服务/包装等）
  • 具体问题点
  • 建议回复话术

✦17.3 AI 聊天解析

API： /api/ai-parse-chat

AI 解析客服聊天记录，识别：

  • 客户咨询意图（咨询商品/物流/退款/投诉等）
  • 客服响应质量
  • 潜在风险（差评/投诉倾向）
  • 关键词云

19. 数据质量监控

系统内置数据质量监控模块，自动检测数据异常、空值率、同步延迟等问题。

相关数据表： dq_alert_rule、dq_anomaly_detail、dq_check_log、dq_null_rate_log、dq_score_snapshot、dq_sync_lag_log

📊18.1 监控维度

维度说明
空值率监控关键字段为空的比例
同步延迟聚水潭同步数据的时间差
异常检测数据异常波动自动告警
质量评分按表/字段维度的质量评分快照
告警规则可配置的告警触发条件

⚠️18.2 告警规则

支持自定义告警规则（数据表 dq_alert_rule），包括：

  • 阈值告警：字段空值率超过 X%
  • 趋势告警：数据量环比下降超 X%
  • 同步告警：同步延迟超过 X 小时
  • 异常告警：检测到异常数据点

20. 权限管理

页面代码： sys-users　数据表： sys_users、sys_roles、sys_permissions、sys_role_permissions、sys_user_permissions、sys_user_roles

基于 RBAC（基于角色的权限控制）模型，支持细粒度模块权限授权。

👥19.1 用户列表

字段说明
username用户名（唯一）
phone / email联系方式
department所属部门
role主角色（运营/采购/仓储/客服/管理）
status状态：1=启用，0=禁用
permissions细粒度权限 JSON

➕19.2 新建用户

进入用户管理

侧边栏「系统管理 → 用户管理」

点击"新建用户"

填写用户名、密码、姓名、部门、手机号

分配角色

选择主角色（运营/采购/仓储/客服/管理）

设置权限

勾选可访问的模块

保存

系统调用 /api/users POST 创建用户

🔒19.3 权限设置

权限采用三层模型：

  • 角色（Role）： 预定义角色，绑定一组权限
  • 模块权限（Permission）： 细粒度的菜单/操作权限
  • 用户权限覆盖： 可单独给用户加权限或减权限

相关 API

API说明
/api/permissions所有权限点列表
/api/permissions/modules按模块分组的权限
/api/roles角色 CRUD
/api/roles/<id>/permissions角色权限分配
/api/users/<id>/permissions用户权限覆盖
/api/users/<id>/reset-password重置密码

角色说明

角色可见模块说明
运营仪表盘、商品、订单、售后、报表、淘宝闪购、京东到家、美团、聊天日常运营管理
采购商品、库存、采购、报表采购与库存管理
仓储库存、采购、入库仓储操作
客服订单、售后、聊天、评价客服与售后
管理全部模块系统管理员

21. API 参考手册

本平台所有 API 均为 RESTful 风格，基础路径 /api/，返回 JSON 格式数据。除白名单接口外，所有接口需在请求头携带 JWT Token：

Authorization: Bearer <token>

Token 通过 /api/auth/login 获取，有效期 24 小时。

🔑20.1 认证接口

方法路径说明
POST/api/auth/login登录，返回 JWT Token
GET/api/auth/check校验 Token 是否有效
GET/api/health健康检查

📊20.2 仪表盘 API

方法路径说明
GET/api/dashboard/stats整体统计
GET/api/dashboard/channel渠道分布
GET/api/dashboard/recent近期订单
GET/api/dashboard/backend-stats后台统计
GET/api/dashboard/overview概览
GET/api/dashboard/store-ranking门店营收排名
GET/api/dashboard/merchant-income-trend商家收入趋势
GET/api/dashboard/store-profit-ranking门店利润排名
GET/api/dashboard/store-loss-ranking门店损耗排名
GET/api/dashboard/tbflash-service淘宝闪购服务
GET/api/dashboard/unreceived-purchases未收货采购
GET/api/dashboard/chat-summary聊天汇总

📦20.3 商品 API

方法路径说明
GET/POST/api/products商品列表/新增
GET/PUT/DELETE/api/products/<id>商品详情/修改/删除
POST/api/products/batch-import批量导入
POST/api/products/batch-delete批量删除
GET/api/products/categories分类列表
GET/api/products/tags标签列表
GET/api/products/statuses状态列表
GET/api/products/check-skuSKU 查重
POST/api/products/update-category修改分类
GET/POST/api/suppliers供应商列表/新增
PUT/DELETE/api/suppliers/<id>修改/删除供应商
POST/api/suppliers/batch-import批量导入供应商

🏭20.4 库存 API

方法路径说明
GET/api/inventory库存列表
PUT/api/inventory/<id>修改库存
GET/api/inventory/summary库存汇总
GET/api/inventory/warehouses仓库列表
POST/api/inventory/import批量导入
GET/api/reports/stock-flow库存流水

🛒20.5 订单 API

方法路径说明
GET/api/orders订单列表
GET/api/orders/<order_no>订单详情
PUT/api/orders/<order_no>修改订单
GET/api/orders/warehouses仓库列表
GET/api/orders/channels渠道列表
POST/api/import-orders导入订单
POST/api/sync-orders同步订单
POST/api/save-refund保存退款单
GET/api/refunds退款列表
GET/api/refunds/shops退款门店

⚡20.6 淘宝闪购 API

方法路径说明
GET/POST/PUT/DELETE/api/tb-flash/service服务数据 CRUD
POST/api/tb-flash/service/batch-import批量导入
GET/POST/PUT/DELETE/api/tb-flash/business经营数据
GET/DELETE/api/tb-flash/traffic流量数据
GET/DELETE/api/tb-flash/promotion推广数据
GET/api/tb-flash/orders/list订单列表
GET/api/tb-flash/orders/summary订单汇总
POST/api/tb-flash/orders/import订单导入
POST/api/tb-flash/orders/clear清空订单
GET/api/tb-flash/orders/export订单导出
GET/api/tb-flash/review/list评价列表
GET/api/tb-flash/category分类数据

🚀20.7 京东到家 API

方法路径说明
GET/api/jd-orders/list订单列表
GET/api/jd-orders/summary订单汇总
POST/api/jd-orders/import订单导入
GET/api/jd-traffic/list流量列表
POST/api/jd-traffic/import流量导入
GET/api/jd-fulfillment/list履约列表
POST/api/jd-fulfillment/upload履约上传
GET/api/jd/store-detail/list门店详情
GET/api/jd/review/list评价列表
GET/api/jd/aftersale/list售后列表
GET/api/jd/health-check/list体检列表
GET/api/jd/violation/list违规列表

🛵20.8 美团买药 API

方法路径说明
GET/api/mt/orders订单列表
GET/api/mt/orders/summary订单汇总
GET/api/mt/orders/<id>订单详情
GET/api/mt/orders/items订单商品
GET/api/mt/orders/shops门店列表
GET/api/mt/orders/export订单导出
GET/api/mt/service-score服务分
GET/api/mt/review评价
GET/api/mt/store-rating门店评分
GET/api/mt/service-analysis服务分析
GET/api/mt/backend-data后台数据

🔗20.9 聚水潭 API

方法路径说明
GET/api/jst/config获取配置
POST/api/jst/update-config更新配置
GET/api/jst/status同步状态
POST/api/jst/test-connection测试连接
POST/api/jst/sync-orders同步订单
POST/api/jst/sync-products同步商品
POST/api/jst/sync-inventory同步库存
POST/api/jst/sync-refunds同步退款

💬20.10 聊天与 AI API

方法路径说明
GET/api/chats?platform=聊天列表（按平台）
GET/api/customer-service客服服务
GET/api/customer-service/raw原始客服数据
POST/api/import-customer-service导入客服数据
POST/api/clear-customer-service清空客服数据
POST/api/ai-chatAI 智能问答
POST/api/ai-parse-reviewAI 评价解析
POST/api/ai-parse-chatAI 聊天解析

👥20.11 权限 API

方法路径说明
GET/POST/api/users用户列表/创建
GET/PUT/DELETE/api/users/<id>用户详情/修改/删除
POST/api/users/<id>/reset-password重置密码
GET/PUT/api/users/<id>/permissions用户权限
GET/POST/api/roles角色列表/创建
PUT/DELETE/api/roles/<id>角色修改/删除
GET/PUT/api/roles/<id>/permissions角色权限
GET/api/permissions所有权限
GET/api/permissions/modules模块权限

📊20.12 报表 API

方法路径说明
GET/api/reports/sales销售报表
GET/api/reports/inventory-value库存价值
GET/api/reports/replenish补货建议
GET/api/reports/replenish-by-warehouse按仓库补货
GET/api/reports/customer客户分析
GET/api/reports/ranking排行榜
GET/api/reports/review评价报表
GET/api/reports/stock-flow库存流水
GET/api/report/sales-by-warehouse按仓库销售
GET/api/report/product-sales商品销量
GET/api/store-expense门店费用

⚙️20.13 字段配置 API

方法路径说明
GET/api/field-config/platforms平台字段配置
GET/api/field-config/list字段配置列表
GET/api/field-config/groups字段分组
POST/api/field-config/save保存字段配置
POST/api/field-config/delete删除字段配置
POST/api/field-config/batch-save批量保存

22. 数据库表结构

系统使用 MySQL 8 数据库，数据库名 mystore，共 75 张表。

📦21.1 核心业务表

表名行数说明
products2,359商品主数据
suppliers8供应商
inventory85,195实时库存
store_inventory79,490门店库存
orders144,956订单主表
unified_orders140,334统一订单视图
purchases53,928采购单
purchase_in22,477入库单
refunds19,985退款单
reviews—评价
chats824聊天会话
customer_service20,383客服记录
store_expense106门店费用

⚡21.2 淘宝闪购表

表名行数说明
tb_flash_service1,248服务数据
tb_flash_business1,093经营数据
tb_flash_traffic1,248流量数据
tb_flash_promotion906推广数据
tb_flash_orders11,033订单数据
tb_flash_review17评价数据
tb_flash_category0分类
tb_orders / tb_order_ext590 / 605淘宝订单

🚀21.3 京东到家表

表名行数说明
jd_orders / jd_order_ext160订单
jd_traffic_overview340流量
jd_fulfillment532履约
jd_store_detail35门店详情
jd_review532评价
jd_aftersale532售后
jd_health_check338体检
jd_violation0违规

🛵21.4 美团买药表

表名行数说明
mt_orders10,223订单主表
mt_order_items17,467订单商品
mt_order_ext767订单扩展
mt_order_bill648账单
mt_order_withdrawal64提现
mt_order_rebate16返佣
mt_order_product_activity19,216商品活动
mt_order_product_detail19,024商品明细
mt_fulfillment97,949履约（最大）
mt_review1,139评价
mt_service_score1,188服务分
mt_service_analysis2,331服务分析
mt_store_rating1,008门店评分
mt_backend_data1,434后台数据
mt_responsibility29,682责任响应

🔗21.5 聚水潭与同步表

表名行数说明
jst_order_ext171,199聚水潭订单扩展
jst_inventory49,349聚水潭库存
inventory_backup587,095库存备份（最大）
store_inventory_backup81,135门店库存备份
fulfillment_fails44,146履约失败记录

👥21.6 系统表

表名说明
sys_users系统用户
sys_roles角色
sys_permissions权限点
sys_role_permissions角色权限关联
sys_user_roles用户角色关联
sys_user_permissions用户权限覆盖
field_config字段配置
wh_region仓库区域

📊21.7 数据质量表

表名说明
dq_alert_rule告警规则
dq_anomaly_detail异常详情
dq_check_log检查日志
dq_null_rate_log空值率日志
dq_score_snapshot质量评分快照
dq_sync_lag_log同步延迟日志

23. 常见问题 FAQ

Q：页面顶部显示「数据库连接失败」怎么办？

检查 MySQL 服务是否运行：systemctl status mariadb 或 systemctl status mysqld。

检查数据库配置是否正确：查看 /opt/mystore/mystore_server.py 中的 DB_CONF 配置。

检查 MySQL 用户权限：确保 root 用户可访问 mystore 数据库。

Q：采购单状态显示 [object] 或英文字母是什么意思？

这是因为状态字段渲染异常。可参考第 6.1 节"状态说明"，状态值含义：

  • pending → 待确认
  • confirmed → 已确认
  • shipping → 待收货
  • received → 已收货
  • stored → 已入库

Q：入库单列表为空？

检查筛选条件是否过严，或采购单是否已收货但未执行"入库"操作。入库操作需要在采购单详情中点击"入库"按钮。

Q：修改了库存数量，刷新后恢复了？

可能是聚水潭同步覆盖了本地修改。建议：

  1. 暂停聚水潭自动同步（jst-settings 页面）
  2. 修改库存
  3. 确认无误后再恢复同步

Q：弹窗无法关闭？

按 ESC 键关闭，或点击弹窗外部区域。如仍无法关闭，刷新页面即可。

Q：聚水潭数据多久同步一次？

聚水潭同步默认手动触发。如需自动同步，可在 jst-settings 页面开启定时任务，建议频率：每 2 小时一次。

查看同步状态：/api/jst/status

Q：如何添加新用户？

参考第 17.2 节"新建用户"。需要管理员权限，进入「系统管理 → 用户管理」。

Q：导入数据时报错怎么处理？

常见导入报错原因：

  • 字段缺失： Excel 模板必填字段未填写
  • 格式不符： 日期、金额等字段格式错误
  • SKU 不存在： 导入订单时关联的商品 SKU 未在系统创建
  • 数据重复： 订单号/退款号已存在

建议：先下载模板，按模板格式填写；少量数据先测试导入。

Q：淘宝闪购/京东到家/美团数据如何导入？

从对应平台后台导出 Excel 后，到本系统对应页面点击"导入"按钮上传即可。每个子页面都有独立的导入接口。

Q：AI 智能问答支持哪些问题？

支持自然语言提问，例如："本月销售额最高的商品"、"近 7 天哪些商品库存不足"、"各门店营收排名"。详见第 18章。

Q：忘记了登录密码？

联系系统管理员重置密码（/api/users/<id>/reset-password）。管理员可在用户管理页面操作。

Q：如何查看服务器状态？

访问 /api/health 查看健康状态。服务器端可通过 systemctl status mystore 查看服务运行情况，journalctl -u mystore -f 查看实时日志。

24. 术语表

术语英文/缩写说明
ERPEnterprise Resource Planning企业资源计划系统
SKUStock Keeping Unit库存量单位，商品唯一编码
GMVGross Merchandise Volume成交总额
JWTJSON Web Token用于身份认证的令牌
JST聚水潭第三方 ERP 系统
RBACRole-Based Access Control基于角色的权限控制
SPASingle Page Application单页应用
APIApplication Programming Interface应用程序接口
CRUDCreate Read Update Delete增删改查
ROIReturn On Investment投资回报率
CPCCost Per Click每次点击成本
CPMCost Per Mille每千次展示成本
曹庄仓—独立仓库，库存单独管理
聚水潭JST电商 ERP 服务商
淘宝闪购TB Flash淘宝旗下即时零售业务
京东到家JD Daojia京东旗下即时零售平台
美团买药MT Medicine美团旗下医药即时零售
聚水潭同步JST Sync从聚水潭 ERP 拉取数据
近效期Near Expired商品接近过期日期
动销率Movement Rate有销售 SKU 数 / 总 SKU 数
妥投率Delivery Rate成功送达订单比例
履约Fulfillment订单从下单到送达的全过程
钻取Drilldown从汇总数据下钻到明细

25. 版本更新记录

版本日期更新内容
V2.142026-08-26
  • 新增第 1 章「基础维度数据总览」小节：系统全部基础维度数据按五大类整理 — MySQL 92 张表（按 13 个业务域分类，含行数/说明）、平台商品 CSV 快照（7 个文件清单）、进销存报表产出（exports 目录）、本地 RPA 源数据目录（10 条路径 + 同步方式）、定时任务调度清单（服务器 7 个 cron + 本机 3 个计划任务，含脚本/频率/日志路径）
  • 所有数据路径精确到实际目录与文件名，便于运维排查时快速定位
V2.132026-08-26
  • 同步看板升级为全任务版：在商品数据 4 项任务基础上，纳入服务器 6 个同步任务（聚水潭订单 / 单据同步 / 统一订单 / 进销存报表 / 销售汇总 / 质量巡检），按分组表头展示，共 10 个任务列
  • 新增服务器端状态采集器 sync_health.py（crontab 每半小时执行）：扫描各任务日志与产出文件，按天判定 ok / missing，回溯最近 30 天，合并写入 sync_status.json（不影响商品任务记录）
  • 13.3 节同步更新：两组任务说明、状态含义（✓正常 / ✗未运行）、服务器任务排查指引与日志清单
V2.122026-08-24
  • 「平台商品明细」新增京东平台 Tab（红色）：京东门店库存商品明细（约 93,924 行 × 36 店 × 19 字段），展示 门店价格 / 会员价 / 实时价 / 现货库存 / 可用库存 / 库存状态 / 小时达医保 等字段，门店按美团口径过滤（36 家）
  • 新增京东商品明细每日自动同步（计划任务 JdDailySync，每日 05:30）：扫描 D:\rpa_transer\京东\京东商品明细\京东商品明细M-D.zip，自动转换上传 jd_products_YYYYMMDD.csv、15 天滚动保留、jd_manifest.json 自动更新
  • 同步看板（sync-dashboard.html）新增「京东商品」状态列，与美团 / 淘宝闪购 / 主快照 并列展示
V2.112026-08-24
  • 新增「平台商品明细」二级页面（platform-products.html）：汇总淘宝闪购 / 美团 36 家门店商品明细，双平台 Tab + 数据日期下拉（最近 15 天快照）+ 组合搜索 + CSV 导出
  • 新增美团 / 淘宝闪购商品信息每日自动同步（计划任务 MeituanDailySync / TaobaoDailySync，每日 05:30）：RPA 数据自动合并上传、15 天滚动保留、日期清单 manifest 自动更新
  • 新增「同步看板」页面（sync-dashboard.html）：按天查看 美团 / 淘宝闪购 / 主快照 上传状态（绿=已上传、红=缺失），支持 7 / 15 / 30 / 90 天切换与行详情展开
  • 操作手册新增第 13 章「平台商品明细与每日同步」，后续章节编号顺延
V2.102026-08-17
  • 修复进销存「销售金额」与聚水潭不一致（偏大约 1.75 倍）：根因为同步订单时把整单实付金额写入了每个商品行导致重复累加。修复：①同步时按商品标价（price×qty）占比分摊整单实付到每行；②历史约 20 万行一次性回填；③已取消 / 异常订单不再计入销售统计。近 30 天销售金额由错误的 266.3 万修正为约 126.4 万
  • 同步 5.5 章节与 psv.html 弹窗的「销售金额」字段口径：金额取 merchant_income，为 0 时回退 total_amount（= 整单实付按商品占比分摊）
V2.92026-08-17
  • 进销存报表历史列表增加「🗑 删除」按钮：可手动清理不再需要的旧报表（弹窗确认后不可恢复），连带删除对应的 .xlsx.json 概要与 .rows.json 明细缓存；新增 API POST /api/export/psv/delete，带安全校验（仅限 进销存_*.xlsx 文件名、防路径穿越）
  • 生成锁修复：报表生成锁（_LOCK_PSV）增加 5 分钟超时自动释放机制，防止异常卡死导致后续生成请求一直被拒
  • 操作手册 5.5 章节与 psv.html 弹窗同步更新：新增「历史报表管理」说明、API 列表补充 delete 接口
V2.82026-08-17
  • 进销存报表子网页（psv.html）新增「门店进销存预览」实时查询区：不再依赖预生成报表，按所选日期直接查库聚合，支持 门店维度 / 门店×SKU 维度切换（默认 SKU 维度，12 列明细 + 分页 + 汇总条），出库类型（进货 / 销售 / 退货）筛选
  • 预览销售数据来自 orders 表（聚水潭每 10 分钟自动同步），销售数量接近实时；预览期初 / 期末取库存快照，口径与导出报表一致
  • 更新 5.5 进销存报表章节：新增「在线预览」与「预览区字段口径」说明、门店 36 家白名单、数据实时性说明
V2.72026-08-17
  • 补货看板「库存位置」三列（现货 / 在途 / 有效库存）改由 聚水潭 inventory.query API 实时查询（数据表 inventory_live），确保库存数据准确、实时，不再依赖每日库存快照
  • 新增每日 03:30 自动链路：实时库存拉取（约 2.4 万行 / 36 家门店）→ 销量聚合 → 补货重算，打开页面即为最新结果
  • 修复门店 → 仓映射遇被排除渠道（京东）整仓误杀：恢复绍兴 / 青浦 / 静安 / 周浦 / 无锡 / 柯桥 / 湖州 / 金华 8 家门店，补货覆盖门店 28 → 36 家
  • 更新 9.3 补货看板章节：字段表按页面实际 26 列重写，新增「数据来源与更新频率」与注意事项
V2.62026-08-12
  • 新增「报表字段计算公式」说明（平台简介章节）：汇总通用计算指标公式（点击率/付费依赖度/客单价/商责退款率/取消单量/环比变化率）、BI 看板 15 个指标三平台取值口径（直采 vs 计算）、以及京东履约/美团订单/服务漏斗/库存价值等其他报表计算字段
V2.52026-08-12
  • 新增「数据来源与同步路径」说明（平台简介章节）：梳理三平台报表本地目录 → 数据库表 → 页面映射，以及美团订单/电话转写/聚水潭/库存等其他数据来源与同步执行方式
  • BI 看板导出升级为真正的 .xlsx（SheetJS），按钮「导出CSV」→「导出Excel」，数字列为数值类型
  • AI 问答数据库上下文修正：订单按状态分组、评价按渠道分组统计准确
  • 侧边栏调整：操作手册入口置顶第一位并常亮高亮，菜单不再随页面切换高亮
V2.42026-08-12
  • AI 智能问答接入手册知识库：可回答操作手册中的操作流程问题（新增用户、仓龄计算、报表导出等），按问题关键词自动检索匹配章节
  • 修复权限管理「新增用户」无反应：补加载 users.js、补建用户弹窗与权限配置弹窗 HTML
  • 修复新建用户弹窗角色/状态下拉与列表筛选器重复 ID 冲突导致「请选择角色」误报
  • 修复「配置权限保存」无反应：权限保存改用 PUT 请求，并修正权限读取路径
  • 修复用户列表用户名被清空：用户更新接口改为部分更新，仅修改提交字段
  • 操作手册入口置顶至侧边栏首位（仪表盘之后）
V2.32026-08-11
  • 新增「库存仓龄分析」功能（库存管理 → 仓龄分析）：按门店查看 SKU 仓龄，默认仓龄 ≥ 20 天，支持统计基准日/阈值/门店/SKU 筛选与分页
  • 仓龄 = 统计基准日 − 最后入库日期（purchase_in 表 MAX(io_date)），新增 API /api/inventory/age-analysis
  • 仓龄表格 10 列：门店 / SKU / 商品名称 / 可用库存 / 订单占有 / 最后入库时间 / 最后入库单号 / 仓龄(天) / 入库次数 / 成本价；仓龄颜色分级（≥45红 / 30-44橙 / 20-29黄）
  • 修复 BI 看板 A/B缺货率商品库存缺失：数据源由 store_inventory 切换为实时库存表 inventory
  • 修复 BI 看板「点击查询无效」：清理重复页面 DOM、增强 apiGet 错误处理、刷新前端缓存
  • 修复网页登录后空白：删除多余闭合 div 导致的布局破坏
  • 修复库存管理菜单「库存仓龄分析」未显示：调整导航分组高度与菜单顺序
V2.22026-08-10
  • 新增「BI看板与A/B缺货率计算逻辑」章节：三平台108行对比、15个核心指标、A/B缺货率7步计算流程
  • 修复 BI 看板 A/B 缺货率计算：基于 unified_orders（聚水潭统一订单表）计算近30天销量并分档
V2.12026-07-19
  • 新增「历史快照」功能：商品库存 / 曹庄仓库存 支持按日期查看历史库存
  • 新增 inventory_daily 快照表，每次聚水潭同步自动追加当日快照（按 SKU+仓库+日期去重）
  • 新增 API：/api/inventory/daily（按日期查快照）、/api/inventory/dates（列出快照日期）
  • 两个库存页面工具栏新增 📅 日期选择器与「今天」按钮
  • 历史数据永不覆盖，可追溯任意日期的库存状态
  • 新增第 5.4 节「历史快照（按日期追加记录）」操作说明
V2.02026-07-19
  • 新增「淘宝闪购」7 个子页面（数据概览/服务/经营/流量/推广/订单/评价）
  • 新增「京东到家」8 个子页面（订单/流量/履约/门店/评价/售后/体检/违规）
  • 新增「美团买药」9 个子页面（订单/退款/履约/评价/服务分/服务分析/后台数据/后台仪表盘/责任响应）
  • 新增「客服聊天记录」4 个平台子页面
  • 新增「数据质量监控」模块
  • 新增「门店费用」报表
  • 新增「曹庄仓库存」独立页面
  • 新增 AI 评价解析、AI 聊天解析功能
  • 扩展 API 参考手册，覆盖全部 160+ API
  • 补充数据库表结构文档（75 张表）
  • 操作手册覆盖全部 47 个功能页面
V1.02026-06-01
  • 初版手册发布
  • 覆盖：平台简介、登录、仪表盘、商品、库存、采购、订单、售后、报表、美团、聚水潭、聊天、权限、AI、FAQ、术语

📄 文档信息

文档版本： V2.6

发布日期： 2026 年 8 月 12 日

适用系统： 全佑健康管理 · 数据管理平台（MyStore）

系统地址： https://www.pcyiliao.com

文档维护： 系统管理员

反馈渠道： 如有疑问或建议，请联系系统管理员。