📋 旧系统短剧管理模块分析报告
项目:柠檬剧场 (lemon_import) · 分析日期:2026-07-02 · 目的:为新项目 drama-fusion-platform 重构提供参考
1. 数据模型
1.1 短剧主表 — fa_videolist
| 字段 | 类型 | 说明 | 新系统映射 |
| id | int(11) PK | 主键 | t_drama.id |
| name | varchar(255) | 短剧名称 | t_drama.title |
| ym | varchar(20) | 年月分组 (按月聚合展示) | — 新系统无此需求 |
| source | tinyint(1) | 来源:1=自有 2=穿山甲SDK | t_drama.external_source |
| shortplay_id | int(11) | 外部平台短剧ID | t_drama.external_id |
| channel | tinyint(1) | 频道:1=男频 2=女频 | t_drama.category |
| is_vip | tinyint(1) | VIP专享 | t_drama.is_vip |
| ishot | int(1) | 热门标记 | t_drama.hot_score |
| check_status | tinyint(1) | ⭐ 审核状态:1=待审 2=审核中 3=拒绝 4=通过 | t_drama.audit_status |
| check_time / check_desc | int / varchar | 审核时间/说明 | t_drama.audit_reason |
| status | varchar(30) | normal/hidden | t_drama.status (1/0) |
| put_time | int(11) | 定时上架时间戳 | — 待定 |
| free_episodes | int(11) | 免费试看集数 | t_drama.free_episodes |
| price / vipprice | decimal | 价格 | — 移到支付模块 |
| sum | int(11) | 总集数 | t_drama.total_episodes |
| views / give / forward | int(11) | 播放/点赞/转发 | t_drama.click_rate |
| img / image | varchar(255) | 封面图URL | t_drama.cover |
| story / icp_name | varchar(500) | 简介 / ICP备案 | t_drama.description / icp_record |
| producer / director / starred | varchar | 制片/导演/主演 | — 建议新系统增加 |
| nav | varchar(255) | 分类IDs (逗号多选) | t_drama.category (单值) |
| weigh | int(11) | 排序权重 | — 建议保留 |
1.2 剧集表 — fa_video
| 字段 | 类型 | 说明 | 新系统映射 |
| id | int(11) PK | 主键 | t_episode.id |
| pid | int(11) FK | 关联短剧ID | t_episode.drama_id |
| name | varchar(50) | 剧集名称 | t_episode.title |
| videourl | varchar(255) | 视频地址 | t_episode.video_url |
| img | varchar(255) | 剧集封面 | t_episode.cover |
| price / vipprice | decimal | 价格 | — 移到支付 |
| weigh | int(11) | 排序(集序) | t_episode.ep_num |
| duration | varchar(32) | 时长 | t_episode.duration |
| status | varchar(30) | normal/hidden | t_episode.status |
2. 业务规则引擎
2.1 审核流转
审核状态 (check_status):
1 → 待审核 (CP提交后)
2 → 审核中
3 → 已拒绝 (含 check_desc 原因)
4 → 已通过 (进入展示)
上架条件: status='normal' AND check_status=4 AND put_time ≤ NOW() AND lx=1
1 待审核 →
2 审核中 →
4 通过 |
3 拒绝
2.2 内容源 (source) 八种类型
| source | 说明 | 排序逻辑 |
| 1 | 全部 | weigh ASC, put_time DESC |
| 2 | 新剧 | 同1 |
| 3 | VIP专享 | is_vip=1 |
| 4 | 排行榜 | (views*1+visit*2+like*3) DESC |
| 5 | 文旅 | travel=1 |
| 6 | 经典好剧 | 排除青少年(nav≠130) |
| 7 | 青少年模式 | 特定分类 |
| 8 | 穿山甲SDK | source=2, shortplay_id≠0 |
2.3 播放权限 (复杂)
pays = 1(不可看) / 2(可看)
用户VIP: group_id>1 AND dtime≥now → pays=2
分集免费: beans=0 → pays=2
VIP免费: vipprice=0 AND VIP → pays=2
全章购买: video_order(lx=1) → pays=2
单集购买: video_order(lx=2, smid=epId) → pays=2
全集免费: price=0 → pays=2
分享链接(VideoShare): free_num集免费, 超额 pay_beans 金币
3. API 端点映射
| 旧系统 | 功能 | 新系统对应 |
POST /api/video/index | 热门短剧 (ishot=2) | GET /api/content/dramas |
POST /api/video/videoRecommend | 个性化推荐 | GET /api/rec/feed |
POST /api/video/videoinfo | 详情+分集+权限 | GET /api/content/dramas/:id |
POST /api/video/bfjl | 播放记录 | POST /api/user/behavior |
POST /api/video/zuiju | 追剧+签到 | GET /api/user/profile/report |
4. 新旧对比 & 迁移建议
| 维度 | 旧系统 (ThinkPHP) | 新系统 (Spring Boot) |
| 分类体系 | nav逗号多选 + channel双轨 | category 单值 |
| 审核流 | 4级 check_status | 3级 audit_status |
| 播放权限 | 6条件复合判断 | 分集属性 + 支付模块 |
| 排行榜 | views+point_log复合 | hot_score 单字段 |
| 外部短剧 | source=2 + shortplay_id | external_source + external_id |
| 优先级 | 任务 |
| P0 | fa_videolist→t_drama / fa_video→t_episode 数据迁移脚本 |
| P0 | nav逗号分隔 → category单值映射规则 |
| P1 | check_status 4级 → audit_status 3级转换 |
| P1 | 播放权限逻辑迁移到支付模块 |
| P2 | 分享链接(VideoShare)、角标(Cornermark)、文旅(travel) |
5. 文件清单 & 数据流
| 文件 | 作用 |
application/common/model/Videolist.php | 短剧ORM (关联User/Cornermark) |
application/common/service/VideolistService.php | 核心业务逻辑 (分页/排序/缓存) |
application/api/controller/Video.php | 用户端API (推荐/详情/追剧) |
application/admin/controller/video/Vidseriesdata.php | 管理后台 剧集数据分析 |
application/admin/validate/video/Check.php | 审核验证规则 |
CP后台 → fa_videolist(check_status:1→2) → 审核(3拒绝/4通过)
↓ 通过(status=normal, lx=1, put_time≤now)
用户APP ← VideolistService(过滤/排序/缓存)
├ videoRecommend (推荐) ├ videoinfo (详情+权限)
├ bfjl (播放记录) └ zuiju (追剧+签到)
6. 风险提示
- ⚠️ nav 逗号多选:旧系统分类用逗号分隔 (如 "125,130"),新系统 category 是单值,迁移需确定主分类映射规则
- ⚠️ price/vipprice 双表冗余:价格在 fa_videolist 和 fa_video 都有,新系统需统一到支付模块
- ⚠️ put_time 定时上架:新系统暂不支持未来上架时间
- ⚠️ ~50字段大量废弃:yearq/adddd/tp/yyid 等已弃用,迁移只取核心20+字段
报告生成 2026-07-02 · 旧系统 /home/project/houtai/app.zgddj.com