柠檬剧场 × Lilishop × OpenIM 三系统集成方案
PHP 短剧平台 + Java 电商系统 + Go IM 服务 — 统一后台 · 三系统协作
📅 2026-07-08
🐘 PHP (FastAdmin)
☕ Java (Spring Boot)
🔊 Go (OpenIM)
🎨 Vue 3 统一前端
1 三系统全景
🍿 柠檬剧场
PHP 7.2+ / ThinkPHP 5
MySQL + Redis
核心能力:
· 短剧内容管理 (191表)
· 用户/代理/分销体系
· 金币/余额/提现
· 广告投放 & 风控
· Token 认证
🛒 Lilishop
Java 8+ / Spring Boot
MySQL + ES + Redis
核心能力:
· 商品/订单/物流
· 营销 (优惠券/秒杀)
· 店铺管理
· 买家/商家/管理员
· JWT 认证
💬 OpenIM
Go / WebSocket
MySQL + MongoDB + Redis + Kafka
核心能力:
· 单聊/群聊/大群
· 文本/图片/语音/视频
· 好友/黑名单
· 消息漫游 & 推送
· REST API + WebSocket
集成目标:用户在一个统一后台中管理短剧内容、商城运营、即时通讯。三套系统各自独立部署,通过 API 网关 + 统一认证 + Vue 3 前端实现"一个后台、三套能力"。
2 总体集成架构
┌──────────────────────────────────────────────────────────────────────────┐
│ Vue 3 统一管理后台 (新开发) │
│ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────────┐ │
│ │ 短剧管理 │ │ 商城管理 │ │ IM 管理 │ │ 用户管理 │ │ 统一工作台 │ │
│ │(柠檬剧场)│ │(Lilishop)│ │(OpenIM) │ │(三合一) │ │(聚合Dashboard)│ │
│ └────┬─────┘ └────┬─────┘ └────┬─────┘ └────┬─────┘ └──────┬───────┘ │
└───────┼────────────┼────────────┼────────────┼───────────────┼──────────┘
│ │ │ │ │
┌────┴────────────┴────────────┴────────────┴───────────────┴─────┐
│ Nginx API Gateway │
│ 路由: /api/drama/* → PHP | /api/shop/* → Java | /api/im/* → Go │
│ 统一 CORS · 限流 · 日志 · Token 透传 │
└────┬────────────────────┬────────────────────┬──────────────────┘
│ │ │
┌────┴──────┐ ┌───────┴────────┐ ┌──────┴──────────┐
│ 柠檬剧场 │ │ Lilishop │ │ OpenIM │
│ PHP:8080 │ │ Java:8888 │ │ Go:10001/10002│
│ │ │ │ │ │
│ MySQL │ │ MySQL + ES │ │ MySQL + MongoDB │
│ Redis │ │ Redis │ │ Redis + Kafka │
└───────────┘ └────────────────┘ │ MinIO (文件) │
└─────────────────┘
┌──────────────────────────────────────────────────────────────┐
│ 统一认证层 (新增) │
│ PHP Auth Service 扩展: │
│ · 柠檬剧场 Token (保持) │
│ · Lilishop JWT 签发代理 │
│ · OpenIM User Token 签发代理 │
│ · user_mapping 表 (drama_id ↔ shop_member_id ↔ im_user_id) │
└──────────────────────────────────────────────────────────────┘
2.1 三系统技术栈对比
| 维度 | 柠檬剧场 | Lilishop | OpenIM |
| 语言 | PHP 7.2+ | Java 8+ | Go 1.18+ |
| 框架 | ThinkPHP 5 | Spring Boot 2.x | 自研 (Gin + WebSocket) |
| 数据库 | MySQL | MySQL + ES | MySQL + MongoDB + Redis |
| 消息队列 | Redis Queue | RocketMQ (可选) | Kafka |
| 认证 | 自定义 Token | JWT (Spring Security) | 自定义 Token + UserID |
| API 协议 | HTTP/JSON | HTTP/JSON (RESTful) | HTTP/JSON + WebSocket |
| 部署端口 | 8080 (建议) | 8888 (建议) | 10001(API) + 10002(WS) |
3 OpenIM 架构与集成要点
3.1 OpenIM 核心组件
OpenIM 服务架构:
┌─────────────────────────────────────────────┐
│ openim-api (REST API :10001) │
│ · 用户注册/查询 · 好友管理 │
│ · 群组创建/管理 · 消息历史查询 │
│ · 管理后台接口 · 统计/监控 │
├─────────────────────────────────────────────┤
│ openim-ws (WebSocket :10002) │
│ · 实时消息收发 │
│ · 在线状态管理 │
│ · 消息推送 (单聊/群聊/大群) │
├─────────────────────────────────────────────┤
│ openim-msgtransfer / openim-push │
│ · Kafka 消费消息 │
│ · 离线消息存储 (MongoDB) │
│ · 消息漫游 & 同步 │
├─────────────────────────────────────────────┤
│ openim-rpc (内部 gRPC) │
│ · 服务间通信 │
│ · 业务服务 → IM 服务调用 │
└─────────────────────────────────────────────┘
3.2 关键 API
| API | 方法 | 用途 |
/user/register | POST | 注册 IM 用户 (userID + nickname + faceURL) |
/user/update | POST | 更新用户信息 (昵称/头像同步) |
/friend/add | POST | 添加好友 (无需对方同意模式) |
/group/create | POST | 创建群组 (短剧粉丝群/代理群) |
/group/invite | POST | 邀请用户入群 |
/msg/send | POST | 服务端发送消息 (系统通知/订单通知) |
/auth/user_token | POST | 获取用户 Token (供前端 WebSocket 连接) |
4 统一认证方案 (三系统)
4.1 认证流程
用户登录 → 统一认证:
Vue 前端 柠檬剧场 PHP (认证中心) Lilishop Java OpenIM Go
│ │ │ │
│ POST /api/auth/login │ │ │
│ {username, password, │ │ │
│ device:"admin"} │ │ │
│─────────────────────────────→│ │ │
│ │ 验证 fa_user / fa_admin │ │
│ │ 生成 drama_token │ │
│ │ │ │
│ │ 查 user_mapping 表 │ │
│ │ 无记录→调用注册 │ │
│ │───────────────────────────→│ │
│ │←────────── shop_jwt ──────│ │
│ │ │ │
│ │ 查 im_user_id │ │
│ │ 无记录→调用 /user/register │ │
│ │──────────────────────────────→ │
│ │←────────── im_token + im_user_id ─── │
│ │ │ │
│ { │ │ │
│ drama_token, │ │ │
│ shop_jwt, │ │ │
│ im_token, │ │ │
│ im_user_id, │ │ │
│ user_info │ │ │
│ } │ │ │
│←─────────────────────────────│ │ │
4.2 user_mapping 表设计 (在柠檬剧场 MySQL)
| 字段 | 类型 | 说明 |
drama_user_id | int | 柠檬剧场 fa_user.id (主关联键) |
shop_member_id | varchar(64) | Lilishop 买家 ID |
shop_store_id | varchar(64) | Lilishop 商家 ID (代理用户) |
im_user_id | varchar(64) | OpenIM 用户 ID |
created_at | int | 创建时间 |
5 IM 业务场景设计
🎧 在线客服
用户在 APP/小程序中点击客服按钮 → 创建与客服的单聊会话。客服在管理后台统一接待。
技术:OpenIM 单聊 + PHP 排队分配逻辑
👥 短剧粉丝群
每部短剧自动创建粉丝群。用户追剧后可选择入群讨论。群主为平台运营账号。
技术:OpenIM 群组 + PHP 短剧-群组关联表
🤝 代理团队群
代理/总代用户可创建自己的团队群,邀请下级加入。用于推广培训、收益分享。
技术:OpenIM 群组 + 代理层级权限控制
📢 系统通知
短剧更新、订单状态变更、金币到账、提现结果 → 通过 IM 系统消息推送给用户。
技术:OpenIM /msg/send 服务端 API
🛒 订单咨询
用户在商城下单前咨询商品详情 → 发起与商家客服单聊。商家在后台实时回复。
技术:OpenIM 单聊 + Lilishop 商家 ID ↔ IM 用户映射
📊 IM 管理后台
管理员可在后台查看 IM 统计 (日活/消息量)、管理群组、设置敏感词过滤、配置自动回复。
技术:OpenIM 管理 API + Vue 管理页面
IM 用户自动注册策略:用户在柠檬剧场注册/登录时,PHP 异步调用 OpenIM /user/register,使用 drama_user_id 作为 im_user_id,nickname 和 avatar 从 fa_user 同步。首次登录后台时触发 IM Token 获取。
6 前端集成方案
6.1 技术栈
| 层级 | 选型 | 覆盖系统 |
| 框架 | Vue 3 + TypeScript + Vite | 全部 |
| UI 库 | Element Plus | 管理后台 |
| HTTP | Axios × 3 实例 (dramaApi / shopApi / imApi) | 全部 |
| 状态管理 | Pinia (auth / menu / im) | 全部 |
| IM SDK | OpenIM Web SDK (@openim/wasm-client-sdk) | IM 客服端 |
| 图表 | ECharts 5 (按需加载) | Dashboard |
6.2 统一后台页面结构
┌──────────────────────────────────────────────┐
│ 顶部栏: 系统名称 | 消息铃铛(IM未读) | 用户头像 │
├────────┬─────────────────────────────────────┤
│ │ │
│ 左侧 │ 主内容区 (Vue Router) │
│ 菜单 │ │
│ │ 📊 工作台 (聚合三系统核心指标) │
│ 📺 内容 ├──────────────────────────────────────┤
│ 短剧 │ 📺 内容管理 (柠檬剧场 API) │
│ 剧集 │ · 短剧列表/编辑/审核 │
│ 分类 │ · 广告管理 │
│ 广告 │ · 用户管理 (含 IM 用户) │
│────────│ · 财务管理 │
│ 🛒 商城 ├──────────────────────────────────────┤
│ 商品 │ 🛒 商城管理 (Lilishop API) │
│ 订单 │ · 商品/订单/物流 │
│ 店铺 │ · 营销活动 │
│ 营销 │ · 店铺管理 │
│────────│ │
│ 💬 IM ├──────────────────────────────────────┤
│ 客服 │ 💬 消息中心 (OpenIM API) │
│ 群组 │ · 客服会话 (WebSocket 实时) │
│ 消息 │ · 群组管理 │
│ 统计 │ · 系统消息/通知模板 │
│────────│ │
│ ⚙ 系统 │ │
└────────┴──────────────────────────────────────┘
7 API 网关路由设计
# Nginx 配置 — 三系统统一入口
upstream drama_backend { server 127.0.0.1:8080; } # PHP
upstream shop_backend { server 127.0.0.1:8888; } # Java
upstream im_api { server 127.0.0.1:10001; } # OpenIM REST
upstream im_ws { server 127.0.0.1:10002; } # OpenIM WebSocket
server {
listen 443 ssl;
server_name admin.zgddj.com;
# === WebSocket (IM 实时通信) ===
location /ws/im/ {
proxy_pass http://im_ws;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
proxy_read_timeout 86400s;
}
# === 柠檬剧场 ===
location /api/drama/ {
proxy_pass http://drama_backend/api/;
}
# === Lilishop 商城 ===
location /api/shop/ {
proxy_pass http://shop_backend/;
rewrite ^/api/shop/(.*) /$1 break;
}
# === OpenIM REST API ===
location /api/im/ {
proxy_pass http://im_api/;
rewrite ^/api/im/(.*) /$1 break;
}
# === Vue 前端 SPA ===
location / {
root /var/www/admin-frontend/dist;
try_files $uri /index.html;
}
}
8 三系统数据流 & 事件联动
| 业务事件 | 触发系统 | 联动系统 | 动作 |
| 用户注册 |
🍿 柠檬剧场 |
🛒 Lilishop 💬 OpenIM |
异步注册 Lilishop 买家 + OpenIM 用户 |
| 代理升级 |
🍿 柠檬剧场 |
🛒 Lilishop 💬 OpenIM |
开通 Lilishop 店铺 + 创建代理专属群 |
| 短剧上新 |
🍿 柠檬剧场 |
🛒 Lilishop 💬 OpenIM |
创建短剧粉丝群 + 关联商品 + 群内推送通知 |
| 订单完成 |
🛒 Lilishop |
🍿 柠檬剧场 💬 OpenIM |
PHP 分佣结算 + IM 推送订单通知 |
| 金币到账 |
🍿 柠檬剧场 |
💬 OpenIM |
IM 系统消息推送:"您获得了 XX 金币" |
| 提现审核通过 |
🍿 柠檬剧场 |
💬 OpenIM |
IM 系统消息推送:"您的提现已到账" |
| 客服接入 |
💬 OpenIM |
🍿 柠檬剧场 |
PHP 记录客服会话日志,用于服务质量统计 |
| 商品被关联短剧 |
🍿 柠檬剧场 |
🛒 Lilishop 💬 OpenIM |
同步商品-短剧关联表 + 商家 IM 通知 |
9 OpenIM 部署与资源配置
| 组件 | 推荐配置 | 说明 |
| openim-api | 2 Core / 4GB × 1 | REST API 服务,处理管理请求 |
| openim-ws | 4 Core / 8GB × 2 | WebSocket 长连接,承载实时消息 |
| MySQL | 复用现有 RDS (新 schema) | 存储用户、好友、群组关系 |
| MongoDB | 2 Core / 8GB × 1 (或阿里云 MongoDB) | 消息体存储 (文本/图片/语音等) |
| Kafka | 2 Core / 4GB × 3 (集群) | 消息队列,解耦消息发送与存储 |
| Redis | 复用现有 Redis (新 db) | 在线状态缓存、消息序列号 |
| MinIO | 或复用阿里云 OSS | IM 中发送的图片/语音/文件存储 |
成本优化:如果 IM 用户量初期较小 (< 10 万),可先用 Docker Compose 单机部署全部组件,MySQL 和 Redis 复用现有实例。Kafka 可用 Redis Stream 替代简化部署。MongoDB 是必须新增的组件。
10 柠檬剧场需要的 API 改造清单
| 改造项 | 说明 | 优先级 |
| CORS + API 格式统一 | 已在 Phase 1 优化中完成 | P0 已完成 |
POST /api/auth/login (扩展) | 登录时同步注册 Lilishop + OpenIM,返回三系统 Token | P0 新增 |
GET /api/auth/verify | 验证 Token 有效性+返回 user_mapping | P0 新增 |
POST /api/im/register | 手动触发 IM 用户注册 (已注册用户补注册) | P1 新增 |
POST /api/im/group/create | 手动创建短剧粉丝群/代理群 | P1 新增 |
POST /api/drama/goods/bind | 短剧绑定商品 (商城联动) | P1 新增 |
| 事件钩子 | 用户注册/代理升级/金币变动 → 异步通知其他系统 | P1 改造 |
fa_user_mapping 表 | 三系统用户 ID 映射表 | P0 新增 |
11 分阶段实施计划
| 阶段 | 周期 | 柠檬剧场 | Lilishop | OpenIM | 前端 |
| P0: 环境部署 |
2 周 |
API 格式统一 (已完成) |
部署 Java 环境 独立运行验证 |
Docker Compose 部署 独立运行验证 |
— |
| P1: 认证打通 |
2 周 |
新增 user_mapping 表 扩展 login 接口 新增 verify 接口 |
配置 JWT 共享密钥 |
配置 admin token 对接用户注册 API |
Axios 三实例 三 Token 存储 |
| P2: 前端框架 |
3 周 |
— |
— |
— |
Vue 3 框架 动态菜单 Dashboard 聚合 |
| P3: 内容+IM 集成 |
3 周 |
事件钩子改造 IM 管理 API 封装 |
— |
粉丝群自动创建 客服分配逻辑 系统消息模板 |
短剧管理页面 IM 客服页面 WebSocket 集成 |
| P4: 商城集成 |
3 周 |
商品关联接口 金币抵现对接 |
订单完成回调 商家 IM 通知 |
商家客服单聊 |
商城管理页面 |
| P5: 优化上线 |
2 周 |
性能优化 · 灰度发布 · 旧后台下线 · 文档完善 |
全面切换 |
总工期:15 周 (约 3.5-4 个月)。P0-P1 (4周) 可与此前"PHP 单体优化"并行推进。P2-P5 是纯增量工作。
12 风险与注意事项
| 风险 | 等级 | 缓解 |
| OpenIM 与 PHP 用户体系同步延迟 | 中 | 异步注册 + 重试队列;前端增加"IM 正在连接..."过渡态 |
| 三系统 Token 过期时间不一致导致频繁重登录 | 中 | 统一 Token 有效期 (建议 7 天);Axios 拦截器自动刷 Token |
| WebSocket 连接数激增 | 中 | 管理后台不需要实时消息时使用轮询;openim-ws 可水平扩展 |
| 三系统事务一致性 (金币+订单) | 高 | 补偿事务 + 本地消息表 + 每日对账 |
| 新增 MongoDB 运维成本 | 低 | 使用阿里云 MongoDB 托管服务,免运维 |
| 前端三套 API 拦截器复杂度 | 低 | 封装统一的 createApiClient(baseURL, authHeader) 工厂函数 |
13 总结与建议
- 认证是基石。三系统集成最大的工程难点不是 API 调用,而是统一认证。建议以柠檬剧场 PHP 为认证中心,代理签发 Lilishop JWT 和 OpenIM Token。新增
fa_user_mapping 表维护三系统用户 ID 映射。
- 先通后优。OpenIM 先实现基础 IM 能力 (单聊/群聊/系统通知),后续再迭代客服排队、敏感词过滤等高级功能。
- MongoDB 是唯一新增存储。MySQL 和 Redis 均复用现有实例。Kafka 初期可用 Redis Stream 简化部署。
- IM 用户注册时机。新用户在柠檬剧场注册时异步注册 IM 用户。已有用户提供批量注册脚本。
- 管理后台的 IM 功能用 REST API。管理后台不需要 WebSocket 长连接 (不像 APP 需要实时消息)。客服功能使用 OpenIM REST API 轮询或 WebSocket 即可。
- 事件驱动的系统联动。用户注册、代理升级、短剧上新等关键事件建议通过 Redis Queue 异步通知其他系统,避免同步调用链路过长。
- 保留独立升级能力。三套系统各自独立部署,任何一套系统升级不影响其他系统。前端通过 API 适配层屏蔽后端差异。
一句话总结:以柠檬剧场 PHP 为认证和业务中枢,Lilishop 提供电商能力,OpenIM 提供即时通讯能力。通过 Nginx 统一入口 + Vue 3 统一前端,实现"一个后台、三套系统、用户无感"。核心投入在认证打通和前端开发,后端系统改动最小化。
报告生成: 2026-07-08 | PHP (FastAdmin) + Java (Lilishop) + Go (OpenIM) | 三系统统一后台集成方案