drama-fusion-platform 二期 Go 重构分析报告

DEMO 现状盘点 · 与二期规划差距分析 · Go + Gin 重构映射与实施建议
📅 生成日期:2026-08-02 📁 代码路径:/root/drama-fusion-platform 📋 依据:二期规划 3 份 HTML(边界固化 / 核心架构 / AI 边界)

目录

  1. 一、项目现状盘点(DEMO 定位)
  2. 二、与二期规划的目标差距
  3. 三、Java → Go 服务映射方案
  4. 四、重构关键难点与对策
  5. 五、边界清单(BOUNDARIES.md)对齐检查
  6. 六、分阶段迁移路线图
  7. 七、风险与总结

01 项目现状盘点(DEMO 定位)

1.1 技术栈与规模

维度现状
后端框架Spring Boot 3.2.5 + Java 17 + MyBatis-Plus 3.5.5 + Spring Cloud 2023.0.1
服务治理Spring Cloud Gateway + Nacos(19 个 yml 引用,实际各服务 discovery.enabled=false)
模块数量11 个 Maven 模块(common / gateway + 9 个业务服务)
代码规模约 150+ Java 文件、290+ 接口端点、60+ 数据库表(@TableName 可见)
前端Vue3 + Vite(h5 / admin / admin-portal / seller)+ UniApp(uniapp / uniapp-app)+ lemon
数据库MySQL 8(本地 drama_fusion)+ Redis 7(7 个 yml)
宣称但未落地RocketMQ(README 声称,配置 0 处)、Elasticsearch(无配置)

1.2 服务分解与代码分布

服务Java 文件行数接口数定位
drama-user-service907,198150用户/钱包/评论/社交/购物车/AI 对话(职责过载)
drama-content-service282,39256短剧/分集/弹幕/审核/上传
drama-risk-service351,57629风控规则/黑名单/IP
drama-common91,151-公共库(JWT/客户端:Lilishop/Spree/EDD)
drama-rec-service44939推荐 Feed
drama-trade-service94708订单/分佣
drama-payment-service84059支付
drama-coin-service83297金币账户/流水
drama-ai-service84447AI 弹幕/OpenIM Webhook/WebSocket
drama-ad-service1664415广告位/广告日志
drama-gateway268-Spring Cloud Gateway 路由

1.3 三大集成现状(与二期目标对比)

集成现状实现完整度
OpenIMOpenImClient(403 行:注册/发消息/加好友/建群/群消息/图片/语音);ai-service 有 ImWebhookController 接收回调基础能力已通
LilishopLilishopClient(统一 REST 客户端,JWT 认证,172.16.0.90:8080);CartController / TradeController / CommissionService基础对接已通
DeepSeekDeepSeekClient + CommentController(@小柠 AI 回复)+ AssistantChatController(AI 对话)+ ai-service已接入,但 new Thread() 裸线程、无排队无超时兜底
ℹ️ DEMO 定位判定:功能覆盖面广(用户/内容/金币/支付/风控/社交/AI/电商均有实现),但为演示验证而建,存在职责混叠、重复实现、硬编码与测试缺失等"demo 特征",正适合作为二期 Go 重构的业务蓝图与功能清单。

02 与二期规划的目标差距

2.1 关键差距矩阵

维度一期 DEMO 现状二期规划目标差距等级
后端语言/框架Spring Boot (Java)Go + Gin 微服务高 全量重写
DAU 支撑演示规模,无缓存(无 Redis 查询缓存)50,000 DAU,首页列表缓存 10min、进度缓存 30min高
服务边界user-service 一个服务塞了用户/钱包/评论/社交/购物车/AI(150 接口)8 个 Go 服务严格职责分离(user/content/audit/asset/settlement/social/ai/ecom)高 需按域拆分
弹幕/评论三处实现并存(content 表 + ai WebSocket + user OpenIM 群消息)统一归 social-service + OpenIM,先发后审高
资金安全金币/提现有锁与扣减,但无日上限硬顶、无 RedlockRedlock 分布式锁 + 单设备/单用户日上限 20 元 + 防重放中
回调幂等无 nonce 防重放所有回调 nonce + timestamp + sign 验证中
外部依赖治理RestTemplate 直连,无熔断超时 3s/5s、熔断降级、失败率 >50% 熔断中
跨端进度未按 UnionID 打通UnionID 关联,iOS/Android 实时同步中
CP 入驻/审核/分账仅 CopyrightSubmission 雏形,无审核状态机/结算CP 资质审核 + 内容审核 + 结算分账全链路高 新增能力
测试与 CI仅 3 个测试文件,无 CI 配置CI/CD + 单测 + 迁移回滚脚本中

