闪仓 BI 仪表盘实战：用数据驱动月度经营分析

为什么月度经营分析很重要

对于中小型仓储企业来说，月末复盘往往面临一个尴尬的局面：数据分散在各个 Excel 表里，采购员知道进了多少货，销售员知道出了多少货，但老板要看全局就得花半天时间手动汇总。

闪仓 WMS 的 BI 仪表盘正是为解决这个问题而设计的。登录 PC 端后，首页即为数据仪表盘，所有核心经营指标一目了然。本文将详细介绍如何利用这些功能完成一次完整的月度经营分析。

6 大统计卡片：经营全貌一眼看清

仪表盘顶部排列了 6 张统计卡片，每张卡片对应一个核心经营指标：

1. 库存总价值 -- 当前所有仓库中商品的总价值（单位：元）。这是衡量资产规模的基础指标。对应后端 API 端点 /bi/total/value。

2. 出库数量 -- 全部出库操作的商品总数（单位：件）。反映销售和发货的活跃程度。对应端点 /bi/output/amount。

3. 入库数量 -- 全部入库操作的商品总数（单位：件）。反映采购和补货节奏。对应端点 /bi/input/amount。

4. 维护成本 -- 基于商品记录中 reference_cost 字段汇总的仓储维护成本（单位：元）。对应端点 /bi/total/cost。

5. 应收账款 -- 客户尚未支付的货款总额。来源于合作伙伴（客户类型）的账户余额汇总。对应端点 /bi/should/receive。

6. 应付账款 -- 企业尚未支付给供应商的货款总额。来源于合作伙伴（供应商类型）的账户余额汇总。对应端点 /bi/should/pay。

当数值超过 10,000 时，前端会自动转换为"万"为单位的显示格式，例如 1.25万元，避免大数字造成的阅读障碍。

趋势折线图：本周价值变化一目了然

仪表盘的第一行图表区域左侧是 本周库存价值趋势 折线图。该图表展示当前自然周（周一到周日）每天的入库金额和出库金额两条曲线，使用 ECharts 渲染，支持平滑曲线和面积填充效果。

后端通过 /bi/io/price/line 端点返回数据，接受 begin_time 和 end_time 两个必填参数。前端自动计算本周的起止日期并请求数据。

这张图表的核心价值在于：快速发现异常波动。如果某天的出库金额突然飙升，可能意味着一笔大订单完成了发货；如果入库金额连续为零，可能说明采购补货出了问题。

分类饼图：仓库商品分布

折线图右侧是 商品分类分布 饼图（环形图），展示各仓库中的商品种类数量（SKU 数）占比。系统会遍历所有仓库，查询每个仓库的商品种类数，然后以饼图形式呈现。

这项数据帮助管理者了解库存是否过度集中在某个仓库。如果一个仓库占了 80% 的 SKU，可能需要考虑调拨分散风险。

出入库柱状图：进出对比

图表区域第二行是 出入库概览 柱状图，以本周每天为 X 轴，对比展示当天的入库数量和出库数量。该图表通过两次 API 调用获取数据：先请求 /bi/input/amount（带时间范围），再请求 /bi/output/amount（带时间范围），最终合并渲染。

这张图表适合用来判断库存的"呼吸节奏"：健康的仓库应该是进出平衡的，如果持续只进不出或只出不进，都值得关注。

通过 MCP 工具实现自定义日期分析

仪表盘的 PC 界面默认展示本周数据，但实际的月度分析需要查看整个月的趋势。这时，闪仓的 MCP 工具就派上用场了。

闪仓 CLI 工具 fwh 提供了 7 个 BI 相关的 MCP 工具，其中 bi_line_chart 是做月度分析最核心的一个：

工具名称: bi_line_chart
参数:
  - begin_time (必填): 起始时间, 格式 yyyy-MM-dd HH:mm:ss
  - end_time (必填): 结束时间, 格式 yyyy-MM-dd HH:mm:ss
返回: [{date, input, output}] 每天一条记录, 包含零活动日

在 Claude Code 中使用

将闪仓 MCP 服务器配置到 Claude Code 后，可以直接用自然语言请求分析：

"帮我查看 2026 年 5 月的出入库金额趋势"

Claude Code 会自动调用 bi_line_chart 工具：

{
  "begin_time": "2026-05-01 00:00:00",
  "end_time": "2026-05-31 23:59:59"
}

返回数据格式如下：

[
  {"date": "2026-05-01", "input": 12500.00, "output": 8300.00},
  {"date": "2026-05-02", "input": 0.00, "output": 0.00},
  {"date": "2026-05-03", "input": 45000.00, "output": 15200.00}
]

零活动日也会包含在返回结果中（input 和 output 均为 0.00），确保时间轴连续，方便绘制图表。

在 CLI 中使用

fwh bi line-chart --begin "2026-05-01 00:00:00" --end "2026-05-31 23:59:59"

其他 BI 工具配合使用

完整的月度分析还可以配合以下工具：

带日期范围的工具在传入 begin_time 和 end_time 后，会返回每日明细数据而非单一汇总值。

月度分析实操清单

基于以上功能，一次完整的月度经营分析可以按如下步骤执行：

第一步：查看汇总数据。 打开 PC 端仪表盘，记录当前的 6 大统计卡片数值，与上月末的数值对比。

第二步：分析趋势。 通过 MCP 工具 bi_line_chart 拉取整月的出入库金额趋势，识别高峰日和低谷日。

第三步：定位异常。 对趋势中的异常波动（如某天出库金额是平时的 5 倍），使用 bill_list 或 bill_search 工具查询当天的具体单据。

第四步：评估资金状况。 通过 bi_should_receive 和 bi_should_pay 查看应收应付，评估现金流健康度。

第五步：检查库存预警。 仪表盘的库存预警区域会自动显示低于阈值的商品，确认是否需要启动补货流程。

小结

闪仓 BI 仪表盘将分散在采购、销售、仓储、财务各环节的数据汇聚到一个界面中。PC 端提供开箱即用的可视化体验，MCP 工具则将这些数据能力开放给 AI 助手，实现更灵活的自定义分析。两者结合，让月度经营分析从"半天苦差事"变成"十分钟就能完成的例行工作"。