docs/自营业务/库存周转视图设计.md

库存周转视图设计

在 Admin「自营业务 → 库存分析」增加默认打开的“库存周转”视图，让运营在同一处比较各 SKU 的 7／15／30 天出库、当前库存和消化速度，并按货主汇总，筛选需要复核库存安排及内部仓储成本的对象。

本设计整理自 2026-10-13 优化数据采集页面状态提示中的业务讨论。用户已要求整理方案并交开发总控安排。本文件是新增视图、指标扩展、查询合同与验收的维护入口；基础数据、采集及权限沿用一期方案，总览原有下钻沿用经营总览图表设计。设计交付不表示功能已实现、部署或通过验收。

历史库存还原与周转率修正方案（2026-10-15，实施合同）

用户已确认按本方案实现，先完成本地验证，再统一更新测试环境。本节是该扩展的唯一实施合同；FLOW_EOD_V1 整体替换期间周转的分母来源，原始日观测继续留作对账证据，不能混用两套日库存口径。代码完成不表示已建表、补齐两仓历史或部署，运行与验收事实只维护在 TEST 主契约。

1. 目标与已知边界

• 先补 US01、US02 截至昨日的最近30个完整日，校验通过的 SKU 可以显示期间件数周转率；再扩展到60日。现有两个月销量复用，不重拉出库详情，也不要求等待30天自然积累。
• 数量周转率＝同期已发布出库件数 ÷ 同期平均每日实物库存 ×100%。出库件数继续使用现行列表优先、缺项补详情口径，不能借本次库存流水核验宣称所有列表量已经证明等于最终实出量。期间次数与百分比来自同一个未舍入比值；不是金额／成本财务周转率。
• 分母采用北京时间每日结束前的全品质实物库存，规则名 FLOW_EOD_V1。日期 D 对应 [D 00:00, D+1 00:00)，D+1零点事件归次日。平均数为N个完整日末库存之和÷N；不把08:00快照直接当日末，不与旧日代表混合，不用当前库存替代缺失的日库存。该口径与查询合同一并冻结。
• 已验证一条 SKU 的两个月77条流水、5组库位／批次／品质结存链；三个真实库存观测点和最近30天逐日销量一致，支持此 SKU 的还原。后续本地扩展样本补齐DO／PA／IMO／IAT／RI、正次品转换、包含端点、空页及小范围多页对照；这不等于新增SKU都已完成独立库存锚点对账，也不证明两仓全量历史完整。真实执行与验收证据统一见TEST主契约，字段实测统一见接口手册。

2. 拉取什么、如何分页

数据	首次补齐	后续增量	用途
已发布 SKU 日销量	读取已有完整版本及日覆盖，不重新采集	继续现行销量增量	周转率分子、DO差异诊断
产品库存快照	复用合格的已保存快照；需要新锚点时通过既有库存任务采一轮	继续每日计划库存	当前库存展示、独立库存锚点
stock/stockCellBook/page 流水	目标起日00:00到有效锚点之后的必要尾段；冻结上界后分页	采新增时间片，重查近期窗口捕获迟到变化	历史实物增减、批次链与日末库存

1. 开发阶段先在本地回放已保存响应，补样本时继续限定账号、仓库、货主／SKU，不通过反复发布试探类型。全量上线必须回到 Integration 的唯一受控出口，共用账号锁、permit、请求计数、冷却和至少1200ms间隔；本地直连只用于本轮明确授权的诊断，不能变成长驻的第二个采集器。
2. 生产采集计划按仓库＋固定时间片，优先整仓分页覆盖全部货主／SKU，不按几千个 SKU 逐个请求。官方参数允许货主／SKU筛选；整仓不传这两个条件的实际范围及权限尚须小页验证。若整仓范围不能证明，明确改为已核验的“货主＋时间片”计划，不能静默认为返回的是全仓。
3. 首补从最近日向前推进，一天一片、每页1000条，端点支持情况经本地小范围确认。片内 startTime/endTime、排序、账号／仓范围固定；单片过大时按小时确定性拆分，不改变已开始翻页的条件。请求次数按各片 ceil(total/1000) 估算，首片取得总数后再估算耗时，不承诺“几分钟全补完”。
4. 已核验来源时间参数在样本处两端包含；请求允许边界重叠取回，入库按流水ID去重，本地严格归属半开区间。小范围分页一致不替代每次完整性校验，同秒事件排序仍无永久合同；不能仅凭时间戳大于上次最大值跳过同秒或迟到记录。createTime 用已确认北京时间解析，原字符串同时保留。合法空首分页的size10特殊响应按接口手册严格归一化，不因空片误暂停整仓。
5. 页响应、暂存及下一页检查点同事务保存；HTTP不在数据库长事务里。累计返回数、唯一ID数、源total/pages、每页范围及摘要均校验。总数变化、同页／跨页异常重复、排序漂移导致可能漏页时，不用“去重后条数差不多”判完整；缩小到固定历史片重新形成一次完整尝试，保留失败证据。重叠时间片的边界重复与片内分页异常分别处理。
6. 只有全部页验证通过，时间片才获得“请求范围覆盖完整”的证据；这个结论不等于供应商永久保留、不可修改或历史绝无漏记。跨重启恢复若不能证明原分页集合稳定，重读当前小时间片，不从旧页码盲接新集合。
7. 流水HTTP每页完成后释放账号锁，让销量及当日库存优先执行。流水归并、历史重建和版本发布交给本地工作队列；当前 SelfopSchedulePlanner.tick → SelfopExecutionService.execute 同步执行路径必须调整，否则仅释放账号锁仍会被同一个调度线程的计算阻塞。采集与本地计算分开调度，本地同仓重建有持久化状态与互斥，发布只持有短锁。

3. 必须保存的字段与三张新表

数据归 baiyue_lastleg。复用 ll_selfop_sync_task/run 记录请求、尝试、失败和检查点，复用 ll_selfop_sync_stage 保存每次拉取的白名单原始字段，新增 INVENTORY_FLOW 对象类型；原始响应中姓名、备注、操作者、地址等与数量无关字段不入业务库。日志不保存原始响应、Key或签名。

新表	关键内容	唯一性与用途
ll_selfop_inventory_flow	source_account、warehouse_code、customer_code、sku_code、source_flow_id、cell_no、inner_batch_no、product_quality；bill_no、source_no、bill_type；book_qty、book_change_qty_raw、delta_quantity、close_quantity；source_create_time、event_at_utc、business_date、quantity_unit；content_hash、revision_no、first/last_run_id、last_observed_at、validation_status/reason	来源账号＋仓库＋来源流水ID唯一，ID按字符串保存；同ID异身份拒绝，不按单号或时间去重。保存最新确认事实，旧载荷／版本证据留在不可变stage中。ID作用域核验后再冻结唯一键，不能假定其全球唯一。
ll_selfop_inventory_day_version	account／warehouse／business_date／scope_hash／rule_version、版本号、build_run_id、publication_group_id、固定销量版引用、锚点库存run及观测区间、已完成流水片与事实修订号、输入摘要；READY/PUBLISHED/SUPERSEDED/FAILED、发布／替代时刻、有效／未知SKU数、差异摘要	每仓每日一个已发布头；历史版本不覆盖。唯一约束配合仓scope短锁切换；同一校正组涉及的全部日头在一个事务内切换。它不是原库存快照的发布指针。
ll_selfop_inventory_daily	day_version_id、customer_code、sku_code、product_quality、physical_quantity、quality_status/reason、anchor_reference、evidence_hash、source=FLOW_RECONSTRUCTED	每日版本＋货主＋SKU＋品质唯一；数量用DECIMAL(20,6)，未知NULL、有效零为0。日末实物分品质保存，查询再合计一次；不储存重复的冻结／可售／在途推算值。

