# 六米云枢系统架构与迭代说明书 更新日期：2026-06-06 本文档面向管理员和系统建设者，不作为店主或运营日常使用说明展示。店主和运营只需要看到各自的任务、动作、回收状态和必要业务口径。 ## 1. 系统目标 六米云枢不是展示型后台，而是运营赋能系统。它要把门店经营、商品、中心仓、SA货盘、爆品、订单和动作回收统一为一条闭环： 数据接入 -> 诊断判断 -> 角色动作 -> 完成回收 -> 复盘迭代。 最终输出只保留两类： - 店主今天要做什么。 - 运营按 T+1 / T+3 / T+7 回收什么。 ## 2. 总体架构 ### 2.1 数据底座 当前数据底座分为五层： - 基础门店层：6.4营业底表、原门店清单、门店主数据、账号绑定。 - 经营数据层：美团订单流水、订单ID、订单详情、后续扩展流量、履约、评价、点金。 - 商品数据层：美团商品目录、商品后台链接、爆品对应表、SA商品清单。 - 供应链层：中心仓货盘、库存、周转、滞销、供应商、商品风险。 - 协同回收层：动作台账、店主完成、运营回收、飞书发送和回传。 ### 2.2 角色权限 - 管理员：看全局、配置取数、导入数据、查看系统资料和调度状态。 - 运营：看归属门店、待回收动作、SLA、单店诊断和区域热销品。 - 店主：只看自己门店的今日动作和执行状态。 - 专项账号：例如国际卡负责人，只看专项页面。 管理员资料入口只对管理员显示。 ## 3. 取数与同步规划 ### 3.1 当前已上线定时任务 - 门店主数据：每日 1 次，约 06:20。 - 订单流水号：每小时 1 次，约每小时 20 分。 - 订单ID与订单详情：每小时 1 次，约每小时 50 分。 - 商品状态：每周 3 次，周日、周三、周五凌晨约 03:20。 商品三更指的是商品状态刷新每周三次，不是每天三次。当前设定为： - 周日 03:20 左右。 - 周三 03:20 左右。 - 周五 03:20 左右。 服务端设置了 `RandomizedDelaySec=300`，因此实际执行可能在 03:20 后 0-5 分钟内启动。 ### 3.2 并发策略 - 订单流水号：8并发。 - 订单ID：3并发。 - 订单详情：8并发。 订单ID接口曾触发美团流控 `code=711`，因此不能继续硬拉高并发。内存不是当前瓶颈，接口限流才是约束。 ### 3.3 闭店过滤 所有商品、订单、经营同步只跑 6.4 底表中的营业门店，并排除原门店清单中闭店、停业、下线门店。 ## 4. 当前已落地能力 ### V1 基础巡检生成器 - 单店、7天、T+1/T+3/T+7回收口径。 - 只看6.4底表营业门店。 - 门店补货、SA缺货、爆品缺货、中心仓比对。 ### V2 后台化与账号体系 - 公网后台 `sinan.liulv.net`。 - 管理员、运营、店主、专项账号自动识别。 - 店主绑定门店，运营绑定归属。 - 手机端兼容。 ### V3 角色动作与回收闭环 - 店主待办。 - 运营待回收。 - 完成后置灰。 - 运营验收后进入已回收。 - 动作状态进入台账。 ### V4 自动取数中台 - 美团开放平台门店主数据。 - 商品目录和商品链接。 - 订单流水号。 - 订单ID。 - 订单详情。 - 定时同步和限流保护。 ### V5 系统化指挥舱 - 运营任务中心。 - 数据中心。 - 点金引擎规划。 - 飞书派发和回传规划。 - SLA提醒。 - 国际卡专项页面。 - 管理员资料入口。 ### V6 经营指标沉淀与商品动销事实表 - 从美团订单详情自动派生单店经营指标。 - 已形成近3天、近7天、近14天、近30天经营口径。 - 已形成单店订单、销售额、客单价、退款、取消、活动订单等结构化字段。 - 从订单详情 `sku_benefit_detail` 恢复商品明细，生成订单商品动销事实表。 - 单店热销品和区域热销品优先使用真实订单动销，缺失时回退商品表月售。 - 新增小时级派生任务 `liumi-business-metrics-refresh.timer`，在订单详情同步后沉淀中台指标。 ### V7 订单详情质量加固 - 订单详情原始响应保存上限从 8000 提升到 120000 字符。 - 历史截断订单详情已按正确服务环境补拉。 - 已补齐 1205 个订单ID的成功原始响应，成功覆盖率 100%。 - 订单商品动销事实表提升到 1464 行。 - 新增 `meituan_data_quality.json` 数据质量报告。 - 管理员经营健康接口展示原始响应覆盖、商品动销行数、平均每单商品行数。 ### V8 运营动作优先级引擎 - 单店诊断新增 `priorityEngine`。 - 系统综合库存0、低库存、下架、近7日订单、目标节奏、订单环比、退款取消履约、点金承接状态。 - 每个门店输出 P0/P1/P2、评分、主动作、原因和回收节点。 - 店主动作不再只看库存，已加入目标追单、退款取消处理、小额点金放大等动作。 - 运营回收动作新增“本店优先级”首条判断，明确 T+1/T+3/T+7 回收节点。 - 单店经营状态页新增“系统优先级”卡片，直接展示判定原因和回收节点。 ### V9 任务中心轻量优先级队列 - 任务中心新增运营优先级队列，直接展示 P0/P1 门店。 - 队列项包含门店、负责人、原因、回收节点和下一步动作。 - 任务中心首屏指标调整为 P0动作、P1动作、待回收。 - 任务中心从重型全量动作派发聚合改为轻量模式，避免首页接口超时。 - 当前验证响应时间约 0.29 秒。 - 当前队列：P0动作 164 项，P1动作 7 项。 ## 5. 已取回数据说明 截至当前版本，服务器已形成： - 美团商品目录：覆盖 172 家营业门店。 - 订单流水号：覆盖 172 家营业门店。 - 订单详情事实表：已形成 1205 条详情记录，覆盖 156 家门店。 - 经营指标事实表：已形成 156 家门店的结构化经营指标。 - 订单商品动销事实表：已从订单详情中恢复 1464 条商品动销记录。 - 订单详情原始响应质量：1205 个订单ID成功响应覆盖率 100%。 - 国际卡专项数据：已形成Top100覆盖和明细。 - 爆品、SA、中心仓底表：已导入作为商品诊断底座。 订单详情覆盖门店数小于 172 的原因通常是部分门店当日无订单，或订单ID接口受限流影响等待下一轮补齐。 ## 6. 后续系统规划 ### 6.1 经营指标层 已完成订单详情到经营指标的第一版沉淀： - 3天经营状态。 - 7天经营状态。 - 14天趋势。 - 30天月售等级。 - 单店热销品。 - 区域热销品。 下一步补齐： - 曝光人数。 - 进店人数。 - 下单转化率。 - 点金消耗。 - 评分、差评。 - 履约超时。 ### 6.2 点金推广层 点金逻辑规划： - 每日小额预算，例如约50元。 - 优先选择高毛利、热销、库存安全商品。 - T+3看消耗、曝光、进店、下单。 - 基本盘未修复前不建议扩大预算。 ### 6.3 中心仓系统层 后续接入： - 中心仓货盘。 - 库存。 - 周转。 - 滞销。 - 营收。 - 供应商管理。 - 商品管理。 - 风险管理。 ### 6.4 协同自动化层 后续将飞书打通： - 系统派发动作。 - 店主回传完成。 - 运营回收验收。 - actionId写回。 - 未完成原因入账。 ## 7. 管理员维护原则 - 不对店主展示系统架构和复杂版本说明。 - 不对运营展示底层接口细节。 - 商品状态周更三次即可，不做高频浪费。 - 订单流水和订单详情小时级同步。 - 遇到美团接口流控时优先降并发和错峰，不靠服务器硬冲。 - 对外输出保持简单，内部架构保持清晰。