docs: record turnover multi-owner export TEST release

2026-10-15 11:20:57 +08:00
parent fe23b1d7a8
commit 29d8997680
2 changed files with 13 additions and 1 deletions
@@ -2,6 +2,12 @@

 ## 自营库存周转 TEST 发布与验收（2026-10-15）

+11:17 按用户本轮实现并一起上线授权，发布货主多选、当前显示列全量 CSV 导出与期间周转率：Lastleg `e19d303a769bc0e59084a58c5d88f111d4772e17`（预构建 #321、backend-java #700 SUCCESS，digest `sha256:9322351f4053afa4681886d2ed81d0178a83d6a9213b8badfcf13b0e86179244`）；Admin `50b06dca1082ebc5c38455b35d9991efc4b2b41d`（admin-web-test #611 SUCCESS，imageId `sha256:f0f8e71d797ef73762877efb770db94f77a2804f689c7ff66bd08bdcf102aa07`）。Admin Job 已恢复 release/test、lightweight=true。Integration 未更新，无 SQL 写入或采集配置变更；部署前无待办及活动任务，部署后健康、唯一供应商出口、BUSINESS／continuousEnabled=true／1200ms 保持。经营总览两个文件的其他未提交改动未纳入本批。
+
+验证：后端74项测试及5项网关检查、前端41项定向测试、374文件3086项全量测试、类型检查与构建通过。真实 HTTP 26次请求核验两仓多货主过滤、汇总、图表、去重、清空恢复，以及固定快照全量分页（所选货主 US01 704条、US02 312条）；前端资源与运行镜像核验通过。CSV 分页、当前列、百分比、转义、取消及版本变化检查通过本地测试，人工1920×1080、100%视觉与浏览器下载验收仍待确认。证据位于后端 target：`selfop-multi-owner-http-proof.json`、`selfop-multi-owner-runtime-after.json`、`selfop-multi-owner-web-runtime.json` 及本批构建／发布回执。
+
+11:18 补充周转率空值只读核验：以10月14日为截止的 US01 样本 SKU，7／15／30天出库覆盖均 COMPLETE，但合格日库存仅10月14日一份，7天窗口为1/7、30天为1/30，积累起点2026-10-14；平均实物库存与周转次数为空，原因为 INSUFFICIENT。历史销量完整不能替代历史每日库存，当前百分比沿用出库量÷期间平均实物库存×100%，未改用当前库存。真实接口未取得可计算的周转率样本，百分比正值、零与未知由本地测试覆盖。证据：`selfop-turnover-missing-samples.json`。未增加供应商请求或修改业务数据。
+
 10:34 按用户“授权更新测试环境”发布本轮库存周转配套版本：Lastleg `72d7ed696255908826c7167d083cd29b3ece8bd7`（预构建 #320、backend-java #699 SUCCESS，digest `sha256:4fdc5ea4fc90ff51b914a8eedde61ca1a50d5f02fe983a107eb61289c030d308`），Admin `11e348a29f649f3c98e976d54a89d359bebf6207`（admin-web-test #610 SUCCESS，imageId `sha256:34b55801fece3d4409078ac1fcf78ac2843bc26e95b8f7491703a6179907ba68`）。先完成后端健康与镜像核验，再更新前端；Admin Job 已恢复 release/test、lightweight=true。两服务各部署一次；Integration 沿用原版本。无 SQL 写入或采集配置变更，部署前只读确认待办及活动任务为0，部署后两后端健康、唯一供应商出口，BUSINESS／continuousEnabled=true／1200ms 保持。

 范围：默认隐藏明确零实物库存，支持SKU／货主全量筛选后计数、排序和分页；未知库存保留，取消勾选显示全部。前端移除主表“状态与样本”列，记录证据保留在统计说明；“隐藏 0 库存”使用带边框复选框并放在列表快捷筛选右侧，清除无数据概览空行及首次失败的“保留上次结果”误导提示。其他窗口未提交的经营总览说明调整未纳入本次前端提交。
@@ -161,7 +161,7 @@ SKU 窗口出库、日均、可售天数及无出库判断与库存明细使用
 | --- | --- |
 | sourceAccount、warehouseCode | 沿现有受控配置及服务端范围检查；只查单仓 |
 | endDate、baseWindowDays | 截止日含当天且必须为已结束日期；基准 7／15／30，默认昨天／30；三窗固定返回，不传任意窗口数组 |
-| groupBy、customerCode、sku | SKU／OWNER；customerCode 可选精确身份，用于下钻；sku 沿用现有合法搜索语义但只适用 SKU 分组，OWNER 携带则拒绝 |
+| 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 绕过检查 |
@@ -234,3 +234,9 @@ SKU 数值表头支持实物件数、正品可售、7／15／30 日出库、所
 本轮评审已明确：7／15／30是完整滚动窗口；四页日期统一最近3／7／15／30天及自定义，原明细继续有入口；货主汇总仅在新视图可选；件数不是空间；可售天数不是库龄或期间周转；历史样本不足不造数；新视图查询不增加领星请求。待后续业务确认的是正式仓租／优惠阈值、空间数据和成本主体，均不阻断本次只读功能开发。

 自定义长区间的翻页上下文携带逐日样本映射的SHA-256摘要，服务端仍按固定查询时刻重建完整max(30,N)日映射（含缺失日期）后比较摘要；完整日历保留在响应中。不能仅相信客户端摘要，也不能读取当前最新样本替代原版本。
+
+### 货主多选、导出与期间周转率（2026-10-15确认）
+
+货主筛选支持可搜索多选，清空恢复全部，变化回到第一页；概览及图表标注“所选货主”。期间周转率默认显示，沿用期间件数周转次数×100%，历史库存样本不足或分母不可计算时保留—，不以当前库存替代。
+
+顶部“导出”按当前已查询的筛选、排序及快照逐页读取全部匹配记录，导出CSV（Excel可打开），列顺序与当前显示列一致，扩展列打开时一并导出；保留未知与估算说明、周转率，提供进度及取消。查询变化或离开页面取消导出，版本失效或分页异常不下载部分文件。