meal_manager/jeesharp-business/business-content-security

business-content-security（UGC 内容安全）

跨模块 内容安全检测 能力：业务侧仅依赖 ContentSecurityApi，底层通过 Provider SPI 对接微信（可扩展阿里云等），满足小程序审核对 UGC 文本/图片检测的要求。

---

模块结构

business-content-security/
├── business-content-security-api/          # ContentSecurityApi、Provider SPI、事件
├── business-content-security-bean/         # Entity、VO、Convert
├── business-content-security-service/      # Log/Task 持久化
├── business-content-security-application/  # 编排、WeChat Provider、ApiImpl
├── business-content-security-controller/   # 管理端流水查询
└── src/main/resources/sql/
    ├── content_security.sql                # 建表
    └── content_security_menu_permission.sql # 菜单权限（可选）

---

已接入业务

业务模块	入口	文本	图片	异步回调
统一评价 REVIEW	ReviewApplicationService.submit	✅	✅	违规 → 评价 已拒绝
意见反馈 FEEDBACK	FeedbackApplicationService.submitFeedback	✅	✅	违规 → 反馈 已关闭

---

配置（application.yaml）

jeesharp:
  content-security:
    enabled: true                    # 总开关
    default-provider: WECHAT_MINI
    on-missing-openid: REVIEW          # 无 openid 时：REVIEW / REJECT
    on-provider-error: REVIEW          # Provider 异常时
    media-async-enabled: true          # 图片走 mediaCheckAsync
    media-async-fallback-sync: true    # 异步失败降级同步 img_sec_check

---

微信运维

1. 执行建表：src/main/resources/sql/content_security.sql

2. 小程序消息推送 URL（服务器配置）：

   https://{域名}/mobile/noAuth/contentSecurity/wechat/mediaCallback
   

   路径已在 /mobile/noAuth/** 白名单，无需额外 yaml。

3. 依赖：会员须绑定微信小程序 openid（MemberOauthService），否则按 on-missing-openid 降级。

---

管理端

• 接口：POST /admin/manager/business/contentSecurity/log/v1/list
• 权限：manager:business:contentSecurity:log:list
• 前端（开发路由）：/business/contentSecurity/log（asyncRouter.ts）
• 生产菜单：执行 content_security_menu_permission.sql（按环境调整父菜单 ID）

---

业务接入方式（新模块）

1. pom 依赖 business-content-security-api（禁止依赖 application）
2. 注入 ContentSecurityApi，UGC 写入口优先使用 ContentSecurityUgcCheckSupport.checkTextAndImages + bindAfterPersist
3. 监听 ContentSecurityMediaCompletedEvent 处理异步 REJECT（可选）

---

版本记录

日期	说明
2026-06-27	初版：微信文本/图片、异步任务、评价/反馈接入、管理端流水