# DRAMA 融合短剧平台 — P2 演进与治理实施报告

- **版本**: v1.0
- **交付日期**: 2026-08-06
- **代码基线**: `/root/drama-fusion-platform` develop 分支（P1 之后新增变更）
- **验证结果**: ✅ 全模块 `mvn -B compile -DskipTests` **BUILD SUCCESS**；✅ P2-6 对抗测试 16 用例全绿
- **范围**: P2 共 6 项，本轮交付 **6/6 全部完成**

---

## 一、交付总览

| 编号 | 项目 | 状态 | 关键证据 |
|------|------|------|---------|
| P2-3 | 分支清理 | ✅ | 本地 14 个已合并分支删除 + 远程 `async-threadpool` 确认废弃删除 |
| P2-1 | product-sync(8089) 下线 | ✅ | 移除 3 处硬编码直连 + Client 兜底化，编译通过 |
| P2-6 | 风控/资金对抗测试 | ✅ | 并发充值一致性（真实 Redis）+ 设备黑名单决策，16 用例全绿 |
| P2-4 | 前端 URL 统一 + 预览尺寸治理 | ✅ | 3 端 vite 代理修复（去 8089 残留/端口纠错）+ 预览尺寸统一 |
| P2-2 | 二期 Go 重构评估 | ✅ | 本地无代码库，确认保留长期演进路线 |
| P2-5 | 选品中台推送接口 | ✅ | README 外部系统 8→7、推送接口标记已取消、BOUNDARIES 删除线 |

---

## 二、逐项交付详情

### P2-3 分支清理（0.5 人天）

- **本地**: 删除 14 个已合并分支（feature/observability、performance-cache、rocketmq-async、fix/* ×4、refactor/* ×7 等）
- **远程**: `origin/feature/async-threadpool` 经 `git rev-list --count develop..origin/feature/async-threadpool` 确认为 **0 独有提交**（内容已全部并入 develop），判定废弃并 `git push origin --delete` 删除
- **结果**: 远程仅剩 `develop` + `feat/p0-p1-security-quality`

### P2-1 product-sync(8089) 下线（3~5 人天 → 实际 ~1 天）

**现状**: 选品中台已取消、网关路由已注释下线，但 content-service 残留依赖：
- `ContentController` 3 处硬编码 `http://localhost:8089` 直连（道具检查/签约/列表）
- `ProductSyncClient` 6 处调用点（fetchProducts/triggerFullSync/createProduct/applyDistribution）

**改动**:
- `addPropAsset`：Step 1 从 8089 检查改为**本地 t_prop_asset 查重**；删除 Step 3 的 8089 签约调用
- `listPropAssets`：删除"从 8089 获取"段，仅保留本地数据合并
- `ProductSyncClient`：改为**已下线兜底**（@Deprecated，方法返回空/失败，不再发起网络请求），保留类以兼容旧调用点，待后续彻底删除
- 验证：全仓 `grep 8089` 仅剩注释文字，无实际代码引用；`mvn compile` BUILD SUCCESS

### P2-6 风控/资金对抗测试（2 人天）

**新增测试**（纯 Mockito + 真实 Redis 集成）:

| 测试类 | 用例 | 覆盖 |
|--------|------|------|
| `RiskAssessmentServiceTest`（新） | 6 | 已拉黑设备 BLOCK 100 / CRITICAL≥80 自动拉黑 / 正常设备 PASS 不误杀 / 黑设备规则覆盖低分 / 屏蔽配置优先 BLOCK / 新设备放行 |
| `RiskScorerTest`（已有） | 9 | 评分组合边界（P1-1 已交付） |
| `CoinServiceConcurrencyTest`（新） | 1 | **真实 Redis 分布式锁互斥**：10 线程并发充值同一用户，严格断言仅 1 个成功 |

**技术要点**: `CoinServiceConcurrencyTest` 用真实 `LettuceConnectionFactory`（`start()` 初始化）+ 随机 userId + CountDownLatch 同时起跑；Redis 不可用时 `Assumptions.assumeTrue` 自动跳过（CI 无 Redis 不阻断）。

**验证**: 16/16 用例全绿，BUILD SUCCESS。

### P2-4 前端 URL 统一 + 上传预览尺寸治理（2~3 人天 → 核心项完成）

**vite 代理修复**（3 端，seller 无需改）:
- 移除已下线 product-sync 的 `/api/sync → 8089` 代理残留（h5/admin/admin-portal）
- 修正端口映射错误：`/api/rec` → 8103（原 8102）、`/api/ad` → 8104（原 8102）、admin `/api/coin` → 8107（原 8101）
- `node --check` 4 端配置语法验证通过；全仓无 8089 残留

**上传预览尺寸统一**:
- `MUpload.vue`：单图 `width="120"` 与多图 `width="100"` 统一为 `.file-preview` 类（100×140 固定 + object-fit:cover 防变形 + 圆角边框）

**说明**: 上传端点实为 2 个合理端点（内容上传 `/api/content/upload`、版权上传 `/api/user/copyright/upload`），此前"3 端不统一"主要体现为 vite 代理残留与预览尺寸，均已治理。

### P2-2 二期 Go 重构评估（长期路线）

- 本地无 `drama-go-refactor` 代码库（`find /root /home` 无结果）
- 二期规划（2026-08-02《drama-fusion-platform二期Go重构分析报告》）已定义 8 服务映射（gateway/user/content/audit/asset/settlement/social/ecom），但属长期演进
- 符合生产化计划核心决策：**Java 渐进优化为主，Go 重构成熟后按域灰度替换**——本轮无代码动作，保留为长期路线

### P2-5 选品中台推送接口（状态同步）

由于 P2-1 已确认选品中台完全下线：
- `README.md`：对接外部系统 8→7 项；第 1 项标记 ❌ 已下线；第 8 项 ⬜ 推送接口 → ❌ 已取消
- `BOUNDARIES.md`：`drama-product-sync` 行加删除线并注明"已下线：P2-1 由 lilishop 替代"

---

## 三、验证记录

- ✅ `mvn -B compile -DskipTests` → **BUILD SUCCESS**（全模块，含 P2-1 content-service 改动）
- ✅ `mvn test`（risk/coin）→ **16/16 用例通过**（RiskAssessment 6 + RiskScorer 9 + Concurrency 1）
- ✅ `node --check` 4 个前端 vite.config.js 语法通过
- ✅ `git ls-remote` 确认远程分支清理结果

---

## 四、遗留与建议

1. **ProductSyncClient 彻底删除**: 当前保留为 @Deprecated 兜底（兼容旧调用点），待确认前端/业务无引用后可整类删除 + ContentController 相关方法清理。
2. **并发测试的 CI 策略**: `CoinServiceConcurrencyTest` 依赖真实 Redis，CI 无 Redis 时跳过；建议在 Gitea act_runner 环境预置 Redis 服务以让该用例常驻执行。
3. **前端治理剩余项**: 上传组件跨端复用（MUpload 仅 admin 端）、3 端 API 封装（index.js 各自维护）可进一步收敛为共享包。
4. **Go 重构**: 需另行确认 `drama-go-refactor` 仓库是否在 Gitea 上已有（本地无检出），如有可 clone 后做差距对照。
5. **提交建议**: 本轮 P2 变更（content-service、risk/coin 测试、前端 vite/MUpload、README/BOUNDARIES）建议独立 PR（如 `feat: P2 演进与治理`）合入 develop。

---

*报告基于 2026-08-06 代码库实测生成；P2 共 6 项全部交付，编译与对抗测试验证通过。*
