docs(self-operated): include transit stock and simplify ranking explanations

2026-10-14 14:08:54 +08:00
parent 34c65c8c7c
commit 7164105623
2 changed files with 5 additions and 3 deletions
@@ -68,7 +68,7 @@ SKU／商品／货主 | 实物／可售 | 7日／15日／30日出库 | 日均 |
 | 图表完整明细 | 沿用 1040px 居中图表明细框，支持键盘等价下钻；不默认重复展示第二张表 |
 | 统计说明 | 同页折叠文字，集中说明三种指标、时间及未知规则；主表不重复长段说明 |

-SKU 列表是只读分析表，无须新增“操作”列。第一组身份列为 SKU、商品名称、所属货主；长名称可换行，不以内部 ID 回退。首屏保留三窗出库及主要库存／速度指标；冻结、次品、期间平均库存、周转次数、最近已观测出库日、样本证据放扩展列。允许表格内部横向滚动，不挤小全页字体。
+SKU 列表是只读分析表，无须新增“操作”列。第一组身份列为 SKU、商品名称、所属货主；长名称可换行，不以内部 ID 回退。首屏保留三窗出库及主要库存／速度指标；在正品可售后默认展示“在途”列，SKU及货主视图均支持全量升降序排序，未知末尾；冻结、次品、期间平均库存、周转次数、最近已观测出库日、样本证据放扩展列。允许表格内部横向滚动，不挤小全页字体。

 本节是新视图的逐操作设计依据，总控实施时并入模块 `operation-matrix.md`；原明细和总览承载继续沿用既有矩阵。视觉验收为人工 1920×1080、100% 截图，缺证据记“待人工截图确认”。

@@ -131,7 +131,7 @@ SKU 窗口出库、日均、可售天数及无出库判断与库存明细使用

 货主汇总是一条服务端分页聚合查询，不先获取货主选项再逐个调用 `owner-overview`。身份键为来源账号＋仓库＋货主；SKU 继续以货主＋SKU 去重，不跨货主合并同名商品。

-每行展示货主名称／编码、有实物 SKU 数、实物／正品可售／冻结／次品件数、7／15／30 日出库、所选 N 日日均、所选时段无出库 SKU 数及实物件数、慢消化命中和待评估数量；期间周转放扩展列。不平均 SKU 可售天数，也不输出“总库存÷总日均”作为货主整体可售天数。
+每行展示货主名称／编码、有实物 SKU 数、实物／正品可售／在途／冻结／次品件数、7／15／30 日出库、所选 N 日日均、所选时段无出库 SKU 数及实物件数、慢消化命中和待评估数量；期间周转放扩展列。不平均 SKU 可售天数，也不输出“总库存÷总日均”作为货主整体可售天数。

 货主历史出库和平均实物候选必须涵盖期间曾有库存或出库而当前已售空的商品；不能先筛当前正库存再算周转。货主平均实物先按每个合格日代表汇总该货主全部同口径商品，再取 N 日均值；完整时用货主同期总出库除以该平均量。它仍是混合商品的件数指标，不作为跨货主奖惩排名，不能用高销量小件掩盖积压大件。

@@ -163,7 +163,7 @@ SKU 数值表头支持实物件数、正品可售、7／15／30 日出库、所
 | 数据 | 复用与约束 |
 | --- | --- |
 | 三窗实际出库 | `ll_selfop_sku_daily_sales`，按固定销量版、仓库及最长max(30,N)日读取，一次条件聚合三窗；仓级概览优先复用 `ll_selfop_warehouse_daily_sales` 及原覆盖证据 |
-| 当前实物／可售库存 | `ll_selfop_inventory_snapshot`＋其固定 profile，同 SKU 全品质先聚合，避免与日销量多行连接后乘倍 |
+| 当前实物／可售／在途库存 | `ll_selfop_inventory_snapshot`＋其固定 profile，同 SKU 全品质先聚合，避免与日销量多行连接后乘倍 |
 | 历史平均库存 | `ll_selfop_sync_run.inventory_daily_sample_date/inventory_sample_rule_version` 对应的 snapshot、profile、范围与发布证据；最多366个不可变代表批次 |
 | 商品观察与缺日 | 固定版本 profile＋销量覆盖证明＋各库存代表的资格；可信完整销量覆盖内缺销量行可计零，缺库存代表行仍不得补零，不读取可变最新档案污染旧上下文 |
 | 查询上下文 | 沿现有版本上下文机制扩展日代表集合；可用服务端签名令牌或既有上下文存储，但冻结字段及权限行为一致，实施前总控确定唯一方式 |