# Tasks: WVP-Platform 迁移到 viewsh-module-video

**Change ID**: `add-video-module-wvp-migration`
**Branch**: `feature/video-module`

---

## Phase 0: 前置检查

- [x] **T0.1** ~~扫描 WVP 源码中的 Java 21 特性~~ — **已完成，无 Java 21 专有语法**，仅 `isBlank()`（Java 11），风险消除
- [ ] **T0.2** 确认 WVP feature 分支的当前状态和内容

## Phase 1: 代码搬迁与包结构调整

- [ ] **T1.1** 从 `C:\workspace\java17\wvp-platform` 复制目标目录到 video-server
  - 复制 `gb28181/`、`media/`、`aiot/`、`streamProxy/`、`streamPush/`、`vmanager/`、`service/`、`common/`、`utils/`
  - 复制 `storager/`（含 RedisCatchStorageImpl，被 67 个文件引用）
  - 复制 `conf/` 中保留的配置类（SipConfig、MediaConfig、UserSetting、redis、websocket、ThreadPool、Schedule、CivilCodeFileConf、VersionConfig）
- [ ] **T1.2** 全局替换包名 `com.genersoft.iot.vmp` → `com.viewsh.module.video`
- [ ] **T1.3** 删除不迁移的文件
  - `conf/security/` 全部
  - `conf/ftpServer/` 全部
  - `conf/MybatisConfig.java`
  - `conf/SpringDocConfig.java`
  - `vmanager/user/` 全部
  - `jt1078/` 全部
  - UserMapper、RoleMapper、UserApiKeyMapper
  - User.java、Role.java、LoginUser.java、JwtUser.java
  - VManageBootstrap.java
- [ ] **T1.4** 复制资源文件
  - `civilCode.csv`（行政区划数据）

## Phase 2: pom.xml 依赖补充 + 配置文件整合（可并行）

- [ ] **T2.1** 在 `viewsh-module-video-server/pom.xml` 添加必须依赖
  - jain-sip-ri 1.3.0-91
  - dom4j
  - okhttp
  - okhttp-digest 3.1.1
  - bouncycastle bcprov-jdk18on 1.78.1
  - fastjson2 + **fastjson2-extension-spring6**（不是 spring5）
  - **不引入 pagehelper-spring-boot-starter**
- [ ] **T2.2** 添加按需依赖
  - paho.mqttv5 1.2.5
  - jts-core 1.18.2
  - cos_api 5.6.227（AI 截图）
- [ ] **T2.3** 在 `viewsh-dependencies/pom.xml` 注册新依赖版本管理
- [ ] **T2.4** 在 application.yaml 中添加 SIP/Media/UserSettings/AI 配置段
- [ ] **T2.5** 在 application-local.yaml 中配置独立 video 数据库连接（`aiot-video`）
- [ ] **T2.6** 配置 `spring.main.allow-circular-references=true`（已有，确认保留）

## Phase 3: RedisTemplate 隔离（必须在编译修复前完成）

- [ ] **T3.1** 改造 WVP 的 `RedisTemplateConfig`，Bean 名改为 `videoRedisTemplate`（不覆盖框架默认 Bean）
- [ ] **T3.2** WVP 内部所有 `@Autowired RedisTemplate` 的地方加 `@Qualifier("videoRedisTemplate")`（涉及 30+ 文件：RedisRpcConfig、RedisCatchStorageImpl 等）

## Phase 4: 多租户配置

- [ ] **T4.1** 在 application.yaml 配置多租户忽略表
  ```yaml
  viewsh:
    tenant:
      ignore-tables:
        - wvp_media_server
  ```
  > 不需要自定义基类，业务表 DO 直接继承 `TenantBaseDO`，共享表 DO 继承 `BaseDO`

## Phase 5: 按域迭代 — 编译修复 + ORM 改造（合并执行）

> Phase 3/4 原本分开的编译修复和 ORM 改造合并为一个阶段，按业务域迭代推进，每个域完成后做一次 mvn compile 验证。

### 5.1 GB28181 域（核心，最先做）
- [ ] **T5.1.1** 修复 gb28181/ 编译错误（认证引用、用户引用、JT1078 引用）
- [ ] **T5.1.2** DO 改造：Device/DeviceChannel/Platform/PlatformChannel/CommonGroup/CommonRegion/DeviceAlarm/DeviceMobilePosition → 加 @TableName、继承 TenantBaseDO
- [ ] **T5.1.3** Mapper 改造：DeviceMapper、DeviceChannelMapper、PlatformMapper、PlatformChannelMapper、GroupMapper、RegionMapper、CommonGBChannelMapper、DeviceAlarmMapper、DeviceMobilePositionMapper → 继承 BaseMapperX，复杂 SQL 保留 @Select
- [ ] **T5.1.4** `mvn compile` 验证 gb28181 域

