DRAMA 融合短剧平台 — 生产化优化计划报告

Dev 容器 + Gitea 新建项目 · 逐步优化至生产可运行 · v1.0
生成日期:2026-08-06目标主机:172.16.0.67(Dev 容器 + Gitea 服务器)依据:Drama项目分析文档 8 份 + 二期规划 5 份 + 环境实测

一、报告目的与范围

1.1 目标

在 Dev 容器与 Gitea 服务器(172.16.0.67)上新建正式项目仓库,以现有 drama-fusion-platform(一期 DEMO)源码为 V0 基线,分阶段逐步优化,使其达到生产可运行状态——底层健壮、稳定、安全、可观测、可运维。

本报告为计划阶段交付物:明确项目定位、环境基线、问题清单、阶段路线图、验收标准与里程碑。批准后按阶段执行。

1.2 范围

涵盖:基础设施(Gitea 仓库 / Dev 容器 / CI / Docker)、代码质量(架构债务清理)、安全加固(密钥 / 验签 / 认证)、资金一致性(锁 / 幂等 / 事务)、可观测性(日志 / 指标 / 追踪)、测试体系、部署与运维、性能容量。

不包含:业务功能新增需求(超出生产化范畴的迭代另行立项);二期 Go 重构全量实施(本报告保留其作为长期演进路线)。

1.3 核心决策:Java 渐进优化为主,Go 重构为长期演进

现状 Java 代码已覆盖 290+ 接口、60+ 表、8 大业务域;二期规划提出 Go + Gin 重构(8 服务拆分)。

本报告选择渐进式优化主线:先修复现有系统的 P0/P1 风险使其可生产运行(见效快、风险低),同时保持 drama-go-refactor 仓库并行演进,成熟后按域灰度替换。

决策依据:全量重写周期长(预估 3~6 个月)、业务行为对齐成本高;而生产化改造可在数周内完成止血并上线,符合“逐步优化”的诉求。

二、环境现状基线(2026-08-06 实测)

2.1 服务器 172.16.0.67

系统:Ubuntu 24.04.4 LTS(hostname: ubuntu-VMware20-1);SSH: root@172.16.0.67

Docker 容器运行状态:

2.2 Gitea 仓库现状

Gitea 1.27.1(容器 gitea,Up 14h),Web: http://172.16.0.67:3000/

组织/用户:banxia.ltd、chenchuhui、dev_codewhale、pl、zzb

banxia.ltd 已有仓库:drama-app.git、drama-gateway.git、drama-go-refactor.git、shortdrama-backend.git

CI:原生 act_runner(systemd 服务 gitea-runner.service),已注册可用

2.3 Dev 容器

dev-codewhale-app(Up 4d)— 应用开发容器

dev-codewhale-go(Up 4d)— Go 重构开发容器

shortdrama-mysql(healthy)/ shortdrama-redis / shortdrama-mongo 均在运行

2.4 本地源码基线

路径:/root/drama-fusion-platform(11 个 Maven 模块,master 分支,仅 2 次提交,无 git remote)

存在未提交修改(drama-ad-service/pom.xml);需先梳理后作为 V0 基线推入 Gitea

三、项目新建方案(Gitea + Dev 容器)

3.1 仓库规划

新建主仓库:banxia.ltd/drama-fusion-platform.git(mono-repo:后端 11 模块 + 前端 5 端面 + docker/ + docs/)

导入策略:本地源码清理(.gitignore、大文件、凭据)→ 初始化基线提交(V0.0.1)→ 推送到 Gitea

已有 drama-app / drama-gateway 等历史仓库仅归档,不再维护,避免分仓混乱

drama-go-refactor 保持独立演进(二期)

3.2 分支策略(Git Flow)

