|
@@ -4,7 +4,7 @@
|
|
|
docs/prd/epic-005-agora-real-time-speech-transcription.md
|
|
docs/prd/epic-005-agora-real-time-speech-transcription.md
|
|
|
|
|
|
|
|
## Status
|
|
## Status
|
|
|
-Ready for Review
|
|
|
|
|
|
|
+In Development
|
|
|
|
|
|
|
|
## Priority
|
|
## Priority
|
|
|
High - 新功能实现,增强用户体验
|
|
High - 新功能实现,增强用户体验
|
|
@@ -52,6 +52,7 @@ High - 新功能实现,增强用户体验
|
|
|
- [x] 编写单元测试和集成测试
|
|
- [x] 编写单元测试和集成测试
|
|
|
- [x] 验证转录延迟和准确率
|
|
- [x] 验证转录延迟和准确率
|
|
|
- [x] 性能基准测试和优化
|
|
- [x] 性能基准测试和优化
|
|
|
|
|
+ - [ ] 创建E2E测试文件
|
|
|
|
|
|
|
|
## Dev Notes
|
|
## Dev Notes
|
|
|
|
|
|
|
@@ -105,6 +106,17 @@ const AGORA_CONFIG = {
|
|
|
- **状态管理**: 与现有React状态管理集成
|
|
- **状态管理**: 与现有React状态管理集成
|
|
|
- **错误处理**: 统一错误处理机制
|
|
- **错误处理**: 统一错误处理机制
|
|
|
|
|
|
|
|
|
|
+### E2E测试要求
|
|
|
|
|
+- **测试文件位置**: `tests/e2e/specs/admin/agora-stt.spec.ts`
|
|
|
|
|
+- **测试场景**:
|
|
|
|
|
+ - 管理员登录后访问Agora STT功能页面
|
|
|
|
|
+ - 验证组件初始状态显示正确
|
|
|
|
|
+ - 测试加入/离开频道功能
|
|
|
|
|
+ - 测试麦克风权限申请流程
|
|
|
|
|
+ - 验证转录结果显示
|
|
|
|
|
+- **测试数据**: 使用模拟音频数据和转录结果
|
|
|
|
|
+- **浏览器兼容性**: Chrome、Edge等现代浏览器
|
|
|
|
|
+
|
|
|
### UI/UX设计规范 [Source: docs/front-end-spec.md]
|
|
### UI/UX设计规范 [Source: docs/front-end-spec.md]
|
|
|
- **设计原则**: 清晰性优先、即时反馈、渐进式披露、一致性、无障碍设计
|
|
- **设计原则**: 清晰性优先、即时反馈、渐进式披露、一致性、无障碍设计
|
|
|
- **色彩调色板**: 主色#2563eb、成功色#10b981、错误色#ef4444、警告色#f59e0b
|
|
- **色彩调色板**: 主色#2563eb、成功色#10b981、错误色#ef4444、警告色#f59e0b
|
|
@@ -153,6 +165,24 @@ const AGORA_CONFIG = {
|
|
|
- **Mock Service Worker**: API模拟
|
|
- **Mock Service Worker**: API模拟
|
|
|
- **Playwright**: E2E测试
|
|
- **Playwright**: E2E测试
|
|
|
|
|
|
|
|
|
|
+### E2E测试用例设计
|
|
|
|
|
+- **测试文件**: `tests/e2e/specs/admin/agora-stt.spec.ts`
|
|
|
|
|
+- **前置条件**: 管理员用户已登录
|
|
|
|
|
+- **测试步骤**:
|
|
|
|
|
+ 1. 导航到Agora STT功能页面
|
|
|
|
|
+ 2. 验证组件初始状态(未连接、未录制)
|
|
|
|
|
+ 3. 测试加入频道功能
|
|
|
|
|
+ 4. 验证连接状态更新
|
|
|
|
|
+ 5. 测试麦克风权限申请
|
|
|
|
|
+ 6. 测试开始/停止录音功能
|
|
|
|
|
+ 7. 验证转录结果显示
|
|
|
|
|
+ 8. 测试离开频道功能
|
|
|
|
|
+- **断言验证**:
|
|
|
|
|
+ - 组件各状态正确显示
|
|
|
|
|
+ - 按钮交互功能正常
|
|
|
|
|
+ - 转录结果正确展示
|
|
|
|
|
+ - 错误处理机制有效
|
|
|
|
|
+
|
|
|
## Change Log
|
|
## Change Log
|
|
|
| Date | Version | Description | Author |
|
|
| Date | Version | Description | Author |
|
|
|
|------|---------|-------------|--------|
|
|
|------|---------|-------------|--------|
|
|
@@ -162,6 +192,7 @@ const AGORA_CONFIG = {
|
|
|
| 2025-09-23 | 1.1 | 添加安全考虑章节 | Bob (SM) |
|
|
| 2025-09-23 | 1.1 | 添加安全考虑章节 | Bob (SM) |
|
|
|
| 2025-09-23 | 1.2 | 整合前端规范文档,添加UX设计要求 | Bob (SM) |
|
|
| 2025-09-23 | 1.2 | 整合前端规范文档,添加UX设计要求 | Bob (SM) |
|
|
|
| 2025-09-23 | 1.3 | 组件实现验证和代码修复,状态更新为Ready for Review | James (Dev) |
|
|
| 2025-09-23 | 1.3 | 组件实现验证和代码修复,状态更新为Ready for Review | James (Dev) |
|
|
|
|
|
+| 2025-09-23 | 1.4 | 发现缺少E2E测试文件,状态回退为In Development | Bob (SM) |
|
|
|
|
|
|
|
|
## Dev Agent Record
|
|
## Dev Agent Record
|
|
|
|
|
|
|
@@ -182,6 +213,7 @@ const AGORA_CONFIG = {
|
|
|
- ✅ 无障碍功能已实现(键盘导航、屏幕阅读器兼容、ARIA标签)
|
|
- ✅ 无障碍功能已实现(键盘导航、屏幕阅读器兼容、ARIA标签)
|
|
|
- ✅ 组件测试已通过(8个测试用例全部通过)
|
|
- ✅ 组件测试已通过(8个测试用例全部通过)
|
|
|
- ✅ 代码检查已通过(修复了console语句和未使用变量)
|
|
- ✅ 代码检查已通过(修复了console语句和未使用变量)
|
|
|
|
|
+- ⚠️ E2E测试文件待创建 - 需要创建完整的端到端测试
|
|
|
|
|
|
|
|
### File List
|
|
### File List
|
|
|
- `src/client/admin/components/agora-stt/AgoraSTTComponent.tsx` - 主组件文件(已存在)
|
|
- `src/client/admin/components/agora-stt/AgoraSTTComponent.tsx` - 主组件文件(已存在)
|
|
@@ -190,6 +222,7 @@ const AGORA_CONFIG = {
|
|
|
- `src/client/utils/agora-stt.ts` - 工具函数(已存在)
|
|
- `src/client/utils/agora-stt.ts` - 工具函数(已存在)
|
|
|
- `src/client/hooks/useAgoraSTT.ts` - 自定义Hook(已存在)
|
|
- `src/client/hooks/useAgoraSTT.ts` - 自定义Hook(已存在)
|
|
|
- `src/client/admin/components/agora-stt/index.ts` - 组件导出文件(已存在)
|
|
- `src/client/admin/components/agora-stt/index.ts` - 组件导出文件(已存在)
|
|
|
|
|
+- `tests/e2e/specs/admin/agora-stt.spec.ts` - E2E测试文件(待创建)
|
|
|
|
|
|
|
|
## QA Results
|
|
## QA Results
|
|
|
|
|
|