原有 ll_selfop_inventory_snapshot 和已发布 sync_run 日标记原样保留。不能把人工快照改成历史定时日代表，不能把还原数据塞回原始快照，也不能更新旧库存时间。客户／商品名称继续关联已有主档，不在流水复制第二套主数据。

校正组清单与执行状态放入对应重建 task/run 的专用结构，禁止复用原库存日代表的发布标记；组清单冻结后不可改，输入再次变化则放弃候选并生成新清单。日版本另存 invalidated_at/reason/rebuild_run_id 以支持查询资格检查，失效标记不可因重建失败而清除；旧日行和证据仍保留。事实修订归并与所影响旧版的失效标记同事务提交，避免出现新事实已接受、查询仍把已知错误旧值判有效的间隙。失效范围尚不能精确确定时，保守覆盖该仓保留的历史日版本，不能漏标；已知细粒度范围记录在重建清单中。

流水至少按 (account,warehouse,customer,sku,event_at,source_flow_id)、(account,warehouse,business_date) 建查询索引；每日表按 (day_version_id,customer,sku,quality) 唯一及必要身份索引查询。日版本按仓／日期／发布有效区间查头；查询不得全表读取大JSON。删除策略需保护被日版本引用的流水证据、锚点和版本；本期不自动清理这批历史证据，也不直接套用销量计算副本7日淘汰规则。

字段实现时对齐现有长度：账号／仓库／货主64、SKU128、来源ID64、原始时间64；来源ID不转BIGINT，日期用DATE、UTC观测时刻用DATETIME(3)，原始变动字符串与数值分开保留。基线在 lastleg-service/src/main/resources/db/lastleg.sql 与独立 selfop-inventory-history.sql 同步，部署SQL索引记录三表及已有stage/任务字段语义变更；本方案不执行DDL。

4. 历史每日库存如何还原

以 账号＋仓库＋货主＋SKU 为统计身份，内部链进一步按 库位＋内部批次＋品质 区分。同名SKU不跨货主合并，跨仓独立。

1. 变动量用有符号 bookChangQty 解析为DECIMAL；PA／DO样本中它与 bookQty 一致。两字段保留，不相加、不因业务类型再取负号。bookQty 不是期初量。其他类型是否同义由类型样本验证，未知语义不能用于正式日库存。
2. 链校验：同一链前一笔结存＋当前变动＝当前结存；首笔前结存＝首笔结存－首笔变动。closeQty 只对该库位／批次／品质有效，不能把多笔结存直接相加或取最新一笔当SKU总量。分组键缺失时保留未知；同秒流水按“前结存→后结存”构成有向余额图，只有使用全部独立流水边的完整路径唯一时才接受，不按条数阈值或字符串ID猜顺序。无前序余额的多边回路、重复边引起的多解及真正分支歧义仍未知，断链／断开图拒绝；用相反边优先级的两次迭代欧拉路径核对唯一性，避免阶乘枚举。
3. SKU锚点：使用已保存、身份与单位明确的SKU分品质实物快照作为独立锚点，按同品质完整流水反推，再合计全品质。某批次在窗口内无变动就可能完全不出现在流水中，因此不能要求“出现过的链结存之和＝SKU快照”，也不能把两者的差额自动判为漏账。例如活动批次10件、无变动批次90件，SKU锚点仍是100件；90件保留在锚点余额内。链连续性检查只约束实际观察到的链；只有另有完整同刻批次清单，才做全链总额对账。缺品质快照不能把总量任意拆分；快照缺行只有在供应商已核验的完整返回／零库存省略规则下才能认定零，否则未知。 库存扫描不是原子历史快照，observed_at 也不保证就是供应商扣账时刻；保存真实页面／整次扫描观测区间。若该SKU在区间内发生变动而无法确定先后，标记 ANCHOR_TIME_AMBIGUOUS，补稳定锚点或缩小对账区间，不能把秒级流水与毫秒响应时间机械相减。用其他独立库存观测点检验还原结果；仅从同一个锚点正推、反推互相吻合不能充当独立正确性证明。
4. 反推公式与尾段：在已确认稳定的锚点状态A下，日期D日末为 I_D = I_A − ΣΔ，求和范围从 D+1 00:00（含）到锚点状态已包含的最后事件，不能漏掉次日零点至早晨锚点之间的流水。来源端点未核验或无法确认事件是否已包含于锚点时，不发布该SKU。目标日期片与锚点尾段分别冻结边界并记录覆盖；尾段必须覆盖锚点整个观测区间以检查歧义，不以“昨日片已完成”替代。跨片重复按来源ID只计一次，恰好零点的事件属于新一天。也可从已核验期初正推逐笔核对；没有变动的日子只有在完整流水范围与有效锚点支撑下才继承余额，这属于结存推导，不是缺日补零。
5. 品质转换和移库：同SKU同仓移库的出／入两端合计应为0，但不能仅按业务单号删掉两条。已实测IMO也承载正品转次品，必须分品质分别记增减后合计，全品质总量不重复；不能只取某一品质或把全部IMO直接丢弃。跨仓移出入分别影响两仓。冻结／解冻若不改变实物不计入实物增减。调整已有正负样本，退件已见正增量，拦截／出库差异尚无实际样本；未知类型影响到的SKU／日期保持未知。上述增减不自动加入销量分子。
6. 历史售空与新商品：候选全集是当前库存、目标窗销量、窗口流水、已有历史日库存身份的并集，包含当前已售空SKU。无流水且有可靠库存锚点及完整范围，可证明恒定存量；缺锚点不能把缺行当0。新SKU首次入库前，必须有可靠零期初和完整流水才能确认历史零值；仅“第一次看见”不够。
7. 资格逐SKU逐日判断：范围缺页、重复身份、链断裂、负库存、单位未知、未知业务语义、锚点不符均保留NULL和原因。数值为0也要证据。对账容差按来源数量精度固定，不用任意百分比误差将不符样本判通过。

5. “回写”写到哪里、什么时候可见

这里的回写仅指写入平台自己的历史事实和日表，不调用领星库存调整接口、不改变领星库存或已有销量事实。

流程为：固定片拉取 → stage落地 → 覆盖校验 → 幂等归并flow事实 → 固定输入构建day_version/daily → 锚点及链校验 → 原子发布日版本 → 查询读取。

