From e81f07053ab9cf84b144a87f2997cafb443f44e1 Mon Sep 17 00:00:00 2001 From: ouyangxq <775153912@qq.com> Date: Wed, 14 Oct 2026 17:48:54 +0800 Subject: [PATCH] docs(selfop): define volume metrics and record idle planner release --- 测试环境单机部署与配置契约.md | 2 ++ 自营业务/库存周转视图设计.md | 11 +++++++++++ 自营业务/领星一件代发数据统计一期方案.md | 2 +- 3 files changed, 14 insertions(+), 1 deletion(-) diff --git a/测试环境单机部署与配置契约.md b/测试环境单机部署与配置契约.md index 14082eb..af270db 100644 --- a/测试环境单机部署与配置契约.md +++ b/测试环境单机部署与配置契约.md @@ -2,6 +2,8 @@ ## 自营统计 TEST 发布与验收（2026-10-14，进行中） +17:38 经用户授权单独发布空闲调度查询补丁 Lastleg `814eb11d2f44c4cda6d675e882f4665c6400c11d`，预构建 #316、backend-java #696 SUCCESS，运行 digest `sha256:ba59514ded914c3a3c847cb105bc52b457795be8751bb950b7ad8bbc24b242c9`。只缩小连续排期去重查询的字段，排除历史目录 JSON；17项调度测试、5项路由检查通过。部署前只读核验0待办、0活动任务，无SQL写入或维护租约变更。17:39两后端健康、唯一供应商出口、BUSINESS／continuousEnabled=true／1200ms；Integration及Admin版本保持下述版本。5秒网络采样显示 Lastleg 内部接收从43.462MB/s降到0.994MB/s，默认路由网卡上行约0.176MB/s；此前“所有网卡”包含 Docker bridge/veth 重复计数，不代表外网上传100MB/s。立方数功能不在该版本内，仍在本地开发。证据：后端target下 `selfop-business-prebuild-lastleg-service-814eb11d2f44.json`、`selfop-idle-planner-deploy-dispatch.json.status`、`selfop-idle-planner-runtime-after.json`、`selfop-host-network-r1.json`、`selfop-host-network-r2.json`、`selfop-idle-sql-diagnostic.json`。 + 2026-10-14 客户/商品资料接入本批按用户逐项授权发布：16:30 执行 `selfop-master-data.sql`，仅新建 `ll_selfop_owner`、`ll_selfop_product`；原始版本 `d311d9dc8ddcd0832ba49d071da07264129f2501` 的 Integration #112、Lastleg #314 预构建及 backend-java #693 成功，Admin `46364d3f895f64c5eab3a56122f66175656217c6` #607 成功，Job 已恢复 release/test 和 lightweight=true。首轮真实采集发现资料接口响应分页字段应为 `page/pageSize`，初版误读 `current/size` 而失败；经授权仅补发 Integration `63883f4ffdad09e4fe06ab77a9b99ced55bf5e0c`（#113、backend-java #694，digest `sha256:d641997b62c9d0b5a40edb7351f49fcf7f47d8826b35839faa5575f877f6e53f`），40项适配测试及5项路由检查通过。该失败属于实现遗漏，不归因于授权 key。 第二次真实尝试已采85货主及2000商品，随后产品分页真实HTTP429，账号进入RATE_LIMIT_REQUIRES_REVIEW，冷却截止16:53:35。经用户追加授权，在冷却结束后仅解除经复核的账号暂停，保留原冷却时间、请求计数、完成回执和失败批次；再单独发布 Lastleg `1112d11c80c32d798500c00242bdff1ead312aec`（#315、backend-java #695，digest `sha256:cdc6afad7353619ff99566417cc14295e8c1110ac3c152e8c8ae57715afeebb5`）。资料改为每次1页、完成后持久化至少5秒再调度，等待期间释放账号租约；50项资料/任务回归和5项路由检查通过。5秒仅是保守运行参数，不是已确认的供应商阈值。Integration和前端此轮未重复发布。 diff --git a/自营业务/库存周转视图设计.md b/自营业务/库存周转视图设计.md index 53913bf..22c158a 100644 --- a/自营业务/库存周转视图设计.md +++ b/自营业务/库存周转视图设计.md @@ -20,6 +20,17 @@ ## 菜单与首次进入 +### 库存与出库立方数（2026-10-14 确认） + +库存周转增加库存立方数、所选区间出库立方数及 SKU 单件体积，单位统一为 m³。沿现有 SKU／货主分组、客户筛选、时间范围及客户下钻查看；本仓／本客户概览增加两项体积汇总，汇总范围与原概览相同，不随分页、SKU 或关注筛选缩小。 + +- 尺寸使用查询时刻 `queryAsOf` 之前最近完整已发布的资料批次，按来源账号＋货主编码＋SKU 精确关联。后续翻页和下钻保持原时刻，整体刷新才取得新尺寸。 +- 优先完整、正值且单位有效的仓库实测长宽高；否则使用完整商品申报尺寸，并标明估算。不混用两套长宽高。支持 mm、cm、m、in、ft，英寸严格按 0.0254 米换算；未知单位不猜测。 +- 库存立方数＝当前全品质实物件数×单件体积。不叠加冻结、次品或在途，不代表托盘／库位占用或含空隙的仓储空间。过期、缺失或异常库存保持未知。 +- 出库立方数＝对应完整出库窗口件数×当前商品单件体积。所有历史出库体积均明确标为估算，不冒充历史包裹实测体积；7／15／30 天及所选 N 天独立判断覆盖，不以部分销量冒充完整体积。 +- 先按 SKU 计算再聚合货主与本仓，不平均尺寸、不按当前页求和、不把同名 SKU 跨客户合并。已知零件数可得零体积；正件数缺尺寸及数量未知分开统计。正式总量未知显示“—”，保留已知体积小计、缺尺寸件数／SKU 数、数量待确认 SKU 数及商品尺寸估算件数。 +- 不增加领星请求、重新采集或改动采集节奏。当前扩展仅在库存周转视图展示体积，原库存明细及销量分析保持现有指标。 + 保持 `/self-operated/inventory` 和现有菜单，页内提供「库存周转」「库存明细」两个视图。普通菜单进入默认“库存周转”，其中默认“按 SKU”；“按货主”是可选切换，不要求先选择货主，不在经营总览和销量分析恢复货主面板。 四个统计页面统一最近3／7／15／30天及自定义（1～366天），均截至北京时间昨日，日期选择器禁止今日及未来。原库存明细继续承接所选时段查询与经营总览严格下钻，不得被新默认页签吞掉或转换成相似的新筛选。它是现有查询能力的明确入口，不增加旧协议别名。 diff --git a/自营业务/领星一件代发数据统计一期方案.md b/自营业务/领星一件代发数据统计一期方案.md index 5849626..9775915 100644 --- a/自营业务/领星一件代发数据统计一期方案.md +++ b/自营业务/领星一件代发数据统计一期方案.md @@ -8,7 +8,7 @@ Lastleg 维护 `ll_selfop_owner` 和 `ll_selfop_product`，以完整资料 run 持续 BUSINESS 模式每天登记一项账号级 MASTER_DATA 任务，未结束批次跨日续跑。客户列表每页1000、商品每页100，沿用 Integration 唯一签名出口和账号1200ms间隔、短 permit、lease/fence、限流及未知结果保护。资料接口每次只处理1页就释放账号租约，并持久化至少5秒后的下次调度时间；等待期间日销量、计划库存、历史销量仍优先，普通销量与库存的1200ms账号间隔不变。5秒是本轮保守运行参数，不代表供应商承诺的限流阈值；再次429仍遵守账号冷却与复核保护；正常让出保持同一run与下一页，失败或丢失租约的新尝试从头扫描且不能发布旧半批数据。不开第二条真实出口。 -商品保留申报长宽高及单位、WMS实测长宽高及单位，两者不互相冒充；空值保留 NULL。本批不计算库存/出库立方数，后续再确认尺寸单位、缺失率及历史出库体积口径。结构基线见后端 `lastleg-service/src/main/resources/db/selfop-master-data.sql`；发布和真实首批同步是否完成只记录工程主契约，本设计不表示已部署。 +商品保留申报长宽高及单位、WMS实测长宽高及单位，两者不互相冒充；空值保留 NULL。库存／出库立方数按 2026-10-14 用户确认扩展到库存周转视图，尺寸优先级、换算、缺失及历史估算口径统一维护在[库存周转视图设计](库存周转视图设计.md)的“库存与出库立方数”章节。结构基线见后端 `lastleg-service/src/main/resources/db/selfop-master-data.sql`；发布和真实首批同步是否完成只记录工程主契约，本设计不表示已部署。 ## 持续 BUSINESS 自动采集（2026-10-13 最新确认）