# DRAMA 融合短剧平台 — 优化后剩余可推进工作分析报告

- **版本**: v1.0
- **生成日期**: 2026-08-06
- **分析对象**: `/root/drama-fusion-platform`（develop 分支，65 次提交，HEAD=`01f3180`）
- **分析依据**: git 历史（#7~#28 共 22 个 PR）+ 源码级扫描 + 运行日志 + 既有 8 份分析文档（optimization-proposal / production-hardening-plan / implementation-plan-p1p2 / micro_service_analysis 等）
- **结论先行**: 生产化计划 6 阶段已完成约 **70%**（阶段 1 安全资金止血、阶段 2 健壮性、阶段 3 可观测性、阶段 B/C/D 服务拆分均已落地）；剩余工作集中在 **测试体系、CI/CD 全流水线、容器化与部署自动化、链路追踪、审计日志、若干安全残留** 六类，预计 4~6 周可完成。

---

## 一、已完成优化（已验证落地）

### 1.1 安全与资金止血（阶段 1 已完成）

| 项 | 验证证据 |
|----|---------|
| JWT 安全加固（RS256 + Refresh Token + 黑名单 + 登出吊销） | `JwtUtil.generateRefreshToken/validateRefreshToken`、`UserController.refresh`、`jwt:blacklist:` Redis 键（PR #7） |
| 密钥环境变量化（10 服务） | `application.yml` 中 `WECHAT_APP_SECRET:${...}`、`OPENIM_SECRET:${...}`、`LEGACY_RSA_PRIVATE_KEY:${...}` 占位（PR #10） |
| 支付回调验签（fail-closed + HMAC-SHA256 + 防重放） | `PaymentService.verifySignature`：渠道配置缺失/签名缺失/时间戳 ±5min 全部拒绝（PR #10 后重写，已非 placeholder） |
| 提现加固（Redis 分布式锁 + 日限额 20 元） | `WalletController` lock:wallet 锁 + `WithdrawConfig` 限额 |
| 金币/钱包并发保护 | `CoinService` lock:coin 分布式锁 + 签到每日幂等 Redis 标记（PR #20） |
| 清除硬编码密钥 | 微信 secret 改配置注入、openIM123 默认值清除（PR #12） |
| 日志脱敏 + 吞异常修复（5 处） | `SensitiveUtil`（手机号/Token 脱敏）（PR #15） |

### 1.2 代码健壮性（阶段 2 已完成）

| 项 | 验证证据 |
|----|---------|
| JDBC 直连 → JdbcTemplate（6 处） | PR #13（消除连接泄漏风险） |
| 微信登录事务边界修正 + 超时 | 微信 RPC 移出事务、connect 3s/read 5s（PR #14） |
| 裸线程 → @Async 统一线程池 | `AsyncConfig` ThreadPoolTaskExecutor + CallerRunsPolicy（无 `new Thread` 残留） |
| RocketMQ 异步通道 | `MqTopics/DramaMqProducer/DramaMqConsumer`，DeepSeek 排队 + IM 异步（PR #16） |
| Legacy 死代码删除（1553 行） | PR #27（LegacyController/Upload/User + 网关路由清理） |

### 1.3 可观测性（阶段 3 已完成）

| 项 | 验证证据 |
|----|---------|
| Prometheus 指标端点（10 服务） | `management.endpoints.web.exposure.include: health,info,prometheus,metrics` |
| JSON 结构化日志 + traceId | logback JSON 格式，`logs/*.log` 均为 JSON 行 |
| 告警规则 | `deploy/monitoring/alerts/drama-alerts.yml`（服务 DOWN / 5xx 率 / P95 延迟 / MQ 积压） |
| 性能优化（首页列表缓存 + 复合索引） | PR #19：压测 P95=71ms（<300ms 达标）、2646 req/s、缓存 0.98s→0.026s |

### 1.4 架构治理（阶段 B/C/D 已完成）

| 项 | 验证证据 |
|----|---------|
| 服务拆分：cms（#23）/ asset（#24）/ social（#25）/ audit（#26） | 各自独立模块 + 网关路由，编译通过 + 启动验证 |
| AdminController 抽离 | PR #21：UserController 41→24 接口，零行为变化 |
| Git Flow + Gitea + CI 编译门禁 | remote=`172.16.0.67:2222/banxia.ltd/drama-fusion-platform.git`，`.gitea/workflows/ci.yml` 编译门禁跑通 |
| 工程规范 | `BOUNDARIES.md` / `CLAUDE.md` / `devcontainer.json` / `.env.example` / knowledge-base（ADR × 5） |

