🎬 DRAMA 融合短剧平台

Java 微服务架构深度分析报告

分析日期: 2026-07-21 | Spring Boot 3.2.5 | Spring Cloud 2023.0.1 | Java 17

1. 项目概览

融合短剧平台(Drama Fusion Platform) 是一个面向 C 端用户的短剧观看 APP,聚合 CP 上传的短剧内容,通过推荐系统分发,集成广告变现、AI 弹幕互动、商品分销、虚拟打赏、金币激励等能力。

核心能力矩阵

短剧播放 推荐 Feed 广告变现 AI 弹幕 商品分销 虚拟打赏 金币系统 IM 社交

项目规模

工程结构

drama-fusion-platform/
├── pom.xml                         (父 POM — Spring Boot 3.2.5)
├── drama-common/                   (公共: Result, JwtUtil, RsaCrypto, EddClient, SpreeClient, RiskClient)
├── drama-gateway/                  (API 网关: 8080 — Spring Cloud Gateway + JwtAuthFilter)
├── drama-user-service/             (用户: 8101 — 登录/CP/IM/钱包/画像/风控)
├── drama-content-service/          (内容: 8102 — 短剧/剧集/弹幕/审核/上传)
├── drama-rec-service/              (推荐: 8103 — Feed/热度/协同过滤)
├── drama-ad-service/               (广告: 8104 — GROMORE 广告联盟)
├── drama-ai-service/               (AI/IM: 8105 — WebSocket 弹幕/DeepSeek 对话)
├── drama-trade-service/            (交易: 8106 — 订单/打赏/CP 收益)
├── drama-coin-service/             (金币: 8107 — 签到/广告激励/充值/消费)
├── drama-risk-service/             (风控: 8108 — 规则引擎/设备指纹/黑名单)
├── drama-payment-service/          (支付: 8109 — 微信支付/渠道回调)
├── drama-frontend-admin/           (Vue3 + Arco Design CP 管理后台)
├── drama-frontend-h5/              (Vue3 + Video.js H5 播放器)
├── drama-frontend-admin-portal/    (Admin Portal)
├── drama-frontend-lemon/           (柠檬剧场兼容)
├── drama-frontend-seller/          (商家端)
├── drama-uniapp/                   (UniApp 用户 APP)
├── docker/                         (Docker Compose)
└── docs/                           (架构设计文档)
  

2. 技术栈全景

层级技术选型版本
编程语言Java17
微服务框架Spring Boot + Spring Cloud3.2.5 / 2023.0.1
注册/配置中心Nacos2.3.0
API 网关Spring Cloud Gateway4.1
ORMMyBatis-Plus3.5.5
数据库MySQL 8.0 + Redis 78.0 / 7
消息队列RocketMQ5.1.4
对象存储阿里云 OSS-
JWTjjwt (RS256)0.12.5
用户 APPUniApp 3.0 + uView UI-
CP 后台Vue3 + Arco Design-
H5 播放器Vue3 + Video.js-
构建工具Maven3.9+

3. 微服务架构总览

┌─────────────────────────┐ │ API Gateway (:8080) │ │ Spring Cloud Gateway │ └───────────┬─────────────┘ ┌──────────┬────────┼────────┬──────────┬──────────┐ ▼ ▼ ▼ ▼ ▼ ▼ ┌─────────┐ ┌────────┐ ┌──────┐ ┌──────┐ ┌────────┐ ┌────────┐ │ User │ │Content │ │ Rec │ │ Ad │ │ AI │ │ Trade │ │ :8101 │ │ :8102 │ │:8103 │ │:8104 │ │ :8105 │ │ :8106 │ └────┬────┘ └───┬────┘ └──┬───┘ └──┬───┘ └───┬────┘ └────┬───┘ │ │ │ │ │ │ ▼ ▼ ▼ ▼ ▼ ▼ ┌────────┐ ┌────────┐ ┌─────────┐ ┌────────┐ ┌──────────┐ │ Coin │ │ Risk │ │ Payment │ │Product │ │ H5 Proxy │ │ :8107 │ │ :8108 │ │ :8109 │ │Sync │ │(Node.js) │ └────────┘ └────────┘ └─────────┘ │ :8089 │ └──────────┘ └────────┘ ╔═══════════════════════════════════════════════╗ ║ 基础设施: MySQL8 · Redis7 · RocketMQ · Nacos· OSS ║ ╚═══════════════════════════════════════════════╝

