From 716410562385c021780fe1f24de035237647cc5a Mon Sep 17 00:00:00 2001 From: ouyangxq <775153912@qq.com> Date: Wed, 14 Oct 2026 14:08:54 +0800 Subject: [PATCH] docs(self-operated): include transit stock and simplify ranking explanations --- 自营业务/库存周转视图设计.md | 6 +++--- 自营业务/经营总览图表设计.md | 2 ++ 2 files changed, 5 insertions(+), 3 deletions(-) diff --git a/自营业务/库存周转视图设计.md b/自营业务/库存周转视图设计.md index c04c717..53913bf 100644 --- a/自营业务/库存周转视图设计.md +++ b/自营业务/库存周转视图设计.md @@ -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+销量覆盖证明+各库存代表的资格;可信完整销量覆盖内缺销量行可计零,缺库存代表行仍不得补零,不读取可变最新档案污染旧上下文 | | 查询上下文 | 沿现有版本上下文机制扩展日代表集合;可用服务端签名令牌或既有上下文存储,但冻结字段及权限行为一致,实施前总控确定唯一方式 | diff --git a/自营业务/经营总览图表设计.md b/自营业务/经营总览图表设计.md index 4afb0f5..d04441e 100644 --- a/自营业务/经营总览图表设计.md +++ b/自营业务/经营总览图表设计.md @@ -178,3 +178,5 @@ KPI 采用紧凑的一行指标带;图表是主要内容,不再以整页描 图表明细与说明弹框通过 append-to-body 挂到页面根部,避免图表卡片动画/transform限制遮罩与弹框;更换数据关闭旧弹框,日期下钻先关闭明细,长表只滚动弹框正文。库存分组说明宽760px,每日数值/覆盖证据和排行明细宽1040px,可全屏。 热销Top10完整明细按用户最新截图去重:使用1280px居中弹框,按排名、SKU、商品名称、货主、所选时段出库量、实物库存、可售库存、窗口日均、预计可售天数分列;不再拼接重复说明段落,窗口与覆盖状态只在表格上方展示。商品名称与SKU完全相同时显示—,以“SKU+空格”起始时仅去掉该重复前缀;货主+SKU身份及点击下钻保持不变,未知指标不补零。 + +三张Top10卡片的日常展示只保留标题、图表与必要的一行异常提示(未采齐、待评估数量或待刷新);日期、资格数量、完整性详情和统计口径收进右上角“说明”,正常状态不重复显示“完整/待评估0”。图表顶部保持对齐,预计消化天数图上与悬浮数字最多两位小数,明细保留原始精度。