• 相同流水ID、相同内容重复采集只更新本次已见证据，不重复增减库存；同ID内容变化生成本地修订号，保留旧stage、标记受影响日版本需重算。同ID异身份先隔离冲突并使可能受影响范围待核验，不能自动搬移事实；只有身份更正得到确认后，才按新旧依赖并集重建。不能用 ON DUPLICATE KEY 累加delta，也不因为某一页没返回就删除历史流水。
• 每日候选在独立版本下批量写入；写入中断只留下未发布候选，页面读不到半批数据。公开日末口径 FLOW_EOD_V1 与内部计算修订分开：计算修订号进入构建去重签名和版本证据；算法修复后用已存流水自动重算一次，相同输入和修订成功后不重复构建，无需重新请求来源。输入流水修订号、锚点、范围、候选身份全集、规则版本及校验摘要冻结，指向可重放的不可变stage修订，不能只存摘要后再读flow表最新值。归并事实修订与发布校验共用同仓版本互斥；发布短事务内核对输入代次未变并切换日头，变化则重建，不能在校验和切换之间放入新的修订。
• 首次补齐或新增日期，一天构建和校验通过即可发布一天，不设30分钟等待，不等60天全跑完。版本包含全候选的有效／未知状态；个别SKU异常不阻塞其他SKU出结果，但未知不能被省略而使货主合计看似完整。若本次也修正已发布日期或改变既有候选全集，按下述校正组发布，不能借“逐日发布”跳过跨日一致性。
• 同一SKU历史变动修订会影响多个日余额，必须按实际计算依赖确定受影响日期，不能只重算发生当日或机械地重算“事件日至锚点”。以较晚锚点反推时，某笔delta修订影响求和范围包含它的更早日末；以较早锚点正推时则影响其后的日末。时间、身份、品质或锚点变化按新旧依赖范围并集失效重建；新发现的售空SKU也要重新核对候选全集。按依赖重建保留范围内的全部受影响日期，无需重拉其他未变化的历史销量。无修改时间或删除契约时，旧记录缺失只进入冲突核验，不自动抹账。
• 校正组原子发布：一个重建任务保存不可变的组清单（publication_group_id、受影响日期、预期旧头、新候选ID、输入代次）。全部候选就绪后，在一个短事务内校验旧头和输入代次、切换全部日头及有效区间、标记整组完成；失败全部回滚。批量计算与daily写入在事务外提前完成，切换只涉及头记录；同仓重建互斥避免并发覆盖。查询可读完整旧组或完整新组，不能读到一半新、一半旧；重启用组清单确认整组是否已提交，不逐日猜测完成状态。
• 已确认旧值有问题而新候选尚未就绪时，当前查询返回对应范围“校正中”，期间周转率暂不展示；首次拉取失败但尚未证明旧值错误不自动撤销旧版本。新查询须在同一个数据库一致性读事务内取得组状态、各日头和销量版本并固化准确版本ID映射；不在多个普通读请求间拼装日头，也不能仅靠墙钟asOf重新推导版本。已打开的上下文及导出继续引用固定证据，同时检查其版本是否被标为需校正，命中则要求刷新／暂不输出该周转率，不能继续称为有效正式结果。已发布日行不可就地修改。
• 归并与重建按日期、货主／SKU分批，流式读取有序流水，不把两仓两个月的JSON一次载入内存。批量写入使用短事务；输入版本未变时复用本地结果，不为生成新日版本再次请求领星。数值计算用DECIMAL，不能在JavaScript浮点或前端做最终业务求和。

6. 周转查询、货主汇总与导出

• 改 InventoryTurnoverContext 固定新的日版本映射、校正组与 FLOW_EOD_V1，改 InventoryTurnoverSql 的日库存来源为每日表。上下文在一致性读中同时确定输入版本；后续查询按准确ID读取，并检查校正失效标记，避免迟提交事务被墙钟时间误归入旧上下文。当前 inventoryRunId 仍服务当前库存、可售天数和立方数；历史日库存版本独立。规则切换后旧上下文明确要求刷新，不保留隐式混算分支。
• 对每个SKU，分子日期完整且N个有效日末库存齐全、平均库存>0，才输出周转次数及百分比。平均库存>0且销量0，结果为0%；均库存为0则仍未知并说明原因，不给无限大。补到7日就可计算7日，30日不足仍不缩短分母。
• 货主周转率＝该货主同期总出库÷该货主每日总实物库存的均值×100%，不是SKU百分比的算术平均。历史售空SKU继续参加分子和分母；“隐藏0库存”只控制当前列表展示，不偷偷改变货主历史统计总体。
• 货主范围内存在缺失SKU／日期，正式总周转率未知，同时返回可计算SKU数、未知数及已知库存小计；不能只挑完整SKU算出一个看似完整的货主值。其他已齐的货主可独立正常展示。
• 列表、排序、导出共用后端计算和同一固定销量版／日库存版。导出包含期间、期间出库、平均日末实物库存、周转率%、库存来源“流水还原”、可用日数及缺失原因；不在浏览器用当前库存重算百分比。主表不重新塞回每行0/30，说明和证据留在现有入口。

7. 以后如何自动保持正确

1. 首补30日优先，后续60日；时间片永久记录边界和完成证据，已完成片不在每次启动时重新全跑。现有销量、当日库存继续优先执行。
2. 每天北京时间00:05创建昨日流水片，完成后立即尝试使用已有合格锚点构建；若证据不足，则等待当天08:00计划库存，并追加覆盖“当天00:00至该锚点观测区间结束”的固定尾段任务。仅在昨日片、所有必要尾段、锚点稳定性共同校验通过后发布昨日；有可用证据即可提前发布，不固定等08:00。锚点在翻页后发生变化，不能移动在途请求上界，另建固定片补齐再选新锚点。00:05是启动时间，不承诺所有SKU此时都已具备证据；尾段未齐显示待核验，不把任务完成当库存已完整。
3. 固定冻结上界，日常重查最近3个完整日捕获迟到记录；每周分片复核近30日、保持低优先级且每页让出账号。因为该接口目前只见 createTime，不能宣称它支持更新时间增量或能发现任意旧记录变更。超过复核窗口的更正通过显式指定日期重算；若供应商确认有更新／删除通知或游标，再替换复核方案。
4. 每天与真实库存对账，差异影响对应SKU与日期资格；保持原数据、错误码和业务任务号，不能为“恢复”自动清库、重置采集或更改历史时间。
5. 429遵守账号冷却与暂停；HTTP结果未知先查审计，不重复发同次请求。固定历史片在明确收到响应且可重读时才有限重试。新增流水采集没有额外HTTP总额度上限，仍受现有安全出口和人工停止控制。

8. 实施批次与验收退出条件

