柠檬剧场 × Lilishop 商城集成方案
PHP 短剧平台 + Java 电商系统 — 统一后台 · 双系统协作
📅 2026-07-08
🔄 PHP (FastAdmin) ↔ Java (Spring Boot)
🔐 统一认证
🎨 Vue 二次开发前端
1 系统现状分析
1.1 柠檬剧场 (当前系统)
| 维度 | 详情 |
| 技术栈 | PHP 7.2+ / FastAdmin (ThinkPHP 5) / MySQL / Redis |
| 认证方式 | 自定义 Token 认证 (Cookie + Header),Auth 类管理 |
| API 响应格式 | {code, msg, time, data} — 非 RESTful 标准 |
| 用户体系 | fa_user 表,支持手机号/微信/小程序多端登录,含邀请/代理/分销体系 |
| 核心业务 | 短剧内容管理、广告投放、金币/余额体系、代理分佣 |
| 管理后台 | AdminLTE + Bootstrap 3 + jQuery + RequireJS |
| 前端入口 | public/admin.php (管理端) + H5/小程序/APP (用户端) |
1.2 Lilishop 商城系统 (待集成)
| 维度 | 详情 |
| 技术栈 | Java 8+ / Spring Boot 2.x / Spring Cloud / MyBatis-Plus / Redis / Elasticsearch |
| 认证方式 | JWT (Spring Security + OAuth2 可扩展) |
| API 响应格式 | {success, code, message, result} — RESTful 风格 |
| 用户体系 | 买家 (Member) + 商家 (Store) + 管理员 (Admin) 三套独立体系 |
| 核心业务 | 商品管理、订单、支付、物流、营销 (优惠券/团购/秒杀)、售后、店铺装修 |
| 管理后台 | Vue 2.x + Element UI (前后端分离) |
| API 入口 | /buyer/* /store/* /admin/* /common/* |
核心矛盾:两套系统的技术栈、认证方式、API 规范、用户体系完全不同。集成不是简单的"调用 API",而是需要在架构层面解决统一认证、API 网关、数据同步三大核心问题。
2 目标集成架构
2.1 总体架构图
┌─────────────────────────────────────────────────────────────────────┐
│ Vue 3 统一管理后台 (新开发) │
│ ┌──────────┐ ┌──────────┐ ┌──────────────────┐ │
│ │ 短剧管理 │ │ 商城管理 │ │ 统一登录/个人中心 │ │
│ │ (内容模块)│ │ (商店模块)│ │ (用户模块) │ │
│ └─────┬────┘ └─────┬────┘ └────────┬─────────┘ │
└────────────────┼─────────────┼────────────────┼────────────────────┘
│ │ │
┌────────────┴─────────────┴────────────────┴────────────┐
│ API Gateway (网关层) │
│ ┌──────────────────────────────────────────────────┐ │
│ │ Nginx / Kong / APISIX │ │
│ │ · 统一入口 · 路由分发 · Token 转换 · 限流 · CORS │ │
│ └──────────────────────────────────────────────────┘ │
└────────┬──────────────────────────────┬────────────────┘
│ │
┌────────┴────────┐ ┌──────────┴──────────┐
│ 柠檬剧场 PHP │ │ Lilishop Java │
│ (内容平台) │ │ (商城平台) │
│ │ │ │
│ API 控制器 │ │ /buyer/* 买家接口 │
│ · User.php │ │ /store/* 商家接口 │
│ · Video.php │ │ /admin/* 管理接口 │
│ · Pay.php │ │ /common/* 公共接口 │
│ · Order.php │ │ │
│ │ │ JWT Auth │
│ Token Auth │ │ MySQL + ES + Redis │
│ MySQL + Redis │ │ │
└─────────────────┘ └─────────────────────┘
2.2 核心设计原则
🔐 统一认证层
新开发 Vue 后台使用统一的登录入口。登录成功后同时获取柠檬剧场的 Token 和 Lilishop 的 JWT,前端双 Token 并存,请求不同后端时自动携带对应 Token。
🚪 API 网关统一入口
Nginx 作为前置网关,按 URL 前缀路由:/api/drama/* → PHP 后端,/api/shop/* → Java 后端。统一 CORS、限流、日志。
📦 数据库独立
柠檬剧场和 Lilishop 各自维护独立数据库。仅在必要时通过 API 同步少量冗余数据(如用户昵称、头像),不建立数据库层面的耦合。
🎨 前端统一体验
Vue 3 新前端完全替代旧的 AdminLTE 后台。同一个 UI 框架、同一个左侧菜单、同一个用户头像下拉。用户感知不到背后是两个独立系统。
3 统一认证方案 (核心难点)
3.1 问题分析
| 对比维度 | 柠檬剧场 PHP | Lilishop Java |
| Token 格式 | 自定义字符串 (存 fa_user_token) | JWT (Header.Payload.Signature) |
| Token 传递 | Cookie 或 Header token | Header Authorization: Bearer xxx |
| 过期机制 | 服务端控制 (可刷新) | JWT 自带 exp 声明 + Refresh Token |
| 用户标识 | user_id (fa_user.id) | memberId / storeId (多角色) |
| 权限模型 | RBAC (fa_auth_group) | Spring Security 注解 + 数据库权限 |
3.2 推荐方案:OAuth2 统一认证中心
搭建轻量级 OAuth2 认证服务 (可基于 PHP 现有 Auth 扩展或独立 Go/Node 服务):
用户登录流程:
Vue 前端 OAuth2 认证中心 柠檬剧场 PHP Lilishop Java
│ │ │ │
│ POST /auth/login │ │ │
│ {username, password} │ │ │
│─────────────────────────────→│ │ │
│ │ 验证用户 (查 fa_user) │ │
│ │─────────────────────────→│ │
│ │←─────────────────────────│ │
│ │ │ │
│ │ 同步/创建 Lilishop 用户 │ │
│ │──────────────────────────────→ │
│ │←────────────────────────────── │
│ │ │ │
│ {access_token, │ │ │
│ drama_token, ←─────────│ │ │
│ shop_jwt} │ │ │
│←─────────────────────────────│ │ │
│ │ │ │
│ 后续请求携带双Token: │ │ │
│ /api/drama/* → drama_token │ │ │
│ /api/shop/* → shop_jwt │ │ │
3.3 简化方案:PHP 代理认证 (快速落地)
如果不想引入独立认证服务,可以在柠檬剧场 PHP 端增加一个 /api/auth/shop-token 端点:
- Vue 前端先调用柠檬剧场
/api/user/login 获取 drama_token
- 前端用 drama_token 调用
/api/auth/shop-token
- PHP 端验证 drama_token 有效后,使用预设的 Lilishop 管理员账号生成 JWT 返回
- 前端拿到 shop_jwt 后,后续商城 API 调用携带此 JWT
推荐:Phase 1 使用简化方案快速上线,Phase 2 根据业务复杂度决定是否升级到 OAuth2 统一认证。
3.4 用户体系映射
| 柠檬剧场角色 | Lilishop 角色 | 权限范围 |
| 平台管理员 (fa_admin) | Lilishop 管理员 (Admin) | 全部:内容管理 + 商城管理 |
| 代理商/总代 (parent_agent) | Lilishop 商家 (Store) | 自己的内容 + 自己的店铺 |
| 普通用户 (fa_user) | Lilishop 买家 (Member) | 看剧 + 购物 (C端) |
| 达人/分销商 | Lilishop 商家 (Store) + 分销员 | 推广短剧 + 分销商品 |
4 API 网关设计
4.1 Nginx 路由配置
# Nginx 配置 — 统一入口
server {
listen 443 ssl;
server_name admin.zgddj.com;
# 柠檬剧场 PHP 后端
location /api/drama/ {
proxy_pass http://127.0.0.1:8080/api/;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
}
# Lilishop Java 后端
location /api/shop/ {
proxy_pass http://127.0.0.1:8888/;
# 去掉 /api/shop 前缀,映射到 Lilishop 原始路径
rewrite ^/api/shop/(.*) /$1 break;
}
# Vue 管理后台前端 (SPA)
location / {
root /var/www/admin-frontend/dist;
try_files $uri /index.html;
}
}
4.2 API 响应格式适配层
两套系统返回格式不同,需要在前端 Axios 拦截器中统一处理:
| 柠檬剧场 | Lilishop | 统一格式 (前端) |
| 成功标识 | code == 1 | success == true | code == 200 |
| 数据字段 | data | result | data |
| 消息字段 | msg | message | message |
| 分页格式 | {total, rows} | {total, records, pages} | {total, list, page} |
// Axios 拦截器伪代码
api.interceptors.response.use(res => {
const url = res.config.url;
if (url.startsWith('/api/drama/')) {
return { code: res.data.code === 1 ? 200 : res.data.code, message: res.data.msg, data: res.data.data };
}
if (url.startsWith('/api/shop/')) {
return { code: res.data.success ? 200 : res.data.code, message: res.data.message, data: res.data.result };
}
});
5 前端集成方案
5.1 技术选型
| 层级 | 选型 | 说明 |
| 框架 | Vue 3 + TypeScript | 与 Lilishop 官方后台 (Vue 2) 同一生态,升级到 Vue 3 |
| UI 库 | Element Plus | Element UI 的 Vue 3 版本,与 Lilishop 风格一致 |
| 构建 | Vite | 替代 Webpack,开发体验大幅提升 |
| 状态管理 | Pinia | 管理双 Token、用户信息、菜单权限 |
| 路由 | Vue Router 4 | 根据用户角色动态生成菜单 (内容管理 / 商城管理) |
| HTTP | Axios (双实例) | dramaApi + shopApi,各自独立 baseURL 和拦截器 |
5.2 前端项目结构
admin-frontend/
├── src/
│ ├── api/
│ │ ├── drama/ # 柠檬剧场 API 封装
│ │ │ ├── user.ts # 用户管理
│ │ │ ├── video.ts # 短剧管理
│ │ │ ├── ad.ts # 广告管理
│ │ │ └── finance.ts # 财务管理
│ │ └── shop/ # Lilishop API 封装
│ │ ├── goods.ts # 商品管理
│ │ ├── order.ts # 订单管理
│ │ ├── store.ts # 店铺管理
│ │ └── marketing.ts# 营销活动
│ ├── views/
│ │ ├── drama/ # 短剧管理页面
│ │ ├── shop/ # 商城管理页面
│ │ ├── dashboard/ # 统一工作台
│ │ └── login/ # 统一登录
│ ├── stores/
│ │ ├── auth.ts # 双 Token 管理
│ │ └── menu.ts # 动态菜单生成
│ └── utils/
│ ├── request-drama.ts# dramaApi 实例
│ └── request-shop.ts # shopApi 实例
5.3 动态菜单设计
左侧菜单根据登录用户的角色动态生成:
平台管理员登录:
📊 工作台
📺 内容管理 (柠檬剧场)
├── 短剧列表
├── 剧集管理
├── 分类管理
└── 广告管理
🏪 商城管理 (Lilishop)
├── 商品管理
├── 订单管理
├── 店铺管理
└── 营销中心
👤 系统管理
├── 用户管理
└── 权限管理
代理商/商家登录:
📊 工作台
📺 我的内容 (仅自己的短剧)
🏪 我的店铺 (仅自己的店铺)
💰 收益管理
6 业务联动场景设计
🛒 短剧带货
短剧详情页嵌入商品卡片。用户看剧时可直接点击购买同款商品。通过短剧 ID ↔ 商品 ID 关联实现。PHP 提供短剧信息,Java 提供商品详情和下单。
🎁 看剧领优惠券
用户观看短剧达到一定集数后,触发 Lilishop 发券接口。PHP 端检测观看进度 → 调用 Java /promotion/coupon/send。
💰 金币抵现
用户在柠檬剧场积累的金币,可在商城下单时抵扣现金。PHP 提供 /api/user/coin-deduct 接口,Java 下单时调用扣减。
🏪 代理商开店
柠檬剧场的代理/总代用户,自动在 Lilishop 开通店铺。PHP 用户注册为代理 → 异步调用 Java /store/register 创建店铺。
📊 统一数据看板
Dashboard 聚合两套系统的核心指标:短剧播放量/收益 + 商城订单量/GMV。通过定时任务汇总或 API 聚合实现。
🔔 统一消息通知
短剧更新 + 订单状态变更,统一推送到用户端。可复用柠檬剧场现有的短信/推送通道。
7 数据同步策略
| 数据 | 主系统 | 同步方向 | 方式 | 频率 |
| 用户基础信息 |
柠檬剧场 PHP |
PHP → Java |
注册/登录时 API 同步 (nickname, avatar, mobile) |
实时 |
| 用户金币/余额 |
柠檬剧场 PHP |
双向 |
下单时 PHP 扣金币,退款时 PHP 加金币。Java 保持只读缓存 |
实时 |
| 商品与短剧关联 |
两端各自维护 |
关联表在 PHP |
新增 fa_drama_goods_relation 表存储关联关系 |
按需 |
| 订单与分佣 |
Lilishop Java |
Java → PHP |
订单完成后回调 PHP 分佣接口 |
异步 |
| 统计报表 |
两端独立 |
聚合层 |
定时任务汇总到独立统计表或 ClickHouse |
T+1 |
关键原则:不建立跨数据库的外键或 JOIN。所有跨系统数据关联通过 API 调用实现,关联键使用业务 ID (user_id, goods_id) 而非数据库主键。
8 柠檬剧场需要的 API 改造
| 改造项 | 当前状态 | 目标 | 优先级 |
| CORS 标准化 |
当前 header('Access-Control-Allow-Origin:*') 过于宽松 |
通过 Nginx 统一处理,限制为 admin.zgddj.com |
P0 |
| API 响应格式统一 |
{code:1, msg, time, data} |
已完成 (Phase 1 优化) — 与前端约定一致 |
P0 |
| 新增 Token 验证接口 |
无 |
GET /api/auth/verify → 验证 token 有效性并返回用户信息 |
P0 |
| 新增代理开店回调 |
无 |
代理注册时异步调用 Lilishop 创建店铺 |
P1 |
| 新增金币扣减接口 |
逻辑在控制器内 |
封装为独立 Service 方法,支持外部调用 |
P1 |
| 新增商品关联接口 |
无 |
POST /api/drama/goods/bind — 短剧绑定商品 |
P1 |
| API 文档 |
无 |
Swagger / Apifox 文档 — 供前端和 Lilishop 对接方参考 |
P2 |
| 统一异常处理 |
已完成 (Phase 3 优化) |
保证异常时返回一致的 JSON 格式 |
P2 |
9 实施路线图
| 阶段 | 周期 | 任务 | 交付物 |
| Phase 0: 环境准备 |
1 周 |
部署 Lilishop Java 环境 (JDK/MySQL/Redis/ES);配置 Nginx 反向代理;柠檬剧场 PHP 完成 Phase 1 优化 (API 格式统一) |
Lilishop 可独立访问;两系统均可通过 Nginx 访问 |
| Phase 1: 认证打通 |
2 周 |
PHP 新增 /api/auth/shop-token;前端 Axios 双实例;统一登录页面;Token 存储方案 |
用户一次登录即可访问内容管理和商城管理 |
| Phase 2: 前端框架搭建 |
3 周 |
Vue 3 + Element Plus 项目初始化;动态菜单;Dashboard 聚合页;左侧导航框架 |
统一后台框架上线,包含两个模块入口 |
| Phase 3: 内容管理迁移 |
3 周 |
短剧列表/编辑、用户管理、财务管理 → Vue 页面迁移;对接 PHP API |
内容管理模块在 Vue 后台可用 |
| Phase 4: 商城管理集成 |
3 周 |
商品管理、订单管理、店铺管理 → Vue 页面开发;对接 Lilishop API;业务联动 (金币抵现/看剧发券) |
商城管理模块在 Vue 后台可用 |
| Phase 5: 优化与上线 |
2 周 |
性能优化、灰度发布、旧 AdminLTE 后台下线、文档完善 |
全面切换至新后台 |
总工期预估:14 周 (约 3.5 个月)。Phase 0-1 可与之前的"PHP 单体优化 Phase 1-2"并行推进,不重复占用时间。
10 风险与注意事项
| 风险 | 等级 | 缓解措施 |
| 两套系统 Token 过期时间不一致 |
中 |
前端 Axios 拦截器统一处理 401,自动刷新 Token 或跳转登录 |
| Lilishop API 版本升级不兼容 |
中 |
锁定 Lilishop 版本;在 shopApi 层做适配,不直接暴露原始 API |
| 双系统事务一致性 |
高 |
金币抵现场景:先扣 PHP 金币 → 再创建 Java 订单。失败时回滚 PHP 金币 (补偿事务) |
| 前端开发复杂度 |
中 |
双 API 实例的拦截器、错误处理需充分测试;建议编写 E2E 测试 |
| Lilishop 与柠檬剧场用户 ID 不匹配 |
中 |
在认证中心维护 user_mapping 表:drama_user_id ↔ shop_member_id |
11 总结与建议
- 不要强行"合并"数据库。两个系统各自维护独立数据库,通过 API 解耦。强行合并会导致任何一方的升级都牵动另一方。
- 统一认证是最大难点。建议 Phase 1 使用简化方案 (PHP 代理发 JWT) 快速上线,后续评估是否需要独立 OAuth2 服务。
- 前端先搭框架,再填内容。Vue 3 项目初始化、动态菜单、双 Token 管理是基础设施,必须优先完成。后续页面迁移可以逐步进行。
- 旧 AdminLTE 后台不要立即下线。新 Vue 后台和老后台通过不同 URL 共存至少 2 周,确保运营团队适应后再切换。
- 金币抵现场景必须做补偿事务。这是唯一涉及资金的跨系统操作,需要仔细设计回滚逻辑和每日对账。
- 优先改造柠檬剧场 API。在 Lilishop 部署完成前,先把柠檬剧场的 API 格式统一、CORS 规范、Token 验证接口完成,这些是集成的前提条件。
一句话总结:通过 API 网关 + 统一认证 + Vue 3 新前端,实现"一个后台、两套系统、无感切换"。关键是做好认证打通和 API 适配层,保持两套后端独立演进。
报告生成: 2026-07-08 | PHP (FastAdmin) ↔ Java (Lilishop Spring Boot) | 统一后台集成方案