柠檬剧场 × 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 三系统技术栈对比

维度柠檬剧场LilishopOpenIM
语言PHP 7.2+Java 8+Go 1.18+
框架ThinkPHP 5Spring Boot 2.x自研 (Gin + WebSocket)
数据库MySQLMySQL + ESMySQL + MongoDB + Redis
消息队列Redis QueueRocketMQ (可选)Kafka
认证自定义 TokenJWT (Spring Security)自定义 Token + UserID
API 协议HTTP/JSONHTTP/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/registerPOST注册 IM 用户 (userID + nickname + faceURL)
/user/updatePOST更新用户信息 (昵称/头像同步)
/friend/addPOST添加好友 (无需对方同意模式)
/group/createPOST创建群组 (短剧粉丝群/代理群)
/group/invitePOST邀请用户入群
/msg/sendPOST服务端发送消息 (系统通知/订单通知)
/auth/user_tokenPOST获取用户 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_idint柠檬剧场 fa_user.id (主关联键)
shop_member_idvarchar(64)Lilishop 买家 ID
shop_store_idvarchar(64)Lilishop 商家 ID (代理用户)
im_user_idvarchar(64)OpenIM 用户 ID
created_atint创建时间

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管理后台
HTTPAxios × 3 实例 (dramaApi / shopApi / imApi)全部
状态管理Pinia (auth / menu / im)全部
IM SDKOpenIM 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-api2 Core / 4GB × 1REST API 服务,处理管理请求
openim-ws4 Core / 8GB × 2WebSocket 长连接,承载实时消息
MySQL复用现有 RDS (新 schema)存储用户、好友、群组关系
MongoDB2 Core / 8GB × 1 (或阿里云 MongoDB)消息体存储 (文本/图片/语音等)
Kafka2 Core / 4GB × 3 (集群)消息队列,解耦消息发送与存储
Redis复用现有 Redis (新 db)在线状态缓存、消息序列号
MinIO或复用阿里云 OSSIM 中发送的图片/语音/文件存储
成本优化:如果 IM 用户量初期较小 (< 10 万),可先用 Docker Compose 单机部署全部组件,MySQL 和 Redis 复用现有实例。Kafka 可用 Redis Stream 替代简化部署。MongoDB 是必须新增的组件。

10 柠檬剧场需要的 API 改造清单

改造项说明优先级
CORS + API 格式统一已在 Phase 1 优化中完成P0 已完成
POST /api/auth/login (扩展)登录时同步注册 Lilishop + OpenIM,返回三系统 TokenP0 新增
GET /api/auth/verify验证 Token 有效性+返回 user_mappingP0 新增
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 分阶段实施计划

阶段周期柠檬剧场LilishopOpenIM前端
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 总结与建议

  1. 认证是基石。三系统集成最大的工程难点不是 API 调用,而是统一认证。建议以柠檬剧场 PHP 为认证中心,代理签发 Lilishop JWT 和 OpenIM Token。新增 fa_user_mapping 表维护三系统用户 ID 映射。
  2. 先通后优。OpenIM 先实现基础 IM 能力 (单聊/群聊/系统通知),后续再迭代客服排队、敏感词过滤等高级功能。
  3. MongoDB 是唯一新增存储。MySQL 和 Redis 均复用现有实例。Kafka 初期可用 Redis Stream 简化部署。
  4. IM 用户注册时机。新用户在柠檬剧场注册时异步注册 IM 用户。已有用户提供批量注册脚本。
  5. 管理后台的 IM 功能用 REST API。管理后台不需要 WebSocket 长连接 (不像 APP 需要实时消息)。客服功能使用 OpenIM REST API 轮询或 WebSocket 即可。
  6. 事件驱动的系统联动。用户注册、代理升级、短剧上新等关键事件建议通过 Redis Queue 异步通知其他系统,避免同步调用链路过长。
  7. 保留独立升级能力。三套系统各自独立部署,任何一套系统升级不影响其他系统。前端通过 API 适配层屏蔽后端差异。
一句话总结:以柠檬剧场 PHP 为认证和业务中枢,Lilishop 提供电商能力,OpenIM 提供即时通讯能力。通过 Nginx 统一入口 + Vue 3 统一前端,实现"一个后台、三套系统、用户无感"。核心投入在认证打通和前端开发,后端系统改动最小化。

报告生成: 2026-07-08 | PHP (FastAdmin) + Java (Lilishop) + Go (OpenIM) | 三系统统一后台集成方案