cfc/docs/tdd/orchestration/admin-ops-kickoff-20261107.md

平台运营批次 · 开工包（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 登记。