能力键: admin.content.security
任务号: S-cfc-322(TDD 实现使绿,SC-A-13 内容安全审核 ⭐ / SC-A-18 内容安全审核队列 ⭐)
状态: TDD-GREEN(实现已存在,测试已通过)
状态机流转: YELLOW -> GREEN(通过本验证提交)
AdminContentSecurityContractTest(15 cases,测试侧 S-cfc-208 a18b731c3 登记、已合入 cfclub)在 origin/cfclub HEAD(b9d80dd6d)上已全绿 15/15,无需任何 src/main 改动。origin/cfclub 已完整落地):
AdminArticleController /api/admin/articles 审核端点家族全部存在且为 @PostMapping:
/audit(audit)、/submit-review(submitReview)、/withdraw(withdraw)、
/re-draft(reDraft)、/upload/image(uploadImage,微信 checkImage 检测)、
/upload/video(uploadVideo)、/comments/list(commentList)、/list(list)。create 敏感词命中拦截:标题命中 -> Result.error("文章标题包含敏感信息,发布失败");
正文命中 -> Result.error("文章内容包含敏感信息,发布失败");均不触达 articleService.create。checkTextSafe fail-open:null/全空白直接放行,不触达微信检测(单测未注入 wechatService 也不 NPE)。ArticleService 审计状态机:
submitForReview:draft -> status=pending + auditStatus=pending + updateById;
非 draft 抛 仅草稿状态可提交审核 且不写库。withdraw:published -> withdrawn(下架);非 published 抛 仅发布中的文章可撤回 且不写库。reDraft:rejected/withdrawn -> draft 且清空 auditStatus/auditReason/auditorId/auditedAt;
其他状态抛 仅已驳回或已撤回的文章可重新编辑 且不写库。auditArticle:approved -> published / rejected -> rejected+原因(SC-A-13 闭环)。ReviewCenterController /api/admin/review-center/summary(SC-A-18 审核队列):
articlePending / productPending / guidePending / vendorPending / butlerPending / packagePending /
activityPending / activityRegistrationPending / withdrawPending / refundPending /
hierarchyChangePending / nutritionistPending / knowledgePending 13 类待审聚合键齐全;
空队列时全部键存在且为 0。ContentFilterController /api/content/by-tags:无标签无问题域 -> code 200,
resultTags/articles/knowledgeBases/foods 四组全空,不触达 DB。/api/admin/ 整族登录门(B-142-1 已修)+ audit 角色守卫——由
AdminArticleAuditContractTest(12/12 绿)锁定,本键不重复覆盖。AdminArticleAuditContractTest 12/12 绿,
合计 27/27 全绿,BUILD SUCCESS。该能力键的实现已存在于 origin/cfclub,无需代码修改即可使红单测全绿(与 S-cfc-309 实现验证报告、
S-cfc-208 测试侧首验结论一致:契约端点与行为在登记 RED 任务时即已全部落地,测试以「契约绿锁定」
形式作为回归基线)。本提交仅登记闭环验证产物,标记任务已完成。
无。实现现状与契约断言全部吻合;本键属编排侧在测试登记(S-cfc-208 实现在先)后重复派发的 GREEN 任务,建议编排侧直接登记收尾,不再重复派发。
.worktrees/task_S-cfc-322)基准: origin/cfclub @ b9d80dd6d(HEAD)
复核命令(cfc-backend 单模块,未触碰测试 / 未改实现):
mvn -Dtest="AdminContentSecurityContractTest,AdminArticleAuditContractTest" test
实测结果(surefire 报告):
[INFO] Tests run: 15, Failures: 0, Errors: 0, Skipped: 0 - in com.etotem.cfc.unit.AdminContentSecurityContractTest
[INFO] Tests run: 12, Failures: 0, Errors: 0, Skipped: 0 - in com.etotem.cfc.controller.admin.AdminArticleAuditContractTest
[INFO] BUILD SUCCESS
复核结论: 红单测实跑为全绿(失败数 0 -> 通过数 15/15),实现(审核端点家族 + 敏感词拦截 +
审计状态机 + review-center 13 类队列聚合 + content by-tags 空标签边界 + fail-open 策略)已完整落地于
origin/cfclub,本键无需 src/main 改动即可闭环。
改动文件:
docs/tdd/impl-2026-11-14-S-cfc-322-admin-content-security.md(本报告,docs-only,无代码变更)暴露的缺陷: 无。