2.2 二期规划已拍板、DEMO 尚未具备的关键项

03 Java → Go 服务映射方案

3.1 服务映射总览

二期 Go 服务来源(DEMO Java)核心职责迁移新增能力
gateway(Go + Gin)drama-gatewayJWT 鉴权(保留 RSA 兼容)、路由、限流、熔断全局限流、熔断降级
user-servicedrama-user-service 拆分登录/注册/UnionID/用户资料/IM 异步同步UnionID 合并、IM 异步重试
content-servicedrama-content-service短剧/分集/CP 归属/上下架状态机status 状态机(pending/approved/rejected)
audit-servicedrama-content-service + risk 部分CP 资质/短剧/商品绑定审核全新:异步审核 + 广电接口对接
asset-servicedrama-coin-service + user Wallet/Withdraw金币/余额/提现,Redlock + 日上限 20 元Redlock、硬顶、防重放
settlement-servicedrama-trade-service 分佣部分 + 新增CP 账单/分账/对公提现全新:结算锁定、周期账单
social-serviceuser DramaSocialController + content Bullet + ai WebSocket弹幕/评论/剧群,统一走 OpenIM先发后审、OpenIM 消息限速
ai-servicedrama-ai-service + user AssistantChatDeepSeek 对话,排队 + 缓存 + 5s 兜底限流 1次/5s、2500 并发、缓存复用
ecom-servicedrama-trade-service + user CartController购物车自建表 + Lilishop 下单/扣库存卖家映射校验、SKU 归属校验

3.2 可直接复用 vs 必须重写的资产

类别内容策略
✅ 数据库表结构60+ 张表(t_* 前缀)表结构大部分可沿用,Go 直接连同一 RDS;字段命名需对齐二期规范(created_at 等)
✅ 接口契约290+ REST 端点语义作为 OpenAPI 定义蓝本,Go 端按 /api/v1/ 重写路由
✅ 业务规则风控规则(drama-risk-service 35 文件)、分佣逻辑规则逻辑照搬,用 Go 重写
⚠️ 外部客户端LilishopClient / OpenImClient / DeepSeekClient协议保留,Go 重写(httpx + 超时/熔断)
❌ 弹幕三处实现content 表 + ai WS + user OpenIM合并为 social-service 单一路径:写 OpenIM 群 + MySQL 落库 + 先发后审
❌ AI 回复裸线程CommentController new Thread()改 Go goroutine + 队列 + 限流
⚠️ 关键判断:二期 Go 重构不是"翻译代码",而是按二期规划的 8 服务边界做域重构。DEMO 的最大价值是提供完整的功能清单、表结构和接口语义,最大负担是 user-service 的职责过载需要拆分重构。

04 重构关键难点与对策

4.1 难点 1:user-service 职责过载(150 接口)

现状:一个服务承载用户、钱包、评论、社交(剧群/角色)、购物车、AI 对话、CMS、卡密、实名、反馈等 20 个控制器。二期需拆到 user / asset / social / ecom / ai 五个 Go 服务。

对策:按控制器归属划分迁移边界,每个控制器对应二期目标服务的模块;先拆"钱包/提现→asset"、"购物车→ecom"、"评论/剧群→social"、"AI→ai",最后留"用户核心→user"。

4.2 难点 2:弹幕三处实现合并

现状实现存储实时通道
ContentController /bulletst_bullet_commentary (MySQL)REST 轮询
AiService /bullet/pusht_bullet_message (MySQL)STOMP WebSocket /topic/bullet/{dramaId}
DramaSocialController /sendOpenIM 群消息OpenIM 长连接

对策:统一走二期 social-service:弹幕 = OpenIM 剧群消息(实时)+ MySQL 落库(回放/时间点索引),删除重复的 STOMP 与双表,落库表只保留一张。

4.3 难点 3:资金安全升级

4.4 难点 4:DeepSeek 接入工程化

4.5 难点 5:一期 PHP 过渡调用

二期规划要求一期 PHP 仅作历史数据查询、超时 ≤500ms 熔断。DEMO 中 gateway 已保留 RSA legacy 兼容(RSACrypto 对应 PHP),Go 网关需继续维护该兼容层直到数据迁移完成。