批次	交付	通过条件
A 本地语义核验	保存白名单字段、时间／品质／变动／结存对照；冻结日末口径	已有77条实响应回放；另补移库／调整／退货／品质等出现的真实类型样本、同秒与端点证据。未出现类型列出未验证，不假造真实通过。
B 持久化与受控拉取	三张新表基线、stage/任务类型、整仓分页合同、断点／去重／修订及调度分离	分页变化不假完整；重启不重算delta；本地构建不占供应商锁或阻塞销量线程；无重复任务头。
C 单SKU→单货主还原	日末重建、原子校正组、独立锚点对账	样本三锚点一致；次日尾段、静止批次、连续日链、空日、售空、新品、负库存、未知字段与重复／修订场景通过；正推与反推的修订依赖分别验证；至少一个货主完整候选汇总对齐。
D 两仓30日与查询	近30日分片补齐，页面／排序／导出改读新日版本	已覆盖完整且合格的SKU显示数值；未知有原因；货主算总量比值；当前库存／销量原数据不变；首次逐日发布、校正组事务回滚／重启、并发读、旧上下文失效均通过，不出现跨日新旧混合。
E 增量与60日	昨日自动任务、近期复核、低优先级更早历史	无人操作仍生成任务并继续；停机恢复、迟到流水、冲突与日版本重建有证据；不以首轮成功替代持续能力验收。

代码入口为 Lastleg selfoperated/analytics/history/。INVENTORY_FLOW_HISTORY 请求任务和 INVENTORY_HISTORY_BUILD 本地构建任务使用独立类型及账号任务角色，不进入原始库存／销量任务执行器；构建结果使用独立日版本，原库存发布指针保持。两个独立调度执行器分别负责每页HTTP和有界本地归并／构建。Lastleg 配置 inventoryHistoryEnabled 默认 false；启用前必须完成三表与两服务发布，inventoryHistoryDays 默认60、首批30日。SQL、发布、开启两仓采集按仓库要求明确授权；单SKU本地诊断不扩大成全量本地直连。

9. 设计复核与必须保留的反例

以下是设计推演和已有样本证据，不代替待实现代码的测试或上线验收：

场景	必须得到的结果
已核验样本：次日早晨库存144、零点至锚点出库变动−1	前一日日末为145；漏采尾段时禁止把144发布为日末。
活动批次10、窗口内无流水批次90、完整SKU锚点100	无变动批次保留在锚点余额中；不能因已观察链只合计10而判缺90或把总库存算成10。
两个已发布日均为100，校正后均为110	新查询只能看到完整旧组、校正中或完整新组；不允许110／100混合得到105的均值。
较晚锚点固定为100、区间内仅一笔事件，其delta由−1修订为−2	该笔事件之前的日末应从101变102，事件之后的日末不因该笔修订改变；失效范围沿计算依赖确定。
校正组发布到一半异常、或计算后输入被再次修订	日头全事务回滚，或拒绝过期候选；重启不重复发布部分日期。
零点事件、尾段边界重叠、观测期间恰有库存变动	零点归新日，重叠ID只计一次，锚点先后不明则未知；禁止通过毫秒时间精度假装先后已确认。

第二轮复核除前三项外，已补齐反推修订向更早日期传播、输入冻结与发布竞争、旧查询／导出失效检查。随后有界本地核验结果已纳入接口手册；BO／OBIAT、全仓独立覆盖对照、缺行零库存语义、永久稳定排序及历史修改／删除规则仍未关闭。基础存储、已验证字段适配和资格校验可进入实现，正式日库存仍须逐SKU／日期满足证据门槛；不能把未验证类型当0跳过，也不能把有限样本当作所有历史数据完整的证明。

业务目标与本次边界

业务需要回答四个问题：哪些货现在存得多；哪些 SKU 近期不动或消化慢；哪些货主的库存需要优先复核；哪些商品持续流转，可以进一步评估仓储支持或成本优惠。

继续按仓库独立查看全部授权货主，当前仍是自营业务的内部评估与成本分摊准备。领星货主不是平台收费客户，不自动绑定财务账户。件数、出库速度与当前可售天数是经营依据，不直接给出“加价”“优惠”“优级客户”或费率结论。

本次交付	后续另行核验
默认进入即查；SKU 与货主两种视图；7／15／30 天出库同屏；按所选窗口的日均及可售天数；无出库、消化较慢／较快、冻结／次品及待评估筛选	真实批次库龄、占用体积、托盘／库位及占用时间、货主与内部成本中心映射
有完整日库存样本时计算期间件数周转次数；不足时展示样本数与缺口，不阻断其他指标	正式内部评级、仓租加价／优惠规则、生效期、例外、审批及财务联动
库存与销量时间分别展示；同版本分页、汇总、图表及趋势下钻	新外部接口、提高领星并发、补造历史库存、任意历史时点库存重建

本轮扩展了早前“期间周转留待后续”的范围：实现有资格才计算的查询与展示，但不放宽日样本标准。新品、战略备货、季节性、断货与促销尚未建模，所有关注标签都供人工复核。

菜单与首次进入

库存与出库立方数（2026-10-14 确认）

库存周转增加库存立方数、所选区间出库立方数及 SKU 单件体积，单位统一为 m³。沿现有 SKU／货主分组、客户筛选、时间范围及客户下钻查看；本仓／本客户概览增加两项体积汇总，汇总范围与原概览相同，不随分页、SKU 或关注筛选缩小。

• 尺寸使用查询时刻 queryAsOf 之前最近完整已发布的资料批次，按来源账号＋货主编码＋SKU 精确关联。后续翻页和下钻保持原时刻，整体刷新才取得新尺寸。
• 优先完整、正值且单位有效的仓库实测长宽高；否则使用完整商品申报尺寸，并标明估算。不混用两套长宽高。支持 mm、cm、m、in、ft，英寸严格按 0.0254 米换算；未知单位不猜测。
• 库存立方数＝当前全品质实物件数×单件体积。不叠加冻结、次品或在途，不代表托盘／库位占用或含空隙的仓储空间。过期、缺失或异常库存保持未知。
• 出库立方数＝对应完整出库窗口件数×当前商品单件体积。所有历史出库体积均明确标为估算，不冒充历史包裹实测体积；7／15／30 天及所选 N 天独立判断覆盖，不以部分销量冒充完整体积。
• 先按 SKU 计算再聚合货主与本仓，不平均尺寸、不按当前页求和、不把同名 SKU 跨客户合并。已知零件数可得零体积；正件数缺尺寸及数量未知分开统计。正式总量未知显示“—”，保留已知体积小计、缺尺寸件数／SKU 数、数量待确认 SKU 数及商品尺寸估算件数。
• 表格体积列的m³放在有效数值后，未知值显示“—”并保留必要的简短状态；完整数值来源、估算依据及缺尺寸原因在已有说明或 tooltip 中按需查看，估算属性仍须可辨认，不得冒充实测。库存立方数、所选窗口出库立方数支持SKU／货主全量升降序，单件体积仅SKU支持排序。排序取正式未舍入值，未知末尾，不以已知小计代替；切换排序保持上下文并回第一页。
• 不增加领星请求、重新采集或改动采集节奏。当前扩展仅在库存周转视图展示体积，原库存明细及销量分析保持现有指标。

保持 /self-operated/inventory 和现有菜单，页内提供「库存周转」「库存明细」两个视图。普通菜单进入默认“库存周转”，其中默认“按 SKU”；“按货主”是可选切换，不要求先选择货主，不在经营总览和销量分析恢复货主面板。

