数据管理平台 · 操作手册
全佑健康管理内部 ERP 系统，涵盖商品、库存、采购、订单、售后、淘宝闪购、京东到家、美团买药、客服聊天、聚水潭同步、AI 智能问答等全链路业务管理。
目录
1. 平台简介
全佑健康管理 · 数据管理平台（MyStore）是企业内部 ERP 系统，统一管理多平台电商业务的全链路数据。
系统整合淘宝天猫、淘宝闪购、京东到家、美团买药等四大平台的商品、库存、订单、售后、客服等业务数据，并提供聚水潭 ERP 数据同步、AI 智能问答、数据质量监控等高级功能。
🎯核心功能
⚙️技术架构
| 层级 | 技术 | 说明 |
|---|---|---|
| 前端 | 原生 JavaScript + Chart.js | SPA 单页应用，19 个 JS 模块 |
| 后端 | Python Flask | mystore_server.py 主程序 + api_restful.py API 模块 |
| 数据库 | MySQL 8 + SQLite | 主库存 75 张表，SQLite 用于本地备份 |
| 反向代理 | Nginx | HTTPS 终端，反向代理 8090 端口 |
| 进程管理 | systemd | mystore.service 自启动 |
| 鉴权 | JWT + sha256 | 24 小时有效期，sessionStorage 存储 |
| 部署 | 阿里云 ECS | Alibaba Cloud Linux 3 |
2. 登录与界面导航
🔑登录
访问地址： https://www.pcyiliao.com
登录方式： 用户名 + 密码（管理员账号由系统管理员分配）
登录流程
浏览器打开 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 的主数据管理页面，支持增删改查、批量导入、分类管理。
字段说明
| 字段 | 类型 | 说明 | 示例 |
|---|---|---|---|
sku | varchar(100) | 商品 SKU 编码，唯一 | PCY-2024-001 |
name | varchar(255) | 商品名称 | 维生素 C 1000mg |
category | varchar(100) | 一级分类 | 保健品 |
subcategory | varchar(100) | 二级分类 | 维生素类 |
spec | varchar(200) | 规格 | 100粒/瓶 |
color | varchar(50) | 颜色/口味 | 橙子味 |
price | decimal(10,2) | 销售价 | 89.00 |
cost_price | decimal(10,2) | 成本价 | 45.00 |
cost | decimal(12,2) | 最新成本（含运费分摊） | 48.50 |
unit | varchar(20) | 单位 | 瓶 |
tags | varchar(500) | 标签，逗号分隔 | 热销,新品 |
status | varchar(20) | 状态：在售/下架/缺货 | 在售 |
supplier_id | int | 供应商 ID | 1 |
channel | varchar(50) | 主销售渠道 | 美团买药 |
image | text | 商品图片 URL | /images/prod/001.jpg |
description | text | 商品描述 | ... |
操作说明
点击"新增"按钮 → 填写 SKU、名称、分类、规格、价格等 → 保存
列表中点击商品行 → 进入编辑模式 → 修改字段 → 保存
点击"批量导入" → 下载模板 → 填写数据 → 上传 Excel（/api/products/batch-import）
勾选多个商品 → 点击"批量删除"（/api/products/batch-delete）
新增前可调用 /api/products/check-sku 检查 SKU 是否已存在
查看 /api/products/categories 获取所有分类；调用 /api/products/update-category 修改分类
📈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 | 查看历史日期 | 不参与 | 读取该日期快照 |
6. 采购与入库管理
📦6.1 采购单
页面代码： purchases 数据表： purchases
管理采购订单全流程：创建 → 待确认 → 已确认 → 待收货 → 已收货 → 已入库。
统计卡片
页面顶部展示：本月采购总额、待收货单数、本月已入库单数、采购商品总数。
筛选项
| 筛选项 | 说明 |
|---|---|
| 采购单号 | 精确/模糊搜索 |
| 供应商 | 下拉多选 |
| 状态 | 待确认/已确认/待收货/已收货/已入库 |
| 下单日期 | 日期范围 |
列表字段
采购单号、供应商、商品数、采购总额、预计到货日、实际到货日、状态、创建时间。
查看明细
点击单条采购单可展开查看商品明细（SKU、数量、单价、金额、备注）。
状态说明
| 状态 | 说明 | 下一步 |
|---|---|---|
| 待确认 | 采购单已创建，未确认 | 确认 → 已确认 |
| 已确认 | 已审核，等待供应商发货 | 发货 → 待收货 |
| 待收货 | 供应商已发货，等待入库 | 收货 → 已收货 |
| 已收货 | 已到货，等待入库登记 | 入库 → 已入库 |
| 已入库 | 库存已增加，流程结束 | — |
手动同步
采购单支持从聚水潭 ERP 同步（参见 第 14 章 聚水潭对接）。
🏭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
基于销量预测与安全库存，自动计算补货建议。
补货看板 - 补货建议明细字段
| 字段 | 说明 |
|---|---|
| 商品 SKU / 名称 | 补货目标商品 |
| 当前库存 | 可用库存数量 |
| 安全库存 | 安全库存阈值 |
| 近 7/15 日销量 | 历史销量参考 |
| 建议补货量 | 系统计算（suggest_purchase） |
| 预计到货日 | 建议下单到货时间 |
| 主供应商 | 首选供应商 |
🏆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）、导入、清空、导出。