4.6 难点 6:工程基建从零补齐

05 边界清单(BOUNDARIES.md)对齐检查

5.1 逐项对照(demo 现状 → Go 目标)

边界项规划约束demo 现状Go 落地要点
连接池MaxOpen=50 / MaxIdle=20Spring 默认(Hikari 默认 10)database/sql SetMaxOpenConns(50)
HTTP 超时Lilishop/PHP 3s、DeepSeek 5sRestTemplate 10s/30snet/http Client Timeout + context
Redis 缓存首页列表 10min、进度 30min无查询缓存go-redis + 缓存穿透限流
分布式锁Redlock ≤2sRedis SETNX 5sredsync 库
消息队列Redis Streams / Kafka + 重试退避无(RocketMQ 仅声明)Redis Streams 起步,Kafka 后续
防重放nonce+timestamp+sign❌ 无回调中间件统一校验
密钥管理仅环境变量❌ yml 硬编码(如 spree api-key)os.Getenv + .env / 密钥服务
日志脱敏不打印手机号/身份证/密码⚠️ 部分明文日志zap 脱敏 hook
CP 隔离仅查自己 cp_id 数据❌ 无 CP 体系中间件强制 cp_id 过滤
金币上限单设备/用户日上限 20 元❌ 无硬顶asset-service 每日累计校验
先发后审弹幕/评论异步送审❌ 直接展示social-service 异步审核队列
OpenIM 限速单群 20条/s、单用户 5条/s❌ 无消息中间件限速丢弃
跨端进度UnionID 同步❌ 未打通user-service 登录合并 + 进度表
结算锁定账单周期订单禁物理删除❌ 无结算体系settlement-service 软删
🚨 结论:demo 与边界清单的差距集中在资金安全(日上限/防重放/Redlock)、CP 体系(审核/隔离/结算)、工程基建(缓存/队列/限流/测试/密钥管理)三大块。这些不是"翻译代码"能补齐的,必须在 Go 架构中新增设计与实现。

06 分阶段迁移路线图

6.1 建议阶段划分(对齐二期规划 4 阶段,双轨并行)

阶段周期Go 服务核心动作demo 对应资产
P0 基建第 1 周gateway + pkgGo 工程骨架、BOUNDARIES/CLAUDE、连接池/超时/限流框架、CIdrama-common(JWT/客户端)翻译
P1 资产第 2-3 周asset-service金币/钱包/提现重构,Redlock + 日上限,一期 PHP 停写余额drama-coin-service + user Wallet/Withdraw
P2 用户第 3-5 周user-service登录/UnionID/IM 异步同步,OpenIM 集成drama-user-service 核心 + OpenImClient
P3 内容+审核第 5-7 周content + audit短剧状态机、CP 审核、广电异步审核drama-content-service + risk
P4 社交第 7-9 周social-service弹幕/评论统一 OpenIM,先发后审,删除三处重复实现DramaSocial + Bullet + WS 合并
P5 AI第 8-10 周ai-serviceDeepSeek 排队/缓存/5s 兜底/限流drama-ai-service + AssistantChat
P6 电商+结算第 10-12 周ecom + settlement购物车自建表、Lilishop 扣库存、CP 分账CartController + Trade + Commission

6.2 双轨并行策略

✅ 建议:P1(资产)先行完全符合二期规划"先重构金币余额"的决策——资金域最先稳定,其他域逐步迁移。

07 风险与总结

7.1 主要风险

风险等级缓解措施
user-service 拆分边界错误导致返工高先按控制器归属画拆分矩阵,评审后再动
弹幕三实现迁移期间数据不一致高先冻结新增(只留 OpenIM 路径),再迁移存量双表数据并去重
资金域重构出错(余额/提现)高P1 先行 + 对账脚本 + 灰度 + 回滚脚本
一期 PHP 慢查询拖垮 Go(雪崩)中500ms 超时 + 熔断 + 降级兜底
CP 体系/审核/结算为新域,工期估计不足中纳入 P3/P6 独立排期,demo 无现成逻辑可抄
原生双端开发与后端并行,联调窗口紧张中先出 OpenAPI 契约,双端按契约 mock 联调

7.2 总结

📌 本报告基于 /root/drama-fusion-platform 源码静态盘点 + 二期规划 3 份 HTML 对照分析,未做任何代码变更。行数与接口数由源码统计所得,供排期与拆分评估使用。