柠檬剧场 × 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 问题分析

对比维度柠檬剧场 PHPLilishop Java
Token 格式自定义字符串 (存 fa_user_token)JWT (Header.Payload.Signature)
Token 传递Cookie 或 Header tokenHeader 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 端点:

  1. Vue 前端先调用柠檬剧场 /api/user/login 获取 drama_token
  2. 前端用 drama_token 调用 /api/auth/shop-token
  3. PHP 端验证 drama_token 有效后,使用预设的 Lilishop 管理员账号生成 JWT 返回
  4. 前端拿到 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 == 1success == truecode == 200
数据字段dataresultdata
消息字段msgmessagemessage
分页格式{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 PlusElement UI 的 Vue 3 版本,与 Lilishop 风格一致
构建Vite替代 Webpack,开发体验大幅提升
状态管理Pinia管理双 Token、用户信息、菜单权限
路由Vue Router 4根据用户角色动态生成菜单 (内容管理 / 商城管理)
HTTPAxios (双实例)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 总结与建议

  1. 不要强行"合并"数据库。两个系统各自维护独立数据库,通过 API 解耦。强行合并会导致任何一方的升级都牵动另一方。
  2. 统一认证是最大难点。建议 Phase 1 使用简化方案 (PHP 代理发 JWT) 快速上线,后续评估是否需要独立 OAuth2 服务。
  3. 前端先搭框架,再填内容。Vue 3 项目初始化、动态菜单、双 Token 管理是基础设施,必须优先完成。后续页面迁移可以逐步进行。
  4. 旧 AdminLTE 后台不要立即下线。新 Vue 后台和老后台通过不同 URL 共存至少 2 周,确保运营团队适应后再切换。
  5. 金币抵现场景必须做补偿事务。这是唯一涉及资金的跨系统操作,需要仔细设计回滚逻辑和每日对账。
  6. 优先改造柠檬剧场 API。在 Lilishop 部署完成前,先把柠檬剧场的 API 格式统一、CORS 规范、Token 验证接口完成,这些是集成的前提条件。
一句话总结:通过 API 网关 + 统一认证 + Vue 3 新前端,实现"一个后台、两套系统、无感切换"。关键是做好认证打通和 API 适配层,保持两套后端独立演进。

报告生成: 2026-07-08 | PHP (FastAdmin) ↔ Java (Lilishop Spring Boot) | 统一后台集成方案