旧项目前端代码迁移分析报告
分析日期: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 API | Vue 2, uni-app, SCSS, ThinkPHP 加密协议 |
| 旧 PHP 后端 | /home/project/houtai/ | ThinkPHP 5 + FastAdmin | 单一入口 /api/advertising/allapi, RSA 加密, fa_* 表 |
2.2 旧前端页面分布(60 页)
核心业务(13 页)
| App_login | 5 页 | 登录/注册/隐私 |
| App_home | 3 页 | 首页/更多 |
| App_theater | 4 页 | 剧场/详情 |
| App_player | 1 页 | 播放器 |
扩展功能(47 页)
| App_mine/member/chat | 4 页 | 个人中心 |
| App_wallet/exchange | 3 页 | 钱包/兑换 |
| App_invite/channel | 3 页 | 邀请/渠道 |
| App_cart/checkout/product | 3 页 | 电商 |
| App_adolescent/tutelage | 3 页 | 青少年模式 |
| App_splash/ads | 3 页 | 闪屏广告 |
| 其他 | 28 页 | 设置/搜索/浏览/客服等 |
2.3 旧前端 API 模块(18 个,96+ 接口调用)
| 模块 | 调用数 | 功能域 | 迁移状态 |
mine.js | 21 | 个人中心(资料/收藏/浏览/钱包/邀请) | 部分 |
appSet.js | 18 | 系统配置(OSS/RSA/版本/推送/启动日志) | 已覆盖 |
video.js | 13 | 视频播放(列表/详情/弹幕/点赞/追剧) | 部分 |
ads.js | 8 | 广告(点位/记录/激励/控制) | 已覆盖 |
login.js | 6 | 登录(微信/手机/Apple/一键登录) | 已覆盖 |
chatGroup.js | 5 | 聊天群组 | 部分 |
home.js | 4 | 首页 | 已覆盖 |
share/theater/welfare | 4+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 崩溃上报 | 否 |
adSpark | AdSpark 广告聚合 | 是 |
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 不可直接迁移的根因
| # | 阻断项 | 影响范围 |
| 1 | API 协议不兼容:旧代码 96+ 处 API 调用全部走 ThinkPHP 加密协议(/api/advertising/allapi + RSA),新后端是 RESTful JSON | 全部 18 个 API 模块 |
| 2 | Vue 版本差异:旧代码 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/product | 3 | 低 | 已有新 cart/checkout/product |
| App_mine(我的) | 1 | 中 | 新 profile 页面可扩展 |
| App_chat(聊天) | 2 | 中 | 已有新 chat 页面 |
| App_wallet/exchange | 3 | 高 | 金币/提现/兑换,业务复杂 |
| App_invite(邀请) | 3 | 高 | 邀请码/二维码/下级树 |
| App_member(会员) | 2 | 高 | 会员体系+充值 |
| App_splash(闪屏) | 3 | 高 | 依赖 CSJ AD native 插件 |
| App_adolescent/tutelage | 3 | 高 | 青少年模式+监护密码 |
| 其他(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、火山引擎、风控 tools | 1-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 |
| 后端 LegacyController | drama-user-service/.../LegacyController.java |
| 旧项目对比参考 | /root/project_compare/ |
Report generated 2026-06-15 · DeepSeek TUI Agent · Workspace /root