docs(selfop): define customer and product directory integration

自营业务/领星一件代发数据统计一期方案.md

@@ -1,5 +1,15 @@
 # 领星一件代发数据统计一期方案
 
+## 客户名称与商品资料接入（2026-10-14 最新确认）
+
+此节覆盖下文销量/库存不得选择货主的旧页面限制；经营总览仍不增加客户筛选。销量分析、库存明细、库存周转允许按名称或编码选择客户，默认全部，货主汇总与 SKU 排名均使用原有同仓、同货主、同 SKU 统计口径。名称缺失仍显示外部业务编码，不使用内部数据库主键。
+
+Lastleg 维护 `ll_selfop_owner` 和 `ll_selfop_product`，以完整资料 run 为版本；稳定关联键为来源账号+货主编码，商品再加 SKU，不按名称连接，也不自动创建 IAM 客户或对外收费关系。`ll_selfop_sku_profile` 保留原统计版本职责，不被商品目录替代。客户、商品资料整批完成分页元数据、总数、唯一身份校验后同事务发布；不完整批次不参与查询。`GET /owner-directory` 及各列表/榜单名称均取 queryAsOf 之前最近完整发布的账号资料批次，刷新后才看到新名称；不重采历史出库。
+
+持续 BUSINESS 模式每天登记一项账号级 MASTER_DATA 任务，未结束批次跨日续跑。客户列表每页1000、商品每页100，沿用 Integration 唯一签名出口和账号1200ms间隔、短 permit、lease/fence、限流及未知结果保护。最多处理5页就让出调度，日销量、计划库存、历史销量优先；正常让出保持同一run与下一页，失败或丢失租约的新尝试从头扫描且不能发布旧半批数据。不开第二条真实出口。
+
+商品保留申报长宽高及单位、WMS实测长宽高及单位，两者不互相冒充；空值保留 NULL。本批不计算库存/出库立方数，后续再确认尺寸单位、缺失率及历史出库体积口径。结构基线见后端 `lastleg-service/src/main/resources/db/selfop-master-data.sql`；发布和真实首批同步是否完成只记录工程主契约，本设计不表示已部署。
+
 ## 持续 BUSINESS 自动采集（2026-10-13 最新确认）
 
 用户随后明确取消 BUSINESS 的22:36:59整体许可截止及现有manual/新根人为会话截止。最新代码目标为所有BUSINESS不因这些截止停采，不以continuous开关决定是否免截止；开关仍控制服务端持续计划。VALIDATION仍有界，短permit有效期、有效lease/fence、匹配非空grant、唯一出口、限流/认证/未知结果保护均保留。已有DEAD不自动复活，消费计数和检查点不重置。下文关于BUSINESS保留冻结根截止的旧要求由本条覆盖；实际环境是否生效仍由工程主契约证据确认。