DRAMA 融合短剧平台 — 代码结构及框架分析报告

Code Structure & Framework Analysis — drama-fusion-platform(develop @ 70b959a)
报告日期:2026-08-09 版本:v1.0 技术栈:Spring Boot 3.2.5 · Java 17 · Vue 3 规模:15 模块 · 292 Java 文件 · 14 微服务

一、项目概述

DRAMA 融合短剧平台 是一套面向短剧内容的商业化平台,覆盖内容生产(CP)、内容消费(用户)、电商变现(商品卡片/商城)、AI 互动(AI 弹幕/评论/虚拟角色)、广告变现与金币经济等多条业务线。

15
Maven 模块
14
运行中微服务
292
Java 文件
5
前端项目
6
外部系统集成

架构采用 Spring Cloud Alibaba 微服务 模式:Nacos 注册与配置中心、网关统一入口、领域化服务拆分(内容/交易/支付/金币/风控/AI 等 13 个业务服务)、RocketMQ 异步解耦、Zipkin 链路追踪,并通过 RS256 JWT 统一认证 打通 DRAMA 与 OpenIM、lilishop 的 SSO 集成。

二、总体架构

接入层

Gateway :8080
统一路由 / 认证 / 限流 / CORS
前端:H5 / Admin / Seller / Lemon

业务服务层(13 个)

user 8101 · content 8102 · rec 8103
ad 8104 · ai 8105 · trade 8106
coin 8107 · risk 8108 · payment 8109
cms 8120 · asset 8121 · social 8122 · audit 8123

公共层

drama-common:统一结果/异常/工具/客户端
RocketMQ · Redis · Nacos · Zipkin
OpenIM · lilishop · DeepSeek 客户端

外部系统

OpenIM 172.16.0.66:10002(IM/剧群)
lilishop 172.16.0.90:8080/8889(商城)
DeepSeek(AI 弹幕/评论/角色)
微信支付 / 微信登录 / 穿山甲广告

服务间通过 Nacos 服务发现 + REST/Feign 同步调用,异步场景经 RocketMQ(DeepSeek 排队、IM 异步、订单状态消息);全链路 Zipkin(9411)追踪;日志 JSON 结构化 + Prometheus/Grafana/Loki 监控告警。

三、模块结构(15 个 Maven 模块)

模块职责main 类test 类端口
drama-common公共库:统一结果/异常、工具、REST 客户端、MQ、安全、灰度/i18n/ABTest260—
drama-gatewayAPI 网关:路由、鉴权、限流、CORS608080
drama-user-service用户域:注册/登录(手机/微信)、CP 审核、风控联动、钱包/提现4148101
drama-content-service内容域:短剧/分集/弹幕/评论/时间轴商品卡片3128102
drama-rec-service推荐域:内容推荐——8103
drama-ad-service广告域:广告位/收益、穿山甲联盟接入1618104
drama-ai-serviceAI 域:DeepSeek 弹幕/评论/情感陪伴/虚拟角色918105
drama-trade-service交易域:订单/佣金/支付编排(→ lilishop)918106
drama-coin-service金币域:金币账户/签到/消费/提现928107
drama-risk-service风控域:设备/行为风控、登录风控3438108
drama-payment-service支付域:微信支付、回调验签、退款1218109
drama-cms-service内容管理:CMS/运营位1318120
drama-asset-service资产域:素材/资源/广告素材2918121
drama-social-service社交域:OpenIM 集成、剧群、IM 消息1218122
drama-audit-service审核域:内容/版权审核、审计日志1418123

注:rec-service 为 8103 端口独立模块;端口信息来自各服务 application.yml。

drama-common 公共包结构

包职责
com.drama.fusion.common.exception全局异常处理、业务异常
com.drama.fusion.common.result统一响应封装 Result / ResultCode
com.drama.fusion.common.utilsJwtUtil(RS256)、SensitiveUtil 脱敏等工具
com.drama.fusion.common.client外部客户端:LilishopClient / OpenIMClient / DeepSeekClient 等
com.drama.fusion.common.mqRocketMQ 生产者/消费者、Topic 定义
com.drama.fusion.common.config通用配置(Async 线程池、Redis、RestTemplate)
com.drama.fusion.common.security安全组件、JWT 过滤器、上下文
com.drama.fusion.common.gray / i18n / abtest灰度发布、国际化、AB 测试基础能力

四、技术栈与框架

类别技术选型版本/说明
语言/运行时Java 17 · Spring Boot 3.2.5Jakarta EE、GraalVM 友好
微服务框架Spring Cloud 2023.0.1 · Spring Cloud Alibaba 2023.0.1.0网关 Gateway(WebFlux)
注册/配置中心Nacos172.16.0.69:8848(本机)
ORMMyBatis-Plus 3.5.5Spring Boot 3 starter
认证JJWT 0.12.5RS256 + Refresh Token + 黑名单
消息队列RocketMQ 5.x异步通道、DeepSeek 排队、IM 异步
缓存Redis(Spring Data Redis)分布式锁、幂等、会话
可观测性Zipkin · Prometheus · Grafana · Loki链路追踪 + 指标 + 日志 + 告警
容错Resilience4j 2.1.0熔断/重试/限流注解
前端Vue 3 · Vite · Pinia · Vue RouterH5 / Admin / Admin-Portal / Lemon / Seller 5 个项目

外部系统集成(drama-common/client)

系统地址集成内容
OpenIM172.16.0.66:10002IM 消息、剧群、虚拟角色对话(统一认证)
lilishop172.16.0.90:8080 / 8889商城:商品卡片、购物车、订单、支付、CP 发货(RS256 SSO)
DeepSeekAPIAI 弹幕 / AI 评论 / 情感陪伴 / 虚拟角色变现
微信—微信登录(OAuth)、微信支付(回调验签)
穿山甲 Gromore—广告联盟(穿山甲/优量汇/快手/百度)
Elasticsearch172.16.0.90:9200lilishop 商品搜索(ES 版)

五、领域划分与关键设计

领域服务核心能力
用户与 CPuser手机/微信登录、CP 注册审核、钱包、提现(分布式锁+日限额)
内容content / cms / audit短剧、分集、弹幕、评论、时间轴商品卡片、审核流
交易与支付trade / payment订单编排(→lilishop)、微信支付、佣金、退款
金币经济coin金币账户、签到(Redis 幂等)、消费、提现
风控risk设备指纹、登录/交易风控、黑名单
AIaiDeepSeek 弹幕/评论、情感陪伴、虚拟角色收费
广告ad / asset广告位、收益、素材管理、联盟接入
社交socialOpenIM 集成、剧群、IM 异步
推荐rec内容推荐

关键设计要点

六、前端项目与部署运维

前端项目(5 个)

项目定位技术
drama-frontend-h5用户 H5(短剧观看/剧场/我的/消息中心)Vue 3 + Vite
drama-frontend-admin管理端Vue 3
drama-frontend-admin-portal管理门户Vue 3
drama-frontend-lemon柠檬剧场 H5Vue 3
drama-frontend-sellerCP 卖家端Vue 3

部署与运维

七、代码规模统计

模块main 类test 类
drama-user-service414
drama-risk-service343
drama-content-service312
drama-asset-service291
drama-common260
drama-ad-service161
drama-audit-service141
drama-cms-service131
drama-payment-service121
drama-social-service121
drama-trade-service91
drama-coin-service92
drama-ai-service91
drama-gateway60
drama-rec-service——
合计≈261≈19

java 文件总数(含各模块):292;另有 deploy/docker/docs 等工程资产。

八、结论与观察