---

## 二、剩余可推进工作（按优先级）

### P0 · 安全与资金残留（建议 1~2 周内完成）✅ 已交付（2026-08-06）

> **状态更新**: P0 全部 5 项已实施完成并通过全模块编译（BUILD SUCCESS），详见 [drama-p0-delivery-20260806.md](./drama-p0-delivery-20260806.md)。以下为交付前的问题描述存档。

#### P0-1 微信 OAuth 网络异常降级为 mock openid —— 高危
- **现状**: `UserController.java:203-205` 微信 OAuth API 不可达时 `mockOpenid = "wx_" + hashCode(code)` 直接登录。生产网络抖动会**伪造任意账号**。
- **目标**: fail-closed。异常时返回明确的 `WECHAT_OAUTH_UNAVAILABLE` 错误，禁止 mock；测试模式仅允许显式 `TEST_` code 前缀（已有分支可保留）。
- **验收**: 停掉微信接口后登录返回错误而非 mock 账号；测试模式仍可用。
- **工作量**: 0.5 人天。

#### P0-2 全局审计日志缺失（P2-2 未落地）
- **现状**: 仅 `ContentAuditLog`（内容审核），无 `t_audit_log` 表 / `AuditLogService`；implementation-plan-p1p2.html 规划的 8 个注入点（CP 审核/封禁/上下架/充值/提现审批/广告位/提现档位/支付费率）**全部未做**。
- **目标**: 按 plan 建 `t_audit_log` + `@Async` 记录服务，注入 8 场景。
- **验收**: 8 场景操作后 `t_audit_log` 有对应记录，不阻塞主流程。
- **工作量**: 2 人天。

#### P0-3 WebSocket 弹幕通道无认证 + 全源跨域
- **现状**: `WebSocketConfig` `setAllowedOriginPatterns("*")`，STOMP 端点 `/ws/bullet` 无鉴权，任何人可订阅/广播。
- **目标**: 握手阶段校验 JWT（ChannelInterceptor 或 `setHandshakeHandler`），生产 CORS 收窄到自有域名。
- **验收**: 无 token 握手被拒；伪造 Origin 被拒。
- **工作量**: 1 人天。

#### P0-4 网关 CORS 全源允许
- **现状**: `application.yml` `globalcors.cors-configurations['/**'].allowed-origins: "*"`。
- **目标**: 白名单化（h5 域名 + 管理端域名），`allow-credentials` 按需。
- **验收**: 非白名单 Origin 被拒；白名单正常。
- **工作量**: 0.5 人天。

#### P0-5 密钥默认值兜底
- **现状**: `app-secret: ${WECHAT_APP_SECRET:CHANGE_ME}`、`${LEGACY_RSA_PRIVATE_KEY:}` 存在默认值兜底；若部署未注入环境变量，会以占位值启动，易被误用。
- **目标**: 生产 profile 移除默认值（空默认值 + 启动时校验必填），本地 profile 保留示例。
- **验收**: 未注入环境变量时启动失败并给出明确提示。
- **工作量**: 0.5 人天。

### P1 · 测试体系（建议 3~4 周）✅ 已交付（2026-08-06）

> **状态更新**: P1 共 10 项全部实施完成（33 个新测试用例全绿 + 全模块编译 BUILD SUCCESS），详见 [drama-p1-delivery-20260806.md](./drama-p1-delivery-20260806.md)。以下为交付前的问题描述存档。

#### P1-1 单元/集成测试补齐（当前最大短板）
- **现状**: 仅 3 个测试文件共 178 行（UserServiceTest 97 / ContentServiceTest 70 / **RiskServiceTest 11 行近空壳**）；无 JaCoCo 插件、无覆盖率门槛；CI 的 test 阶段被注释（`# TODO 阶段 5 启用`）。
- **目标**（对齐 implementation-plan-p1p2）:
  - 新增 ≥20 用例：CoinService 并发扣减/充值/签到幂等、PaymentService 重复回调幂等 + 验签失败、TradeService 下单/打赏/CP 收益、ContentController 三级审核状态机、RiskService 全评分组合、JwtUtil/RsaCryptoUtil 往返测试、Gateway JwtAuthFilter 白名单/吊销。
  - 接入 JaCoCo，行覆盖率 ≥ 50%（资金域 ≥ 80%）。
  - CI 启用 test 阶段（`mvn test jacoco:report`），覆盖率不达标即失败。
