📝 docs(stories): add testing infrastructure stories

- 创建基础单元测试框架搭建故事文档(001.001.story.md)
- 添加集成测试环境配置故事文档(001.002.story.md)
- 编写端到端测试流水线故事文档(001.003.story.md)
- 详细规划测试框架、环境配置和集成策略

docs/stories/001.001.story.md

@@ -0,0 +1,150 @@
+# Story 001.001: 基础单元测试框架搭建
+
+## Status
+Draft
+
+## Story
+**As a** 全栈开发者
+**I want** 建立完整的单元测试基础设施和模式
+**so that** 我可以为现有代码库编写高质量的单元测试，确保代码质量和可维护性
+
+## Acceptance Criteria
+1. 为核心模块创建单元测试模板和模式
+2. 建立测试工具函数和mock数据
+3. 配置测试覆盖率阈值和报告
+4. 创建开发人员测试指南文档
+
+## Tasks / Subtasks
+- [ ] 检查现有Jest配置并验证其完整性 (AC: 3)
+- [ ] 创建核心模块的单元测试模板文件 (AC: 1)
+  - [ ] UserService单元测试模板
+  - [ ] AuthService单元测试模板
+  - [ ] GenericCRUDService单元测试模板
+- [ ] 建立测试工具函数库 (AC: 2)
+  - [ ] 创建测试数据工厂函数
+  - [ ] 建立常用mock工具
+  - [ ] 创建测试辅助函数
+- [ ] 配置测试覆盖率报告和阈值 (AC: 3)
+  - [ ] 验证现有覆盖率配置
+  - [ ] 设置合理的覆盖率阈值
+  - [ ] 配置HTML覆盖率报告
+- [ ] 创建开发人员测试指南文档 (AC: 4)
+  - [ ] 编写单元测试最佳实践
+  - [ ] 创建测试模式示例
+  - [ ] 提供常见测试场景指南
+
+## Dev Notes
+
+### 现有技术栈分析
+- **测试框架**: Jest 29.7.0 + ts-jest 29.2.5 [Source: package.json]
+- **测试环境**: Node.js环境 + jsdom（前端测试）[Source: jest.config.js]
+- **覆盖率工具**: Jest内置覆盖率报告 [Source: jest.config.js]
+- **现有配置**: Jest配置完整，包含模块映射、覆盖率阈值、测试环境设置 [Source: jest.config.js]
+
+### 核心模块测试需求
+**UserService测试重点**:
+- 用户CRUD操作验证
+- 密码加密和验证逻辑
+- 角色权限关联测试
+- 错误处理和边界条件
+
+**AuthService测试重点**:
+- JWT令牌生成和验证
+- 登录认证流程
+- 会话管理测试
+- 安全漏洞防护
+
+**GenericCRUDService测试重点**:
+- 通用CRUD操作测试
+- 关联查询验证
+- 分页和过滤功能
+- 自定义扩展点测试
+
+### 测试文件结构
+基于现有项目结构 [Source: architecture.md#源码树和文件组织]:
+```
+src/
+├── server/
+│   ├── modules/
+│   │   ├── users/
+│   │   │   ├── __tests__/           # 单元测试目录
+│   │   │   │   ├── user.service.test.ts
+│   │   │   │   └── role.service.test.ts
+│   │   ├── auth/
+│   │   │   ├── __tests__/
+│   │   │   │   └── auth.service.test.ts
+│   ├── utils/
+│   │   ├── __tests__/
+│   │   │   ├── generic-crud.service.test.ts
+│   │   │   └── errorHandler.test.ts
+```
+
+### 测试标准和模式
+**命名约定**:
+- 测试文件: `*.test.ts` 或 `*.spec.ts`
+- 测试套件: `describe('模块名称', () => {})`
+- 测试用例: `it('应该描述预期行为', () => {})`
+
+**测试结构模式**:
+```typescript
+describe('ServiceName', () => {
+  describe('methodName', () => {
+    it('should do something when condition', () => {
+      // Arrange
+      // Act
+      // Assert
+    });
+
+    it('should handle error case', () => {
+      // Error scenario test
+    });
+  });
+});
+```
+
+### 技术约束和要求
+- **兼容性**: 必须保持现有API接口不变 [Source: epic-001-test-infrastructure.md]
+- **性能**: 测试执行时间应合理，不影响开发流程
+- **覆盖率**: 核心业务逻辑测试覆盖率 > 70% [Source: architecture.md]
+- **质量**: 测试代码遵循相同代码质量标准
+
+### 集成点
+- **构建流程**: 集成到现有`npm test`命令
+- **CI/CD**: 与GitHub Actions或其他CI工具集成
+- **开发体验**: 支持watch模式和调试
+
+## Testing
+
+### 测试策略
+- **单元测试范围**: 单个函数、方法、类的独立测试
+- **Mock策略**: 使用Jest mock功能隔离外部依赖
+- **数据准备**: 使用工厂函数创建测试数据
+- **断言库**: Jest内置断言 + 自定义匹配器
+
+### 测试覆盖目标
+- **行覆盖率**: > 70%
+- **分支覆盖率**: > 70%
+- **函数覆盖率**: > 70%
+- **语句覆盖率**: > 70%
+
+### 测试环境
+- **Node.js环境**: 后端服务和工具函数测试
+- **jsdom环境**: 前端组件测试（需要时）
+- **数据库**: 使用内存数据库或mock进行数据层测试
+
+## Change Log
+| Date | Version | Description | Author |
+|------|---------|-------------|--------|
+| 2025-09-15 | 1.0 | 初始故事创建 | Bob (Scrum Master) |
+
+## Dev Agent Record
+
+### Agent Model Used
+
+### Debug Log References
+
+### Completion Notes List
+
+### File List
+
+## QA Results

docs/stories/001.002.story.md

@@ -0,0 +1,202 @@
+# Story 001.002: 集成测试环境配置
+
+## Status
+Draft
+
+## Story
+**As a** 后端开发者
+**I want** 配置完整的集成测试环境和工具
+**so that** 我可以测试API接口的完整工作流程和组件集成，确保系统各部分的正确协作
+
+## Acceptance Criteria
+1. 设置API接口集成测试环境
+2. 配置React组件集成测试
+3. 建立数据库和外部服务mock
+4. 创建集成测试最佳实践
+
+## Tasks / Subtasks
+- [ ] 配置API集成测试环境 (AC: 1)
+  - [ ] 设置Hono服务器测试启动
+  - [ ] 配置测试数据库连接
+  - [ ] 创建测试请求工具函数
+- [ ] 建立React组件集成测试配置 (AC: 2)
+  - [ ] 配置Testing Library集成
+  - [ ] 设置组件测试渲染环境
+  - [ ] 创建组件测试工具函数
+- [ ] 实现数据库mock和服务stub (AC: 3)
+  - [ ] 创建TypeORM测试数据源
+  - [ ] 实现数据库事务回滚机制
+  - [ ] 建立外部服务mock工具
+- [ ] 编写集成测试最佳实践文档 (AC: 4)
+  - [ ] 创建API集成测试模式
+  - [ ] 编写组件集成测试指南
+  - [ ] 提供mock策略和示例
+
+## Dev Notes
+
+### 现有技术栈分析
+- **API框架**: Hono 4.8.5 [Source: package.json]
+- **测试库**: @testing-library/react 16.3.2, @testing-library/jest-dom 6.6.3 [Source: package.json]
+- **数据库**: MySQL 8.0.36 + TypeORM 0.3.25 [Source: package.json]
+- **现有配置**: Jest支持jsdom环境 [Source: jest.config.js]
+
+### 集成测试需求
+**API集成测试重点**:
+- Hono路由端到端测试
+- 认证中间件集成验证
+- 数据库操作完整流程
+- 错误处理链测试
+
+**React组件集成测试重点**:
+- 组件渲染和交互测试
+- 状态管理和副作用
+- 路由和导航测试
+- 表单验证和提交
+
+### 测试环境配置
+**API测试环境**:
+```typescript
+// 测试服务器启动配置
+const testServer = () => {
+  const app = new Hono()
+  // 加载所有路由
+  return app
+}
+
+// 测试数据库配置
+const testDataSource = new DataSource({
+  type: 'mysql',
+  // 使用测试数据库或内存数据库
+})
+```
+
+**组件测试环境**:
+基于现有Vite + React 19配置 [Source: package.json]，需要配置：
+- JS DOM环境设置
+- CSS和样式处理
+- React Router测试集成
+- React Query测试配置
+
+### 文件结构规划
+基于现有项目结构 [Source: architecture.md#源码树和文件组织]:
+```
+src/
+├── server/
+│   ├── api/
+│   │   ├── __integration_tests__/    # API集成测试
+│   │   │   ├── auth.integration.test.ts
+│   │   │   ├── users.integration.test.ts
+│   │   │   └── roles.integration.test.ts
+│   ├── __test_utils__/               # 测试工具
+│   │   ├── test-server.ts
+│   │   ├── test-db.ts
+│   │   └── api-client.ts
+├── client/
+│   ├── __integration_tests__/        # 组件集成测试
+│   │   ├── components/
+│   │   │   ├── Form.integration.test.tsx
+│   │   │   └── Table.integration.test.tsx
+│   │   ├── pages/
+│   │   │   ├── Login.integration.test.tsx
+│   │   │   └── Dashboard.integration.test.tsx
+│   ├── __test_utils__/
+│   │   ├── test-render.tsx
+│   │   ├── test-router.tsx
+│   │   └── test-query.tsx
+```
+
+### Mock策略和技术
+**数据库Mock**:
+- 使用测试数据库实例
+- 事务回滚确保测试隔离
+- 种子数据工厂函数
+
+**外部服务Mock**:
+- Jest mock模块功能
+- Mock Service Worker (MSW) for HTTP
+- 自定义stub实现
+
+**认证Mock**:
+- Mock JWT令牌生成
+- 模拟用户会话
+- 权限验证stub
+
+### 集成测试模式
+**API测试模式**:
+```typescript
+describe('API Integration', () => {
+  let server: Hono
+
+  beforeAll(async () => {
+    server = createTestServer()
+    await setupTestDatabase()
+  })
+
+  it('should return users list', async () => {
+    const response = await server.request('/api/v1/users')
+    expect(response.status).toBe(200)
+  })
+})
+```
+
+**组件测试模式**:
+```typescript
+describe('Component Integration', () => {
+  it('should render and interact', async () => {
+    render(<LoginForm />)
+
+    await userEvent.type(screen.getByLabelText('Email'), 'test@example.com')
+    await userEvent.click(screen.getByRole('button', { name: 'Login' }))
+
+    expect(...).toBeInTheDocument()
+  })
+})
+```
+
+### 技术约束和要求
+- **性能**: 集成测试执行时间控制在合理范围内
+- **隔离性**: 测试之间完全隔离，无状态污染
+- **可靠性**: 测试结果稳定可靠，无随机失败
+- **可维护性**: 测试代码清晰易维护
+
+### 集成点
+- **构建流程**: 集成到现有测试命令
+- **CI/CD**: 支持并行测试执行
+- **开发体验**: 快速反馈和调试支持
+
+## Testing
+
+### 测试策略
+- **集成测试范围**: 多组件/服务协作测试
+- **环境要求**: 接近生产环境的测试配置
+- **数据管理**: 测试数据生命周期管理
+- **网络模拟**: HTTP请求拦截和mock
+
+### 测试覆盖目标
+- **API端点**: 主要业务端点100%覆盖
+- **关键流程**: 用户旅程和核心业务流程
+- **错误场景**: 主要错误处理路径
+- **性能基准**: 关键接口性能验证
+
+### 测试环境
+- **Node.js服务器**: Hono应用完整启动
+- **数据库**: 测试数据库实例
+- **浏览器环境**: jsdom模拟浏览器
+- **网络环境**: 模拟HTTP请求响应
+
+## Change Log
+| Date | Version | Description | Author |
+|------|---------|-------------|--------|
+| 2025-09-15 | 1.0 | 初始故事创建 | Bob (Scrum Master) |
+
+## Dev Agent Record
+
+### Agent Model Used
+
+### Debug Log References
+
+### Completion Notes List
+
+### File List
+
+## QA Results

docs/stories/001.003.story.md

@@ -0,0 +1,215 @@
+# Story 001.003: 端到端测试流水线
+
+## Status
+Draft
+
+## Story
+**As a** 质量保证工程师
+**I want** 建立完整的端到端测试框架和CI/CD集成
+**so that** 我可以自动化验证完整的用户流程和系统功能，确保发布质量
+
+## Acceptance Criteria
+1. 建立完整的E2E测试框架
+2. 配置CI/CD流水线中的测试执行
+3. 创建测试报告和结果分析
+4. 设置测试失败警报机制
+
+## Tasks / Subtasks
+- [ ] 选择和配置E2E测试框架 (AC: 1)
+  - [ ] 评估Playwright vs Cypress vs其他选项
+  - [ ] 安装和配置选定框架
+  - [ ] 设置测试浏览器环境
+- [ ] 创建核心E2E测试用例 (AC: 1)
+  - [ ] 用户认证流程E2E测试
+  - [ ] 用户管理功能E2E测试
+  - [ ] 数据CRUD操作E2E测试
+- [ ] 集成到CI/CD流水线 (AC: 2)
+  - [ ] 配置GitHub Actions工作流
+  - [ ] 设置测试环境变量和密钥
+  - [ ] 实现测试并行执行
+- [ ] 实现测试报告和分析 (AC: 3)
+  - [ ] 配置测试结果报告生成
+  - [ ] 创建测试覆盖率可视化
+  - [ ] 实现历史结果跟踪
+- [ ] 设置警报和监控 (AC: 4)
+  - [ ] 配置测试失败通知
+  - [ ] 实现性能基准监控
+  - [ ] 创建测试健康度仪表板
+
+## Dev Notes
+
+### 现有技术栈分析
+- **前端框架**: React 19.1.0 + Vite 7.0.0 [Source: package.json]
+- **后端框架**: Hono 4.8.5 + Node.js 20.18.3 [Source: package.json]
+- **数据库**: MySQL 8.0.36 [Source: package.json]
+- **部署环境**: Docker Compose [Source: architecture.md]
+
+### E2E测试需求
+**关键用户流程**:
+- 用户注册和登录完整流程
+- 管理后台功能操作流程
+- 数据创建、读取、更新、删除流程
+- 错误处理和边界场景
+
+**技术考量**:
+- 跨浏览器兼容性测试
+- 移动端响应式测试
+- 性能和时间敏感性测试
+- 可访问性测试
+
+### 框架选择评估
+**Playwright优势**:
+- 多浏览器支持（Chromium, Firefox, WebKit）
+- 自动等待和智能选择器
+- 强大的调试工具
+- 微软维护，生态成熟
+
+**Cypress优势**:
+- 优秀的开发体验
+- 时间旅行调试
+- 丰富的插件生态
+- 社区活跃
+
+**推荐选择**: Playwright（基于现有技术栈和需求）
+
+### 测试环境配置
+**本地开发环境**:
+```yaml
+# docker-compose.test.yml
+test-db:
+  image: mysql:8.0.36
+  environment:
+    MYSQL_DATABASE: test_d8dai
+    MYSQL_ROOT_PASSWORD: test_password
+
+test-app:
+  build: .
+  environment:
+    NODE_ENV: test
+    DATABASE_URL: mysql://root:test_password@test-db:3306/test_d8dai
+```
+
+**CI/CD环境**:
+- GitHub Actions工作流
+- 测试专用环境变量
+- 并行测试执行配置
+- 资源清理和回收
+
+### 文件结构规划
+基于现有项目结构 [Source: architecture.md#源码树和文件组织]:
+```
+tests/
+├── e2e/
+│   ├── specs/                       # E2E测试用例
+│   │   ├── auth/                    # 认证相关测试
+│   │   │   ├── login.spec.ts
+│   │   │   ├── register.spec.ts
+│   │   │   └── logout.spec.ts
+│   │   ├── users/                   # 用户管理测试
+│   │   │   ├── user-crud.spec.ts
+│   │   │   └── profile.spec.ts
+│   │   ├── admin/                   # 管理后台测试
+│   │   │   ├── dashboard.spec.ts
+│   │   │   └── settings.spec.ts
+│   ├── fixtures/                    # 测试数据
+│   │   ├── users.json
+│   │   ├── roles.json
+│   │   └── test-data.ts
+│   ├── pages/                       # 页面对象模型
+│   │   ├── login.page.ts
+│   │   ├── dashboard.page.ts
+│   │   └── user-list.page.ts
+│   ├── utils/                       # 测试工具
+│   │   ├── test-setup.ts
+│   │   ├── test-teardown.ts
+│   │   └── helpers.ts
+├── playwright.config.ts             # Playwright配置
+├── global-setup.ts                  # 全局设置
+└── global-teardown.ts               # 全局清理
+```
+
+### CI/CD集成策略
+**GitHub Actions工作流**:
+```yaml
+name: E2E Tests
+on: [push, pull_request]
+
+jobs:
+  e2e-tests:
+    runs-on: ubuntu-latest
+    services:
+      mysql:
+        image: mysql:8.0.36
+        env:
+          MYSQL_DATABASE: test_d8dai
+          MYSQL_ROOT_PASSWORD: test_password
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+      - run: npm ci
+      - run: npm run build
+      - run: npx playwright install --with-deps
+      - run: npm run test:e2e
+```
+
+### 报告和监控
+**测试报告**:
+- HTML测试报告生成
+- JUnit XML格式输出
+- 测试覆盖率报告
+- 性能指标收集
+
+**警报机制**:
+- Slack/Teams测试失败通知
+- 邮件警报重要故障
+- 性能退化检测
+- 测试健康度监控
+
+### 技术约束和要求
+- **执行时间**: E2E测试总时间控制在10分钟以内
+- **稳定性**: 测试结果稳定，误报率低
+- **可维护性**: 测试代码清晰，易于维护
+- **扩展性**: 支持后续测试用例扩展
+
+### 集成点
+- **版本控制**: 与Git分支策略集成
+- **部署流程**: 测试通过后才能部署
+- **监控系统**: 与现有监控工具集成
+- **文档系统**: 测试报告集成到文档
+
+## Testing
+
+### 测试策略
+- **E2E测试范围**: 完整用户流程验证
+- **环境要求**: 生产-like测试环境
+- **数据策略**: 测试数据隔离和清理
+- **执行模式**: 并行执行优化速度
+
+### 测试覆盖目标
+- **关键用户旅程**: 100%覆盖主要业务流程
+- **跨浏览器**: 主要浏览器兼容性验证
+- **移动端**: 响应式设计验证
+- **性能**: 关键路径性能基准
+
+### 测试环境
+- **浏览器**: Chromium, Firefox, WebKit
+- **设备模拟**: 桌面、平板、手机
+- **网络条件**: 不同网络速度模拟
+- **地理位置**: 多区域测试支持
+
+## Change Log
+| Date | Version | Description | Author |
+|------|---------|-------------|--------|
+| 2025-09-15 | 1.0 | 初始故事创建 | Bob (Scrum Master) |
+
+## Dev Agent Record
+
+### Agent Model Used
+
+### Debug Log References
+
+### Completion Notes List
+
+### File List
+
+## QA Results