### 5.2 Media + Storager 域
- [ ] **T5.2.1** 修复 media/ 和 storager/ 编译错误
- [ ] **T5.2.2** DO 改造：MediaServer（继承 BaseDO，无租户）、StreamInfo、CloudRecord/RecordPlan/RecordPlanItem（继承 TenantBaseDO）
- [ ] **T5.2.3** Mapper 改造：MediaServerMapper、CloudRecordServiceMapper、RecordPlanMapper
- [ ] **T5.2.4** `mvn compile` 验证 media + storager 域

### 5.3 StreamProxy + StreamPush 域
- [ ] **T5.3.1** 修复编译错误
- [ ] **T5.3.2** DO + Mapper 改造：StreamProxy、StreamPush
- [ ] **T5.3.3** `mvn compile` 验证

### 5.4 AI 域
- [ ] **T5.4.1** 修复 aiot/ 编译错误
- [ ] **T5.4.2** DO 改造：AiAlert/AiAlgorithm/AiAlgoTemplate/AiRoi/AiRoiAlgoBind/AiCameraSnapshot/AiConfigLog/AiEdgeDevice
- [ ] **T5.4.3** Mapper 改造（全部低复杂度）
- [ ] **T5.4.4** `mvn compile` 验证 AI 域

### 5.5 Vmanager + Service + Common 域
- [ ] **T5.5.1** 修复 vmanager/（去掉 user/）、service/、common/ 编译错误
- [ ] **T5.5.2** `mvn compile` 全量验证通过

### 5.6 硬删除改逻辑删除（跨域）
- [ ] **T5.6.1** 全局搜索 `@Delete` 和 `DELETE FROM`，将 39 处硬删除改为 BaseMapperX 的 `deleteById()` / `delete(wrapper)`
- [ ] **T5.6.2** 排查通道同步、级联取消共享等场景，确认逻辑删除后的业务语义正确

### 5.7 Service 层分页适配（跨域）
- [ ] **T5.7.1** PageHelper.startPage() → MyBatis Plus Page + selectPage()
- [ ] **T5.7.2** PageInfo<T> → PageResult<T>

## Phase 6: 认证与安全整合

- [ ] **T6.1** 更新 SecurityConfiguration，放行 Hook 和公开路径
  - `/index/hook/**` → permitAll（ZLM 回调）
  - `/video/device/query/snap/**` → permitAll（设备快照）
  - `/video/sse/**` → permitAll（SSE 推送）
- [ ] **T6.2** Controller 中用户获取方式替换
  - WVP SecurityUtils → viewsh SecurityFrameworkUtils
- [ ] **T6.3** 删除 WVP 的 `user-settings.interface-authentication` 逻辑

## Phase 7: Controller 路径适配

- [ ] **T7.1** 所有 Controller 移到 `controller/admin/` 包下
- [ ] **T7.2** 调整 @RequestMapping 路径
  - `/api/device/*` → `/video/device/*`
  - `/api/gb28181/*` → `/video/gb28181/*`
  - `/api/common/channel/*` → `/video/channel/*`
  - `/api/ai/*` → `/video/ai/*`
- [ ] **T7.3** Hook 回调 Controller 保持 `/index/hook/*` 路径，网关加透传路由

## Phase 8: 数据库迁移

- [ ] **T8.1** 编写 `aiot-video` 数据库初始化 SQL
  - 基于 WVP `数据库/2.7.4/初始化-mysql-2.7.4.sql`
  - 去掉 user/role/api_key 表和 jt1078 表
  - 业务表加 `tenant_id BIGINT NOT NULL DEFAULT 0`（多租户）
  - 共享表（wvp_media_server）不加 tenant_id
  - 每张表加 `creator VARCHAR(64) DEFAULT ''`, `updater VARCHAR(64) DEFAULT ''`
  - `create_time` / `update_time` 字段类型统一为 `DATETIME`
  - 每张表加 `deleted BIT(1) NOT NULL DEFAULT 0`（逻辑删除）
  - 含唯一索引的表（device、device_channel、platform、media_server、stream_proxy、stream_push、common_group、common_region），将 `deleted` 加入联合唯一索引
- [ ] **T8.2** 导入 AI 模块表（从 `数据库/aiot/初始化-mysql-aiot.sql`）
- [ ] **T8.3** 编写初始化数据（默认媒体服务器配置等）

## Phase 9: 验证与收尾

- [ ] **T9.1** `mvn compile` 全量编译通过
- [ ] **T9.2** VideoServerApplication 启动成功，SIP 端口监听正常
- [ ] **T9.3** Swagger 文档可访问
- [ ] **T9.4** 网关路由验证
- [ ] **T9.5** SIP 设备注册测试
- [ ] **T9.6** 提交并整理 commit history