四个统计页面统一最近3／7／15／30天及自定义（1～366天），均截至北京时间昨日，日期选择器禁止今日及未来。原库存明细继续承接所选时段查询与经营总览严格下钻，不得被新默认页签吞掉或转换成相似的新筛选。它是现有查询能力的明确入口，不增加旧协议别名。

仓库优先级为合法深链仓库、当前页面保留的有权限仓库、服务端返回的首个有权限仓库；不硬编码仓库编码。确定仓库后自动加载，默认截止日为北京时间昨天，计算基准为 30 天，按实物件数降序、未知末尾。无可用仓库不发经营请求。非法深链或无权仓库明确报错，不静默改查其他仓。

新视图路由参数使用 view=TURNOVER,groupBy=SKU|OWNER,endDate,baseWindowDays=1..366，以及其合法筛选／排序和查询上下文。显式 view=DETAIL 或原总览严格下钻走原合同；相互冲突的参数拒绝，不混合两套筛选。重置保留仓库，恢复新视图默认条件并重新查询；刷新、查询都只读本地已发布数据，不创建采集任务。

页签判定按以下顺序执行：总览严格下钻（from=overview／drilldownFrom=DASHBOARD）进入 DETAIL；其次采用合法显式 view；未指定 view 但有明细专属 salesWindowDays,attention,coverageSelection,coverageBucket,bucketRuleVersion 时进入 DETAIL；其余默认 TURNOVER。warehouseCode,sku,customerCode,endDate 和公共版本字段本身不决定页签。优先级不吞掉冲突：显式 TURNOVER 同时携带总览来源或明细专属条件必须报错，所有参数再按选定视图校验。

页面示意与交互

以下是布局与承载设计，不是实际数据或已验收截图。2026-10-20 用户授权与经营总览、销量分析一起采用蓝白工作台公共样式：两组各三张摘要卡使用紧凑模式，图表面板、货主件数／体积／日均图表、库存视图页签和关注筛选统一蓝白外观。保留现有 360px 双图面板和内部伸缩画布、表格密度及趋势／证据弹窗尺寸。本轮按用户截图收尾：快照解释、本仓概览／截至／采集时间整行和图表范围说明移入已有说明入口；正常卡片只保留名称、数值及单位，删除重复“已确认”；移除独立“展开图表”行，将图表操作并入顶部简短入口。真实未知、陈旧和异常保留简短文字，来源及估算细节按需查看；估算不冒充实测，状态不只靠颜色。视觉待人工截图确认。

库存分析        库存周转〔默认〕  库存明细   图表   数据采集   显示更多指标   说明
仓库 [当前仓]  统计时间范围 [最近3 / 7 / 15 / 30天 / 自定义]  查询  刷新
按 SKU / 按货主    SKU 搜索〔仅 SKU 视图〕    关注条件 / 阈值 / 排序
────────────────────────────────────────────────────────────────────
实物件数   正品可售件数   库存立方数 | 无出库 SKU   出库立方数   待评估 SKU
────────────────────────────────────────────────────────────────────
货主实物件数 Top10（横条）           货主库存立方数 Top10／日均出库对比
────────────────────────────────────────────────────────────────────
全部 | 实物件数最多 | 所选时段无出库 | 消化较慢 | 消化较快 | 待评估
SKU／商品／货主 | 实物／可售 | 7日／15日／30日出库 | 日均 | 可售天数 | 状态
……服务端分页，20条／页……

图表面板保持 360px 高，可折叠且记住本页偏好，表格仍是比较明细的主区。两组各三张指标卡和两图显示当前仓库及精确货主范围的整体情况，不随 SKU 关键字、关注筛选及翻页改变；完整作用范围在已有说明入口明确，不另设常驻概览解释行。筛选结果条数沿现有列表呈现，不能让全仓卡片被误读为当前页合计。

指标卡主数值只展示正式总量，未知总量显示“—”；已知小计（含0）与待核验SKU数放辅助说明，不用已知小计冒充完整总量。库存过期须明确显示最近观测完成时间及受影响指标；同仓采集失败独立显示原因、真实任务号与状态观测时间，沿现有数据采集入口查看。整体刷新同时更新只读采集状态，状态请求失败须说明，不能继续把旧失败当最新状态或影响已成功返回的经营数据。样本证据明确区分出库历史、原始库存观测和流水还原的日末库存；截止日只允许已结束的北京时间日期。当天08:00库存仅作为独立锚点，尾段和对账齐全后可还原并发布昨日库存，不需要再等一天。

货主 Top10 按有效全品质实物件数排序，未知货主不按零参与排名，图旁显示未能完整计算的货主数；标题必须是“实物件数”，不写“占仓面积／占仓最多”。相同件数按货主编码稳定排序。点击条目切入本仓该货主的 SKU 视图，显示可清除的货主条件，保留上下文；不足十个按实际数展示。

右侧默认显示“货主库存立方数 Top10”，标题处切换“日均出库对比”，切换不发新请求、不改变筛选和查询上下文。体积榜复用当前全品质库存体积口径，按完整未舍入值降序、同值按货主编码稳定排序，最多十个；缺尺寸或数量未知的货主不按零或已知小计排名，展示未参与的货主数。条末显示最多两位小数及 m³，明细保留尺寸来源及估算说明，点击条目及明细货主沿用同版本 SKU 下钻。库存体积排名不受统计时段影响，不代表库位空间或占仓面积。

日均对比包含截至所选结束日的7／15／30天及所选N天（去重），每窗完整出库分别除以对应自然日数，各柱独立判覆盖，不比较不同天数的原始累计量；无完整口径的柱留空并显示原因，不画零柱。图表用于观察平均速度，不直接生成增长率或客户等级。

操作	承载与行为
切仓／截止日／计算基准／分组	同页 QueryToolbar；更新条件并回到第一页；切仓清旧数据，取消旧请求并校验请求世代
关注与阈值	同页紧凑控件；选择消化较慢／较快时展开整数天阈值，输入有效后查询；不新增确认弹框
按货主切换	同页服务端分页汇总；切换时清除 SKU 关键字及仅适用 SKU 的排序，提示条件已调整；保留仓库、截止日、基准及有效精确货主条件
点击货主	同页切回 SKU 列表并添加精确货主 chip；返回货主汇总恢复原页码、筛选和上下文
点击 SKU	复用当前 1120px 居中 SKU 日趋势 AppDialog，带真实货主＋SKU与所选基准区间；不加抽屉或独立详情页
历史库存记录与未知原因	主表隐藏“状态与样本”列，不逐行显示日样本进度；期间平均实物／期间件数周转未知时显示“—”，悬停说明原因。在现有“统计说明”中选择本页商品或货主，打开现有 1040px 居中证据 AppDialog 查看历史库存记录及销量覆盖，最多 366 日