- **验收**: `mvn test` 全绿；JaCoCo 报告达标；CI 门禁启用。
- **工作量**: 4~6 人天。

#### P1-2 前端测试缺失
- **现状**: 5 个前端端面（h5/admin/admin-portal/seller/lemon）无 vitest/jest/cypress。
- **目标**: 先补 h5 关键旅程（登录→列表→播放→下单）的 Playwright E2E 冒烟。
- **验收**: CI 内 E2E 冒烟通过。
- **工作量**: 2~3 人天。

### P1 · CI/CD 与部署自动化 ✅ 已交付（2026-08-06）

#### P1-3 CI 流水线扩展（编译 → 全门禁）
- **现状**: `.gitea/workflows/ci.yml` 仅 `mvn compile`；test/security/docker 阶段全部注释。
- **目标**: 按 plan 扩展 stages：lint（checkstyle）→ test（jacoco）→ security（dependency-check/spotbugs）→ build → docker（仅 main tag）。
- **验收**: MR→develop 跑 lint+test；main tag 触发全流水线 + 镜像推送。
- **工作量**: 1~2 人天。

#### P1-4 服务容器化（Dockerfile 全缺失）
- **现状**: 仓库内 **0 个 Dockerfile**；仅 `docker/` 编排基础设施（MySQL/Redis/Nacos/RocketMQ）；部署靠 `*.exp`（expect+scp+kill，含硬编码密码）+ `start-all.sh`（mvn spring-boot:run 直跑）。
- **目标**: 多阶段构建 Dockerfile（14 个后端模块）或统一 base image + 构建参数；docker-compose 全栈一键起；`start-all.sh` 改为可配。
- **验收**: 任一服务 `docker build` + `docker compose up` 成功；部署脚本无硬编码密码。
- **工作量**: 3~4 人天。

#### P1-5 数据库迁移管理（Flyway 未接入）
- **现状**: `db/migration/V*.sql` 手动维护（15+ 个文件），**无 Flyway/Liquibase 依赖**，无版本校验与回放机制。
- **目标**: 接入 Flyway，历史 SQL 转为基线版本，CI 集成迁移校验。
- **验收**: 新环境 `mvn flyway:migrate` 幂等可复现；变更走版本化 SQL。
- **工作量**: 1~2 人天。

#### P1-6 部署与回滚机制
- **现状**: expect+scp+kill 脚本、无回滚、无健康检查门禁（虽然服务有 /actuator/health，但部署流程未用）。
- **目标**: 部署脚本增加「启动→健康检查→切流/回滚」三段式；保留 N 个历史 jar；失败自动回退。
- **验收**: 演练一次回滚成功。
- **工作量**: 2 人天。

### P1 · 可观测性补全 ✅ 已交付（2026-08-06）

#### P1-7 链路追踪缺失
- **现状**: 无 zipkin/micrometer-tracing 依赖（grep 全仓库无结果）；跨服务调用（gateway→user→deepseek 等）无法串联。
- **目标**: Micrometer Tracing + Zipkin，网关与服务间透传 traceId（JSON 日志已有 traceId，需打通跨服务）。
- **验收**: 一次用户请求在 Zipkin UI 可看到完整调用链。
- **工作量**: 1~2 人天。

#### P1-8 日志集中化（ELK 未落地）
- **现状**: JSON 日志落地本机文件，无 Filebeat→ES→Kibana 管道。
- **目标**: Filebeat 采集 logs/ 推 ES，Kibana 提供检索；或至少部署 Loki + Grafana。
- **验收**: 一条线上日志可在 Kibana/Loki 检索到。
- **工作量**: 2~3 人天。

#### P1-9 熔断/限流缺失
- **现状**: 无 resilience4j / RequestRateLimiter 依赖；外部依赖（OpenIM/Lilishop/DeepSeek）无熔断兜底，仅超时。
- **目标**: Gateway 加 RequestRateLimiter（Redis 限流）；服务间关键调用加 Resilience4j 重试/熔断。
- **验收**: 压测触发限流 429；外部依赖故障时快速失败不拖垮线程。
- **工作量**: 2~3 人天。

#### P1-10 网关 LoadBalancer 缓存警告
- **现状**: 启动日志 WARN：LoadBalancer 使用默认缓存，建议 Caffeine。
- **目标**: 引入 Caffeine 缓存。
- **工作量**: 0.5 人天。

### P2 · 架构与体验（可并行/长期）✅ 已交付（2026-08-06）

