Add project testing doc

README.md

@@ -14,6 +14,9 @@
 2. **赛车游戏交互系统**：实现与《Rush Rally Origins》等赛车游戏的隔空手柄交互
 3. **WaveSign 手语通**：面向听障人群的手语学习与社区互动平台
 
+[项目测试文档](./项目测试文档.md)
+
+
 
 
 ## 技术架构

项目测试文档.md

@@ -0,0 +1,155 @@
+# 📋 WaveControl 隔空手势控制系统 - 测试文档
+
+## 一、测试概述
+
+### 1.1 测试目标
+
+确保系统三个核心子模块功能完整、交互稳定、性能可靠，满足多场景下的非接触式人机交互需求，包括主控制平台、手语通平台、游戏控制模块。
+
+### 1.2 测试对象
+
+- 主控制系统（控制面板 + 手势库管理 + 语音识别）
+- WaveSign 手语通系统（教学、评分、社区）
+- 虚拟赛车手柄系统（游戏中控制响应）
+
+### 1.3 测试类型
+
+| 测试类型     | 说明                                       |
+| ------------ | ------------------------------------------ |
+| 功能测试     | 各模块是否能完成核心功能                   |
+| 集成测试     | 各子模块之间的数据流与交互是否正确         |
+| 性能测试     | 系统是否在高帧率下稳定运行、响应及时       |
+| 边界测试     | 识别模糊手势、断网、摄像头断连等异常情况   |
+| 用户体验测试 | 普通用户是否能流畅使用、易上手、有清晰反馈 |
+
+
+
+## 二、测试环境
+
+| 项目        | 配置                              |
+| ----------- | --------------------------------- |
+| 操作系统    | Windows 10 / 11、MacOS            |
+| Python 版本 | Python 3.8+                       |
+| 浏览器      | Chrome / Edge                     |
+| 识别设备    | USB 外接摄像头 / 笔记本自带摄像头 |
+| 游戏平台    | Steam 平台《Rush Rally Origins》  |
+
+
+
+## 三、测试用例设计
+
+### ✅ 主控制系统
+
+| 用例编号   | 手势名称     | 手势说明                               | 操作步骤                      | 预期结果                        | 优先级 |
+| ---------- | ------------ | -------------------------------------- | ----------------------------- | ------------------------------- | ------ |
+| TC-GEST-01 | 光标控制     | 坚起食指滑动 → 控制光标位置            | 做出光标控制手势              | 光标位置随手移动                | 高     |
+| TC-GEST-02 | 鼠标左键点击 | 食指 + 大拇指贴合手势                  | 做出鼠标点击动作              | 系统执行鼠标单击                | 高     |
+| TC-GEST-03 | 滚动控制     | okay 手势控制滑动                      | 做出 okay 手势，手向上/下移动 | 页面上下滚动                    | 高     |
+| TC-GEST-04 | 全屏模式     | 四指并拢并上扬                         | 举起四指向上                  | 触发全屏操作                    | 中     |
+| TC-GEST-05 | 退出（Back） | 向后挥动手势                           | 向后快速摆动手掌              | 返回上一步                      | 中     |
+| TC-GEST-06 | 六指开启识别 | 六指手势激活识别                       | 做出六指（拇指+小指展开）     | 系统进入六指模式识别            | 中     |
+| TC-GEST-07 | 暂停/播放    | 手势为 ✋ / 🖐️                           | 显示手掌面向摄像头            | 音乐暂停或播放                  | 高     |
+| TC-GEST-08 | 静音         | 拇指上扬，其他手指收回（1.5D静音手势） | 举起静音手势                  | 系统进入静音状态                | 中     |
+| TC-GEST-09 | 鼠标右键     | 拇指、食指、中指上扬手势               | 展示该手势                    | 模拟右键点击                    | 中     |
+| TC-GEST-10 | 南左移动     | 单手水平向左挥动                       | 做出快速向左的滑动手势        | 控制元素向左移动                | 中     |
+| TC-GEST-11 | 触屏         | 手掌、卡指、中指上扬                   | 做出该手势                    | 模拟屏幕触碰                    | 中     |
+| TC-GEST-12 | 上一首音乐   | 大拇指向左                             | 举出“上一首”手势              | 播放上一首歌曲                  | 中     |
+| TC-GEST-13 | 下一首音乐   | 大拇指向右                             | 举出“下一首”手势              | 播放下一首歌曲                  | 中     |
+| TC-GEST-14 | 暂停/播放    | 比五手势用于暂停/播放                  | 做出五指伸展手势              | 音乐暂停或播放                  | 高     |
+| TC-GEST-15 | 模式切换     | rock 手势（🤘）                         | 做出 rock 手势                | 切换当前系统模式（如游戏/控制） | 高     |
+
+
+
+
+
+### 🤟 手语通 WaveSign
+
+#### ✅ 1. **SLClassroom（手语教室）模块**
+
+| 用例编号 | 用例名称           | 测试点                      | 预期结果                    |
+| -------- | ------------------ | --------------------------- | --------------------------- |
+| TC-SL-01 | 摄像头实时识别     | 摄像头接通后手势是否被识别  | 返回手语内容 + 实时评分动画 |
+| TC-SL-02 | 视频上传评分       | 上传手语视频后是否正常评分  | 返回分数、标准建议          |
+| TC-SL-03 | 视频课程学习流程   | 是否能顺序播放、标记已学    | 视频播放正常，课程解锁      |
+| TC-SL-04 | 翻转卡片练习       | 卡片是否翻转 + 显示正确答案 | 点击翻面后显示预设解释      |
+| TC-SL-05 | 任务式课程地图跳转 | 点击课程节点是否正确跳转    | 跳转至对应课程页            |
+
+
+
+#### ✅ 2. **Community（社区系统）模块**
+
+| 用例编号  | 用例名称      | 测试点                     | 预期结果                   |
+| --------- | ------------- | -------------------------- | -------------------------- |
+| TC-COM-01 | 发帖功能      | 输入文字/图片/视频发帖     | 帖子成功展示 + ID 唯一标识 |
+| TC-COM-02 | 评论功能      | 帖子下评论 + 删除          | 评论正常显示/删除          |
+| TC-COM-03 | 点赞机制      | 点赞后数值变化             | 点赞数+1，重复点则取消     |
+| TC-COM-04 | 热门话题显示  | 帖子互动数高时是否上热门区 | 热门区出现帖子             |
+| TC-COM-05 | 内容审核机制  | 敏感词是否被拦截/提示      | 给出“内容不合规”提示       |
+| TC-COM-06 | 标签推荐      | 选择话题是否推荐相关内容   | 推荐结果合理、及时加载     |
+| TC-COM-07 | 关注/取关系统 | 关注后是否成功建立关注关系 | 动态展示更新               |
+
+
+
+#### ✅ 3. **Schedule（日程与任务模块）**
+
+| 用例编号  | 用例名称             | 测试点                     | 预期结果                  |
+| --------- | -------------------- | -------------------------- | ------------------------- |
+| TC-SCH-01 | 添加任务清单         | 是否可设置日期/优先级      | 列表显示任务 + 状态可勾选 |
+| TC-SCH-02 | 事件提醒触发         | 设置提醒是否能按时通知     | 到时弹出提醒/响铃提示     |
+| TC-SCH-03 | 日/周/月视图切换     | 是否能无误切换不同日历视图 | 各视图正常显示            |
+| TC-SCH-04 | 删除任务是否更新视图 | 删除后是否同步更新         | 日历图/列表同步清除       |
+
+
+
+#### ✅ 4. **LifeServing（生活服务）模块**
+
+| 用例编号 | 用例名称         | 测试点                             | 预期结果                     |
+| -------- | ---------------- | ---------------------------------- | ---------------------------- |
+| TC-LS-01 | 发布内容管理     | 发布好物推荐/活动等信息            | 内容展示无误                 |
+| TC-LS-02 | 辅助器具推荐     | 推荐列表是否分类清晰/加载正确      | 分类显示 + 图片正常          |
+| TC-LS-03 | 学习设备推荐     | 展示硬件学习工具列表               | 内容图文加载完整             |
+| TC-LS-04 | 就业信息推送     | 职位内容、公司信息展示是否完整     | 包含岗位名称、描述、联系方式 |
+| TC-LS-05 | 残障友好企业标识 | 是否加V / 标签区分                 | 有“友好企业”提示             |
+| TC-LS-06 | 无障碍路线规划   | 是否能绘制无台阶/电梯路线          | 地图路径合理                 |
+| TC-LS-07 | 实时公交提醒     | 路线是否加载正确/更新是否及时      | 实时展示公交进站时间         |
+| TC-LS-08 | 活动预告展示     | 亲子/文娱/演出分类信息加载是否完整 | 可报名 + 有时间地点说明      |
+
+
+
+#### ✅ 5. **MyPage（个人中心）模块**
+
+| 用例编号 | 用例名称           | 测试点                          | 预期结果                     |
+| -------- | ------------------ | ------------------------------- | ---------------------------- |
+| TC-MY-01 | 修改头像           | 上传头像 + 预览功能是否生效     | 显示新头像                   |
+| TC-MY-02 | 修改资料           | 昵称/简介/联系方式可修改        | 保存后页面同步更新           |
+| TC-MY-03 | 收藏管理           | 收藏帖子/课程后是否能查看       | 我的收藏页显示内容           |
+| TC-MY-04 | 账号注册/登录/登出 | 是否可注册新用户 + 正确跳转状态 | 新用户进入首页，旧账号可退出 |
+| TC-MY-05 | 权限角色识别       | 是否区分普通用户/审核员角色     | 页面显示不同选项             |
+
+
+
+#### ✅ 6. **技术实现相关（稳定性/架构）测试**
+
+| 用例编号   | 用例名称              | 测试点                        | 预期结果                 |
+| ---------- | --------------------- | ----------------------------- | ------------------------ |
+| TC-TECH-01 | SQLite 数据读写测试   | 批量操作课程/帖子是否存取正常 | 数据不丢失，响应时间正常 |
+| TC-TECH-02 | MediaPipe模型崩溃恢复 | 强行关闭摄像头后是否重连      | 显示重连提示/自动恢复    |
+| TC-TECH-03 | Tailwind 前端样式响应 | 各分辨率下页面是否响应式变化  | 不溢出，元素自适应       |
+
+
+
+
+
+### 🏎️ 游戏控制模块
+
+| 用例编号   | 模块     | 用例名称         | 前置条件                 | 测试步骤                         | 预期结果                           | 优先级 |
+| ---------- | -------- | ---------------- | ------------------------ | -------------------------------- | ---------------------------------- | ------ |
+| TC-GAME-01 | 游戏控制 | 加速动作识别     | 摄像头运行正常，程序启动 | 举起右手拇指上扬                 | 车辆开始加速                       | 高     |
+| TC-GAME-02 | 游戏控制 | 刹车动作识别     | 同上                     | 举起左手拇指上扬                 | 车辆开始减速                       | 高     |
+| TC-GAME-03 | 游戏控制 | 左右转向动作识别 | 同上                     | 向左倾手掌                       | 车辆向左转弯                       | 高     |
+| TC-GAME-04 | 游戏控制 | 手势连续识别切换 | 程序运行中               | 快速从加速 → 左转 → 刹车切换手势 | 每步操作都有反馈，游戏响应流畅     | 高     |
+| TC-GAME-05 | 游戏控制 | 识别抖动干扰测试 | 程序运行中，抖动手指     | 快速小幅度摆动手指               | 系统不误触操作，保持稳定           | 中     |
+| TC-GAME-06 | 游戏控制 | 虚拟手柄断连恢复 | 手柄模拟开启中           | 断开 vgamepad 端口 → 重连        | 程序检测中断并尝试自动恢复         | 中     |
+| TC-GAME-07 | 游戏控制 | 低帧率下性能表现 | 模拟20fps摄像头          | 尝试完成左右转、加速等动作       | 出现识别滞后，界面给出低帧警告     | 中     |
+| TC-GAME-08 | 游戏控制 | UI反馈准确性     | 摄像头运行中             | 做出加速动作，观察 UI 面板反馈   | 显示“当前动作：加速”，图像区域标亮 | 中     |
+