列表快捷筛选右侧提供默认选中的带边框复选框“隐藏 0 库存”（hideZeroInventory，省略时为true）。按当前全品质实物件数筛选：SKU视图隐藏明确零实物SKU，货主视图隐藏汇总实物明确为零的货主；未知、过期库存不当作零，可售为零但仍有实物的记录保留。服务端在完整候选上筛选后计数、排序、分页；不改变概览、图表及货主内部销量的汇总范围。取消勾选显示全部，切换立即回第一页并保留查询快照，分组／货主下钻保持选择，重置恢复默认选中。 | 图表完整明细 | 沿用 1040px 居中图表明细框，支持键盘等价下钻；不默认重复展示第二张表 | | 统计说明 | 同页折叠文字，集中说明三种指标、时间及未知规则；主表不重复长段说明 |

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

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

统计时间与三种指标

所有窗口使用同一个北京时间截止日 D，默认昨天且不允许未来或未结束的今日。N 天范围为 [D-N+1 00:00, D+1 00:00)，N 为所选日期数（1～366）；保留7、15、30天辅助对比，非这些天数的所选窗口另行返回；不是自然周／自然月。例：截止 2026-10-12，三个起始日分别为 10-06、09-28、09-13。

三列出库量始终同屏；baseWindowDays 决定日均、可售天数、无出库、快慢查询和期间周转的计算基准，默认 30，不会偷偷把未齐的 30 天换成 7 天。每窗独立返回完整量、已采集量、完整／部分／未知日数、实际日期及原因。部分窗口显示“已采集 X，覆盖不足”，所有日均与派生判断不采用该部分量。

SKU 窗口出库、日均、可售天数及无出库判断与库存明细使用相同资格：仓库固定销量版可信且日期覆盖完整、商品及实际出库数量单位有效时，缺销量行可确认为窗口内零出库，不再要求商品首次观察早于窗口起点。单日存在无效单位或异常出库数量时必须撤销该日资格，不能由缺行补零掩盖。首次观察时间保留为证据；历史周转以合格日末库存资格为准，不再要求观察起点早于整个窗口，历史库存缺口仍不得补零。卡片汇总与列表筛选使用同一结果，真正未知的库存或出库继续保留已知小计和待核验数。

指标	计算与命名	资格
N 日日均出库	同期完整实际出库件数 ÷ N，含真实零出库日	使用固定销量版日事实及完整日规则；不只除以有出库的天数
预计可售天数	当前正品可售量 ÷ N 日日均出库	沿用库存有效性、可信窗口完整性及数量单位资格，不以 SKU 首次观察时间阻断；描述正品可售库存，不代表全部实物消化时间
N 日件数周转次数	同期完整实际出库件数 ÷ 同期每日全品质日末实物均值	N 个合格同口径日代表、范围／单位／商品身份可靠、同期销量完整；显示“次／N日”，不叫财务周转率

期间平均库存为 N 个合格日末实物量之和 ÷ N，统一采用本节 FLOW_EOD_V1 流水还原规则，不使用日内首次快照、期初／期末二点平均或时间加权平均。每个日版本的商品库存先按品质聚合一次，冻结和次品是实物子集，在途不加入。出库分子为同商品同单位全部实际出库，不以某个库存品质过滤重复累加订单。

当前库存和历史期间独立：更改截止日只改变销量及平均库存的历史区间，预计可售天数仍使用查询时固定的当前库存，页面必须保留库存观测时间。历史周转有完整样本时，不因当前库存过期而抹去历史结果；当前可售天数仍须失效。不同 N 的周转次数不是同一期间，不能直接比较次数得出速度变快。

计算保留原六位小数精度；日均显示两位、天数一位、周转次数两位，筛选和排序使用未舍入值。很小的正数按显示精度显示“<0.01／<0.1”，不伪装为真实零；前端不重新推算业务指标。

仓库／货主的 7／15／30 日日均出库图按固定已发布销量版的实际覆盖与单位资格独立计算。后台补采或归并触发 rebuildRequired 时，不抹去该版已经完整覆盖的日期；图表显示销量发布时间和新版待重算提示，未发布的事实及其他版本均不混入。30 日未齐不能用已覆盖天数缩小分母。SKU当前库存评估继续受待重算保护，图表旧版可读不代表可作为最新补货或告警依据。

零值与数据不足

条件	结果
窗口完整，当前正可售，但出库为零	日均 0，可售天数为空，显示“所选窗口无出库”；不填无限大
当前库存有效且可售为 0	可售天数 0 并标“无可售库存”；不进入消化较快，不代表库存健康或货主优秀
当前库存未知／异常／过期	可售天数为空并说明；可靠历史出库及历史周转独立展示
7 天完整、15／30 天缺失	7 天可独立输出正式值，其他窗口显示已采集量／缺口；默认 30 日基准的日均及天数仍为空
N 日日代表齐全且平均实物大于零、出库为零	件数周转次数为 0；仍要满足历史日末库存与销量完整性
平均实物为零	周转次数为空；有出库时说明“每日观测未捕获存量”，不输出无穷大或直接认定数据造假
有 30 天出库，但库存只有 2 个合格日样本	证据弹框显示 2／30、缺口和历史覆盖起点；周转次数为空，不缩小分母、不用当前库存直接替代历史
缺少独立锚点、流水不完整、日版本缺商品行或品质／单位异常	保留未知／缺口；不补零，不把原始快照事后改成历史日末记录

最近已观测出库日期取固定销量版的有效正出库最大日期，不以任意首采日充当。没有可靠日期显示“已采集历史内未见出库”；只有该日期至截止日连续覆盖且商品存在证据可靠时，才可显示“距最近出库 N 天”。不得将有限观察窗口内未见出库写成“从未售出”或真实库龄。

筛选与内部评估规则

新视图使用独立 focus，不改写原 attention、总览分桶或所选时段严格下钻含义。观察与异常证据沿用主方案。快慢阈值是本次查询输入，按仓库保存页面偏好但不是正式仓租政策；初始不预设未经确认的 90／180 天，不因未设阈值阻止默认列表。

快捷入口／focus	规则与默认排序
全部 ALL	固定版本候选全集，保留零值、售空及未知；默认实物件数降序
实物件数最多	ALL＋实物降序；不得称为占用空间最大
所选时段无出库 NO_OUTBOUND_IN_WINDOW	有效正实物、所选可信完整时段出库为零及有效数量单位；包含全冻结／次品；按所选基准窗口判定
消化较慢 COVERAGE_GT	有效正品可售量和 N 日日均均为正且正式可售天数 > 查询阈值；天数降序
消化较快 COVERAGE_LE	有效正品可售量和 N 日日均均为正且正式可售天数 ≤ 查询阈值；天数升序；只是消化估算，不代表持续销售或正式高周转等级
冻结／次品 FROZEN／DEFECTIVE	对应有效数量 >0，不依赖销量完整性；这些库存可能无法按日均正常售出
待评估 UNASSESSABLE	当前库存、所选 N 日可信窗口或数量单位资格不足，无法完整评估流转表现；有效零可售仍按优先规则显示0天，窗口不足时可同时标“待评估：销量覆盖不足”；完整零出库不属于此类

