Procházet zdrojové kódy

docs(contract): EVD-12R2 商品服务商域 6 SC 契约核对(SC-S-01/05/07/08/10/11)

防假 RED 端点核对:逐条 grep 实测 cfc-backend controller 源码定位端点载体。
- 6/6 SC 端点齐全无缺口;SC-S-01 载体置换(AdminSupplier/EcomSupplier 已废弃 → SupplySystemController /api/admin/supply-system)
- SC-S-11 ⚠授权语义回填 ✅(/api/user/data-export + ReportMemberPermissionController member-permission 双载体)
- 新增契约核对文档 + API_REFERENCE 增补 4.62 段落;未改业务代码/测试/.tdd,无 DB 迁移
Sisyphus před 1 týdnem
rodič
revize
fe63ce82b0

+ 180 - 0
docs/superpowers/api/API_REFERENCE.md

@@ -2994,3 +2994,183 @@ W0.2 双配置中心合并:`product_config` 已并入 `service_config`(唯
 | SC-A-21 | 舌诊/情绪模型管理 | `POST /api/admin/innate-portrait-config/{list,update,invalidate}` + `POST /api/mind/emotion/{analyze,analyze-url}` 存在;舌诊模型无独立 admin 端点(内联报告解析链) | 端点载体部分存在,需产品侧确认 |
 
 *文档更新:2026-11-07(EVD-11 平台运营 25 SC 契约核对增补「平台运营能力」段落 4.60:管理端登录 / 统计 / 报告解析中台 / 文章审核 / 勋章 / 供应商 / 活动 / 知识库 / 维度 / 迁移 / 用户家庭治理 / 订单退款 / 审核队列 / 审计日志 / 优惠券 / 能量配置 / 睡眠选项 + 契约缺口。完整核验表见 `docs/superpowers/specs/2026-11-07-admin-ops-contract.md`)*
+
+### 4.62 商品服务商域(SC-S-01/05/07/08/10/11,EVD-12R2 契约核对增补)
+
+> 归属:契约补建计划 P0「商品服务商域」· 核对 2026-11-07(EVD-12R2)
+> 核对方法:类级 `@RequestMapping` + 方法级 `@PostMapping` 实测定位(防假 RED)。SC-S-02/03/04/06 由 EVD-4 商城-会员覆盖;SC-S-09 由 EVD-7R 报告闭环覆盖。
+> 完整核验表见 `docs/superpowers/specs/2026-11-07-service-provider-contract.md`。
+
+#### 4.62.1 服务商入驻申请(`SupplySystemController /api/admin/supply-system`,SC-S-01 `supplier.apply`)
+
+> ⚠ 载体置换:开工包候选 `AdminSupplierController /api/admin/supplier`、`EcomSupplierController /api/admin/ecom-supplier` 均标注「【已废弃】请使用 /api/admin/supply-system/list」,活跃载体为 `SupplySystemController`。
+
+| 路径 | 说明 |
+|------|------|
+| `POST /api/admin/supply-system/list` | 服务商体系分页(keyword/status/page/size) |
+| `POST /api/admin/supply-system/create` | 服务商体系建档(入驻申请提交) |
+| `POST /api/admin/supply-system/update` | 服务商体系更新 |
+| `POST /api/admin/supply-system/detail` | 服务商体系详情 |
+| `POST /api/admin/supply-system/toggle-status` | 启停审核(入驻审核动作) |
+| `POST /api/admin/supply-system/list-all` | 全量体系(下拉选择) |
+| `POST /api/admin/supply-system/my-system` | 当前用户所属体系 |
+| `POST /api/admin/supply-system/my-teams` | 一人多团队(顶部切换器) |
+| `POST /api/admin/supply-system/member/list` | 体系成员列表 |
+| `POST /api/admin/supply-system/member/add` | 添加体系成员 |
+| `POST /api/admin/supply-system/member/remove` | 移除体系成员 |
+| `POST /api/admin/supply-system/member/change-role` | 成员角色变更 |
+
+> 边界:体系层级/团队治理(`SupplyManageController /api/admin/supply-manage`:list/detail/create/update/delete/add-role/remove-role/adjust-tier)由 EVD-11 SC-A-06 覆盖,不重复登记。
+
+#### 4.62.2 库存管理(`AdminInventoryController /api/admin/inventory` + `SupplierProductController /api/admin/supplier/product`,SC-S-05 `supplier.inventory.manage`)
+
+**AdminInventoryController `/api/admin/inventory`**
+
+| 路径 | 说明 |
+|------|------|
+| `POST /api/admin/inventory/inbound/create` | 入库单创建 |
+| `POST /api/admin/inventory/inbound/list` | 入库单列表 |
+| `POST /api/admin/inventory/inbound/detail` | 入库单详情 |
+| `POST /api/admin/inventory/inbound/confirm` | 入库确认 |
+| `POST /api/admin/inventory/inbound/cancel` | 入库取消 |
+| `POST /api/admin/inventory/outbound/create` | 出库单创建 |
+| `POST /api/admin/inventory/outbound/list` | 出库单列表 |
+| `POST /api/admin/inventory/transactions/list` | 库存流水列表 |
+| `POST /api/admin/inventory/counting/create` | 盘点单创建 |
+| `POST /api/admin/inventory/counting/confirm` | 盘点确认 |
+| `POST /api/admin/inventory/counting/list` | 盘点单列表 |
+| `POST /api/admin/inventory/alert/list` | 库存告警列表 |
+| `POST /api/admin/inventory/product/stock` | 商品库存查询 |
+| `POST /api/admin/inventory/combo/items` | 组合商品项 |
+| `POST /api/admin/inventory/combo/items/list` | 组合商品项列表 |
+
+**SupplierProductController `/api/admin/supplier/product`**
+
+| 路径 | 说明 |
+|------|------|
+| `POST /api/admin/supplier/product/list` | 服务商商品列表 |
+| `POST /api/admin/supplier/product/create` | 服务商商品创建 |
+| `POST /api/admin/supplier/product/update` | 服务商商品更新 |
+| `POST /api/admin/supplier/product/detail` | 服务商商品详情 |
+| `POST /api/admin/supplier/product/delete` | 服务商商品删除 |
+| `POST /api/admin/supplier/product/shelve` | 服务商商品上/下架 |
+
+#### 4.62.3 营销活动报名(`ActivityController /api/activity` + `AdminActivityController /api/admin/activity` + `ActivityOrderController /api/activity/order`,SC-S-07 `supplier.activity.signup`)
+
+**ActivityController `/api/activity`**
+
+| 路径 | 说明 |
+|------|------|
+| `POST /api/activity/list` | 活动列表 |
+| `POST /api/activity/detail` | 活动详情 |
+| `POST /api/activity/create` | 活动创建 |
+| `POST /api/activity/update` | 活动更新 |
+| `POST /api/activity/publish` | 活动发布 |
+| `POST /api/activity/end` | 活动结束 |
+| `POST /api/activity/submit-review` | 提交审核 |
+| `POST /api/activity/register` | 活动报名 |
+| `POST /api/activity/cancel-registration` | 取消报名 |
+| `POST /api/activity/my-registrations` | 我的报名列表 |
+| `POST /api/activity/registration-roster` | 报名名单/核销 |
+| `POST /api/activity/checkin` | 活动签到 |
+| `POST /api/activity/checkin-review` | 签到审核 |
+
+**AdminActivityController `/api/admin/activity`**
+
+| 路径 | 说明 |
+|------|------|
+| `POST /api/admin/activity/list` | 活动管理列表 |
+| `POST /api/admin/activity/review` | 审核 |
+| `POST /api/admin/activity/detail` | 详情 |
+| `POST /api/admin/activity/submit-review` | 提交审核 |
+| `POST /api/admin/activity/audit` | 审核动作 |
+| `POST /api/admin/activity/backfill-tags` | 标签回填 |
+| `POST /api/admin/activity/withdraw` | 撤回 |
+| `POST /api/admin/activity/re-draft` | 退回草稿 |
+
+**ActivityOrderController `/api/activity/order`**
+
+| 路径 | 说明 |
+|------|------|
+| `POST /api/activity/order/create` | 报名订单创建 |
+| `POST /api/activity/order/pay` | 报名订单支付 |
+| `POST /api/activity/order/handlePaymentSuccess` | 支付成功回调处理 |
+| `POST /api/activity/order/notify` | 支付通知 |
+| `POST /api/activity/order/status` | 订单状态查询 |
+
+#### 4.62.4 对账/结算(`AdminSettlementController /api/admin/dan-settlement` + `SupplySettlementController /api/admin/supply-settlement`,SC-S-08 `supplier.settlement.reconcile`)
+
+**AdminSettlementController `/api/admin/dan-settlement`**
+
+| 路径 | 说明 |
+|------|------|
+| `POST /api/admin/dan-settlement/list` | DAN 结算列表 |
+| `POST /api/admin/dan-settlement/detail/{settlementId}` | DAN 结算详情 |
+| `POST /api/admin/dan-settlement/confirm/{settlementId}` | DAN 结算确认 |
+| `POST /api/admin/dan-settlement/stats` | DAN 结算统计 |
+
+**SupplySettlementController `/api/admin/supply-settlement`**
+
+| 路径 | 说明 |
+|------|------|
+| `POST /api/admin/supply-settlement/list` | 供货结算列表 |
+| `POST /api/admin/supply-settlement/detail` | 供货结算详情 |
+| `POST /api/admin/supply-settlement/detail-items` | 供货结算明细 |
+| `POST /api/admin/supply-settlement/create` | 供货结算创建 |
+| `POST /api/admin/supply-settlement/confirm` | 供货结算确认 |
+
+#### 4.62.5 营养/食谱数据供给(`NutritionProductController /api/nutrition/product` + `BeijingNutritionController /api/nutrition/beijing` + `UserNutritionProfileController /api/nutrition/profile`,SC-S-10 `supplier.nutrition.supply`)
+
+**NutritionProductController `/api/nutrition/product`**
+
+| 路径 | 说明 |
+|------|------|
+| `POST /api/nutrition/product/category/list` | 营养品分类列表 |
+| `POST /api/nutrition/product/brand/list` | 营养品品牌列表 |
+| `POST /api/nutrition/product/search` | 营养品搜索 |
+| `POST /api/nutrition/product/detail` | 营养品详情 |
+| `POST /api/nutrition/product/recommend` | 营养品推荐 |
+| `POST /api/nutrition/product/price-compare` | 营养品价格对比 |
+| `POST /api/nutrition/product/from-product` | 从商品转换 |
+
+**BeijingNutritionController `/api/nutrition/beijing`**
+
+| 路径 | 说明 |
+|------|------|
+| `POST /api/nutrition/beijing/bacteria/save` | 北京食谱菌群保存 |
+| `POST /api/nutrition/beijing/recommend` | 北京食谱推荐 |
+| `POST /api/nutrition/beijing/recommend/custom` | 北京食谱自定义推荐 |
+| `POST /api/nutrition/beijing/kb/query` | 食谱知识库查询 |
+| `POST /api/nutrition/beijing/kb/list` | 食谱知识库列表 |
+| `POST /api/nutrition/beijing/kb/info` | 食谱知识库详情 |
+| `POST /api/nutrition/beijing/analysis` | 食谱分析 |
+
+**UserNutritionProfileController `/api/nutrition/profile`**
+
+| 路径 | 说明 |
+|------|------|
+| `POST /api/nutrition/profile/get` | 营养画像查询 |
+| `POST /api/nutrition/profile/save` | 营养画像保存 |
+
+#### 4.62.6 数据导出合规(`UserController /api/user` + `ReportMemberPermissionController /api/health/report/member-permission`,SC-S-11 `supplier.export.compliance`)
+
+**UserController `/api/user`(用户侧自助,个保法数据可携带权)**
+
+| 路径 | 说明 |
+|------|------|
+| `POST /api/user/data-export` | 导出用户数据(`AccountCleanupService.exportUserData`) |
+| `POST /api/user/deactivate` | 注销账号(数据匿名化,`AccountCleanupService.deactivateAccount`) |
+
+**ReportMemberPermissionController `/api/health/report/member-permission`(授权使用约束)**
+
+| 路径 | 说明 |
+|------|------|
+| `POST /api/health/report/member-permission/list` | 报告授权列表 |
+| `POST /api/health/report/member-permission/members/{memberId}` | 指定成员的授权详情 |
+| `POST /api/health/report/member-permission/grant` | 授予报告查看权 |
+| `POST /api/health/report/member-permission/revoke` | 撤销报告查看权 |
+| `POST /api/health/report/member-permission/visible-members` | 可见成员列表 |
+
+> 边界:EVD-11 SC-A-19 的**运营工单处理**(账号注销/数据导出工单)无端点载体,属平台运营域需产品侧确认;本 SC 为用户侧自助能力。
+
+*文档更新:2026-11-07(EVD-12R2 商品服务商域 6 SC 契约核对增补「商品服务商域」段落 4.62:服务商入驻 / 库存管理 / 活动报名 / 对账结算 / 营养食谱数据供给 / 数据导出合规 + 边界归位说明。完整核验表见 `docs/superpowers/specs/2026-11-07-service-provider-contract.md`)*

+ 115 - 0
docs/superpowers/specs/2026-11-07-service-provider-contract.md

@@ -0,0 +1,115 @@
+# 商品服务商域批次 · 契约核对结论(6 SC · 防假 RED)
+
+> 归属:契约补建计划 P0「商品服务商域」· 核对时间 2026-11-07(EVD-12R2,重派)
+> 开工包:`docs/tdd/orchestration/service-provider-kickoff-20261107.md`(origin/cfclub @ 069628810)
+> 核对对象:origin/cfclub `cfc-backend` controller 源码(独立 worktree `feature/evd12r2-svc-contract`,HEAD = origin/cfclub)
+> 核对方法:类级 `@RequestMapping` + 方法级 `@PostMapping` 逐一比对(`grep -rn '@RequestMapping|@PostMapping' cfc-backend/src/main/java/com/etotem/cfc/controller/` 实测定位,**不假定包路径**),逐端点记录存在性;对字面路径缺失/废弃者定位活跃等价载体(防假 RED:契约声明的接口范围必须能在真实源码中找到实现,禁止仅凭开工包候选下结论)
+> 批次范围:SC-S-01 入驻申请 / SC-S-05 库存管理 / SC-S-07 营销活动报名 / SC-S-08 对账结算 / SC-S-10 营养食谱数据供给 / SC-S-11 数据导出合规。SC-S-02/03/04/06(商品/订单/核销/售后)由 EVD-4 商城-会员覆盖;SC-S-09(报告解析接入)由 EVD-7R 报告闭环覆盖。
+
+## 0. 结论摘要
+
+- **6 个 SC 全部存在可用 HTTP 端点载体(端点齐全,无缺口)**,其中 SC-S-01 存在**载体置换**(开工包候选类 `AdminSupplierController`/`EcomSupplierController` 已标注废弃,活跃载体为 `SupplySystemController /api/admin/supply-system`),SC-S-11 的 ⚠「授权语义待核实」已实测回填为 ✅。
+- **端点核对范围内无「假 RED」**:凡开工包候选端点,逐一在真实源码中定位;凡候选类废弃/缺失者,定位活跃等价载体并回填,不虚报存在。
+- 未新增 DB 迁移、未改动业务代码与测试文件、未动 `.tdd/`(本批仅新增本核对文档 + API_REFERENCE 增补段落 4.62)。
+- 与 EVD-11 平台运营域(SC-A-06 供应体系管理 / SC-A-19 账号注销与数据导出工单)**边界已按 SC 语义归位**,避免键重复(见 §3)。
+
+---
+
+## 1. 端点存在性核对(按 SC 清单,6 个)
+
+> 列:SC → 开工包候选载体 → 实测源码端点(`@RequestMapping` 类级 + `@PostMapping` 方法级)→ 结论。
+
+### 1.1 SC-S-01 入驻申请
+
+| 开工包候选 | 实测端点 | 结论 |
+|---|---|---|
+| `AdminSupplierController /api/admin/supplier/*`:list / save / update / delete(服务商档案 CRUD) | 实际类级前缀 `/api/admin/supplier`:`list`、`save`、`update`、`delete`。**均标注 `@Operation(summary="【已废弃】供应商列表,请使用 /api/admin/supply-system/list")`** | ⚠ **候选类已废弃**,活跃载体见下行 |
+| `EcomSupplierController /api/admin/ecom-supplier/*`:list / all / save / update / delete | 实际类级前缀 `/api/admin/ecom-supplier`:`list`、`all`、`save`、`update`、`delete`。**均标注 `@Operation(summary="【已废弃】供应商列表,请使用 /api/admin/supply-system/list")`** | ⚠ **候选类已废弃**,活跃载体见下行 |
+| (活跃载体实测定位) | **`SupplySystemController /api/admin/supply-system`**:`list`、`create`、`update`、`detail`、`toggle-status`、`list-all`、`my-system`、`my-teams`、`member/list`、`member/add`、`member/remove`、`member/change-role`(13 端点);体系层级治理另由 `SupplyManageController /api/admin/supply-manage`:`list`、`detail`、`create`、`update`、`delete`、`add-role`、`remove-role`、`adjust-tier`(EVD-11 SC-A-06 已覆盖,非本批重复登记) | ✅ **端点齐全(载体置换)**:入驻申请/服务商体系治理由 `supply-system` 承载(`create` 建档、`toggle-status` 启停审核、`my-system`/`my-teams` 一人多团队) |
+
+> **结论 ✅**:SC-S-01 能力可满足。注意:无独立「入驻申请单」端点,入驻/启停由 `supply-system create + toggle-status` 承载;如产品要求独立入驻申请审批流(独立申请单 + 审核记录),需产品侧确认,不在本批实现。
+
+### 1.2 SC-S-05 库存管理
+
+| 开工包候选 | 实测端点 | 结论 |
+|---|---|---|
+| `AdminInventoryController /api/admin/inventory/*`:inbound/create · inbound/confirm · inbound/cancel · transactions/list · counting/create · counting/confirm · alert/list · product/stock · combo/items | 实际类级前缀 `/api/admin/inventory`:`inbound/create`、`inbound/list`、`inbound/detail`、`inbound/confirm`、`inbound/cancel`、`transactions/list`、`counting/create`、`counting/confirm`、`counting/list`、`alert/list`、`product/stock`、`combo/items`、`combo/items/list`、`outbound/create`、`outbound/list`(15 端点,开工包子集全数命中 + 额外含入库列表/详情、出库、盘点列表、组合列表) | ✅ 端点齐全 |
+| `SupplierProductController /api/admin/supplier/product/*`:list / create / update / detail / delete / shelve | 实际类级前缀 `/api/admin/supplier/product`:`list`、`create`、`update`、`detail`、`delete`、`shelve`(6 端点全命中) | ✅ 端点齐全 |
+
+> **结论 ✅**:SC-S-05 能力可满足(入库/出库/盘点/库存告警/组合商品 + 服务商商品 CRUD/上下架)。
+
+### 1.3 SC-S-07 营销活动报名
+
+| 开工包候选 | 实测端点 | 结论 |
+|---|---|---|
+| `ActivityController /api/activity/*`:list / detail / register / cancel-registration / my-registrations / registration-roster | 实际类级前缀 `/api/activity`:`list`、`detail`、`create`、`update`、`publish`、`end`、`submit-review`、`register`、`cancel-registration`、`my-registrations`、`registration-roster`、`checkin`、`checkin-review`(13 端点,开工包子集全数命中) | ✅ 端点齐全 |
+| `AdminActivityController /api/admin/activity/*`:review / submit-review | 实际类级前缀 `/api/admin/activity`:`list`、`review`、`detail`、`submit-review`、`audit`、`backfill-tags`、`withdraw`、`re-draft`(8 端点,`review`/`submit-review` 命中) | ✅ 端点齐全 |
+| `ActivityOrderController /api/activity/order` | 实际类级前缀 `/api/activity/order`:`create`、`pay`、`handlePaymentSuccess`、`notify`、`status`(5 端点) | ✅ 端点齐全 |
+
+> **结论 ✅**:SC-S-07 能力可满足(活动报名/取消/我的报名/报名名单 + 管理端审核 + 报名订单支付)。
+
+### 1.4 SC-S-08 对账/结算
+
+| 开工包候选 | 实测端点 | 结论 |
+|---|---|---|
+| `AdminSettlementController /api/admin/dan-settlement/*`:list / detail/{settlementId} / confirm/{settlementId} / stats | 实际类级前缀 `/api/admin/dan-settlement`:`list`、`detail/{settlementId}`、`confirm/{settlementId}`、`stats`(4 端点全命中) | ✅ 端点齐全 |
+| `SupplySettlementController /api/admin/supply-settlement/*`:list / detail / detail-items / create / confirm | 实际类级前缀 `/api/admin/supply-settlement`:`list`、`detail`、`detail-items`、`create`、`confirm`(5 端点全命中) | ✅ 端点齐全 |
+
+> **结论 ✅**:SC-S-08 能力可满足(DAN 结算 + 供货结算双载体,含结算明细/创建/确认)。
+
+### 1.5 SC-S-10 营养/食谱数据供给
+
+| 开工包候选 | 实测端点 | 结论 |
+|---|---|---|
+| `NutritionProductController /api/nutrition/product/*`(营养品数据供给) | 实际类级前缀 `/api/nutrition/product`:`category/list`、`brand/list`、`search`、`detail`、`recommend`、`price-compare`、`from-product`(7 端点) | ✅ 端点齐全 |
+| `BeijingNutritionController /api/nutrition/beijing/*`(北京食谱数据) | 实际类级前缀 `/api/nutrition/beijing`:`bacteria/save`、`recommend`、`recommend/custom`、`kb/query`、`kb/list`、`kb/info`、`analysis`(7 端点) | ✅ 端点齐全 |
+| `UserNutritionProfileController /api/nutrition/profile`(营养画像对齐) | 实际类级前缀 `/api/nutrition/profile`:`get`、`save`(2 端点) | ✅ 端点齐全 |
+
+> **结论 ✅**:SC-S-10 能力可满足(营养品数据 + 北京食谱知识库 + 营养画像对齐)。
+
+### 1.6 SC-S-11 数据导出合规(授权使用)⚠ → 回填 ✅
+
+| 开工包候选 | 实测端点 | 结论 |
+|---|---|---|
+| `UserController POST /api/user/data-export`(个保法数据可携带权,`AccountCleanupService.exportUserData`) | 实际类级前缀 `/api/user`:`deactivate`、`data-export`;服务层 `AccountCleanupService.exportUserData(Long userId)` @147、`deactivateAccount(Long)` @52 均在 | ✅ **确认存在**(用户侧自助导出,数据匿名化注销) |
+| 授权使用约束:`ReportMemberPermissionController /api/health/report/member-permission/*` | 实际类级前缀 `/api/health/report/member-permission`:`list`、`members/{memberId}`、`grant`、`revoke`、`visible-members`(5 端点) | ✅ **确认存在**(报告查看授权/可见性治理) |
+
+> **结论 ✅**:SC-S-11 能力可满足。⚠「授权语义待核实」已回填:数据可携带权导出(`/api/user/data-export`)+ 报告授权可见性(`member-permission` grant/revoke/visible-members)双载体均存在。**边界提示**:与 EVD-11 SC-A-19(账号注销/数据导出**工单处理**)不同——本 SC 为用户侧自助能力(`/api/user/data-export`、`/api/user/deactivate`),SC-A-19 的**运营工单处理**无端点载体(属平台运营域,需产品侧确认,不重复登记)。
+
+---
+
+## 2. 建议能力键映射(按 O-2 方案 A,防键重复)
+
+| SC | 建议能力键 | 对应活跃载体 | 备注 |
+|----|-----------|--------------|------|
+| SC-S-01 | `supplier.apply` | `SupplySystemController /api/admin/supply-system`(list/create/update/detail/toggle-status/my-system/my-teams) | 载体置换,候选类已废弃 |
+| SC-S-05 | `supplier.inventory.manage` | `AdminInventoryController /api/admin/inventory` + `SupplierProductController /api/admin/supplier/product` | — |
+| SC-S-07 | `supplier.activity.signup` | `ActivityController /api/activity` + `AdminActivityController /api/admin/activity` + `ActivityOrderController /api/activity/order` | — |
+| SC-S-08 | `supplier.settlement.reconcile` | `AdminSettlementController /api/admin/dan-settlement` + `SupplySettlementController /api/admin/supply-settlement` | — |
+| SC-S-10 | `supplier.nutrition.supply` | `NutritionProductController /api/nutrition/product` + `BeijingNutritionController /api/nutrition/beijing` + `UserNutritionProfileController /api/nutrition/profile` | — |
+| SC-S-11 | `supplier.export.compliance` | `UserController /api/user/data-export` + `ReportMemberPermissionController /api/health/report/member-permission` | 授权可见性治理 |
+
+> 注:以上为**建议映射**,非最终契约键;定稿须逐条对齐 `docs/superpowers/api/API_REFERENCE.md` 与 `tests/test-cases/*.md` 派生用例,避免与既有键冲突(`admin.*` / `energy.*` / `dimension.*` 已存在)。本批为契约核对,不建实现任务、不动 `.tdd/`。
+
+---
+
+## 3. 实现缺口 / 边界归位说明
+
+- **无 SC 级端点缺口**:6 个 SC 均存在可用 HTTP 载体(含 1 处载体置换、1 处 ⚠ 回填为 ✅),无需登记「实现缺口」任务。
+- **载体置换(SC-S-01)**:`AdminSupplierController`/`EcomSupplierController` 均标注「【已废弃】… 请使用 /api/admin/supply-system/list」,活跃载体为 `SupplySystemController`。契约声明以 `supply-system` 为准,不再引用废弃路径。
+- **边界归位**:
+  - 供应体系**层级/团队**治理(`SupplyManageController`、`supply-system my-teams/member/*`)与 EVD-11 SC-A-06 存在交集;本批仅登记 `supply-system` 作为服务商自身业务载体,`supply-manage` 不重复登记(EVD-11 已覆盖)。
+  - 数据导出:本 SC(SC-S-11)为**用户侧自助**(`/api/user/data-export`);EVD-11 SC-A-19 的**运营工单处理**无端点载体,属平台运营域,需产品侧确认,不并入本批。
+- **待产品侧确认项(非本批实现)**:
+  1. SC-S-01 是否要求独立「入驻申请单 + 审核记录」端点(当前 `supply-system create + toggle-status` 承载,无独立申请单流)。
+  2. SC-S-11 是否要求运营侧导出工单处理端点(当前仅用户侧自助,运营工单无载体)。
+
+---
+
+## 4. 交付说明
+
+- 本批新增 2 文件(单文件精确提交):
+  - `docs/superpowers/specs/2026-11-07-service-provider-contract.md`(本核对结论)
+  - `docs/superpowers/api/API_REFERENCE.md`(增补「4.62 商品服务商域」段落)
+- 未改业务代码、未改测试文件、未新增 DB 迁移、未动 `.tdd/`。
+- 核对基准:`origin/cfclub @ 069628810`,worktree `feature/evd12r2-svc-contract`。