2
0
Prechádzať zdrojové kódy

📝 docs(story): update SDK core architecture story status and requirements

- change story status from "Completed" to "In Progress"
- add extended acceptance criteria for main app integration testing
- add new acceptance criteria: create SDK test page in main app and verify with E2E tests
- add task 8 for main app SDK test page integration
- add subtasks for creating test page, implementing demo interface, and writing E2E tests
- update development notes with new version 1.7 record
- add "to be completed tasks" section for remaining integration work
- add "to be added files" list for test page and E2E test files
yourname 2 mesiacov pred
rodič
commit
f67c0c67de
1 zmenil súbory, kde vykonal 24 pridanie a 1 odobranie
  1. 24 1
      docs/stories/1.1.sdk-core-architecture.md

+ 24 - 1
docs/stories/1.1.sdk-core-architecture.md

@@ -4,7 +4,7 @@
 
 ## Status
 
-✅ Completed - 真实功能集成完成
+🔄 In Progress - 需要主应用集成测试
 
 ## Story
 
@@ -12,6 +12,8 @@
 **I want** 将现有的stt-demo应用中的语音转文字功能封装成通用的TypeScript SDK,
 **so that** 我可以在任何TypeScript项目中轻松使用语音转文字功能,而不依赖特定框架。
 
+**验收标准扩展**: 在主应用中新增SDK测试页面,验证SDK在实际应用环境中的功能完整性。
+
 ## Acceptance Criteria
 
 1. 在项目根目录创建 `packages/` 目录结构,采用monorepo模式管理SDK
@@ -21,6 +23,8 @@
 5. 提供完整的TypeScript类型定义
 6. 确保现有stt-demo应用功能不受影响,保持向后兼容
 7. **SDK必须能够进行实际的语音转文字操作**,集成真实Agora SDK功能
+8. **在主应用中新增SDK测试页面**,提供完整的SDK功能演示和测试环境
+9. **通过E2E测试验证SDK集成**,确保SDK在实际应用场景中正常工作
 
 ## Tasks / Subtasks
 
@@ -58,6 +62,13 @@
   - [x] **验证SDK能够进行实际的语音转文字操作**(单元测试验证通过)
   - [x] 测试多语言转录和翻译功能
   - [ ] 运行Playwright E2E测试验证回归(主应用暂未集成SDK)
+- [ ] Task 8: **主应用集成SDK测试页面** (AC: 8,9)
+  - [ ] 在src/pages/目录下创建sdk-test页面
+  - [ ] 实现SDK初始化、连接、转录功能演示界面
+  - [ ] 添加实时转录结果显示和事件监听
+  - [ ] 配置路由,添加/sdk-test路径访问
+  - [ ] 编写Playwright E2E测试验证SDK功能
+  - [ ] 运行E2E测试确保SDK在实际应用中正常工作
 
 ## Dev Notes
 
@@ -158,6 +169,7 @@
 | 2025-09-25 | 1.4     | 修正包管理工具:将yarn改为npm,与实际package.json保持一致                         | Bob (SM)    |
 | 2025-09-25 | 1.5     | **重大纠正**:发现SDK实现为模拟功能而非真实封装,需要重新实现真实Agora SDK集成    | Bob (SM)    |
 | 2025-09-25 | 1.6     | **完成真实功能集成**:重新实现管理器适配器类,集成真实Agora SDK功能,修复所有测试 | Claude Code |
+| 2025-09-25 | 1.7     | **更新故事状态**:添加主应用集成SDK测试页面需求,将状态改为进行中                 | Bob (SM)    |
 
 ## Dev Agent Record
 
@@ -185,6 +197,11 @@
 8. ✅ 修复TypeScript类型检查问题,测试目录包含在编译中
 9. ✅ 修复模拟配置问题,使用vi.mocked正确处理模拟类型
 
+### 待完成任务
+
+10. 🔄 **主应用集成**: 需要新增SDK测试页面进行实际应用验证
+11. 🔄 **E2E测试**: 需要编写Playwright测试验证SDK在实际应用中的功能
+
 ### File List
 
 **新增/修改的文件:**
@@ -199,4 +216,10 @@
 - `packages/stt-sdk-core/tests/` - 测试文件
 - `package.json` - 根包workspaces配置更新
 
+**待新增文件:**
+
+- `src/pages/sdk-test/` - SDK测试页面目录
+- `src/pages/sdk-test/index.tsx` - SDK测试页面组件
+- `e2e/sdk-test.spec.ts` - SDK功能E2E测试文件
+
 ## QA Results