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
@@ -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可打开），列顺序与当前显示列一致，扩展列打开时一并导出；保留未知与估算说明、周转率，提供进度及取消。查询变化或离开页面取消导出，版本失效或分页异常不下载部分文件。