> **状态更新**: P2 共 6 项全部实施完成（product-sync 下线/分支清理/对抗测试/前端治理/Go 评估/推送接口取消），详见 [drama-p2-delivery-20260806.md](./drama-p2-delivery-20260806.md)。以下为交付前的问题描述存档。

| 项 | 说明 | 工作量 |
|----|------|--------|
| P2-1 product-sync（8089）下线迁移 | Thymeleaf 后台（BOUNDARIES 标注"待下线迁移"）仍占用 8089，需迁移至 cms/admin 后下线 | 3~5 人天 |
| P2-2 二期 Go 重构 | `drama-go-refactor` 并行演进，成熟后按域灰度替换（保留为长期路线） | 长期 |
| P2-3 未合并分支清理 | 本地 14 个已合并 feature/fix 分支未删除；`origin/feature/async-threadpool` 未合入（需确认是否废弃） | 0.5 人天 |
| P2-4 前端治理 | 3 端 URL 不统一、上传预览尺寸 5 种（既有报告） | 2~3 人天 |
| P2-5 选品中台推送接口 | README ⬜ 项：内容审核、上下架回调 | 按业务排期 |
| P2-6 风控/资金对抗测试 | 模拟伪造回调、并发充值、Root/Hook 设备注册验证（五维方案建议 4） | 2 人天 |

---

## 三、建议推进路线图

```
第 1~2 周（P0 收尾）     P0-1 微信 fail-closed → P0-2 审计日志 → P0-3 WebSocket 认证
                         → P0-4 CORS 白名单 → P0-5 密钥兜底校验
第 3~5 周（P1 质量）     P1-1 测试补齐 + JaCoCo → P1-2 前端 E2E → P1-7 链路追踪
第 5~7 周（P1 交付）     P1-3 CI 扩展 → P1-4 Dockerfile → P1-5 Flyway → P1-6 部署回滚
                         → P1-8 日志集中 → P1-9 熔断限流 → P1-10 Caffeine
第 7~10 周（P2 演进）    P2-1 product-sync 下线 → P2-3 分支清理 → P2-4/5/6 按需
```

- **关键里程碑**:
  - M1（第 2 周末）：微信登录 fail-closed、审计日志 8 场景上线、WebSocket 鉴权完成。
  - M2（第 5 周末）：测试 ≥20 用例、覆盖率 ≥50%、CI 全门禁通过。
  - M3（第 7 周末）：全服务 Dockerfile + Flyway + 部署回滚演练通过，达成"生产可运行"。
- **人力估算**: 合计约 **28~40 人天**（2 人并行约 4~6 周）。

---

## 四、风险与依赖

- **R1 外部凭据权限**: 支付验签已实现但需生产商户密钥验证；微信 OAuth 需确认 fail-closed 不影响真实用户（灰度放量）。
- **R2 测试基建**: 当前 Maven 无测试基座（无 spring-boot-starter-test 隔离配置、无 H2/Testcontainers），补齐前先搭测试骨架。
- **R3 日志/追踪平台**: ELK 与 Zipkin 需在 172.16.0.67 上新增容器，确认资源配额。
- **R4 分支卫生**: `origin/feature/async-threadpool` 未合入 develop，若已废弃应显式关闭，避免未来误合并。
- **R5 范围蔓延**: 二期 Go 重构与生产化并行，严格按里程碑门禁推进，禁止中途换向。

---

## 五、附：关键缺口速查（扫描证据）

| 检查项 | 结果 |
|--------|------|
| Dockerfile 数量 | 0 |
| Flyway/Liquibase 依赖 | 无 |
| 测试文件数 | 3（共 178 行） |
| JaCoCo/SpotBugs/OWASP 插件 | 无 |
| CI 阶段 | 仅 compile（test/security/docker 注释） |
| 链路追踪（zipkin/tracing） | 无 |
| 熔断/限流（resilience4j/ratelimiter） | 无 |
| 全局审计日志（t_audit_log） | 无 |
| WebSocket 鉴权 | 无 |
| CORS 白名单 | 否（`*`） |
| 微信 OAuth fail-closed | 否（mock 降级） |
| JWT Refresh + 黑名单 | ✅ 已落地 |
| 支付回调验签 | ✅ HMAC-SHA256 + 防重放 |
| 分布式锁（金币/钱包） | ✅ lock:coin / lock:wallet |
| 密钥环境变量化 | ✅ ${...} 占位 |
| Prometheus + 告警规则 | ✅ 已落地 |

---

*报告基于 2026-08-06 代码库（develop @ 01f3180）实测生成；后续每完成一个里程碑建议更新本报告并归档至 Drama项目分析文档/。*
