# 平台运营批次 · 开工包(25 SC) > 归属:契约补建计划 P0「平台运营(Web 管理端 / 运营治理)」· 生成 2026-11-07 08:38 > 数据源:sc-key-map.md(origin/cfclub,O-8 归一后 241 全量登记)· 端点初步核对:cfc-backend controller 源码 > 前置:O-7 裁决(主理人 2026-11-06 23:59 最终确认)契约补建工作流正式生效——契约核对 = 文档核对 + 端点比对(防假 RED),产出后转测试侧补证据,渐进而非全量。 ## 批次定位 平台运营 = Web 管理端(`cfc-web`)与运营治理能力,主要载体为 `controller/admin/**` 系列 + 少量 `controller/**` 管理端点。本批 25 SC(SC-A-01~22、A-25~27)台账「对应能力键」列全为 `—`。**按 O-7:契约核对非实现型任务,产出契约文档后转测试侧。** ## SC 清单与候选端点(初核,会话须逐条实测回填) | SC | 场景标题 | 候选端点载体 | 初核 | |----|----------|--------------|------| | SC-A-01 | 管理端登录 + 全局统计 | `AdminAuthController` `/api/admin/auth/*`;`StatsController` `/api/stats/*` | ✅ | | SC-A-02 | 报告解析中台(类型/聚类) | `AdminReportParseController` `/api/admin/report-parse/*` | ✅ | | SC-A-03 | 文章发布-审核 | `AdminArticleController` `/api/admin/articles/*` | ✅ | | SC-A-04 | 关系类型 CRUD | `AdminRelationshipTypeController` `/api/admin/relationship-types/*` | ✅ | | SC-A-05 | 勋章配置 CRUD | 勋章/成就 admin 端点(须实测定位) | ⚠ 待核实 | | SC-A-06 | 供应商管理 | `AdminSupplyManageController` `/api/admin/supply-manage/*`;`/api/admin/supply-hierarchy/*` | ✅ | | SC-A-07 | 活动配置 | 活动 admin 端点;`/api/admin/activity-checkins` | ✅ | | SC-A-08 | 知识库管理 | `AdminKnowledgeController`(维度知识库) | ⚠ 待核实 | | SC-A-09 | 维度配置与知识库管理 | `DimensionAdminController` `/api/admin/dimension/*`;`DimensionRegistryController` `/api/dimension-registry/*` | ✅ | | SC-A-10 | 数据迁移 / 参数校验 | 迁移类端点 + `DatabaseInitializer`(非 HTTP,须判载体) | ⚠ 待核实 | | SC-A-11 | 用户/家庭查询治理 | `AdminFamilyOverviewController`;`/api/admin/org/member/*` | ✅ | | SC-A-12 | 订单/退款人工处理 | `AdminProductOrderController` `/api/admin/product/order/*` | ✅ | | SC-A-13 | 内容安全审核 | `AdminReviewCenterController` `/api/admin/review-center/*` | ✅ | | SC-A-14 | 系统监控/告警 | 监控端点(须实测;可能无 HTTP 载体 → 记缺口) | ⚠ 待核实 | | SC-A-15 | 操作审计日志 | 审计端点(须实测) | ⚠ 待核实 | | SC-A-16 | 报告解析自学习/未知类型标注 | `AdminReportParseController`(标注/学习链) | ✅ | | SC-A-17 | 优惠券/活动配置管理 | `AdminCouponController` `/api/admin/coupon/*` | ✅ | | SC-A-18 | 内容安全审核队列 | `AdminReviewCenterController`(队列) | ✅ | | SC-A-19 | 账号注销/数据导出工单处理 | 工单端点(须实测;可能缺 → 记缺口) | ⚠ 待核实 | | SC-A-20 | 限流/熔断配置 | 配置类端点(须实测) | ⚠ 待核实 | | SC-A-21 | 舌诊/情绪模型管理 | `AdminInnatePortraitConfigController`;舌诊模型 admin | ⚠ 待核实 | | SC-A-22 | 精准营养知识库管理 | 营养知识库 admin 端点 | ⚠ 待核实 | | SC-A-25 | 维度/权重/每日上限配置 CRUD 与生效 | `DimensionWeightController` `/api/admin/dimension-weight/*`;`AdminEnergyConfigController` `/api/admin/energy-config/*` | ✅ | | SC-A-26 | 能量来源比例与归因权重治理 | `AdminEnergyConfigController` `/source-*`;`AdminEnergyRuleController` `/api/admin/energy-rule/*` | ✅ | | SC-A-27 | 后台维护睡眠选项并同步小程序端 | `sleep.config.tags`(YELLOW,实现已在 origin/cfclub) | ✅ | ## 建议能力键(契约定稿后按 O-2 方案 A 映射) `admin.auth.login`(已存在,勿重复建)/ `admin.reportParse.manage` / `admin.article.review` / `admin.relationshipType.crud` / `admin.medal.config` / `admin.supplier.manage` / `admin.activity.config` / `admin.knowledge.manage` / `admin.dimension.config` / `admin.data.migrate` / `admin.userGovernance` / `admin.order.manual` / `admin.content.audit` / `admin.monitor.alarm` / `admin.auditLog.view` / `admin.parse.label` / `admin.coupon.config` / `admin.ticket.handle` / `admin.ratelimit.config` / `admin.mind.model` / `admin.nutrition.kb` / `energy.viewConfig`(与 EVD-5 批同键,勿重复)/ `sleep.config.tags`(已存在) > 注意:`admin.auth.login` 与 `sleep.config.tags` **已存在于状态机**,本批只登记 SC↔键映射,不新建任务;其余键定稿前须与 API_REFERENCE 对齐防冲突。 ## 待办 1. 契约核对会话(本批 lan-248)产出 `API_REFERENCE.md` 增补「平台运营能力」段落 + `docs/superpowers/specs/2026-11-07-admin-ops-contract.md` + 端点核验表回填(⚠ 项逐个实测结论;无 HTTP 载体的记「无端点载体,需产品侧确认验收方式」)。单文件精确提交 push `origin/cfclub`。 2. 产出后研发负责人登记 TR-13 转测试侧:补契约 JUnit(admin 端点 MockMvc)+ 权限流(非 admin token → 403)为重点。 3. 证据入库 + 干净提交后按 `sc-key-map.md` 逐 SC 登记。