旧项目前端代码迁移分析报告

分析日期:2026-06-15 · 旧柠檬剧场 → 新 Drama-Fusion 架构 · 工作区 /root

一、执行摘要

核心结论不建议 整体迁移旧前端代码。新旧架构差异巨大,直接迁移成本远超重写。建议采用分层渐进策略:保留旧 APK 壳 + 新后端 API,用新 uni-app 项目逐步替换页面。
旧项目规模60 个页面 + 18 个 API 模块 + Android 原生壳(8 个 native 插件)
新项目现状11 个页面(uni-app)+ 40 个管理后台页面(Vue3)+ 9 个微服务后端
已验证可行旧 APK 壳 + 新后端 API → 微信登录全链路通过

二、旧项目架构分析

2.1 项目组成

组件路径规模技术栈
Android 原生壳/home/project/1/LemonPlayAndroid2/8 个 native 模块Java/Kotlin, Gradle, CSJ AD/DJ SDK, 火山引擎, 百度 LBS, Bugly, 风控
uni-app 前端/home/project/2/zuo-drama-web/60 页面 + 18 APIVue 2, uni-app, SCSS, ThinkPHP 加密协议
旧 PHP 后端/home/project/houtai/ThinkPHP 5 + FastAdmin单一入口 /api/advertising/allapi, RSA 加密, fa_* 表

2.2 旧前端页面分布(60 页)

核心业务(13 页)

App_login5 页登录/注册/隐私
App_home3 页首页/更多
App_theater4 页剧场/详情
App_player1 页播放器

扩展功能(47 页)

App_mine/member/chat4 页个人中心
App_wallet/exchange3 页钱包/兑换
App_invite/channel3 页邀请/渠道
App_cart/checkout/product3 页电商
App_adolescent/tutelage3 页青少年模式
App_splash/ads3 页闪屏广告
其他28 页设置/搜索/浏览/客服等

2.3 旧前端 API 模块(18 个,96+ 接口调用)

模块调用数功能域迁移状态
mine.js21个人中心(资料/收藏/浏览/钱包/邀请)部分
appSet.js18系统配置(OSS/RSA/版本/推送/启动日志)已覆盖
video.js13视频播放(列表/详情/弹幕/点赞/追剧)部分
ads.js8广告(点位/记录/激励/控制)已覆盖
login.js6登录(微信/手机/Apple/一键登录)已覆盖
chatGroup.js5聊天群组部分
home.js4首页已覆盖
share/theater/welfare4+4+4分享/剧场/福利部分
其他 8 个模块1~2渠道/评论/商城/会员/支付/注册/子女未迁移

2.4 Android 原生插件(8 个)

插件模块功能新壳需要?
athree_CSJAD穿山甲广告 SDK(开屏/激励/Banner)是
athree_CSJDJ穿山甲短剧 SDK(播放/点赞/收藏)是
volc_sdk火山引擎(设备指纹/风险检测/VPN/SIM)是
riskcontroltools风控工具(WiFi BSSID/无障碍/App列表/DNS)是
baiduLBS百度定位 SDK否
bugly腾讯 Bugly 崩溃上报否
adSparkAdSpark 广告聚合是
azVideoView自定义视频播放器是

三、新架构现状

3.1 三层架构

┌─────────────────────────────────────────────────────┐
│  前端层                                              │
│  ├─ uni-app 新壳 (11页)  drama-uniapp/src/pages/     │
│  ├─ 管理后台 (40页)       drama-frontend-admin-portal │
│  └─ 旧 APK 壳 (兼容)      drama-fusion-login-v8-diag │
├─────────────────────────────────────────────────────┤
│  网关层 (8080)                                       │
│  ├─ LegacyController  (13 个旧 API 全兼容)            │
│  └─ 8 个微服务路由                                    │
├─────────────────────────────────────────────────────┤
│  微服务层                                             │
│  ├─ user(8101)  content(8102)  rec(8103)  ad(8104)   │
│  ├─ trade(8106) coin(8107)   risk(8108)  payment(8109)│
│  └─ 全 RESTful API + JWT 认证                         │
└─────────────────────────────────────────────────────┘

3.2 新旧前端对比

