Jelajahi Sumber

docs: 合规核查报告 V1.0 (CR-003/019/020/021/022扫描结果)

liaoxg 1 Minggu lalu
induk
melakukan
cfc338bac3
1 mengubah file dengan 199 tambahan dan 0 penghapusan
  1. 199 0
      docs/合规核查报告.md

+ 199 - 0
docs/合规核查报告.md

@@ -0,0 +1,199 @@
+# 爱伴 · AI之旅 训练营小程序 合规核查报告
+
+> **版本**:V1.0 | **日期**:2026-09-08 | **状态**:评审稿
+>
+> **扫描范围**:train-frontend 27 页 + train-backend CaseController / AdminCaseController
+> **核查依据**:22 课纲汇总 §一 超红线清单 + 11 旧SRS §FR-01/§FR-09 + 06 引流闭环 §学员案例 IP
+> **关联 CR**:CR-003、CR-019、CR-020、CR-021、CR-022
+
+---
+
+## 1. 核查结论总览
+
+| CR | 内容 | 核查结论 | 处置 |
+|---|---|---|---|
+| CR-003 | 学员页面禁露销售·引流·钩子·L1凭券信息 | ⚠️ **6 处违规** | 需修复(A4) |
+| CR-019 | 案例 IP 三段流水线完整性 | ✅ **已完整** | 无需动作 |
+| CR-020 | 测评兴趣调研与转化发放规则 | ⚠️ **待核查发放逻辑** | 需确认(A3) |
+| CR-021 | 四线合规红线核查 | ✅ **文案基本合规** | 需法务确认 |
+| CR-022 | L0 半天营学员端禁露销售信息 | ⚠️ **与 CR-003 联动** | 随 CR-003 修复 |
+
+---
+
+## 2. CR-003 / CR-022 详细违规清单
+
+### 违规 1:mine 页暴露"分享中心"入口
+- **文件**:`train-frontend/pages/mine/index.vue`
+- **位置**:line 62-66
+- **违规内容**:
+  ```vue
+  <view class="menu-item" @click="goTo('/pages/share/index')">
+    <text class="menu-icon">🚀</text>
+    <text class="menu-text">分享中心</text>
+  ```
+- **违规类型**:引流入口(L0 半天营学员端可见)
+- **修复建议**:移除该入口,或改为讲师可见域
+
+### 违规 2:mine 页暴露"测评调研"入口
+- **文件**:`train-frontend/pages/mine/index.vue`
+- **位置**:line 67-71
+- **违规内容**:
+  ```vue
+  <view class="menu-item" @click="goTo('/pages/survey/index')">
+    <text class="menu-icon">📝</text>
+    <text class="menu-text">测评调研</text>
+  ```
+- **违规类型**:钩子入口("提交后有机会获得测评兑换卡")
+- **修复建议**:移除该入口,或改为讲师可见域
+
+### 违规 3:share 海报文案"邀请你一起加入 AI 成长营"
+- **文件**:`train-frontend/pages/share/index.vue`
+- **位置**:line 84
+- **违规内容**:`ctx.fillText('邀请你一起加入 AI 成长营', width / 2, 90)`
+- **违规类型**:引流文案
+- **修复建议**:改为中性文案(如"我的专属邀请码")
+
+### 违规 4:share 海报文案"报名时填写邀请码,一起享受专属权益"
+- **文件**:`train-frontend/pages/share/index.vue`
+- **位置**:line 97
+- **违规内容**:`ctx.fillText('报名时填写邀请码,一起享受专属权益', width / 2, 320)`
+- **违规类型**:钩子文案("专属权益")
+- **修复建议**:改为中性文案(如"扫码加入训练营")
+
+### 违规 5:share/stats 页"如何获得奖励"四步引导
+- **文件**:`train-frontend/pages/share/stats.vue`
+- **位置**:line 20-26
+- **违规内容**:
+  ```
+  1. 在我的海报页复制专属邀请码
+  2. 把海报/邀请码分享给朋友
+  3. 朋友报名时填写邀请码并完成付费
+  4. 你将自动获得一张私教激励卡券
+  ```
+- **违规类型**:完整转介绍奖励机制(钩子)+ L1凭券信息("私教激励卡券")
+- **修复建议**:移除"私教激励卡券"表述,改为"训练营积分"或中性表述
+
+### 违规 6:survey 页 couponTypeLabel 显示"L1课程券"
+- **文件**:`train-frontend/pages/survey/index.vue`
+- **位置**:line 78
+- **违规内容**:`var map = { etotem: '测评兑换卡', L1: 'L1课程券' }`
+- **违规类型**:L1凭券信息(仅讲师可见)
+- **修复建议**:移除"L1课程券"标签,或改为"训练营课程券"
+
+---
+
+## 3. CR-019 案例三段流水线核查
+
+### 流水线状态机
+```
+pending(待授权) → authorized(已授权) / rejected(已拒绝) → published(已发布)
+```
+
+### 三段节点实现情况
+
+| 节点 | 接口 | 文件 | 状态 |
+|---|---|---|---|
+| 采集 | `POST /api/admin/case/create` | `AdminCaseController.java` line 49-75 | ✅ 已实现 |
+| 授权 | `POST /api/case/decide` | `CaseController.java` line 62-83 | ✅ 已实现 |
+| 发布 | `POST /api/admin/case/publish` | `AdminCaseController.java` line 117-136 | ✅ 已实现 |
+
+### 采集节点详情
+- 管理员选择学员(uid)+ 班次(classId)+ 标题 + 内容
+- 可关联成果ID(sourceSubmissionId)
+- 状态置为 pending
+- **脱敏**:由管理员在采集时手动脱敏(title/summary 字段)
+
+### 授权节点详情
+- 学员查看自己的待授权案例(`/api/case/mine`)
+- 同意 → status=authorized,记录 consentAt
+- 拒绝 → status=rejected
+- 已发布案例不可再变更授权
+
+### 发布节点详情
+- 仅已授权案例可发布
+- 发布后 status=published
+- **回流**:发布后案例进入对外展示渠道(具体渠道待确认)
+
+### 核查结论
+✅ **CR-019 三段流水线已完整实现**,无需补缺。
+
+### 待确认事项
+- 脱敏规则是否文档化(建议在 AdminCaseController.create 注释中补充脱敏字段映射)
+- 回流渠道是否明确(建议在 AdminCaseController.publish 后增加回流渠道记录)
+
+---
+
+## 4. CR-020 测评兴趣调研与转化发放规则
+
+### 当前实现
+- `pages/survey/index.vue` 提交调研 → `submitSurvey({ interest, classId })`
+- 提交后展示"我的卡券"列表(`getMyCoupons`)
+- 卡券类型:`etotem`(测评兑换卡)、`L1`(L1课程券)
+
+### 待核查事项
+- 5 个触发来源(vote/finish/research/champion/teaching)的券发放逻辑
+- 需检查 `PlanController` 或相关 Controller 的券发放实现
+- 需确认与 cfc 侧 `CouponController` 的发放规则对齐
+
+### 建议核查路径
+1. 阅读 `train-backend/src/main/java/com/train/controller/PlanController.java`
+2. 阅读 `train-backend/src/main/java/com/train/controller/CouponController.java`(如存在)
+3. 阅读 cfc 侧 `E:\cfc\cfc-backend\src\main\java\com\cfc\controller\CouponController.java`
+4. 对比 5 个触发来源的发放规则
+
+---
+
+## 5. CR-021 四线合规红线核查
+
+### 红线 1:财富(事业)不荐个股/不预测/不给买卖建议/不承诺收益
+- **扫描结果**:未发现违规文案
+- **核查页面**:mine、share、survey、course、enroll、case、plan、pay、material、assignment、group、checkin、teaching、upload、scoreboard、vote、group-order、class
+- **结论**:✅ 合规
+
+### 红线 2:健康只识别评估不诊断
+- **扫描结果**:未发现违规文案
+- **核查页面**:同上
+- **结论**:✅ 合规
+
+### 红线 3:成长只评估不承诺升学结果
+- **扫描结果**:未发现违规文案
+- **核查页面**:同上
+- **结论**:✅ 合规
+
+### 红线 4:创客分佣返现过法务前「只送券不返现」
+- **扫描结果**:`share/stats.vue` 的"私教激励卡券"是券而非返现,符合规则
+- **核查页面**:share、share/stats
+- **结论**:✅ 合规(但"私教激励卡券"表述涉及 L1凭券信息,见 CR-003 违规 5)
+
+### 待法务确认事项
+- 海报文案"专属权益"是否构成"承诺收益"
+- "私教激励卡券"是否构成"返现"或"L1凭券信息"
+- 建议法务最终确认
+
+---
+
+## 6. 修复优先级
+
+| 优先级 | 违规项 | 修复工作量 |
+|---|---|---|
+| P0 | 违规 1(mine 分享中心入口) | 1 行删除 |
+| P0 | 违规 2(mine 测评调研入口) | 1 行删除 |
+| P1 | 违规 3(share 海报引流文案) | 1 行修改 |
+| P1 | 违规 4(share 海报钩子文案) | 1 行修改 |
+| P1 | 违规 5(share/stats 奖励机制+L1凭券) | 4 行修改 |
+| P1 | 违规 6(survey L1课程券标签) | 1 行修改 |
+
+**总计**:6 处违规,9 行代码修改,1 个 commit。
+
+---
+
+## 7. 下一步
+
+1. **A2**:CR-019 已确认完整,跳过补缺动作
+2. **A3**:核查 PlanController / CouponController 的券发放逻辑
+3. **A4**:按优先级修复 6 处违规(CR-003/022)
+4. **法务确认**:将本报告提交法务最终确认
+
+---
+
+*爱伴 · AI之旅 训练营小程序 合规核查报告 V1.0 · 2026-09-08*