# 视频监控改造 - 共识文档

## 1. 需求描述
### 1.1 功能模块
将视频监控系统改造为三个版块：

#### 1.1.1 轮巡版块
- **布局**：支持多种宫格排列方式（3x3, 3x4, 4x4, 5x5等）
- **功能**：用户可以自行选择宫格排列方式
- **操作**：保持原有视频墙的操作方式
- **适用场景**：正常情况下使用

#### 1.1.2 追踪版块
- **布局**：一主六副的方式排列
- **功能**：用于跟踪异常事物
- **操作**：自动切换，无需手动操作
- **适用场景**：发现异常时使用

#### 1.1.3 特情版块
- **布局**：左侧70%显示一主六副监控画面，右侧30%显示特情处置预案
- **功能**：用于处理特殊情况
- **操作**：自动切换，无需手动操作
- **适用场景**：出现特情时使用

### 1.2 自动切换逻辑
- **正常状态**：显示轮巡版块
- **异常状态**：自动切换到追踪版块
- **特情状态**：自动切换到特情版块
- **状态切换**：可以通过API或事件触发

## 2. 技术实现方案
### 2.1 前端框架
- 使用现有Vue 3 + TypeScript + Vite技术栈
- 基于Element Plus组件库开发
- 使用Pinia进行状态管理

### 2.2 核心组件改造
1. **VideoWall.vue**改造：
   - 添加三个版块的布局模板
   - 实现版块切换逻辑
   - 保持原有功能完整性

### 2.3 数据流转
1. **轮巡版块**：
   - 用户选择布局 → 切换视频墙布局 → 显示对应宫格的视频画面

2. **追踪版块**：
   - 外部事件触发异常 → 自动切换到追踪版块 → 显示一主六副监控画面

3. **特情版块**：
   - 外部事件触发特情 → 自动切换到特情版块 → 左侧显示一主六副监控画面，右侧显示特情处置预案

## 3. 验收标准
1. **轮巡版块**：
   - 支持多种宫格排列方式
   - 布局切换功能正常
   - 视频画面显示正常

2. **追踪版块**：
   - 一主六副布局显示正常
   - 主画面和副画面比例协调
   - 自动切换功能正常

3. **特情版块**：
   - 左右分栏布局显示正常（7:3比例）
   - 左侧一主六副监控画面显示正常
   - 右侧特情处置预案显示正常
   - 自动切换功能正常

4. **自动切换逻辑**：
   - 正常状态显示轮巡版块
   - 异常状态自动切换到追踪版块
   - 特情状态自动切换到特情版块
   - 状态切换响应及时

5. **原有功能**：所有原有功能保持正常运行

## 4. 技术约束
1. **API兼容性**：保持与现有后端API的兼容性，不修改API接口
2. **性能要求**：页面加载时间不超过3秒，交互响应时间不超过500ms
3. **用户体验**：操作流程简洁明了，减少用户点击次数
4. **代码质量**：保持原有代码风格和架构，添加必要的注释

## 5. 依赖关系
- 依赖现有VideoWall组件
- 依赖现有视频监控功能
- 依赖Element Plus组件库

## 6. 风险评估
1. **布局适配**：不同屏幕尺寸下的布局适配
2. **性能问题**：多个视频画面同时显示可能导致性能问题
3. **状态管理**：三个版块的状态切换逻辑需要清晰可靠
4. **特情处置预案**：数据来源和格式需要明确

## 7. 项目计划
- **启动时间**：2025-12-25
- **完成时间**：2025-12-26
- **测试时间**：2025-12-26
- **交付时间**：2025-12-26