main(生产就绪,仅从 release/hotfix 合并) / develop(日常集成) / feature/* / release/* / hotfix/*

提交规范:Conventional Commits(feat/fix/refactor/test/chore/docs)

3.3 仓库初始化产物(阶段 0 交付)

CLAUDE.md(AI 协作宪法:技术栈约束 / 编码规范 / 错误处理 / 测试要求)

BOUNDARIES.md(系统边界:服务职责 / 外部集成 / 数据所有权)

devcontainer.json(标准 Dev 容器定义,一键复现环境)

CONTRIBUTING.md + .editorconfig + .gitmessage

.gitlab-ci.yml(空流水线骨架:lint → test → build → docker)

docker-compose.yml(本地全栈一键启动)

.gitignore / README.md / CHANGELOG.md

3.4 Dev 容器使用约定

开发在 dev-codewhale-app 容器内进行(标准镜像 + JDK17 + Maven + Node20 + Docker CLI)

容器挂载仓库工作区,容器外不直接改代码;CI 由 Gitea act_runner 承担

四、现状问题清单(分级基线)

4.1 P0 — 安全与资金(必须最先修复)

S1 密钥/凭据硬编码在 application.yml(RSA 私钥、微信 Secret、OpenIM Secret、MySQL root 空密码、Redis 无认证)

S2 支付回调签名验证为 placeholder(verifySignature 恒 true,可伪造回调篡改订单/发币)

S3 JWT 7 天无刷新、无黑名单/吊销(账号封禁后 token 仍有效)

C1 金币/钱包无分布式锁(多实例并发超扣,实测推演余额可被覆盖)

C2 异步操作全部 new Thread() 裸线程(无事务上下文 / 无重试 / 无优雅关闭)

4.2 P0 — 代码健壮性

ContentController 8+ 处 JDBC 直连(绕过连接池,连接泄漏风险)

UserController/ContentController 6+ 处裸线程

登录事务内包含远程 RPC(Spree 供应商同步 spreeClient.createVendor——Spree/EDD 已废弃,该逻辑应移除,改为 Lilishop 通道或直接去除,失败不回滚)

4.3 P1 — 稳定性与运维

测试覆盖 <5%(仅 3 个测试文件);无 CI 流水线;无 Dockerfile

RocketMQ 已部署但零使用(异步可靠性缺口)

热点数据无缓存(短剧/用户/订单每次直查 MySQL);Redis 无 TTL + keys * 全量扫描

无可观测性:Actuator 未配置、无 Prometheus/日志集中/链路追踪/告警

无健康检查 / 熔断 / 限流(外部依赖 RestTemplate 直连无超时兜底)

部署靠 expect+scp+kill 脚本(含硬编码密码);无回滚机制

4.4 P2 — 体验与治理

CORS 全源允许;服务间内网明文 HTTP;WebSocket 弹幕通道无认证

微信 OAuth 降级条件过宽松(网络异常即 mock openid);固定 AES IV

上传组件 3 端 URL 不统一、预览尺寸 5 种;product-sync Bootstrap 后台需下线迁移

审计日志仅覆盖内容审核,缺管理员/资金/配置变更审计

五、分阶段优化路线图

阶段 0 · 基础设施就绪(第 1 周)

任务:Gitea 建仓并推入 V0 基线;创建 CLAUDE.md / BOUNDARIES.md / devcontainer.json;配置分支策略与 Gitea 保护分支;搭建空 CI 流水线;编写基础 Dockerfile(gateway + 1 个业务服务示范)

验收:develop 分支 push 触发流水线通过;容器内 mvn clean package 成功;仓库含全部初始化产物

阶段 1 · 安全与资金止血(第 1~3 周)

任务:密钥迁移(环境变量/Nacos 加密存储);支付回调接入正式验签(微信/支付宝 SDK);JWT 缩短有效期(2h)+ Refresh Token + Redis 黑名单 + 登出吊销;金币/钱包接入 Redis 分布式锁(Redisson)+ 日硬顶;裸线程替换为 @Async 线程池(逐步);输入校验与 XSS 过滤(弹幕/评论/昵称)

验收:安全扫描无硬编码密钥;伪造回调被拒(对抗测试);并发扣减压测余额一致;JWT 吊销即时生效

阶段 2 · 代码健壮性改造(第 3~5 周)

任务:JDBC 直连全部替换为 MyBatis/JdbcTemplate;事务边界修正(事务内禁止 RPC,异步化 + 补偿);异常处理规范化(BizException + GlobalExceptionHandler 全覆盖,禁止吞异常);日志脱敏(手机号/Token);RocketMQ 接入异步通道(IM 注册/DeepSeek 排队;Spree 同步代码移除)

验收:Code Review 检查项全过(无 JDBC 直连、无裸线程、事务边界正确、幂等覆盖)

阶段 3 · 可观测性建设(第 5~7 周)

任务:Actuator 暴露 health/metrics/prometheus;Micrometer + Prometheus + Grafana(JVM + 业务指标);Logback JSON + TraceId,Filebeat → ELK;Micrometer Tracing(Zipkin);告警规则(5xx 率/延迟/队列积压);健康检查 liveness/readiness

验收:全服务 /actuator/health 可用;Grafana 面板可见核心指标;测试告警触发成功

阶段 4 · 性能与容量(第 7~9 周)

任务:热点数据缓存(Spring Cache + Caffeine + Redis 两级);缓存穿透/击穿/雪崩防护(空值/互斥/随机 TTL);Redis Key TTL 策略 + SCAN 替代 keys *;数据库索引审计 + 连接池参数;慢查询治理

验收:压测目标——首页接口 P95 < 300ms,缓存命中率 > 90%,无慢 SQL 告警

阶段 5 · 测试与 CI/CD 完善(第 9~11 周)

任务:测试补齐(金币并发/支付幂等/风控评分/审核状态机/回调防重放 ≥ 20 用例,覆盖率 ≥ 50%);E2E 核心旅程(Playwright);契约测试(Spring Cloud Contract);流水线门禁(lint+test+security+build 全绿才可合并);OWASP dependency-check + SpotBugs + secretlint

验收:Jacoco 覆盖率 ≥ 50%;流水线全绿;P0 场景 100% 覆盖

阶段 6 · 部署与运维(第 11~13 周)

任务:全服务 Dockerfile(多阶段构建)+ docker-compose 完整编排;审计日志补齐(管理员/资金/配置 8 场景);备份恢复脚本(MySQL/Redis 定时 + 演练);K8s 清单或 Compose 生产化(蓝绿/金丝雀可选);发布/回滚手册(回滚 < 5min)

验收:一键部署成功;备份恢复演练通过;故障演练(杀服务)自动拉起

长期 · 二期 Go 重构(并行观察)

按二期规划(8 服务拆分 / Redlock / 回调 nonce / 审核结算全链路)在 drama-go-refactor 演进;生产稳定后按域灰度替换 Java 服务;本阶段不阻塞主线

六、生产化验收标准(“可生产运行”定义)

6.1 稳定性

核心链路(登录/播放/金币/支付)可用性 ≥ 99.9%;无 P0/P1 已知缺陷残留

外部依赖(OpenIM / DeepSeek / Lilishop / 微信)具备超时 + 熔断 + 降级路径,单点故障不影响主流程

6.2 健壮性

资金操作 100% 幂等 + 分布式锁保护;异步任务有队列 + 重试 + 死信;事务边界无 RPC

所有接口有输入校验;日志无敏感信息;异常不吞不裸抛

6.3 安全

无硬编码密钥(Nacos 加密/环境变量/Secrets);支付验签正式接入;JWT 可吊销

CORS 生产限定域名;服务间 HTTPS/mTLS(至少内网隔离);设备指纹签名

6.4 可观测与运维

三支柱齐备:日志集中可检索、指标面板可用、链路追踪可定位慢调用

CI/CD 自动化:合并即构建、tag 即发布;回滚 < 5min;备份可恢复(已演练)

6.5 容量

支撑目标 DAU 5 万:首页缓存 10min、进度缓存 30min、热点接口 P95 < 300ms

七、工作量与里程碑汇总

7.1 阶段汇总

阶段 0(1 周):基础设施就绪 —— 里程碑 M0:仓库 + CI + 容器就绪

阶段 1(2 周):安全止血 —— 里程碑 M1:无高危漏洞,资金安全加固完成

阶段 2(2 周):健壮性 —— 里程碑 M2:架构债务清零,异步队列化

阶段 3(2 周):可观测 —— 里程碑 M3:监控告警可运维

阶段 4(2 周):性能 —— 里程碑 M4:压测达标

阶段 5(2 周):测试 CI —— 里程碑 M5:质量门禁全绿

阶段 6(2 周):部署运维 —— 里程碑 M6:生产可运行(上线就绪)

合计:13 周(约 3 个月);团队 2~3 人,总投入约 26~40 人天

7.2 关键里程碑

M0 第 1 周末:Gitea 仓库可见、Dev 容器可构建、CI 空流水线跑通

M3 第 7 周末:故障可在 5 分钟内定位(日志/指标/追踪联动)

M6 第 13 周末:一键部署 + 回滚演练 + 备份演练通过,正式宣布“生产可运行”

八、风险与依赖

8.1 主要风险

R1 范围蔓延:生产化与二期 Go 重构并行,需严格按阶段门禁推进,禁止中途换方向(缓解:里程碑评审)

R2 外部依赖不可控:Lilishop(172.16.0.90)/OpenIM(172.16.0.66)/DeepSeek/微信凭据与沙箱环境需提前确认可用(缓解:阶段 0 即做连通性清单)

R3 支付验签接入受阻:需要商户号/密钥权限(缓解:尽早向业务方申请)

R4 数据迁移与兼容:60+ 表结构与旧系统(柠檬剧场)耦合,历史 Spree/EDD 数据仅保留兼容读取,不再新引入(缓解:Flyway 版本化 + 迁移演练)

8.2 外部依赖清单(阶段 0 需确认)

OpenIM 172.16.0.66:10002/10001(API/WS);Lilishop 172.16.0.90:8080;DeepSeek API;微信开放平台;阿里云 OSS;GROMORE 广告(⚠️ Spree/EDD 172.16.0.62 已废弃,禁止再次引入)

九、下一步行动(批准后立即执行)

9.1 第一阶段动作

① 在 Gitea 创建 banxia.ltd/drama-fusion-platform 仓库(私有),配置保护分支与 act_runner 标签

② 本地源码清理(凭据剔除 / .gitignore / 大文件),打 V0.0.1 基线提交并推送

③ 编写 CLAUDE.md + BOUNDARIES.md + devcontainer.json + 空 CI 流水线,验证容器构建

④ 输出《外部依赖连通性清单》,逐项确认可用性

9.2 审批点

本报告经确认后,按阶段 0 → 阶段 6 推进;每个阶段结束输出验收报告,由项目方确认后再进入下一阶段