服务调用链路

用户认证

→
  • APP → Gateway(JWT) → UserService → MySQL/Redis

内容播放

→
  • APP → Gateway → ContentService → OSS/MySQL

推荐 Feed

→
  • APP → Gateway → RecService → Profile → Redis

广告奖励

→
  • APP → Gateway → AdService → CoinService → RiskCheck

AI 弹幕

→
  • H5 → Gateway → AiService → WebSocket → DeepSeek

支付

→
  • APP → Gateway → PaymentService → 渠道 → Callback

4. API 网关(drama-gateway)

端口 8080 Spring Cloud Gateway 4.1

路由表

路由 ID路径目标端口
user-service/api/user/**drama-user-service8101
pno-service/api/pno/**, /api/beacon/**drama-user-service8101
content-service/api/content/**drama-content-service8102
rec-service/api/rec/**drama-rec-service8103
ad-service/api/ad/**drama-ad-service8104
ai-service/api/ai/**drama-ai-service8105
trade-service/api/trade/**drama-trade-service8106
coin-service/api/coin/**drama-coin-service8107
risk-service/api/risk/**drama-risk-service8108
payment-service/api/payment/**drama-payment-service8109
product-sync/api/sync/**, /admin/**直连 localhost:80898089
legacy-compat/api/advertising/**drama-user-service8101
spree-store/api/store/**, /api/spree/**直连 172.16.0.6280

JwtAuthFilter

5. 微服务模块详解

5.1 drama-common — 公共模块

无端口 共享工具包

包类职责
resultResult<T>统一响应体 code/message/data
exceptionBizException / GlobalExceptionHandler业务异常 + 全局 @RestControllerAdvice 处理
utilsJwtUtilRS256 JWT 签发/验证(7天过期)
utilsRsaCryptoUtilRSA 加解密 + HMAC-SHA256 签名(兼容旧 PHP 系统)
clientEddClientEDD 商城 REST 客户端
clientSpreeClientSpree Bridge 客户端(多商户/商品/订单)
clientRiskClient风控内部调用客户端, 7 种风控场景

5.2 drama-user-service — 用户服务

8101 Spring Boot + MyBatis-Plus

Controller 汇总: UserController(登录/CP/IM/画像), WalletController, CartController, CommentController, ChannelController, KamiController, ShareController, FeedbackController, TaskController, RealnameController, DramaSocialController

核心实体: User, UserProfile, UserWallet, CoinTransaction, WithdrawConfig, AgentBank/Reward/Settlement, Kami, Task, Feedback, Notice, Permission, Role

IM 集成: OpenImClient(注册/好友/消息/WebHook)+ DeepSeekClient(大模型流式 SSE 对话)

5.3 drama-content-service — 内容服务

8102 Spring Boot + MyBatis-Plus

Controller: ContentController(短剧CRUD/播放页), UploadController(OSS上传), OpsController(审核上下架), SystemConfigController(系统配置)

核心实体: Drama(~60字段含合规全套), Episode, BulletCommentary, DramaProductRel, ContentAuditLog, SystemConfig

外部客户端: ProductSyncClient, SunayingClient, RecommendSyncClient

5.4 drama-rec-service — 推荐服务

8103 Spring Boot + Redis

5.5 drama-ad-service — 广告服务

8104 Spring Boot + GROMORE SDK

实体: AdPlacement, AdPool, AdWatchLog, AdCreateLog, AdEcpmLog, AdTransLog

集成: GROMORE 广告联盟,激励视频广告

5.6 drama-ai-service — AI 弹幕/IM 服务

8105 Spring Boot + WebSocket STOMP

5.7 drama-trade-service — 交易服务

8106 Spring Boot + MyBatis-Plus

实体: Order, VirtualGift | 下单/查询/打赏/CP收益,操作前 RiskClient 风控检查

5.8 drama-coin-service — 金币服务

8107 Spring Boot + Redis + MyBatis-Plus

实体: CoinAccount, CoinTransaction | 余额/签到/激励视频奖励/充值/消费/流水,风控检查

5.9 drama-risk-service — 风控服务

8108 Spring Boot + 规则引擎

5.10 drama-payment-service — 支付服务

8109 Spring Boot + MyBatis-Plus

实体: PaymentOrder, PaymentConfig | 创建支付/查询/渠道回调/配置管理

5.11 drama-product-sync — 选品中台同步

8089 Spring Boot + Thymeleaf

6. 数据库核心模型

用户域

表核心字段
t_userid, phone, openid, unionid, nickname, avatar, userType(NORMAL/CP/ADMIN), verifyStatus, eddWpUserId, parentId, inviteCode, channelLevel, status, lastLoginTime
t_user_profileuserId, tags(json), watchHistory(json), prefCategories
t_user_walletuserId, coinBalance, totalEarned, totalSpent, totalRecharged

内容域

表核心字段
t_drama~60+字段: id, cpUserId, title, cover, category, status, reviewStatus, hotScore, 三级审核字段, 合规字段全套
t_episodeid, dramaId, epNum, title, videoUrl, duration
t_bullet_commentaryid, episodeId, timePoint(秒), content, type
t_drama_product_relid, dramaId, productId, timePoint

行为 / 交易 / 风控域

域核心表
行为t_watch_record, t_user_like, t_bullet_message, t_drama_comment
交易t_order, t_virtual_gift, t_coin_transaction
广告t_ad_placement, t_ad_watch_log, t_ad_pool, t_ad_ecpm_log
风控t_device_fingerprint(~20字段), t_black_device, t_blacklist, t_risk_event, t_risk_rule, t_shielding_config

7. 外部系统集成

系统对接方式接口
选品中台REST APIGET /api/sync/products, POST /callback/content-review
AI 弹幕系统REST APIPOST /api/ai/bullet/generate
OpenIMWebHook + REST/callback/im-message, /msg/send_msg
GROMORE 广告SDK + REST激励视频广告展示/回调
用户画像推荐REST172.16.0.63:8000
DeepSeek AIREST (流式)v1/chat/completions (deepseek-chat)
EDD/Spree 商城REST + WP Bridge172.16.0.62, /wp-json/drama/v1/*
微信开放平台OAuth 2.0sns/oauth2/access_token
阿里云 OSSSDK视频/图片媒资存储

8. 安全体系

JWT RS256 认证

RSA 加密(旧系统兼容)

风控引擎

内容合规

9. 前端架构

端面技术功能
用户 APPUniApp 3.0 + uView UI首页/播放器/购物车/打赏/AI对话
CP 管理后台Vue3 + Arco Design + ECharts上传/审核/数据分析/收益
H5 播放器Vue3 + Video.js + WebSocket播放/弹幕/商品卡/AI对话
Admin PortalVue3平台运营管理
柠檬前端Vue3柠檬剧场兼容
商家端Vue3商家后台

H5 代理: drama-h5-proxy (Node.js) 独立部署

10. 部署与运维

Docker Compose(本地开发)

mysql:8.0        → 3306:3306  drama_fusion
redis:7-alpine   → 6379:6379
nacos:v2.3.0     → 8848:8848, 9848:9848 (Standalone)
rocketmq:5.1.4  → 9876:9876 (NameServer)
rocketmq:5.1.4  → 10909:10911 (Broker)

服务端口

服务端口Nacos备注
Gateway8080是外部唯一入口
User8101是含旧系统兼容
Content8102是-
Rec8103是-
Ad8104是GROMORE SDK
AI8105是WebSocket
Trade8106是-
Coin8107是-
Risk8108是-
Payment8109是-
Product Sync8089否Thymeleaf 后台
EDD/Spree80否172.16.0.62

启动模式

总结

Generated by DeepSeek TUI v0.8.18 | 2026-07-21 | Source: /root/drama-fusion-platform