在 Dev 容器与 Gitea 服务器(172.16.0.67)上新建正式项目仓库,以现有 drama-fusion-platform(一期 DEMO)源码为 V0 基线,分阶段逐步优化,使其达到生产可运行状态——底层健壮、稳定、安全、可观测、可运维。
本报告为计划阶段交付物:明确项目定位、环境基线、问题清单、阶段路线图、验收标准与里程碑。批准后按阶段执行。
涵盖:基础设施(Gitea 仓库 / Dev 容器 / CI / Docker)、代码质量(架构债务清理)、安全加固(密钥 / 验签 / 认证)、资金一致性(锁 / 幂等 / 事务)、可观测性(日志 / 指标 / 追踪)、测试体系、部署与运维、性能容量。
不包含:业务功能新增需求(超出生产化范畴的迭代另行立项);二期 Go 重构全量实施(本报告保留其作为长期演进路线)。
现状 Java 代码已覆盖 290+ 接口、60+ 表、8 大业务域;二期规划提出 Go + Gin 重构(8 服务拆分)。
本报告选择渐进式优化主线:先修复现有系统的 P0/P1 风险使其可生产运行(见效快、风险低),同时保持 drama-go-refactor 仓库并行演进,成熟后按域灰度替换。
决策依据:全量重写周期长(预估 3~6 个月)、业务行为对齐成本高;而生产化改造可在数周内完成止血并上线,符合“逐步优化”的诉求。
系统:Ubuntu 24.04.4 LTS(hostname: ubuntu-VMware20-1);SSH: root@172.16.0.67
Docker 容器运行状态:
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),已注册可用
dev-codewhale-app(Up 4d)— 应用开发容器
dev-codewhale-go(Up 4d)— Go 重构开发容器
shortdrama-mysql(healthy)/ shortdrama-redis / shortdrama-mongo 均在运行
路径:/root/drama-fusion-platform(11 个 Maven 模块,master 分支,仅 2 次提交,无 git remote)
存在未提交修改(drama-ad-service/pom.xml);需先梳理后作为 V0 基线推入 Gitea
新建主仓库:banxia.ltd/drama-fusion-platform.git(mono-repo:后端 11 模块 + 前端 5 端面 + docker/ + docs/)
导入策略:本地源码清理(.gitignore、大文件、凭据)→ 初始化基线提交(V0.0.1)→ 推送到 Gitea
已有 drama-app / drama-gateway 等历史仓库仅归档,不再维护,避免分仓混乱
drama-go-refactor 保持独立演进(二期)
main(生产就绪,仅从 release/hotfix 合并) / develop(日常集成) / feature/* / release/* / hotfix/*
提交规范:Conventional Commits(feat/fix/refactor/test/chore/docs)
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
开发在 dev-codewhale-app 容器内进行(标准镜像 + JDK17 + Maven + Node20 + Docker CLI)
容器挂载仓库工作区,容器外不直接改代码;CI 由 Gitea act_runner 承担
S1 密钥/凭据硬编码在 application.yml(RSA 私钥、微信 Secret、OpenIM Secret、MySQL root 空密码、Redis 无认证)
S2 支付回调签名验证为 placeholder(verifySignature 恒 true,可伪造回调篡改订单/发币)
S3 JWT 7 天无刷新、无黑名单/吊销(账号封禁后 token 仍有效)
C1 金币/钱包无分布式锁(多实例并发超扣,实测推演余额可被覆盖)
C2 异步操作全部 new Thread() 裸线程(无事务上下文 / 无重试 / 无优雅关闭)
ContentController 8+ 处 JDBC 直连(绕过连接池,连接泄漏风险)
UserController/ContentController 6+ 处裸线程
登录事务内包含远程 RPC(Spree 供应商同步 spreeClient.createVendor——Spree/EDD 已废弃,该逻辑应移除,改为 Lilishop 通道或直接去除,失败不回滚)
测试覆盖 <5%(仅 3 个测试文件);无 CI 流水线;无 Dockerfile
RocketMQ 已部署但零使用(异步可靠性缺口)
热点数据无缓存(短剧/用户/订单每次直查 MySQL);Redis 无 TTL + keys * 全量扫描
无可观测性:Actuator 未配置、无 Prometheus/日志集中/链路追踪/告警
无健康检查 / 熔断 / 限流(外部依赖 RestTemplate 直连无超时兜底)
部署靠 expect+scp+kill 脚本(含硬编码密码);无回滚机制
CORS 全源允许;服务间内网明文 HTTP;WebSocket 弹幕通道无认证
微信 OAuth 降级条件过宽松(网络异常即 mock openid);固定 AES IV
上传组件 3 端 URL 不统一、预览尺寸 5 种;product-sync Bootstrap 后台需下线迁移
审计日志仅覆盖内容审核,缺管理员/资金/配置变更审计
任务:Gitea 建仓并推入 V0 基线;创建 CLAUDE.md / BOUNDARIES.md / devcontainer.json;配置分支策略与 Gitea 保护分支;搭建空 CI 流水线;编写基础 Dockerfile(gateway + 1 个业务服务示范)
验收:develop 分支 push 触发流水线通过;容器内 mvn clean package 成功;仓库含全部初始化产物
任务:密钥迁移(环境变量/Nacos 加密存储);支付回调接入正式验签(微信/支付宝 SDK);JWT 缩短有效期(2h)+ Refresh Token + Redis 黑名单 + 登出吊销;金币/钱包接入 Redis 分布式锁(Redisson)+ 日硬顶;裸线程替换为 @Async 线程池(逐步);输入校验与 XSS 过滤(弹幕/评论/昵称)
验收:安全扫描无硬编码密钥;伪造回调被拒(对抗测试);并发扣减压测余额一致;JWT 吊销即时生效
任务:JDBC 直连全部替换为 MyBatis/JdbcTemplate;事务边界修正(事务内禁止 RPC,异步化 + 补偿);异常处理规范化(BizException + GlobalExceptionHandler 全覆盖,禁止吞异常);日志脱敏(手机号/Token);RocketMQ 接入异步通道(IM 注册/DeepSeek 排队;Spree 同步代码移除)
验收:Code Review 检查项全过(无 JDBC 直连、无裸线程、事务边界正确、幂等覆盖)
任务:Actuator 暴露 health/metrics/prometheus;Micrometer + Prometheus + Grafana(JVM + 业务指标);Logback JSON + TraceId,Filebeat → ELK;Micrometer Tracing(Zipkin);告警规则(5xx 率/延迟/队列积压);健康检查 liveness/readiness
验收:全服务 /actuator/health 可用;Grafana 面板可见核心指标;测试告警触发成功
任务:热点数据缓存(Spring Cache + Caffeine + Redis 两级);缓存穿透/击穿/雪崩防护(空值/互斥/随机 TTL);Redis Key TTL 策略 + SCAN 替代 keys *;数据库索引审计 + 连接池参数;慢查询治理
验收:压测目标——首页接口 P95 < 300ms,缓存命中率 > 90%,无慢 SQL 告警
任务:测试补齐(金币并发/支付幂等/风控评分/审核状态机/回调防重放 ≥ 20 用例,覆盖率 ≥ 50%);E2E 核心旅程(Playwright);契约测试(Spring Cloud Contract);流水线门禁(lint+test+security+build 全绿才可合并);OWASP dependency-check + SpotBugs + secretlint
验收:Jacoco 覆盖率 ≥ 50%;流水线全绿;P0 场景 100% 覆盖
任务:全服务 Dockerfile(多阶段构建)+ docker-compose 完整编排;审计日志补齐(管理员/资金/配置 8 场景);备份恢复脚本(MySQL/Redis 定时 + 演练);K8s 清单或 Compose 生产化(蓝绿/金丝雀可选);发布/回滚手册(回滚 < 5min)
验收:一键部署成功;备份恢复演练通过;故障演练(杀服务)自动拉起
按二期规划(8 服务拆分 / Redlock / 回调 nonce / 审核结算全链路)在 drama-go-refactor 演进;生产稳定后按域灰度替换 Java 服务;本阶段不阻塞主线
核心链路(登录/播放/金币/支付)可用性 ≥ 99.9%;无 P0/P1 已知缺陷残留
外部依赖(OpenIM / DeepSeek / Lilishop / 微信)具备超时 + 熔断 + 降级路径,单点故障不影响主流程
资金操作 100% 幂等 + 分布式锁保护;异步任务有队列 + 重试 + 死信;事务边界无 RPC
所有接口有输入校验;日志无敏感信息;异常不吞不裸抛
无硬编码密钥(Nacos 加密/环境变量/Secrets);支付验签正式接入;JWT 可吊销
CORS 生产限定域名;服务间 HTTPS/mTLS(至少内网隔离);设备指纹签名
三支柱齐备:日志集中可检索、指标面板可用、链路追踪可定位慢调用
CI/CD 自动化:合并即构建、tag 即发布;回滚 < 5min;备份可恢复(已演练)
支撑目标 DAU 5 万:首页缓存 10min、进度缓存 30min、热点接口 P95 < 300ms
阶段 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 人天
M0 第 1 周末:Gitea 仓库可见、Dev 容器可构建、CI 空流水线跑通
M3 第 7 周末:故障可在 5 分钟内定位(日志/指标/追踪联动)
M6 第 13 周末:一键部署 + 回滚演练 + 备份演练通过,正式宣布“生产可运行”
R1 范围蔓延:生产化与二期 Go 重构并行,需严格按阶段门禁推进,禁止中途换方向(缓解:里程碑评审)
R2 外部依赖不可控:Lilishop(172.16.0.90)/OpenIM(172.16.0.66)/DeepSeek/微信凭据与沙箱环境需提前确认可用(缓解:阶段 0 即做连通性清单)
R3 支付验签接入受阻:需要商户号/密钥权限(缓解:尽早向业务方申请)
R4 数据迁移与兼容:60+ 表结构与旧系统(柠檬剧场)耦合,历史 Spree/EDD 数据仅保留兼容读取,不再新引入(缓解:Flyway 版本化 + 迁移演练)
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 已废弃,禁止再次引入)
① 在 Gitea 创建 banxia.ltd/drama-fusion-platform 仓库(私有),配置保护分支与 act_runner 标签
② 本地源码清理(凭据剔除 / .gitignore / 大文件),打 V0.0.1 基线提交并推送
③ 编写 CLAUDE.md + BOUNDARIES.md + devcontainer.json + 空 CI 流水线,验证容器构建
④ 输出《外部依赖连通性清单》,逐项确认可用性
本报告经确认后,按阶段 0 → 阶段 6 推进;每个阶段结束输出验收报告,由项目方确认后再进入下一阶段