可售天数判定固定为库存有效性 → 明确零可售 → 正可售的窗口／单位资格 → 分母是否为零；待评估标签不覆盖这一数值顺序，也不等同“可售天数必为空”。另提供“周转样本不足”状态／筛选 turnoverStatus=INSUFFICIENT，它与经营待评估独立：已有完整出库和可售天数的 SKU 可以仅缺历史库存样本。无出库与慢消化是不同集合，不将空天数伪装为超大数；冻结／次品与其他关注可重叠，不把标签命中数相加当总 SKU 数。

货主视图不把整个货主简单分为快／慢：使用“含此类 SKU 的货主”筛选，行内同时显示该类已确认 SKU 数、实物件数和待判断数；未输入阈值时快慢相关值为空并显示“未设查询阈值”。

货主汇总

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

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

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

每项总量分别提供正式总量、已知小计和未知数量。销售窗口完整即可展示货主真实出库总量；单个 SKU 库存观察不足不抹掉已可靠的出库事实。无出库等正式命中件数占比，只有整个候选范围及判断均可靠才输出；否则仅给已确认小计与待判断数。比例为实物件数比例，不是空间占比；分母零时比例为空。

服务端合同与数据结构

新增 Lastleg 只读 GET /api/platform/v1/last-leg/self-operated-analytics/inventory-turnover，供新视图使用；原 /inventory-coverage、owner-overview、经营总览及其严格下钻合同保留各自用途，不把原单窗口接口改成三次调用。复用平台 list 权限、仓库范围检查和既有异常响应。最终 Controller、DTO、OpenAPI、前端类型必须一起收口，以下是开发目标，不宣称接口已经存在。

入参	约束
sourceAccount、warehouseCode	沿现有受控配置及服务端范围检查；只查单仓
endDate、baseWindowDays	截止日含当天且必须为已结束日期；基准 7／15／30，默认昨天／30；三窗固定返回，不传任意窗口数组
groupBy、customerCodes、sku	SKU／OWNER；customerCodes 为可选货主编码集合，重复query键传输，最多100个，省略或空集合查询全部，列表／概览／图表统一按集合筛选，不合并不同货主的同名SKU；下钻传单元素集合；sku 只适用 SKU 分组，OWNER 携带则拒绝
focus、coverageDaysThreshold、turnoverStatus	按上节枚举；GT／LE 必须有正整数阈值，其他关注可带阈值展示标签；拒绝原 attention／coverageBucket 等混入
sortBy、current、size	按分组白名单排序；默认 PHYSICAL_DESC，1／20，size≤100；同值以 SKU＋货主或货主编码稳定排序，未知末尾
查询上下文	复用固定版本、queryAsOf 和有效期；新增历史日代表集合的固定证据，不能由客户端任填 run ID 绕过检查

SKU 数值表头支持实物件数、正品可售、7／15／30 日出库、所选基准日均出库、预计可售天数，以及扩展列冻结件数、次品实物、期间平均实物、期间件数周转的升降序。首次点击未选中的列使用降序，再次点击切换升序；箭头表示成功查询的顺序，与排序下拉框共用同一合同。切换排序回到第一页，保持有效的查询上下文；按全部筛选结果排序后分页，不在当前页重排。日均排序随 baseWindowDays 使用对应窗口。未知或覆盖不足的正式值始终排在末尾，不按已采集小计或零参与；同值按 SKU＋货主稳定排序。OWNER 支持相同指标（预计可售天数除外）及已确认无出库实物小计排序，同值按货主编码稳定排序，未知状态随值返回。

一次响应返回 context,summary,charts,rows,total。首次／整体刷新返回概览与两图，普通列表翻页用同一上下文及 includeOverview=false 省去重复汇总；筛选 SKU 或关注不改变概览范围。切仓、截止日、基准、精确货主或分组变化时，重新请求对应概览；不得把新上下文的行与旧图拼屏。

context 固定账号、仓库、销量版、当前库存版、queryAsOf、有效期、三个真实窗口、当前库存观测起止、历史日末规则与最多366个日期到独立日版本的准确映射及摘要。历史样本只纳入首次上下文时已经发布且合格的代表；后续样本补齐不能悄悄改变旧查询。实际代表映射须可由服务端验证／重建，缺失日期也冻结，不只是返回一个不可校验的哈希。受引用版本按现有保留策略保护，到期或无法重建时明确要求整体刷新。

每窗指标至少返回 days,startDate,endDateExclusive,outboundQuantity,observedQuantity,averageDailyOutboundQuantity,completeDayCount,partialDayCount,unknownDayCount,dataStatus,reasonCodes；行另外返回 inventoryCoverageDays,averagePhysicalQuantity,quantityTurnoverCount,qualifiedSampleDays,requiredSampleDays,attentionReasons 及各自状态。不能用一个行级 COMPLETE 掩盖部分指标未知。内部版本标识用于程序，不作为用户可见业务编号。

复用表与最小结构要求

数据	复用与约束
三窗实际出库	ll_selfop_sku_daily_sales，按固定销量版、仓库及最长max(30,N)日读取，一次条件聚合三窗；仓级概览优先复用 ll_selfop_warehouse_daily_sales 及原覆盖证据
当前实物／可售／在途库存	ll_selfop_inventory_snapshot＋其固定 profile，同 SKU 全品质先聚合，避免与日销量多行连接后乘倍
历史平均库存	ll_selfop_inventory_day_version＋ll_selfop_inventory_daily，固定最多366个不可变日版本，检查范围、规则和已知失效标记
商品观察与缺日	固定版本 profile＋销量覆盖证明＋各库存代表的资格；可信完整销量覆盖内缺销量行可计零，缺库存代表行仍不得补零，不读取可变最新档案污染旧上下文
查询上下文	压缩JSON＋HMAC签名令牌固定准确日版本集合；服务进程重启后旧令牌要求整体刷新，当前单机单实例部署不依赖跨实例共享密钥

不新增 7／15／30 天销量表、不存一张会被实时覆盖的“SKU 周转结果表”；历史流水、独立日版本与还原日明细及专用调度按本文件首节实现。若实际执行计划证明需要索引或有界聚合缓存，由总控在唯一 SQL 基线中评审；不凭设计先引入缓存平台。没有历史代表时，周转值为空即可交付页面，不能为得到数值额外扫描领星或修改原样本标记。

查询性能与一致性

所有查询读取本地已发布数据，不查原始订单明细，不调用 Integration。禁止前端逐 SKU／逐货主请求、把第一页求和当全仓汇总、先取 Top100 后筛选、为三窗执行三套完整扫描。

候选身份是本次固定当前库存版 profile／snapshot、固定销量版所选最长max(30,N)日事实及相关 profile、同期合格历史日版本的 daily 中货主＋SKU 的并集；不读取后续可变档案。仅历史存在而当前缺行的商品保留为当前库存未知，不能补零。rows、total、summary 和图表使用同一候选定义，再分别应用各自已声明的范围与列表筛选。

默认实物排序且无销量／天数／周转等依赖筛选时，可先对完整候选身份分页，再补该页三窗和历史样本，不能只从当前 snapshot 选页而丢失未知／售空商品。依赖销量、可售天数、周转次数的筛选／排序必须先在完整候选计算资格，再排序分页。货主聚合与图表独立按完整范围计算；复用现有性能方案中已验证的路径，不原样重复已无收益的优化实验。