维度旧项目 (zuo-drama-web)新项目 (drama-uniapp)
页面数60(含 15 个 weex/nvue 原生页)11(纯 Vue 3 页面)
API 模块18 个(ThinkPHP 加密协议)7 个(RESTful JSON)
状态管理无(uni.setStorageSync 直接读写)3 个 Pinia stores
构建工具HBuilderX CLI(SCSS 编译问题多)Vite 5(rpx→px 插件)
Vue 版本Vue 2(uni-app 旧版)Vue 3 Composition API
原生插件8 个(CSJ AD/DJ, 火山, 百度等)0(尚未集成)
主题橙色 (#FF6300)紫色 (#7c3aed)
本地预览无:5176 可用

四、迁移可行性评估

4.1 不可直接迁移的根因

#阻断项影响范围
1API 协议不兼容:旧代码 96+ 处 API 调用全部走 ThinkPHP 加密协议(/api/advertising/allapi + RSA),新后端是 RESTful JSON全部 18 个 API 模块
2Vue 版本差异:旧代码 Vue 2 + Options API,新项目 Vue 3 + Composition API + script setup全部 60 个页面
3原生插件依赖:旧壳有 8 个 native 插件(广告/风控/播放器/定位),新 uni-app 壳未集成Android 原生层
4构建系统差异:HBuilderX CLI(需专用 IDE)vs Vite(标准工具链),SCSS 编译插件不兼容构建流程
5存储方案差异:旧代码 uni.setStorageSync 分散读写,无类型安全状态管理
6路由系统差异:旧 pages.json(含 tabBar/nvue),新 pages.json(纯 Vue 页面)页面导航

4.2 逐模块迁移评估

旧页面模块页数迁移难度建议
App_login(登录)5低已有新 login 页面,无需迁移
App_home(首页)3低新 dramas 页面替代
App_player(播放器)1中需要 native 播放器插件
App_theater(剧场)4中核心业务,需重写
App_cart/checkout/product3低已有新 cart/checkout/product
App_mine(我的)1中新 profile 页面可扩展
App_chat(聊天)2中已有新 chat 页面
App_wallet/exchange3高金币/提现/兑换,业务复杂
App_invite(邀请)3高邀请码/二维码/下级树
App_member(会员)2高会员体系+充值
App_splash(闪屏)3高依赖 CSJ AD native 插件
App_adolescent/tutelage3高青少年模式+监护密码
其他(17 个模块)28中-高设置/搜索/浏览/客服/关于等

五、推荐方案

5.1 方案:分层渐进(推荐)

阶段做法时间
第 1 层:壳复用旧 Android 壳 + 旧 uni-app 登录页 → 新后端 API。当前诊断 APK 已验证可行。已完成
第 2 层:管理后台40 个 Vue3 管理页面,全后端功能可配置。已完成
第 3 层:C 端新壳基于新 uni-app 项目(11 页),补齐核心页面:钱包/邀请/会员/闪屏2-3 周
第 4 层:Native 插件在新壳中集成 CSJ AD/DJ、火山引擎、风控 tools1-2 周
第 5 层:功能对齐逐模块用新页面替换旧壳页面,双版本并行灰度4-6 周
核心策略:不迁移旧代码,而是在新架构上重写页面。旧代码的 Vue2/SCSS/ThinkPHP 协议三大技术债一次性解决。新 uni-app 项目(Vue3+Vite+RESTful)是干净的起点。
⚠️ 为什么不能直接迁移:旧代码 96+ 处 API 调用全部用 ThinkPHP 加密格式({controller, api_name, data} + RSA 加密)。要迁移需逐一改写为 RESTful JSON——这个工作量等价于重写。且 Vue2→Vue3、SCSS→CSS 的适配叠加,成本远超新建。

六、关键文件索引

旧 Android 壳/home/project/1/LemonPlayAndroid2/
旧 uni-app 源码/home/project/2/zuo-drama-web/
新 uni-app 项目/root/drama-fusion-platform/drama-uniapp/
管理后台/root/drama-fusion-platform/drama-frontend-admin-portal/
诊断 APK/root/drama-fusion-login-v8-diag.apk
后端 LegacyControllerdrama-user-service/.../LegacyController.java
旧项目对比参考/root/project_compare/

Report generated 2026-06-15 · DeepSeek TUI Agent · Workspace /root