feat: 添加双人对练功能

- 新增数据库迁移脚本 (practice_rooms, practice_room_messages) - 新增后端 API: 房间创建/加入/消息同步/报告生成 - 新增前端页面: 入口页/对练房间/报告页 - 新增 AI 双人评估服务和提示词
2026-01-28 15:20:03 +08:00
parent fc299ed7b7
commit b6aea2e23d
14 changed files with 4195 additions and 0 deletions
--- a/backend/migrations/README.md
+++ b/backend/migrations/README.md
@@ -0,0 +1,82 @@
+# 数据库迁移说明
+
+## 目录结构
+
+```
+migrations/
+├── README.md          # 本说明文件
+└── versions/
+    └── add_practice_rooms_table.sql   # 双人对练功能迁移脚本
+```
+
+## 迁移脚本列表
+
+### 1. add_practice_rooms_table.sql
+
+**功能**：双人对练功能数据库结构
+
+**新增表**：
+- `practice_rooms` - 对练房间表
+- `practice_room_messages` - 房间实时消息表
+
+**修改表**：
+- `practice_dialogues` - 新增 `user_id`, `role_name`, `room_id`, `message_type` 字段
+- `practice_sessions` - 新增 `room_id`, `participant_role`, `session_type` 字段
+- `practice_reports` - 新增 `room_id`, `user_id`, `report_type`, `partner_feedback`, `interaction_score` 字段
+
+## 执行方法
+
+### 方法一：直接登录 MySQL 执行
+
+```bash
+# 1. 登录 MySQL
+docker exec -it kpl-mysql-dev mysql -uroot -p
+
+# 2. 选择数据库
+USE kaopeilian;
+
+# 3. 复制并执行 SQL 脚本内容
+# 或使用 source 命令执行脚本文件
+```
+
+### 方法二：使用 docker exec 执行
+
+```bash
+# 1. 将 SQL 文件复制到容器
+docker cp migrations/versions/add_practice_rooms_table.sql kpl-mysql-dev:/tmp/
+
+# 2. 执行迁移
+docker exec -i kpl-mysql-dev mysql -uroot -pYourPassword kaopeilian < /tmp/add_practice_rooms_table.sql
+```
+
+### 方法三：远程 SSH 执行
+
+```bash
+# SSH 到服务器后执行
+ssh user@your-server "docker exec -i kpl-mysql-dev mysql -uroot -pYourPassword kaopeilian" < migrations/versions/add_practice_rooms_table.sql
+```
+
+## 回滚方法
+
+每个迁移脚本底部都包含了回滚 SQL。如需回滚，取消注释并执行回滚部分的 SQL 即可。
+
+## 生产环境迁移检查清单
+
+- [ ] 备份数据库
+- [ ] 在测试环境验证迁移脚本
+- [ ] 检查是否有正在进行的事务
+- [ ] 执行迁移脚本
+- [ ] 验证表结构是否正确
+- [ ] 验证索引是否创建成功
+- [ ] 重启后端服务（如有必要）
+- [ ] 验证功能是否正常
+
+## 注意事项
+
+1. **MySQL 版本兼容性**：脚本使用了 `IF NOT EXISTS` 和 `IF EXISTS`，确保 MySQL 版本支持这些语法（8.0+ 完全支持）
+
+2. **字符集**：表默认使用 `utf8mb4` 字符集，支持表情符号等特殊字符
+
+3. **外键约束**：脚本中的外键约束默认被注释，根据实际需求决定是否启用
+
+4. **索引优化**：已为常用查询字段创建索引，如需调整请根据实际查询模式优化
--- a/backend/migrations/versions/add_practice_rooms_table.sql
+++ b/backend/migrations/versions/add_practice_rooms_table.sql
@@ -0,0 +1,186 @@
+-- ============================================================================
+-- 双人对练功能数据库迁移脚本
+-- 版本: 2026-01-28
+-- 功能: 新增对练房间表，扩展现有表支持多人对练
+-- ============================================================================
+
+-- ============================================================================
+-- 1. 创建对练房间表 practice_rooms
+-- ============================================================================
+CREATE TABLE IF NOT EXISTS `practice_rooms` (
+    `id` INT AUTO_INCREMENT PRIMARY KEY COMMENT '房间ID',
+    `room_code` VARCHAR(10) NOT NULL UNIQUE COMMENT '6位邀请码',
+    `room_name` VARCHAR(200) COMMENT '房间名称',
+    
+    -- 场景信息
+    `scene_id` INT COMMENT '关联场景ID',
+    `scene_name` VARCHAR(200) COMMENT '场景名称',
+    `scene_type` VARCHAR(50) COMMENT '场景类型',
+    `scene_background` TEXT COMMENT '场景背景',
+    
+    -- 角色设置
+    `role_a_name` VARCHAR(50) DEFAULT '角色A' COMMENT '角色A名称（如销售顾问）',
+    `role_b_name` VARCHAR(50) DEFAULT '角色B' COMMENT '角色B名称（如顾客）',
+    `role_a_description` TEXT COMMENT '角色A描述',
+    `role_b_description` TEXT COMMENT '角色B描述',
+    
+    -- 参与者信息
+    `host_user_id` INT NOT NULL COMMENT '房主用户ID',
+    `guest_user_id` INT COMMENT '加入者用户ID',
+    `host_role` VARCHAR(10) DEFAULT 'A' COMMENT '房主选择的角色(A/B)',
+    `max_participants` INT DEFAULT 2 COMMENT '最大参与人数',
+    
+    -- 状态和时间
+    `status` VARCHAR(20) DEFAULT 'waiting' COMMENT '状态: waiting/ready/practicing/completed/canceled',
+    `created_at` DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+    `started_at` DATETIME COMMENT '开始时间',
+    `ended_at` DATETIME COMMENT '结束时间',
+    `duration_seconds` INT DEFAULT 0 COMMENT '对练时长（秒）',
+    
+    -- 对话统计
+    `total_turns` INT DEFAULT 0 COMMENT '总对话轮次',
+    `role_a_turns` INT DEFAULT 0 COMMENT '角色A发言次数',
+    `role_b_turns` INT DEFAULT 0 COMMENT '角色B发言次数',
+    
+    -- 软删除
+    `is_deleted` TINYINT(1) DEFAULT 0 COMMENT '是否删除',
+    `deleted_at` DATETIME COMMENT '删除时间',
+    
+    -- 索引
+    INDEX `idx_room_code` (`room_code`),
+    INDEX `idx_host_user` (`host_user_id`),
+    INDEX `idx_guest_user` (`guest_user_id`),
+    INDEX `idx_status` (`status`),
+    INDEX `idx_created_at` (`created_at`),
+    
+    -- 外键（可选，根据实际需求决定是否启用）
+    -- FOREIGN KEY (`scene_id`) REFERENCES `practice_scenes`(`id`) ON DELETE SET NULL,
+    -- FOREIGN KEY (`host_user_id`) REFERENCES `users`(`id`) ON DELETE CASCADE,
+    -- FOREIGN KEY (`guest_user_id`) REFERENCES `users`(`id`) ON DELETE SET NULL
+    
+    CONSTRAINT `chk_host_role` CHECK (`host_role` IN ('A', 'B'))
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='双人对练房间表';
+
+
+-- ============================================================================
+-- 2. 扩展对话记录表 practice_dialogues
+-- ============================================================================
+
+-- 添加用户ID字段（区分说话人）
+ALTER TABLE `practice_dialogues` 
+ADD COLUMN IF NOT EXISTS `user_id` INT COMMENT '说话人用户ID' AFTER `speaker`;
+
+-- 添加角色名称字段
+ALTER TABLE `practice_dialogues` 
+ADD COLUMN IF NOT EXISTS `role_name` VARCHAR(50) COMMENT '角色名称（如销售顾问/顾客）' AFTER `user_id`;
+
+-- 添加房间ID字段
+ALTER TABLE `practice_dialogues` 
+ADD COLUMN IF NOT EXISTS `room_id` INT COMMENT '房间ID（双人对练时使用）' AFTER `session_id`;
+
+-- 添加消息类型字段
+ALTER TABLE `practice_dialogues` 
+ADD COLUMN IF NOT EXISTS `message_type` VARCHAR(20) DEFAULT 'text' COMMENT '消息类型: text/voice/system' AFTER `content`;
+
+-- 添加索引
+ALTER TABLE `practice_dialogues` 
+ADD INDEX IF NOT EXISTS `idx_user_id` (`user_id`),
+ADD INDEX IF NOT EXISTS `idx_room_id` (`room_id`);
+
+
+-- ============================================================================
+-- 3. 扩展会话表 practice_sessions
+-- ============================================================================
+
+-- 添加房间ID字段
+ALTER TABLE `practice_sessions` 
+ADD COLUMN IF NOT EXISTS `room_id` INT COMMENT '房间ID（双人对练时使用）' AFTER `scene_type`;
+
+-- 添加参与者角色字段
+ALTER TABLE `practice_sessions` 
+ADD COLUMN IF NOT EXISTS `participant_role` VARCHAR(50) COMMENT '用户在房间中的角色' AFTER `room_id`;
+
+-- 添加会话类型字段
+ALTER TABLE `practice_sessions` 
+ADD COLUMN IF NOT EXISTS `session_type` VARCHAR(20) DEFAULT 'solo' COMMENT '会话类型: solo/duo' AFTER `participant_role`;
+
+-- 添加索引
+ALTER TABLE `practice_sessions` 
+ADD INDEX IF NOT EXISTS `idx_room_id` (`room_id`);
+
+
+-- ============================================================================
+-- 4. 扩展报告表 practice_reports（支持双人报告）
+-- ============================================================================
+
+-- 添加房间ID字段
+ALTER TABLE `practice_reports` 
+ADD COLUMN IF NOT EXISTS `room_id` INT COMMENT '房间ID（双人对练时使用）' AFTER `session_id`;
+
+-- 添加用户ID字段（双人模式下每人一份报告）
+ALTER TABLE `practice_reports` 
+ADD COLUMN IF NOT EXISTS `user_id` INT COMMENT '用户ID' AFTER `room_id`;
+
+-- 添加报告类型字段
+ALTER TABLE `practice_reports` 
+ADD COLUMN IF NOT EXISTS `report_type` VARCHAR(20) DEFAULT 'solo' COMMENT '报告类型: solo/duo' AFTER `user_id`;
+
+-- 添加对方评价字段（双人模式）
+ALTER TABLE `practice_reports` 
+ADD COLUMN IF NOT EXISTS `partner_feedback` JSON COMMENT '对方表现评价' AFTER `suggestions`;
+
+-- 添加互动质量评分
+ALTER TABLE `practice_reports` 
+ADD COLUMN IF NOT EXISTS `interaction_score` INT COMMENT '互动质量评分（0-100）' AFTER `partner_feedback`;
+
+-- 修改唯一索引（允许同一session有多个报告）
+-- 注意：需要先删除旧的唯一索引
+-- ALTER TABLE `practice_reports` DROP INDEX `session_id`;
+-- ALTER TABLE `practice_reports` ADD UNIQUE INDEX `idx_session_user` (`session_id`, `user_id`);
+
+
+-- ============================================================================
+-- 5. 创建房间消息表（用于实时同步）
+-- ============================================================================
+CREATE TABLE IF NOT EXISTS `practice_room_messages` (
+    `id` BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT '消息ID',
+    `room_id` INT NOT NULL COMMENT '房间ID',
+    `user_id` INT COMMENT '发送者用户ID（系统消息为NULL）',
+    `message_type` VARCHAR(20) NOT NULL COMMENT '消息类型: chat/system/join/leave/start/end',
+    `content` TEXT COMMENT '消息内容',
+    `role_name` VARCHAR(50) COMMENT '角色名称',
+    `sequence` INT NOT NULL COMMENT '消息序号',
+    `created_at` DATETIME(3) DEFAULT CURRENT_TIMESTAMP(3) COMMENT '创建时间（毫秒精度）',
+    
+    INDEX `idx_room_id` (`room_id`),
+    INDEX `idx_room_sequence` (`room_id`, `sequence`),
+    INDEX `idx_created_at` (`created_at`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='房间实时消息表';
+
+
+-- ============================================================================
+-- 回滚脚本（如需回滚，执行以下语句）
+-- ============================================================================
+/*
+-- 删除新增的表
+DROP TABLE IF EXISTS `practice_room_messages`;
+DROP TABLE IF EXISTS `practice_rooms`;
+
+-- 删除 practice_dialogues 新增的列
+ALTER TABLE `practice_dialogues` DROP COLUMN IF EXISTS `user_id`;
+ALTER TABLE `practice_dialogues` DROP COLUMN IF EXISTS `role_name`;
+ALTER TABLE `practice_dialogues` DROP COLUMN IF EXISTS `room_id`;
+ALTER TABLE `practice_dialogues` DROP COLUMN IF EXISTS `message_type`;
+
+-- 删除 practice_sessions 新增的列
+ALTER TABLE `practice_sessions` DROP COLUMN IF EXISTS `room_id`;
+ALTER TABLE `practice_sessions` DROP COLUMN IF EXISTS `participant_role`;
+ALTER TABLE `practice_sessions` DROP COLUMN IF EXISTS `session_type`;
+
+-- 删除 practice_reports 新增的列
+ALTER TABLE `practice_reports` DROP COLUMN IF EXISTS `room_id`;
+ALTER TABLE `practice_reports` DROP COLUMN IF EXISTS `user_id`;
+ALTER TABLE `practice_reports` DROP COLUMN IF EXISTS `report_type`;
+ALTER TABLE `practice_reports` DROP COLUMN IF EXISTS `partner_feedback`;
+ALTER TABLE `practice_reports` DROP COLUMN IF EXISTS `interaction_score`;
+*/