验收采用单仓至少1万货主＋SKU、最多30日代表、多历史销量版、10并发只读用户及后台构建场景。新增目标：首屏含概览 HTTP P95≤1.5s；默认列表翻页 P95≤1s。复杂筛选、货主汇总和完整30日周转排序分别报告，不用缺样本快速返回证明达标；未达目标记录瓶颈交总控安排，不能伪报通过。保留 P50／P95／P99、SQL 数、扫描行、响应大小及结果对照，压测不请求领星。

相同条件刷新失败可以保留旧结果并明确时间；切仓清旧结果。当前库存过期时只失效依赖当前库存的判断，历史销量／历史周转仍按各自证据展示。页面刷新不会改变采集状态，开发与发布不得为本视图重置采集任务。

开发顺序与职责

1. 总控冻结新增接口、窗口／零值规则、历史样本上下文和文件写权；明确 SKU 默认与货主可选视图是本轮新增例外，同步最近模块指引及操作矩阵，不恢复其他页面货主控件。
2. 指标查询工作包实现一次三窗聚合、库存资格、分页排序、全范围汇总与有资格的期间周转；样本不足作为正常业务状态，补定向公式／覆盖／版本测试。
3. 前端工作包实现默认打开、表格两视图、紧凑图表、筛选与既有趋势／证据弹框；先按冻结 DTO 并行，随后联调。共享类型与导航由总控协调唯一写者。
4. 采集实现按首节完成受控流水分页、本地重建、独立库存对账和原子日版本发布；保留现有销量优先级及统一出口约束。
5. 总控完成接口、SQL 基线、权限及受影响门禁，安排人工页面验收。实现、自动测试、部署、人工验收分别记录；运行状态仍只维护正式工程契约。

优先交付能立即使用的默认查询、三窗出库、日均／可售天数、关注筛选与货主汇总；期间周转的合成样本测试同期完成，真实数值由已验证流水还原历史日末库存后产生，无证据的日期继续保持缺口。不得以“已有可售天数”宣称正式周转已完成。

验收清单

场景	必须结果
普通菜单进入／有效深链／无仓库	自动选合法仓并查询；深链优先；无仓不查；不要求先选货主
截止2026-10-12	三窗起止分别为10-06／09-28／09-13至10-13不含，均不包含今日
示例 SKU：7／15／30日出库70／150／300，当前可售600；选30日	三列各自真实显示；日均10，可售60.0天；切7日仍日均10，不改三窗累计
同一SKU同期30个日代表实物均值500，30日出库300	30日件数周转0.60次；不能用当前可售600算成0.50次
7日齐、15／30日未齐	7日正式值可用；其他显示已采集量与不足；30日基准天数空，不自动缩短窗口
30日出库齐、仅2个日代表／只有人工TEST库存	显示真实样本缺口，正式周转空；销量和符合资格的可售天数继续展示
全冻结／次品正实物且完整30日零出库	可命中无出库和库存品质关注；可售为零不判消化较快，不重复累加实物
新品／首次观察晚于窗口起点	可信完整销量窗口按实际出库计算日均、天数及无出库判断，不因观察时间变成覆盖不足；期间件数周转仍核对历史库存样本与观察证据
来源库存缺行／负数／过期或销量未覆盖	对依赖指标逐项传播未知；不得把真正未知数量补零，负数不取绝对值
库存有效且可售0，但销量窗口不足	可售天数0并标无可售库存，同时保留销量覆盖不足及待评估；不因0天进入消化较快
平均库存正且零出库／平均库存零且有出库	前者周转0；后者为空并说明单日观测局限，不显示无限大
当前售空但期间有出库与历史库存	仍计入货主期间出库及平均库存；不因当前零库存丢失历史贡献
同仓同名SKU不同货主、两仓同货主SKU	分行、分仓、独立窗口资格，不混合库存或借另一仓历史
货主有部分未知商品	出库、库存及关注分别传播；保留已知小计与未知数，不用合格样本比率冒充完整风险占比
切货主／筛选／分页／图表下钻	统计范围标签准确；列表 total 与全量谓词一致；图表不由当前页拼出；身份与上下文不丢
原经营总览无出库／最长天数／分桶跳入库存	进入原库存明细，保留原所选时段资格、严格版本及时效，不落入新近似筛选
新版发布、日样本新增、旧上下文读取	旧上下文结果不漂移；整体刷新才切新；过期明确要求刷新
页面与性能	1920×1080人工核对；三窗与主库存可读；未知有原因；性能按上述真实完整样本分别报告

本轮评审已明确：7／15／30是完整滚动窗口；四页日期统一最近3／7／15／30天及自定义，原明细继续有入口；货主汇总仅在新视图可选；件数不是空间；可售天数不是库龄或期间周转；历史样本不足不造数；新视图查询不增加领星请求。待后续业务确认的是正式仓租／优惠阈值、空间数据和成本主体，均不阻断本次只读功能开发。

自定义长区间的签名翻页上下文携带准确日版本ID集合及SHA-256摘要，服务端按固定ID读取并重建max(30,N)日历（含缺失日期），不再通过墙钟时刻推定某个版本当时可见。已知修订使所引用旧版本失效时明确要求刷新；普通新版本发布不改变旧查询。完整日历留在响应，日版本字段为dayVersionId。

货主多选、导出与期间周转率（2026-10-15确认）

货主筛选支持可搜索多选，清空恢复全部，变化回到第一页；概览及图表标注“所选货主”。期间周转率默认显示，沿用期间件数周转次数×100%，历史库存样本不足或分母不可计算时保留—，不以当前库存替代。

默认“期间周转率”表头支持全量升降序，与扩展周转次数列及筛选区的“期间周转率从高到低／从低到高”同步，未知值始终末尾。点击排序保留货主、日期、隐藏零库存及固定版本，回到第一页。表头独立信息按钮展示百分比公式、每日末均值、货主汇总与未知值口径；打开说明不触发排序或查询。

顶部“导出”接入统一下载中心，提交 SELFOP_INVENTORY_TURNOVER 后台任务生成 XLSX；浏览器不再分页拉明细或拼CSV。提交参数固定当前已查询的筛选、排序、版本、总条数及有序列键，扩展列打开时一并提交；列名、周转率、未知与估算说明由 Lastleg 生成，File 分批写文件并提供进度、下载和重试。离开页面不取消已提交任务。独立权限为 platform:self-operated-analytics:export，仅平台非代登录账号可创建／下载／重试。

沿用库存周转查询的30分钟固定上下文，不在排队或重试时重新取最新版本。上下文过期、后端重启或日版本失效须刷新列表重新提交；条数变化、缺页等异常整任务失败，不提供部分文件。每批100条，最多200000条，沿用下载中心文件大小与存储有效期限制。必带统计期间、期间出库、平均日末库存、周转率及历史证据列，其他列保留当前表格顺序；新增 File 类型配置及IAM导出权限，无业务建表或销量／库存回写。