指标与字段口径字典
L6 · 168 列字段字典（9 分组）+ 12 条指标公式 + 枚举取值域：全系统口径的唯一权威来源，其他页面只引用不定义。
字段总数
168列
9 个分组，对应决策表导出格式
指标公式
12条
含售罄率/库销比/齐码率/ATP 等
枚举取值域
42个
场景、约束、原因码、状态等
口径待确认
5项
来自调研报告 7.3 节的口径冲突
本期口径变更
7条
全部留痕可回溯
权威来源
本页
唯一权威：其他页面的口径引用本页
!治理原则：本页是口径的唯一权威来源。任何页面、报表、导出文档、接口文档中出现的字段与指标，都必须引用本页定义；发现不一致时，以本页为准，并反向修正引用方。口径变更必须走审批 + 版本号 + 生效日期，历史决策按"当时的口径版本"复算。
168 列字段字典（9 个分组）
分组结构直接对应业务习惯：单据身份 → 商品 → 调入方 → 销量 → 库存 → 调出方 → 仓库汇总 → 补调量 → 约束| 分组 | 分组名称 | 列区间 | 列数 | 主要字段（节选） | 口径说明 |
|---|---|---|---|---|---|
| G01 | 单据主键与版本 | 1–6 | 6 | decision_date / scene / batch_id / version / row_id / snapshot_id | 决策日、场景、批次、口径版本共同构成一行建议的身份 |
| G02 | 商品维度 | 7–24 | 18 | skc / sku / 款名 / 颜色 / 尺码 / 中类 / 小类 / 年份季节 / 波段 / 吊牌价 / 商品角色 | 与 MDM 商品档案同源，禁止在决策表侧维护别名 |
| G03 | 调入方（门店） | 25–46 | 22 | in_store_id / in_store_name / 等级 / 城市 / 区域 / 店群 / 面积 / 库容 / 陈列容量 / 首铺日期 | 面积与库容缺失时陈列/库容约束自动跳过（当前 18 家缺失） |
| G04 | 销量与预测 | 47–70 | 24 | sale_7 / sale_7_14 / 预估周销量 / 预测分位数 / 清洗后销量 / 断货天数 / 节假日倍率 / 活动倍率 | 预估周销量 = 近7天×80% + 近7-14天×20%（清洗后） |
| G05 | 库存（多口径） | 71–96 | 26 | 在库 / 在单 / 在途 / 锁定 / 可用 / 不可销售 / 库龄 / 库销比 / 齐码标记 / 尺码明细 F–XL | 六口径来自 data-inventory 台账；在途不计入可分配 |
| G06 | 调出方（仓 / 店） | 97–112 | 16 | out_store_id / out_wh_id / 可调出量 / 保护期标记 / 就近距离 / 物流时效 / 运费单价 / 单店包裹数 | 可调出量 = 在库 − 陈列下限 − 保护期库存 − 锁定 |
| G07 | 仓库汇总 | 113–128 | 16 | 仓维在库 / 仓维在单 / 仓维在途 / 仓维可用 / 全国库存合计 / 集中阈值标记 / 仓覆盖门店数 | 全国库存 < 80 件时触发集中处理标记 |
| G08 | 补调量（模型 / 人工双轨） | 129–152 | 24 | suggest_qty / actual_qty / 差异量 / 差异原因码 / 修改人 / 修改时间 / 审批链 / 是否已出单 | 模型值与人工值双列留存，差异必须可解释 |
| G09 | 约束标注 | 153–168 | 16 | 不允许调出 / 不允许调拨入 / 不允许补货入 / 未进入模型 / 约束优先级 / 标色对象 / 命中规则版本 | 约束不影响目标库存，只影响流向；优先级 调出 > 调拨入 > 补货入 |
合计 168 列 · 分组顺序即导出 Excel 的列顺序，与 io-template 模板保持一致每页
字段明细（节选 16 列 · 含取值口径）
凡"取值口径"中含公式的字段，其公式必须与下方指标公式字典完全一致| 字段名 | 中文名 | 数据类型 | 存储类型 | 取值口径 | 示例值 |
|---|---|---|---|---|---|
| decision_date | 决策日 | 日期 | date | 决策批次归属日（00:00 快照时点） | 2025-10-21 |
| scene | 业务场景 | 枚举 | string | 日常补货 / 区域调拨 / 换店下沉 / 残码清理 | 日常补货 |
| suggest_qty | 模型建议补调量 | 整数 | int | 模型输出的补调量（件），含在单在途扣减 | 3 |
| actual_qty | 人工确认补调量 | 整数 | int | 人工校正后的补调量（件）；未修改时 = suggest_qty | 3 |
| available_qty | 可用量 | 整数 | int | 在库 − 锁定 − 不可销售；不含在单在途 | 5 |
| on_order_qty | 在单量 | 整数 | int | 采购已下单未收货；仅作未来供给参考 | 2 |
| in_transit_qty | 在途量 | 整数 | int | 已出库未签收；不计入当前可分配 | 3 |
| locked_qty | 锁定量 | 整数 | int | 被订单/拣货/预留占用，尚未出库 | 2 |
| unsellable_qty | 不可销售量 | 整数 | int | 样衣/坏损/赠品/门店自留 | 1 |
| sale_7 | 近 7 天销量 | 整数 | int | 清洗后净销量（不含退货冲减前） | 9 |
| est_week_sale | 预估周销量 | 小数 | decimal(10,2) | 近7天×80% + 近7-14天×20%，断货已还原 | 8.40 |
| meet_weeks | 满足周数 | 小数 | decimal(4,1) | 常规 1 / TOP20 1.5 / 新品 1.5 / 标杆店 TOP10 2 / 节假日 TOP20 3 | 1.5 |
| target_stock | 目标库存 | 整数 | int | 预估周销量 × 满足周数 | 13 |
| replen_qty | 补货量 | 整数 | int | 目标库存 − 现有库存（含在单在途） | 3 |
| hit_constraint | 命中约束 | 文本 | string | 不允许调出 / 不允许调拨入 / 不允许补货入 / 未进入模型 / 无 | 无 |
| constraint_color | 约束标色 | 颜色码 | string | 不允许调出 #ff595e；不允许调拨入 #896bb3；不允许补货入 #3e8965；未进入模型 #999999 | #ff595e |
共 168 列，本页展示最易产生口径分歧的 16 列每页
指标公式字典（唯一权威口径）
调研报告 6.3 节提醒：满足周数分档等参数没有公开基准，属企业内部内控参数，不得写成行业标准| 指标 | 公式 | 口径说明 | 精度 | 使用位置 |
|---|---|---|---|---|
| 售罄率（正价） | 正价窗口内累计净销量 ÷（累计净销量 + 期末库存） | 期末库存取正价销售结束时点库存 | %, 保留 1 位 | 库存健康驾驶舱、售罄率分析 |
| 总售罄率 | 累计净销量 ÷（累计净销量 + 期末库存） | 含折扣销售；与正价售罄率分母口径不同，不可互换 | %, 保留 1 位 | 季末复盘 |
| 库销比 | 期末库存金额 ÷ 当期销售金额 | 金额口径（吊牌价 or 成本价须在字典固定），行业区间 1.5–6.0 | 倍，保留 2 位 | 库存压力判断 |
| 库存周转天数 | 平均库存成本 ÷ 期间销售成本 × 周期天数 | 平均库存 =（期初 + 期末）÷ 2；与"渠道库存周转"不可互换 | 天，整数 | 周转与分段目标 |
| 可续销周数 | 当前可用库存 ÷ 未来周均预测销量 | 分子用可用量（不含在单在途）；预测销量取未来 4 周均值 | 周，保留 1 位 | 补货/调拨/窗口判断 |
| 齐码率 | 满足目标尺码组合的款色数 ÷ 应售款色数 | 尺码组合按 M11 齐码规则配置（全部有货 / 连码有货） | %, 保留 1 位 | 尺码结构健康度 |
| 断货率（时点） | 断货 SKU 数 ÷ 应售 SKU 数 | 断货定义：可用量为 0 且仍有需求（近 7 天有销或有预测） | %, 保留 1 位 | 缺货影响评估 |
| 断货率（周期） | 断货 SKU 天数 ÷ 应售 SKU 天数 | 按日累计，是补货效果的主口径 | %, 保留 1 位 | 补货效果复盘 |
| ATP（对需求数量） | 可用量 + 未来到货 − 已确认需求 − 未确认需求 | 对需求口径：把未确认需求也占用库存，偏保守 | 件，整数 | 补货量测算、ATP 时间轴 |
| ATP（对确认数量） | 可用量 + 未来到货 − 已确认需求 | 对确认口径：仅扣已确认订单，偏乐观；两者差额即不确定需求 | 件，整数 | 调拨量测算、ATP 时间轴 |
| 补调达成率 | 已执行量 ÷ 建议量 | 按件数统计；分场景（补货/调拨）分别计算，不合并 | %, 保留 1 位 | 执行达成驾驶舱（验收指标） |
| 建议采纳率 | 未修改行数 ÷ 建议总行数 | suggest_qty = actual_qty 视为未修改 | %, 保留 1 位 | 模型可信度（验收指标） |
共 12 条指标公式 · 分母口径不同者已在"口径说明"中显式标注不可互换每页
口径冲突待确认（阻塞开发，来自报告 7.3 节）
冲突未解决前，相关字段标注"口径待定"，导出时附说明| # | 冲突项 | 文档口径 | 另一口径 | 影响页面 | 优先级 |
|---|---|---|---|---|---|
| 1 | 新品 / 新店保护天数 | 文档口径 7 天 | 后台配置口径 10 天 | rule-model / data-dict 保护期字段 | P0 |
| 2 | 补货频率 | 旺销季一三五 / 淡销季一四 | 后台配置：每日 | rule-org / goal-calc 覆盖期计算 | P0 |
| 3 | "不允许补货入"是否实装 | 规范定义 #3e8965 | 0507 导出 0 命中 | dec-constraint / data-dict 约束枚举 | P0 |
| 4 | 尺码明细 vs 合计列 | 明细求和 440 | 合计列求和 474（空值漏计） | data-quality DQ-005 判定基准 | P1 |
| 5 | 库存台账口径数 | 0507 导出 4 种口径 | 本设计统一为 6 口径 | data-inventory / 决策表导出口径 | P0 |
共 5 项口径冲突 · 全部需业务给出结论后才能锁定字段口径每页
枚举与取值域（节选）
| 枚举名 | 取值 | 权威来源 |
|---|---|---|
| 业务场景 scene | 日常补货 / 区域调拨 / 换店下沉 / 残码清理 | rule-org |
| 命中约束 | 不允许调出 / 不允许调拨入 / 不允许补货入 / 未进入模型 / 无 | rule-store-exc |
| 约束标色 | #ff595e / #896bb3 / #3e8965 / #999999 / 无 | 约束标注规范 |
| 尺码组 | F / XS / S / M / L / XL（末尾合计列） | base-size |
| 单据状态 | 草稿 / 待审批 / 已通过 / 已记账 / 已作废 | data-stocktake |
| 回写状态 | 待投递 / 投递中 / 待重试 / 成功 / 失败终止 | data-idempotent |
| 库存口径 | 在库 / 在单 / 在途 / 锁定 / 可用 / 不可销售 | data-inventory |
| 数据质量维度 | 规范性 / 完整性 / 准确性 / 一致性 / 时效性 / 可访问性 | GB/T 36344-2018 |
口径治理规则与变更留痕
口径漂移是这类系统最常见的隐性事故，治理规则必须落到系统而非文档| 治理项 | 规则 | 责任人 | 启用 |
|---|---|---|---|
| 唯一权威来源 | 字段与指标口径只在 data-dict 维护；其他页面只引用不定义，发现分歧以本页为准 | 数据治理组 | |
| 变更审批 | 口径变更须双人审批，附影响面分析（涉及页面、报表、接口、历史决策） | 数据治理委员会 | |
| 版本与生效日 | 每次变更生成口径版本号与生效日期；历史决策按当时的版本复算，不追溯改数 | 数据治理组 | |
| 禁止自由文本 | 凡涉及门店、SKC、场景、约束、状态、原因码，必须使用枚举，禁止自由文本 | IT 开发 | |
| 导入模板同步 | 字段字典变更后自动重生成 io-template 导入模板与校验规则，避免模板与字典漂移 | IT 开发 |
口径变更记录（近 7 条）
变更记录同时是"历史决策为什么和现在算得不一样"的答案来源| 变更日期 | 口径对象 | 变更前 | 变更后 | 影响范围 | 审批人 | 状态 |
|---|---|---|---|---|---|---|
| 2025-10-21 | 售罄率（正价） | 累计净销量 ÷ 累计进货量 | 累计净销量 ÷（累计净销量 + 期末库存） | rep-sellthru / dash-inventory / 指标字典 | 李治理 | 已生效 |
| 2025-10-21 | 在途量是否计入可分配 | 口径未定义，各处自定 | 统一为"不计入"，仅作未来供给参考 | data-inventory / inv-inway / 决策表 | 王运营 | 已生效 |
| 2025-10-20 | 齐码率分母 | 在售款色数 | 应售款色数（含断货未下架） | rep-size / dash-inventory / 指标字典 | 李治理 | 已生效 |
| 2025-10-20 | 库销比金额口径 | 未明确（吊牌价 / 成本价混用） | 统一为吊牌价，成本价单列字段 | rep-turnover / 指标字典 / 导出列 | 张计划 | 已生效 |
| 2025-10-19 | 可续销周数分子 | 在库 + 在单 + 在途 | 仅可用量（在库 − 锁定 − 不可销售） | goal-calc / 决策表 / 指标字典 | 张计划 | 已生效 |
| 2025-10-19 | 断货率定义 | 库存 = 0 即断货 | 可用量 = 0 且有需求（近 7 天有销或有预测） | rep-size / dash-inventory | 李治理 | 已生效 |
| 2025-10-18 | 保护期天数默认值 | 7 天（文档口径） | 待定（10 天为后台配置口径） | rule-model / data-dict / 决策表保护期字段 | 待业务 | 待业务确认 |
共 7 条变更 · 全部留痕，可回溯任意时点的口径版本每页
i互链：导入模板见 模板与字段字典 质量规则见 数据质量六维校验 库存口径见 库存多口径台账（ATP） 系统参数见 系统参数