Merge remote-tracking branch 'upstream/server-test' into server-test

.github/workflows/component-tests.yml

@@ -4,16 +4,16 @@ on:
   push:
     branches: [ main, develop ]
     paths:
-      - 'src/client/**'
-      - 'src/client/__integration_tests__/**'
-      - 'vitest.config.components.ts'
+      - 'web/src/client/**'
+      - 'web/tests/unit/**'
+      - 'web/vitest.config.components.ts'
       - '.github/workflows/component-tests.yml'
   pull_request:
     branches: [ main ]
     paths:
-      - 'src/client/**'
-      - 'src/client/__integration_tests__/**'
-      - 'vitest.config.components.ts'
+      - 'web/src/client/**'
+      - 'web/tests/unit/**'
+      - 'web/vitest.config.components.ts'
       - '.github/workflows/component-tests.yml'
   workflow_dispatch:
 
@@ -41,7 +41,9 @@ jobs:
       run: pnpm install --frozen-lockfile
 
     - name: Run component tests
-      run: pnpm test:components
+      run: |
+        cd web
+        pnpm test:components
 
     - name: Upload test results
       if: always()
@@ -55,7 +57,9 @@ jobs:
 
     - name: Generate coverage report
       if: success()
-      run: pnpm test:components:coverage
+      run: |
+        cd web
+        pnpm test:components:coverage
 
     - name: Upload coverage to Codecov
       if: success()

.github/workflows/e2e-tests.yml

@@ -3,8 +3,16 @@ name: E2E Tests
 on:
   push:
     branches: [ main, develop ]
+    paths:
+      - 'web/tests/e2e/**'
+      - 'web/src/**'
+      - '.github/workflows/e2e-tests.yml'
   pull_request:
     branches: [ main ]
+    paths:
+      - 'web/tests/e2e/**'
+      - 'web/src/**'
+      - '.github/workflows/e2e-tests.yml'
   workflow_dispatch:
 
 jobs:
@@ -63,6 +71,7 @@ jobs:
     - name: Run E2E tests
       run: |
         export NODE_ENV=test
+        cd web
         pnpm test:e2e --project=chromium
       env:
         E2E_BASE_URL: http://localhost:8080
@@ -91,7 +100,9 @@ jobs:
 
     - name: Analyze test results
       if: always()
-      run: pnpm test:analyze
+      run: |
+        cd web
+        pnpm test:analyze
 
     - name: Notify on failure
       if: failure()

.github/workflows/integration-tests.yml

@@ -4,16 +4,12 @@ on:
   push:
     branches: [ main, develop ]
     paths:
-      - 'src/server/api/**'
-      - 'src/server/__test_utils__/**'
-      - 'src/client/__integration_tests__/**'
+      - 'web/tests/integration/**'
       - '.github/workflows/integration-tests.yml'
   pull_request:
     branches: [ main ]
     paths:
-      - 'src/server/api/**'
-      - 'src/server/__test_utils__/**'
-      - 'src/client/__integration_tests__/**'
+      - 'web/tests/integration/**'
       - '.github/workflows/integration-tests.yml'
   workflow_dispatch:
 
@@ -70,6 +66,7 @@ jobs:
     - name: Run integration tests
       run: |
         export NODE_ENV=test
+        cd web
         pnpm test:integration
 
     - name: Upload test results

.github/workflows/server-tests.yml

@@ -0,0 +1,125 @@
+name: Server Tests
+
+on:
+  push:
+    branches: [ main, develop ]
+    paths:
+      - 'packages/server/**'
+      - '.github/workflows/server-tests.yml'
+  pull_request:
+    branches: [ main ]
+    paths:
+      - 'packages/server/**'
+      - '.github/workflows/server-tests.yml'
+  workflow_dispatch:
+
+jobs:
+  server-tests:
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+
+    services:
+      postgres:
+        image: postgres:17
+        env:
+          POSTGRES_DB: test_d8dai
+          POSTGRES_USER: postgres
+          POSTGRES_PASSWORD: test_password
+        options: >-
+          --health-cmd="pg_isready -U postgres"
+          --health-interval=10s
+          --health-timeout=5s
+          --health-retries=3
+        ports:
+          - 5432:5432
+
+    steps:
+    - name: Checkout code
+      uses: actions/checkout@v4
+
+    - name: Setup Node.js
+      uses: actions/setup-node@v4
+      with:
+        node-version: '20'
+        cache: 'pnpm'
+
+    - name: Install pnpm
+      uses: pnpm/action-setup@v2
+      with:
+        version: 8
+
+    - name: Install dependencies
+      run: pnpm install --frozen-lockfile
+
+    - name: Setup test environment
+      run: |
+        cp .env.test.example .env.test
+        echo "TEST_DATABASE_URL=postgresql://postgres:test_password@localhost:5432/test_d8dai" >> .env.test
+        echo "NODE_ENV=test" >> .env.test
+        echo "JWT_SECRET=test_jwt_secret_1234567890" >> .env.test
+
+    - name: Run database migrations
+      run: |
+        export NODE_ENV=test
+        cd packages/server
+        pnpm db:migrate
+
+    - name: Run server unit tests
+      run: |
+        export NODE_ENV=test
+        cd packages/server
+        pnpm test:unit
+
+    - name: Run server integration tests
+      run: |
+        export NODE_ENV=test
+        cd packages/server
+        pnpm test:integration
+
+    - name: Generate server test coverage
+      run: |
+        export NODE_ENV=test
+        cd packages/server
+        pnpm test:coverage
+
+    - name: Upload test results
+      if: always()
+      uses: actions/upload-artifact@v4
+      with:
+        name: server-test-results
+        path: |
+          packages/server/coverage/
+          packages/server/test-results/
+        retention-days: 7
+
+    - name: Upload coverage to Codecov
+      if: success()
+      uses: codecov/codecov-action@v3
+      with:
+        file: ./packages/server/coverage/coverage-final.json
+        flags: server-tests
+
+    - name: Generate test summary
+      if: always()
+      uses: test-summary/action@v2
+      with:
+        paths: packages/server/test-results/junit.xml
+
+    - name: Notify on failure
+      if: failure()
+      uses: 8398a7/action-slack@v3
+      with:
+        status: ${{ job.status }}
+        channel: '#ci-notifications'
+        webhook_url: ${{ secrets.SLACK_WEBHOOK }}
+      env:
+        SLACK_WEBHOOK_URL: ${{ secrets.SLACK_WEBHOOK }}
+
+    - name: Send test results to GitHub
+      if: always()
+      uses: dorny/test-reporter@v1
+      with:
+        name: Server Tests
+        path: packages/server/test-results/junit.xml
+        reporter: jest-junit
+        fail-on-error: false

docs/architecture/source-tree.md

@@ -3,6 +3,7 @@
 ## 版本信息
 | 版本 | 日期 | 描述 | 作者 |
 |------|------|------|------|
+| 3.1 | 2025-11-09 | 更新测试结构，清理重复测试文件 | James |
 | 3.0 | 2025-10-22 | 更新为 monorepo 结构，添加 packages/server | Winston |
 
 ## 实际项目结构
@@ -109,6 +110,21 @@ d8d-mini-starter/
 │       │   │   └── restore.ts                   # 数据库恢复
 │       │   ├── data-source.ts                   # 数据库连接
 │       │   └── index.ts                         # 服务器入口
+│       ├── tests/              # 服务器测试
+│       │   ├── integration/    # 集成测试
+│       │   │   ├── auth.integration.test.ts      # 认证集成测试
+│       │   │   ├── backup.integration.test.ts    # 备份集成测试
+│       │   │   ├── files.integration.test.ts     # 文件集成测试
+│       │   │   ├── minio.integration.test.ts     # MinIO集成测试
+│       │   │   └── users.integration.test.ts     # 用户集成测试
+│       │   └── unit/           # 单元测试
+│       │       ├── modules/    # 业务模块测试
+│       │       │   ├── file.service.test.ts      # 文件服务测试
+│       │       │   ├── minio.service.test.ts     # MinIO服务测试
+│       │       │   └── user.service.test.ts      # 用户服务测试
+│       │       └── utils/      # 工具函数测试
+│       │           ├── backup.test.ts            # 备份工具测试
+│       │           └── restore.test.ts           # 恢复工具测试
 │       └── package.json
 ├── web/                        # Web应用 (Hono + React SSR)
 │   ├── src/
@@ -148,8 +164,13 @@ d8d-mini-starter/
 │   │   └── share/              # 共享代码
 │   ├── tests/
 │   │   ├── e2e/                # E2E测试 (Playwright)
-│   │   ├── integration/        # 集成测试
+│   │   ├── integration/        # Web集成测试
+│   │   │   └── client/         # 客户端集成测试
 │   │   └── unit/               # 单元测试
+│   │       └── client/         # 客户端单元测试
+│   │           ├── pages/      # 页面组件测试
+│   │           │   └── Users.test.tsx           # 用户页面测试
+│   │           └── debug.test.tsx               # 调试测试
 │   └── package.json
 ├── docs/                       # 项目文档
 │   └── architecture/           # 架构文档
@@ -173,9 +194,13 @@ d8d-mini-starter/
 - **数据库**: 使用PostgreSQL + TypeORM
 - **存储**: 使用MinIO进行文件存储
 - **测试结构**:
-  - 单元测试位于`tests/unit/`
-  - 集成测试位于`tests/integration/`
-  - E2E测试位于`tests/e2e/` (Playwright)
+  - **packages/server**: 独立的服务器测试
+    - 单元测试位于`packages/server/tests/unit/`
+    - 集成测试位于`packages/server/tests/integration/`
+  - **web**: Web应用测试
+    - 单元测试位于`web/tests/unit/`
+    - 集成测试位于`web/tests/integration/`
+    - E2E测试位于`web/tests/e2e/` (Playwright)
 - **开发环境**: 多八多云端开发容器，包含Node.js 20.19.2、PostgreSQL 17、Redis 7、MinIO
 - **构建工具**: 使用Vite + pnpm，支持SSR构建
 - **架构优势**:

docs/architecture/testing-strategy.md

@@ -3,20 +3,30 @@
 ## 版本信息
 | 版本 | 日期 | 描述 | 作者 |
 |------|------|------|------|
+| 2.7 | 2025-11-09 | 更新为monorepo测试架构，清理重复测试文件 | James |
 | 2.6 | 2025-10-15 | 完成遗留测试文件迁移到统一的tests目录结构 | Winston |
 | 2.5 | 2025-10-14 | 更新测试文件位置到统一的tests目录结构 | Claude |
 | 2.4 | 2025-09-20 | 更新测试策略与主架构文档版本一致 | Winston |
 
 ## 概述
 
-本文档定义了D8D Starter项目的完整测试策略，基于现有的测试基础设施和最佳实践。测试策略遵循测试金字塔模型，确保代码质量、功能稳定性和系统可靠性。
+本文档定义了D8D Starter项目的完整测试策略，基于monorepo架构和现有的测试基础设施。测试策略遵循测试金字塔模型，确保代码质量、功能稳定性和系统可靠性。
+
+### 测试架构更新 (v2.7)
+
+项目已重构为monorepo结构，测试架构相应调整为：
+- **packages/server**: 独立的API服务器包，包含单元测试和集成测试
+- **web**: Web应用，包含组件测试、集成测试和E2E测试
+- **CI/CD**: 独立的工作流分别处理server和web的测试
 
 ## 测试金字塔策略
 
 ### 单元测试 (Unit Tests)
 - **范围**: 单个函数、类或组件
 - **目标**: 验证独立单元的correctness
-- **位置**: `tests/unit/**/*.test.{ts,tsx}`
+- **位置**:
+  - `packages/server/tests/unit/**/*.test.ts` (服务器单元测试)
+  - `web/tests/unit/**/*.test.{ts,tsx}` (Web组件单元测试)
 - **框架**: Vitest
 - **覆盖率目标**: ≥ 80%
 - **执行频率**: 每次代码变更
@@ -24,7 +34,9 @@
 ### 集成测试 (Integration Tests)
 - **范围**: 多个组件/服务协作
 - **目标**: 验证模块间集成和交互
-- **位置**: `tests/integration/**/*.test.{ts,tsx}`
+- **位置**:
+  - `packages/server/tests/integration/**/*.test.ts` (服务器集成测试)
+  - `web/tests/integration/**/*.test.{ts,tsx}` (Web集成测试)
 - **框架**: Vitest + Testing Library + hono/testing
 - **覆盖率目标**: ≥ 60%
 - **执行频率**: 每次API变更
@@ -32,7 +44,7 @@
 ### E2E测试 (End-to-End Tests)
 - **范围**: 完整用户流程
 - **目标**: 验证端到端业务流程
-- **位置**: `tests/e2e/**/*.test.{ts,tsx}`
+- **位置**: `web/tests/e2e/**/*.test.{ts,tsx}`
 - **框架**: Playwright
 - **覆盖率目标**: 关键用户流程100%
 - **执行频率**: 每日或每次重大变更
@@ -72,31 +84,42 @@ export default defineConfig({
 
 ### CI/CD环境
 ```yaml
-# GitHub Actions 测试配置
+# GitHub Actions 测试配置 (Monorepo架构)
 name: Test Pipeline
 
 jobs:
-  unit-tests:
+  server-tests:
     runs-on: ubuntu-latest
+    services:
+      postgres:
+        image: postgres:17
+        env:
+          POSTGRES_PASSWORD: test_password
+          POSTGRES_DB: test_d8dai
     steps:
-      - run: npm run test:api
-      - run: npm run test:components
+      - run: cd packages/server && pnpm test:unit
+      - run: cd packages/server && pnpm test:integration
 
-  integration-tests:
+  web-integration-tests:
     runs-on: ubuntu-latest
     services:
       postgres:
-        image: postgres:15
+        image: postgres:17
         env:
-          POSTGRES_PASSWORD: postgres
-          POSTGRES_DB: test_db
+          POSTGRES_PASSWORD: test_password
+          POSTGRES_DB: test_d8dai
     steps:
-      - run: npm run test:integration
+      - run: cd web && pnpm test:integration
 
-  e2e-tests:
+  web-component-tests:
     runs-on: ubuntu-latest
     steps:
-      - run: npm run test:e2e:chromium
+      - run: cd web && pnpm test:components
+
+  web-e2e-tests:
+    runs-on: ubuntu-latest
+    steps:
+      - run: cd web && pnpm test:e2e:chromium
 ```
 
 ## 测试覆盖率标准
@@ -147,21 +170,41 @@ const inactiveUser = createTestUser({ active: false });
 ## 测试执行流程
 
 ### 本地开发测试
+
+#### packages/server
+```bash
+# 运行所有测试
+pnpm test
+
+# 运行单元测试
+pnpm test:unit
+
+# 运行集成测试
+pnpm test:integration
+
+# 生成覆盖率报告
+pnpm test:coverage
+```
+
+#### web
 ```bash
 # 运行所有测试
-npm test
+pnpm test
 
 # 运行单元测试
-npm run test:unit
+pnpm test:unit
 
 # 运行集成测试
-npm run test:integration
+pnpm test:integration
+
+# 运行组件测试
+pnpm test:components
 
 # 运行E2E测试
-npm run test:e2e:chromium
+pnpm test:e2e:chromium
 
 # 生成覆盖率报告
-npm run test:coverage
+pnpm test:coverage
 ```
 
 ### CI/CD流水线测试
@@ -283,6 +326,7 @@ describe('UserService', () => {
 ### 更新日志
 | 日期 | 版本 | 描述 |
 |------|------|------|
+| 2025-11-09 | 2.7 | 更新为monorepo测试架构，清理重复测试文件 |
 | 2025-10-15 | 2.6 | 完成遗留测试文件迁移到统一的tests目录结构 |
 | 2025-10-14 | 2.5 | 重构测试文件结构，统一到tests目录 |
 | 2025-09-20 | 2.4 | 更新版本与主架构文档一致 |

docs/prd/epic-005-server-test-migration.md

@@ -0,0 +1,104 @@
+# Server测试迁移优化 - Brownfield Epic
+
+## Epic Goal
+将当前web目录中对packages/server的测试迁移到packages/server目录中，实现更好的代码组织和测试架构，使packages/server成为一个真正独立的、可测试的库包。
+
+## Epic Description
+
+### 现有系统上下文
+- **当前测试结构**：所有测试集中在web/tests目录下，包括对packages/server的单元测试和集成测试
+- **packages/server现状**：纯库包，没有任何测试配置和测试文件
+- **技术栈**：Node.js + TypeScript + Hono + TypeORM + PostgreSQL + Vitest
+- **集成点**：数据库连接、服务层、工具类、API路由
+
+### 迁移详情
+- **迁移内容**：将web/tests中针对packages/server的单元测试和部分集成测试迁移到packages/server目录
+- **保留内容**：前端组件测试、E2E测试、需要web特定环境的集成测试
+- **目标架构**：
+  - packages/server成为独立的可测试库包
+  - web目录专注于前端和端到端测试
+  - 测试工具类在适当位置共享
+
+### 迁移优先级
+1. **高优先级**：服务层单元测试（UserService、FileService、MinioService等）
+2. **中优先级**：工具类单元测试（backup、restore、jwt等）
+3. **低优先级**：集成测试（需要评估依赖关系）
+
+## Stories
+
+1. **Story 005.001**: 为packages/server配置测试环境
+   - 在packages/server/package.json中添加测试脚本
+   - 创建packages/server/vitest.config.ts配置文件
+   - 建立packages/server/tests目录结构
+   - 配置测试依赖和工具
+
+2. **Story 005.002**: 迁移服务层单元测试
+   - 迁移UserService相关测试
+   - 迁移FileService相关测试
+   - 迁移MinioService相关测试
+   - 迁移AuthService相关测试
+   - 验证迁移后测试正常运行
+
+3. **Story 005.003**: 迁移工具类单元测试
+   - 迁移backup工具测试
+   - 迁移restore工具测试
+   - 迁移jwt工具测试
+   - 迁移其他工具类测试
+   - 验证迁移后测试正常运行
+
+4. **Story 005.004**: 评估和迁移集成测试
+   - 分析集成测试对web环境的依赖
+   - 迁移适合的集成测试到packages/server
+   - 更新测试工具类的共享使用
+   - 验证集成测试正常运行
+
+5. **Story 005.005**: 清理和优化
+   - 清理web目录中已迁移的测试文件
+   - 更新CI/CD配置支持新的测试结构
+   - 更新文档说明新的测试架构
+   - 验证整体测试覆盖率
+
+## 兼容性要求
+
+- [ ] 现有API保持不变
+- [ ] 测试功能对等（迁移前后测试覆盖相同功能）
+- [ ] 现有测试继续正常工作
+- [ ] 性能影响最小
+- [ ] CI/CD流水线支持新的测试结构
+
+## 风险缓解
+
+- **主要风险**：测试迁移导致测试失败或遗漏
+- **缓解措施**：逐步迁移，保持新旧测试并行运行一段时间
+- **次要风险**：测试工具类依赖关系复杂
+- **缓解措施**：仔细分析依赖，创建适当的共享机制
+- **回滚计划**：恢复原有测试文件，删除packages/server中的测试配置
+
+## 完成定义
+
+- [ ] Story 005.001完成且验收标准满足
+- [ ] 服务层单元测试成功迁移
+- [ ] 工具类单元测试成功迁移
+- [ ] 集成测试评估完成
+- [ ] 测试通过率100%
+- [ ] CI/CD流水线支持新的测试结构
+
+## 验证检查清单
+
+### 范围验证
+- [ ] Epic目标清晰可实现
+- [ ] 故事范围适当
+- [ ] 迁移策略合理
+- [ ] 集成复杂度可控
+
+### 风险评估
+- [ ] 对现有系统风险低
+- [ ] 回滚计划可行
+- [ ] 测试覆盖无遗漏
+- [ ] 团队具备迁移知识
+
+### 完整性检查
+- [ ] Epic目标清晰可实现
+- [ ] 故事范围适当
+- [ ] 成功标准可衡量
+- [ ] 依赖项已识别

docs/stories/005.001.server-test-environment.md

@@ -0,0 +1,138 @@
+# Story 005.001: 为packages/server配置测试环境
+
+**父史诗**: 史诗005 - Server测试迁移优化
+[docs/prd/epic-005-server-test-migration.md](docs/prd/epic-005-server-test-migration.md)
+
+## Status
+Ready for Review
+
+## Story
+**As a** 开发工程师
+**I want** 为packages/server配置完整的测试环境
+**so that** 我可以在独立的服务器包中运行单元测试和集成测试，使packages/server成为一个真正独立的、可测试的库包
+
+## Acceptance Criteria
+1. 在packages/server/package.json中添加测试脚本
+2. 创建packages/server/vitest.config.ts配置文件
+3. 建立packages/server/tests目录结构
+4. 配置测试依赖和工具
+
+## Tasks / Subtasks
+- [x] 在packages/server/package.json中添加测试脚本 (AC: 1)
+  - [x] 添加test脚本运行所有测试
+  - [x] 添加test:unit脚本运行单元测试
+  - [x] 添加test:integration脚本运行集成测试
+  - [x] 添加test:coverage脚本生成覆盖率报告
+  - [x] 添加test:typecheck脚本进行类型检查
+- [x] 创建packages/server/vitest.config.ts配置文件 (AC: 2)
+  - [x] 配置Node.js测试环境
+  - [x] 设置测试别名映射
+  - [x] 配置覆盖率报告
+  - [x] 设置测试超时和排除规则
+- [x] 建立packages/server/tests目录结构 (AC: 3)
+  - [x] 创建tests/unit目录用于单元测试
+  - [x] 创建tests/integration目录用于集成测试
+  - [x] 创建tests/utils目录用于测试工具
+  - [x] 创建tests/fixtures目录用于测试数据
+- [x] 配置测试依赖和工具 (AC: 4)
+  - [x] 添加vitest和测试相关依赖到devDependencies
+  - [x] 配置测试数据库连接
+  - [x] 创建测试设置文件
+  - [x] 复制web/tests/utils/server目录下的测试工具
+  - [x] 验证测试环境正常工作
+
+## Dev Notes
+
+### 技术栈信息
+- **测试框架**: Vitest 3.2.4 [Source: architecture/tech-stack.md#新技术添加]
+- **Node.js版本**: 20.18.3 [Source: architecture/tech-stack.md#现有技术栈维护]
+- **TypeScript**: 5.8.3 [Source: architecture/tech-stack.md#现有技术栈维护]
+
+### 项目结构信息
+- **packages/server位置**: `/packages/server/` [Source: architecture/source-tree.md#实际项目结构]
+- **测试目录结构**:
+  - `tests/unit/` - 单元测试
+  - `tests/integration/` - 集成测试
+  - `tests/utils/` - 测试工具
+  - `tests/fixtures/` - 测试数据 [Source: architecture/source-tree.md#实际项目结构]
+- **现有web测试参考**: `/web/tests/` 目录结构可作为参考 [Source: architecture/source-tree.md#实际项目结构]
+
+### 编码标准和测试策略
+- **测试文件位置**: `__tests__` 文件夹与源码并列 [Source: architecture/coding-standards.md#增强特定标准]
+- **测试类型**: 单元测试、集成测试、E2E测试 [Source: architecture/coding-standards.md#增强特定标准]
+- **覆盖率目标**: 核心业务逻辑 > 80% [Source: architecture/coding-standards.md#增强特定标准]
+
+### 测试策略要求
+- **单元测试范围**: 单个函数、类或组件 [Source: architecture/testing-strategy.md#单元测试-unit-tests]
+- **集成测试范围**: 多个组件/服务协作 [Source: architecture/testing-strategy.md#集成测试-integration-tests]
+- **测试位置**: `tests/unit/**/*.test.{ts,tsx}` 和 `tests/integration/**/*.test.{ts,tsx}` [Source: architecture/testing-strategy.md#单元测试-unit-tests]
+- **覆盖率目标**: 单元测试 ≥ 80%，集成测试 ≥ 60% [Source: architecture/testing-strategy.md#各层覆盖率要求]
+
+### 现有配置参考
+- **web/vitest.config.ts**: 现有的web测试配置可作为参考
+- **web/package.json**: 现有的测试脚本配置可作为参考
+- **web/tests/utils/server/**: 现有的测试工具目录，包含以下重要文件：
+  - `integration-test-db.ts` - 集成测试数据库工具，使用真实PostgreSQL数据库
+  - `integration-test-utils.ts` - 集成测试断言工具
+
+### 项目结构注意事项
+- packages/server目前没有测试配置和测试文件
+- 需要创建与web目录类似的测试目录结构
+- 测试配置需要针对纯Node.js环境（无前端组件测试）
+- web/tests/utils/server目录下的测试工具需要复制到packages/server/tests/utils/目录
+
+### Testing
+
+#### 测试标准
+- **测试框架**: Vitest [Source: architecture/testing-strategy.md#测试框架]
+- **测试位置**: `tests/unit/` 和 `tests/integration/` [Source: architecture/testing-strategy.md#测试位置]
+- **测试文件命名**: `[module].test.ts` 或 `[module].integration.test.ts` [Source: architecture/testing-strategy.md#测试命名约定]
+- **测试描述**: 使用「应该...」格式描述测试行为 [Source: architecture/testing-strategy.md#测试命名约定]
+
+#### 测试环境配置
+- **环境**: Node.js [Source: architecture/testing-strategy.md#开发环境]
+- **别名映射**: 配置 `@` 指向 `src` 目录 [参考 web/vitest.config.ts]
+- **覆盖率**: 使用v8提供者，生成text、lcov、html报告 [参考 web/vitest.config.ts]
+
+#### 测试依赖要求
+- **核心依赖**: vitest, @vitest/coverage-v8
+- **测试工具**: hono/testing (用于API测试)
+- **类型定义**: @types/node (已存在)
+
+#### 测试工具要求
+- **数据库测试工具**: 需要复制web/tests/utils/server目录下的数据库测试工具
+  - `integration-test-db.ts` - 集成测试真实数据库工具
+- **测试断言工具**: 需要复制集成测试断言工具
+  - `integration-test-utils.ts` - 响应状态码、数据结构等断言工具
+
+## Change Log
+| Date | Version | Description | Author |
+|------|---------|-------------|--------|
+| 2025-11-09 | 1.0 | 初始故事创建 | Bob (Scrum Master) |
+
+## Dev Agent Record
+
+### Agent Model Used
+
+### Debug Log References
+
+### Completion Notes List
+- ✅ packages/server/package.json 已包含完整的测试脚本配置
+- ✅ packages/server/vitest.config.ts 已配置完整的测试环境
+- ✅ packages/server/tests 目录结构已建立
+- ✅ 测试工具文件已从 web/tests/utils/server 复制到 packages/server/tests/utils
+- ✅ 更新了 packages/server/tsconfig.json，将 rootDir 改为 "." 并包含 tests 目录
+- ✅ 修复了测试工具文件中的导入路径问题
+- ✅ 测试环境验证通过，所有测试和类型检查正常运行
+- ⚠️ 故事中提到的 test-db.ts、test-auth.ts、service-mocks.ts、service-stubs.ts 文件实际不存在，已确认只有 integration-test-db.ts 和 integration-test-utils.ts 两个文件
+
+### File List
+- [packages/server/package.json](packages/server/package.json) - 测试脚本配置
+- [packages/server/vitest.config.ts](packages/server/vitest.config.ts) - Vitest 配置
+- [packages/server/tsconfig.json](packages/server/tsconfig.json) - TypeScript配置（已更新包含tests目录）
+- [packages/server/tests/unit/example.test.ts](packages/server/tests/unit/example.test.ts) - 示例单元测试
+- [packages/server/tests/utils/setup.ts](packages/server/tests/utils/setup.ts) - 测试设置文件
+- [packages/server/tests/utils/integration-test-db.ts](packages/server/tests/utils/integration-test-db.ts) - 集成测试数据库工具
+- [packages/server/tests/utils/integration-test-utils.ts](packages/server/tests/utils/integration-test-utils.ts) - 集成测试断言工具
+
+## QA Results

docs/stories/005.002.service-layer-unit-tests.md

@@ -0,0 +1,106 @@
+# Story 005.002: 迁移服务层单元测试
+
+**父史诗**: 史诗005 - Server测试迁移优化
+[docs/prd/epic-005-server-test-migration.md](docs/prd/epic-005-server-test-migration.md)
+
+## Status
+Ready for Review
+
+## Story
+**As a** 开发工程师
+**I want** 将服务层单元测试从web目录迁移到packages/server目录
+**so that** 服务层测试与对应的服务代码在同一包中，实现更好的代码组织和测试架构
+
+## Acceptance Criteria
+1. UserService相关测试成功迁移 ✅
+2. FileService相关测试成功迁移 ✅
+3. MinioService相关测试成功迁移 ✅
+4. AuthService相关测试成功迁移 ⚠️ (用户指示跳过，文件不存在)
+5. 验证迁移后测试正常运行 ✅
+
+## Tasks / Subtasks
+- [x] 迁移UserService相关测试
+  - [x] 查找web目录中的UserService测试文件
+  - [x] 迁移测试文件到packages/server/tests/unit/
+  - [x] 更新导入路径和依赖
+  - [x] 验证测试正常运行
+- [x] 迁移FileService相关测试
+  - [x] 查找web目录中的FileService测试文件
+  - [x] 迁移测试文件到packages/server/tests/unit/
+  - [x] 更新导入路径和依赖
+  - [x] 验证测试正常运行
+- [x] 迁移MinioService相关测试
+  - [x] 查找web目录中的MinioService测试文件
+  - [x] 迁移测试文件到packages/server/tests/unit/
+  - [x] 更新导入路径和依赖
+  - [x] 验证测试正常运行
+- [ ] 迁移AuthService相关测试 (已跳过)
+  - [x] 查找web目录中的AuthService测试文件
+  - [ ] 迁移测试文件到packages/server/tests/unit/
+  - [ ] 更新导入路径和依赖
+  - [ ] 验证测试正常运行
+- [x] 验证迁移后测试正常运行
+  - [x] 运行所有迁移的单元测试
+  - [x] 验证测试通过率
+  - [x] 检查测试覆盖率
+
+## Dev Notes
+
+### 技术栈信息
+- **测试框架**: Vitest 3.2.4 [Source: architecture/tech-stack.md#新技术添加]
+- **Node.js版本**: 20.18.3 [Source: architecture/tech-stack.md#现有技术栈维护]
+- **TypeScript**: 5.8.3 [Source: architecture/tech-stack.md#现有技术栈维护]
+
+### 项目结构信息
+- **packages/server位置**: `/packages/server/` [Source: architecture/source-tree.md#实际项目结构]
+- **web测试目录**: `/web/tests/` [Source: architecture/source-tree.md#实际项目结构]
+- **目标测试目录**: `/packages/server/tests/unit/` [Source: 005.001.server-test-environment.md]
+
+### 编码标准和测试策略
+- **测试文件位置**: `__tests__` 文件夹与源码并列 [Source: architecture/coding-standards.md#增强特定标准]
+- **测试类型**: 单元测试、集成测试、E2E测试 [Source: architecture/coding-standards.md#增强特定标准]
+- **覆盖率目标**: 核心业务逻辑 > 80% [Source: architecture/coding-standards.md#增强特定标准]
+
+### 服务模块位置
+- **UserService**: `packages/server/src/modules/users/user.service.ts`
+- **FileService**: `packages/server/src/modules/files/file.service.ts`
+- **MinioService**: `packages/server/src/modules/files/minio.service.ts`
+- **AuthService**: `packages/server/src/modules/auth/auth.service.ts`
+
+### 迁移策略
+- 查找web/tests目录中针对上述服务的单元测试
+- 将测试文件迁移到packages/server/tests/unit/对应目录
+- 更新导入路径，使用相对路径或别名
+- 确保测试依赖项正确配置
+- 验证迁移后测试正常运行
+
+## Change Log
+| Date | Version | Description | Author |
+|------|---------|-------------|--------|
+| 2025-11-09 | 1.0 | 初始故事创建 | James (Developer) |
+
+## Dev Agent Record
+
+### Agent Model Used
+Claude Sonnet 4.5
+
+### Debug Log References
+- 成功迁移UserService测试：6个测试全部通过
+- 成功迁移FileService测试：14个测试全部通过
+- 成功迁移MinioService测试：23个测试全部通过
+- AuthService测试文件不存在，已确认web目录中无对应测试文件
+- 所有迁移的单元测试共46个测试全部通过，通过率100%
+
+### Completion Notes List
+- ✅ UserService测试已从web/tests/unit/server/modules/user.service.test.ts成功迁移到packages/server/tests/unit/modules/user.service.test.ts
+- ✅ FileService测试已从web/tests/unit/server/modules/files/file.service.test.ts成功迁移到packages/server/tests/unit/modules/file.service.test.ts
+- ✅ MinioService测试已从web/tests/unit/server/modules/files/minio.service.test.ts成功迁移到packages/server/tests/unit/modules/minio.service.test.ts
+- ⚠️ AuthService测试文件在web目录中不存在，无法迁移
+- ✅ 所有迁移的测试文件已更新导入路径，使用@别名指向src目录
+- ✅ 测试环境验证通过，所有46个测试全部成功运行
+- ✅ 测试通过率100%，符合验收标准
+
+### File List
+- [packages/server/tests/unit/modules/user.service.test.ts](packages/server/tests/unit/modules/user.service.test.ts) - UserService单元测试
+- [packages/server/tests/unit/modules/file.service.test.ts](packages/server/tests/unit/modules/file.service.test.ts) - FileService单元测试
+- [packages/server/tests/unit/modules/minio.service.test.ts](packages/server/tests/unit/modules/minio.service.test.ts) - MinioService单元测试

docs/stories/005.003.story.md

@@ -0,0 +1,111 @@
+# Story 005.003: 迁移工具类单元测试
+
+## Status
+Ready for Review
+
+## Story
+**As a** 开发人员，
+**I want** 将工具类单元测试从 web/tests 迁移到 packages/server/tests 目录，
+**so that** packages/server 成为一个真正独立的、可测试的库包，工具类测试与源代码在同一包内管理
+
+## Acceptance Criteria
+1. 迁移 backup 工具测试
+2. 迁移 restore 工具测试
+3. 验证迁移后测试正常运行
+
+## Tasks / Subtasks
+- [x] 创建 packages/server/tests/unit/utils 目录结构 (AC: 1,2)
+  - [x] 创建目录 packages/server/tests/unit/utils/
+- [x] 迁移 backup 工具测试 (AC: 1)
+  - [x] 复制 web/tests/unit/server/utils/backup.test.ts 内容
+  - [x] 更新导入路径为 @/utils/backup
+  - [x] 验证测试通过
+- [x] 迁移 restore 工具测试 (AC: 2)
+  - [x] 复制 web/tests/unit/server/utils/restore.test.ts 内容
+  - [x] 更新导入路径为 @/utils/restore
+  - [x] 验证测试通过
+- [x] 验证迁移后测试正常运行 (AC: 5)
+  - [x] 运行所有工具类测试
+  - [x] 检查测试覆盖率
+  - [x] 确保没有测试失败
+
+## Dev Notes
+
+### 技术栈信息 [Source: architecture/tech-stack.md]
+- **测试框架**: Vitest 3.2.4
+- **运行时**: Node.js 20.18.3
+- **模块系统**: ES 模块
+- **数据库**: PostgreSQL 17 + TypeORM
+
+### 项目结构信息 [Source: architecture/source-tree.md]
+- **工具类位置**: packages/server/src/utils/
+  - backup.ts - 数据库备份工具
+  - restore.ts - 数据库恢复工具
+  - jwt.util.ts - JWT 工具
+  - logger.ts - 日志工具
+  - errorHandler.ts - 错误处理工具
+- **测试目录结构**: packages/server/tests/
+  - unit/ - 单元测试
+  - integration/ - 集成测试
+  - utils/ - 测试工具
+- **测试文件命名**: [module].test.ts
+
+### 测试策略信息 [Source: architecture/testing-strategy.md]
+- **单元测试位置**: tests/unit/**/*.test.{ts,js}
+- **覆盖率目标**: ≥ 80%
+- **测试标准**: 使用 Vitest 框架，遵循 Arrange-Act-Assert 模式
+- **测试命名**: 使用「应该...」格式描述测试行为
+
+### 工具类功能分析
+- **backup.ts**: 数据库备份工具，包含单例模式、定时备份、文件清理等功能
+- **restore.ts**: 数据库恢复工具，包含备份文件查找、恢复操作等功能
+- **注意**: 当前 web/tests 中只有 backup 和 restore 工具类的单元测试，其他工具类暂时没有专门的单元测试文件
+
+### 迁移注意事项
+- 保持测试功能对等，迁移前后测试覆盖相同功能
+- 更新导入路径为 @d8d/server 包内路径
+- 确保 mock 和依赖注入正确配置
+- 验证测试在 packages/server 环境中正常运行
+
+### Testing
+- **测试文件位置**: packages/server/tests/unit/utils/
+- **测试框架**: Vitest
+- **测试模式**: 单元测试，完全 mock 外部依赖
+- **覆盖率要求**: 工具类测试覆盖率 ≥ 80%
+- **测试标准**:
+  - 使用 vi.mock() 进行依赖 mock
+  - 遵循 Arrange-Act-Assert 模式
+  - 包含边界条件和错误场景测试
+  - 测试文件命名: [tool-name].test.ts
+
+## Change Log
+| Date | Version | Description | Author |
+|------|---------|-------------|--------|
+| 2025-11-09 | 1.1 | 简化范围，只迁移现有测试文件 | Bob (Scrum Master) |
+| 2025-11-09 | 1.0 | 初始故事创建 | Bob (Scrum Master) |
+
+## Dev Agent Record
+
+### Agent Model Used
+- Claude Sonnet 4.5 (claude-sonnet-4-5-20250929)
+
+### Debug Log References
+- 创建了 packages/server/tests/unit/utils/ 目录结构
+- 迁移 backup 工具测试：12个测试全部通过
+- 迁移 restore 工具测试：12个测试全部通过
+- 验证所有工具类测试正常运行：24个测试全部通过
+
+### Completion Notes List
+1. ✅ 成功创建 packages/server/tests/unit/utils 目录结构
+2. ✅ 成功迁移 backup 工具测试，更新导入路径为 @/utils/backup
+3. ✅ 成功迁移 restore 工具测试，更新导入路径为 @/utils/restore
+4. ✅ 验证迁移后测试正常运行，所有24个测试通过
+5. ✅ 测试覆盖率保持稳定，工具类测试功能完整
+
+### File List
+- **新增文件**: packages/server/tests/unit/utils/backup.test.ts
+- **新增文件**: packages/server/tests/unit/utils/restore.test.ts
+- **修改文件**: 无（仅新增迁移后的测试文件）
+- **删除文件**: 无（保留原始测试文件在 web/tests 中）
+
+## QA Results

docs/stories/005.004.story.md

@@ -0,0 +1,138 @@
+# Story 005.004: 评估和迁移集成测试
+
+## Status
+Ready for Review
+
+## Story
+**As a** 开发人员，
+**I want** 评估和迁移适合的集成测试到packages/server目录，
+**so that** packages/server成为一个真正独立的、可测试的库包，集成测试与源代码在同一包内管理
+
+## Acceptance Criteria
+1. 分析集成测试对web环境的依赖
+2. 迁移适合的集成测试到packages/server
+3. 更新测试工具类的共享使用
+4. 验证集成测试正常运行
+
+## Tasks / Subtasks
+- [x] 分析web/tests/integration/server中的集成测试依赖 (AC: 1)
+  - [x] 检查auth.integration.test.ts的web环境依赖
+  - [x] 检查users.integration.test.ts的web环境依赖
+  - [x] 检查files.integration.test.ts的web环境依赖 (文件位于web/tests/integration/server/files/)
+  - [x] 检查minio.integration.test.ts的web环境依赖 (文件位于web/tests/integration/server/files/)
+  - [x] 检查backup.integration.test.ts的web环境依赖
+- [x] 迁移适合的集成测试到packages/server/tests/integration (AC: 2)
+  - [x] 创建packages/server/tests/integration目录结构
+  - [x] 迁移auth.integration.test.ts（如果依赖可解决）
+  - [x] 迁移users.integration.test.ts（如果依赖可解决）
+  - [x] 迁移files.integration.test.ts（如果依赖可解决）
+  - [x] 迁移minio.integration.test.ts（如果依赖可解决）
+  - [x] 迁移backup.integration.test.ts（如果依赖可解决）
+- [x] 更新测试工具类的共享使用 (AC: 3)
+  - [x] 检查packages/server/tests/utils中现有的测试工具
+  - [x] 更新集成测试以使用packages/server中的测试工具
+  - [x] 确保测试工具类路径正确
+- [x] 验证集成测试正常运行 (AC: 4)
+  - [x] 运行所有迁移后的集成测试
+  - [x] 检查测试覆盖率
+  - [x] 确保没有测试失败
+
+## Dev Notes
+
+### 技术栈信息 [Source: architecture/tech-stack.md]
+- **测试框架**: Vitest 3.2.4
+- **运行时**: Node.js 20.18.3
+- **模块系统**: ES 模块
+- **数据库**: PostgreSQL 17 + TypeORM
+- **API框架**: Hono 4.8.5
+- **测试工具**: hono/testing (内置)
+
+### 项目结构信息 [Source: architecture/source-tree.md]
+- **当前集成测试位置**: web/tests/integration/server/
+  - auth.integration.test.ts - 认证API集成测试
+  - users.integration.test.ts - 用户API集成测试
+  - files.integration.test.ts - 文件API集成测试
+  - minio.integration.test.ts - MinIO服务集成测试
+  - backup.integration.test.ts - 备份工具集成测试
+- **目标集成测试位置**: packages/server/tests/integration/
+- **测试工具类位置**:
+  - web/tests/utils/server/integration-test-db.ts
+  - web/tests/utils/server/integration-test-utils.ts
+  - packages/server/tests/utils/integration-test-db.ts (已存在)
+  - packages/server/tests/utils/integration-test-utils.ts (已存在)
+
+### 测试策略信息 [Source: architecture/testing-strategy.md]
+- **集成测试位置**: tests/integration/**/*.test.{ts,tsx}
+- **集成测试框架**: Vitest + Testing Library + hono/testing
+- **集成测试覆盖率目标**: ≥ 60%
+- **测试执行频率**: 每次API变更
+- **测试数据管理**: 使用专用测试数据库，事务回滚
+
+### 先前故事洞察 [Source: docs/stories/005.003.story.md]
+- 工具类测试迁移成功，所有24个测试通过
+- 测试工具类已成功迁移到packages/server/tests/utils/
+- 导入路径需要更新为@/utils/路径
+- 保持测试功能对等，迁移前后测试覆盖相同功能
+
+### 集成测试依赖分析
+- **auth.integration.test.ts**: 依赖hono/testing, @d8d/server包，可能依赖web环境配置
+- **users.integration.test.ts**: 依赖hono/testing, @d8d/server包，用户管理API测试
+- **files.integration.test.ts**: 依赖hono/testing, @d8d/server包，文件上传API测试
+- **minio.integration.test.ts**: 依赖hono/testing, @d8d/server包，MinIO服务测试
+- **backup.integration.test.ts**: 依赖hono/testing, @d8d/server包，备份工具测试
+
+### 迁移注意事项
+- 检查每个集成测试是否依赖web特定环境（如SSR、前端路由等）
+- 如果测试依赖web环境，可能需要重构或保留在web目录
+- 更新导入路径为@d8d/server包内路径
+- 确保mock和依赖注入正确配置
+- 验证测试在packages/server环境中正常运行
+
+### Testing
+- **测试文件位置**: packages/server/tests/integration/
+- **测试框架**: Vitest + hono/testing
+- **测试模式**: 集成测试，使用真实数据库连接
+- **覆盖率要求**: 集成测试覆盖率 ≥ 60%
+- **测试标准**:
+  - 使用真实数据库连接进行集成测试
+  - 遵循Arrange-Act-Assert模式
+  - 包含API端点和业务逻辑集成测试
+  - 测试文件命名: [module].integration.test.ts
+
+## Change Log
+| Date | Version | Description | Author |
+|------|---------|-------------|--------|
+| 2025-11-09 | 1.0 | 初始故事创建 | Bob (Scrum Master) |
+
+## Dev Agent Record
+
+### Agent Model Used
+- Claude Sonnet 4.5 (claude-sonnet-4-5-20250929)
+
+### Debug Log References
+- 修复JWTUtil.generateToken方法以支持expiresIn参数
+- 修复AuthService.generateToken方法以正确传递expiresIn参数
+
+### Completion Notes List
+- ✅ 成功分析所有集成测试的web环境依赖
+- ✅ 发现所有测试都可以迁移到packages/server（无web特定依赖）
+- ✅ 成功迁移auth.integration.test.ts到packages/server
+- ✅ 成功迁移users.integration.test.ts到packages/server
+- ✅ 成功迁移backup.integration.test.ts到packages/server
+- ✅ 成功迁移files.integration.test.ts到packages/server
+- ✅ 成功迁移minio.integration.test.ts到packages/server
+- ✅ 修复JWT令牌过期测试失败问题
+- ✅ 所有集成测试通过验证
+
+### File List
+- **新增文件**:
+  - packages/server/tests/integration/auth.integration.test.ts
+  - packages/server/tests/integration/users.integration.test.ts
+  - packages/server/tests/integration/backup.integration.test.ts
+  - packages/server/tests/integration/files.integration.test.ts
+  - packages/server/tests/integration/minio.integration.test.ts
+- **修改文件**:
+  - packages/server/src/utils/jwt.util.ts (修复expiresIn参数支持)
+  - packages/server/src/modules/auth/auth.service.ts (修复expiresIn参数传递)
+
+## QA Results

docs/stories/005.005.story.md

@@ -0,0 +1,120 @@
+# Story 005.005: 清理和优化
+
+## Status
+Draft
+
+## Story
+**As a** 开发人员，
+**I want** 清理web目录中已迁移的测试文件并优化测试架构，
+**so that** 项目保持整洁的代码结构，CI/CD流水线支持新的测试架构，文档反映最新的测试组织方式
+
+## Acceptance Criteria
+1. 清理web目录中已迁移的测试文件
+2. 更新CI/CD配置支持新的测试结构
+3. 更新文档说明新的测试架构
+4. 验证整体测试覆盖率
+
+## Tasks / Subtasks
+- [ ] 清理web目录中已迁移的测试文件 (AC: 1)
+  - [ ] 删除web/tests/integration/server/目录下已迁移的集成测试文件
+  - [ ] 删除web/tests/unit/server/目录下已迁移的单元测试文件
+  - [ ] 验证web目录中不再有packages/server相关的测试文件
+- [ ] 更新CI/CD配置支持新的测试结构 (AC: 2)
+  - [ ] 检查GitHub Actions工作流配置
+  - [ ] 更新测试脚本以支持packages/server的独立测试
+  - [ ] 验证CI/CD流水线能够正确运行packages/server的测试
+- [ ] 更新文档说明新的测试架构 (AC: 3)
+  - [ ] 更新测试策略文档反映新的测试结构
+  - [ ] 更新项目结构文档说明测试文件组织
+  - [ ] 添加迁移完成说明到相关文档
+- [ ] 验证整体测试覆盖率 (AC: 4)
+  - [ ] 运行packages/server的测试覆盖率检查
+  - [ ] 运行web目录的测试覆盖率检查
+  - [ ] 验证整体测试覆盖率满足项目要求
+
+## Dev Notes
+
+### 技术栈信息 [Source: architecture/tech-stack.md]
+- **测试框架**: Vitest 3.2.4
+- **运行时**: Node.js 20.18.3
+- **模块系统**: ES 模块
+- **数据库**: PostgreSQL 17 + TypeORM
+- **API框架**: Hono 4.8.5
+- **测试工具**: hono/testing (内置)
+
+### 项目结构信息 [Source: architecture/source-tree.md]
+- **当前web测试位置**: web/tests/
+  - integration/server/ - 已迁移到packages/server的集成测试
+  - unit/server/ - 已迁移到packages/server的单元测试
+- **目标packages/server测试位置**: packages/server/tests/
+  - integration/ - 集成测试
+  - unit/ - 单元测试
+- **CI/CD配置位置**: .github/workflows/
+  - integration-tests.yml
+  - component-tests.yml
+  - e2e-tests.yml
+
+### 测试策略信息 [Source: architecture/testing-strategy.md]
+- **单元测试位置**: tests/unit/**/*.test.{ts,tsx}
+- **集成测试位置**: tests/integration/**/*.test.{ts,tsx}
+- **E2E测试位置**: tests/e2e/**/*.test.{ts,tsx}
+- **测试框架**: Vitest + Testing Library + hono/testing + Playwright
+- **覆盖率目标**: 单元测试 ≥ 80%，集成测试 ≥ 60%
+- **测试执行频率**: 每次代码变更
+
+### 先前故事洞察 [Source: docs/stories/005.003.story.md, docs/stories/005.004.story.md]
+- 工具类单元测试已成功迁移到packages/server/tests/unit/utils/
+- 集成测试已成功迁移到packages/server/tests/integration/
+- 所有迁移的测试在packages/server环境中正常运行
+- 测试覆盖率保持稳定，packages/server当前覆盖率为72.89%
+- 需要清理web目录中重复的测试文件以保持代码整洁
+
+### 需要清理的web测试文件
+- **web/tests/integration/server/**
+  - auth.integration.test.ts (已迁移)
+  - backup.integration.test.ts (已迁移)
+  - files/files.integration.test.ts (已迁移)
+  - files/minio.integration.test.ts (已迁移)
+  - users.integration.test.ts (已迁移)
+- **web/tests/unit/server/**
+  - modules/files/file.service.test.ts (已迁移)
+  - modules/files/minio.service.test.ts (已迁移)
+  - modules/user.service.test.ts (已迁移)
+  - utils/backup.test.ts (已迁移)
+  - utils/restore.test.ts (已迁移)
+
+### CI/CD配置更新需求
+- **GitHub Actions工作流**: 需要更新以支持packages/server的独立测试执行
+- **测试脚本**: web/package.json中的测试脚本可能需要调整
+- **覆盖率报告**: 需要确保packages/server的覆盖率被正确收集和报告
+
+### Testing
+- **测试文件位置**:
+  - packages/server/tests/unit/ 和 packages/server/tests/integration/
+  - web/tests/unit/ 和 web/tests/integration/ (仅保留web特定测试)
+- **测试框架**: Vitest + Testing Library + hono/testing
+- **覆盖率要求**:
+  - packages/server: 单元测试 ≥ 80%，集成测试 ≥ 60%
+  - web: 组件测试 ≥ 70%，集成测试 ≥ 50%
+- **测试标准**:
+  - 删除重复的测试文件
+  - 确保所有测试在正确的位置运行
+  - 验证CI/CD流水线支持新的测试结构
+  - 保持测试覆盖率稳定
+
+## Change Log
+| Date | Version | Description | Author |
+|------|---------|-------------|--------|
+| 2025-11-09 | 1.0 | 初始故事创建 | Bob (Scrum Master) |
+
+## Dev Agent Record
+
+### Agent Model Used
+
+### Debug Log References
+
+### Completion Notes List
+
+### File List
+
+## QA Results

packages/server/package.json

@@ -20,7 +20,12 @@
   "scripts": {
     "build": "tsc",
     "dev": "tsc --watch",
-    "typecheck": "tsc --noEmit"
+    "typecheck": "tsc --noEmit",
+    "test": "vitest",
+    "test:unit": "vitest run tests/unit",
+    "test:integration": "vitest run tests/integration",
+    "test:coverage": "vitest --coverage",
+    "test:typecheck": "tsc --noEmit"
   },
   "dependencies": {
     "@asteasolutions/zod-to-openapi": "^8.1.0",
@@ -47,7 +52,9 @@
     "@types/jsonwebtoken": "^9.0.7",
     "@types/pg": "^8.11.10",
     "tsc-alias": "^1.8.10",
-    "typescript": "^5.8.3"
+    "typescript": "^5.8.3",
+    "vitest": "^3.2.4",
+    "@vitest/coverage-v8": "^3.2.4"
   },
   "files": [
     "src"

packages/server/src/modules/auth/auth.service.ts

@@ -70,7 +70,7 @@ export class AuthService {
   }
 
   generateToken(user: User, expiresIn?: string): string {
-    return JWTUtil.generateToken(user, expiresIn ? { expiresIn } as any : {});
+    return JWTUtil.generateToken(user, {}, expiresIn);
   }
 
   verifyToken(token: string): any {

packages/server/src/utils/jwt.util.ts

@@ -22,9 +22,10 @@ export class JWTUtil {
    * 生成 JWT token
    * @param user 用户实体
    * @param additionalPayload 额外的 payload 数据
+   * @param expiresIn 过期时间
    * @returns JWT token
    */
-  static generateToken(user: UserEntity, additionalPayload: Partial<JWTPayload> = {}): string {
+  static generateToken(user: UserEntity, additionalPayload: Partial<JWTPayload> = {}, expiresIn?: string): string {
     if (!user.id || !user.username) {
       throw new Error('用户ID和用户名不能为空');
     }
@@ -38,7 +39,10 @@ export class JWTUtil {
     };
 
     try {
-      return jwt.sign(payload, JWT_SECRET, { expiresIn: JWT_EXPIRES_IN as SignOptions['expiresIn']});
+      const options: SignOptions = {
+        expiresIn: expiresIn || JWT_EXPIRES_IN as SignOptions['expiresIn']
+      };
+      return jwt.sign(payload, JWT_SECRET, options);
     } catch (error) {
       logger.error('生成JWT token失败:', error);
       throw new Error('生成token失败');

web/tests/integration/server/auth.integration.test.ts → packages/server/tests/integration/auth.integration.test.ts

@@ -4,12 +4,12 @@ import {
   IntegrationTestDatabase,
   setupIntegrationDatabaseHooks,
   TestDataFactory
-} from '~/utils/server/integration-test-db';
-import { UserEntity } from '@d8d/server/modules/users/user.entity';
-import { authRoutes } from '@d8d/server/api';
-import { AuthService } from '@d8d/server/modules/auth/auth.service';
-import { UserService } from '@d8d/server/modules/users/user.service';
-import { DisabledStatus } from '@d8d/server/share/types';
+} from '../utils/integration-test-db';
+import { UserEntity } from '../../src/modules/users/user.entity';
+import { authRoutes } from '../../src/api';
+import { AuthService } from '../../src/modules/auth/auth.service';
+import { UserService } from '../../src/modules/users/user.service';
+import { DisabledStatus } from '../../src/share/types';
 
 // 设置集成测试钩子
 setupIntegrationDatabaseHooks()

web/tests/integration/server/backup.integration.test.ts → packages/server/tests/integration/backup.integration.test.ts

@@ -1,6 +1,6 @@
 import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest'
-import { databaseBackup } from '@d8d/server/utils/backup'
-import { databaseRestore } from '@d8d/server/utils/restore'
+import { databaseBackup } from '../../src/utils/backup'
+import { databaseRestore } from '../../src/utils/restore'
 import path from 'path'
 
 // Mock pg-dump-restore for integration tests
@@ -43,7 +43,7 @@ vi.mock('node-cron', async (importOriginal) => {
 })
 
 // Mock logger
-vi.mock('@d8d/server/utils/logger', () => ({
+vi.mock('../../src/utils/logger', () => ({
   logger: {
     db: vi.fn(),
     error: vi.fn(),

web/tests/integration/server/files/files.integration.test.ts → packages/server/tests/integration/files.integration.test.ts

@@ -1,14 +1,14 @@
 import { describe, it, expect, beforeEach, vi, afterEach } from 'vitest';
 import { testClient } from 'hono/testing';
-import { FileService } from '@d8d/server/modules/files/file.service';
-import { authMiddleware } from '@d8d/server/middleware/auth.middleware';
-import { fileApiRoutes } from '@d8d/server/api';
-import { ConcreteCrudService } from '@d8d/server/utils/concrete-crud.service';
-
-vi.mock('@d8d/server/modules/files/file.service');
-vi.mock('@d8d/server/middleware/auth.middleware');
-vi.mock('@d8d/server/data-source');
-vi.mock('@d8d/server/utils/concrete-crud.service');
+import { FileService } from '../../src/modules/files/file.service';
+import { authMiddleware } from '../../src/middleware/auth.middleware';
+import { fileApiRoutes } from '../../src/api';
+import { ConcreteCrudService } from '../../src/utils/concrete-crud.service';
+
+vi.mock('../../src/modules/files/file.service');
+vi.mock('../../src/middleware/auth.middleware');
+vi.mock('../../src/data-source');
+vi.mock('../../src/utils/concrete-crud.service');
 
 describe('File API Integration Tests', () => {
   let client: ReturnType<typeof testClient<typeof fileApiRoutes>>['api']['v1'];

web/tests/integration/server/files/minio.integration.test.ts → packages/server/tests/integration/minio.integration.test.ts

@@ -1,11 +1,11 @@
 import { describe, it, expect, beforeEach, afterEach, vi } from 'vitest';
-import { MinioService } from '@d8d/server/modules/files/minio.service';
+import { MinioService } from '../../src/modules/files/minio.service';
 import { Client } from 'minio';
-import { logger } from '@d8d/server/utils/logger';
+import { logger } from '../../src/utils/logger';
 
 // Mock dependencies
 vi.mock('minio');
-vi.mock('@d8d/server/utils/logger');
+vi.mock('../../src/utils/logger');
 
 // Mock process.env using vi.stubEnv for proper isolation
 beforeEach(() => {

web/tests/integration/server/users.integration.test.ts → packages/server/tests/integration/users.integration.test.ts

@@ -4,11 +4,11 @@ import {
   IntegrationTestDatabase,
   setupIntegrationDatabaseHooks,
   TestDataFactory
-} from '~/utils/server/integration-test-db';
-import { IntegrationTestAssertions } from '~/utils/server/integration-test-utils';
-import { userRoutes } from '@d8d/server/api';
-import { AuthService } from '@d8d/server/modules/auth/auth.service';
-import { UserService } from '@d8d/server/modules/users/user.service';
+} from '../utils/integration-test-db';
+import { IntegrationTestAssertions } from '../utils/integration-test-utils';
+import { userRoutes } from '../../src/api';
+import { AuthService } from '../../src/modules/auth/auth.service';
+import { UserService } from '../../src/modules/users/user.service';
 
 
 // 设置集成测试钩子

packages/server/tests/unit/example.test.ts

@@ -0,0 +1,17 @@
+import { describe, it, expect } from 'vitest'
+
+describe('示例单元测试', () => {
+  it('应该通过基本的数学运算测试', () => {
+    expect(1 + 1).toBe(2)
+  })
+
+  it('应该验证字符串操作', () => {
+    const str = 'hello'
+    expect(str.toUpperCase()).toBe('HELLO')
+  })
+
+  it('应该处理异步操作', async () => {
+    const result = await Promise.resolve(42)
+    expect(result).toBe(42)
+  })
+})

web/tests/unit/server/modules/files/file.service.test.ts → packages/server/tests/unit/modules/file.service.test.ts

@@ -1,13 +1,13 @@
 import { describe, it, expect, beforeEach, vi, afterEach } from 'vitest';
 import { DataSource } from 'typeorm';
-import { FileService } from '@d8d/server/modules/files/file.service';
-import { File } from '@d8d/server/modules/files/file.entity';
-import { MinioService } from '@d8d/server/modules/files/minio.service';
-import { logger } from '@d8d/server/utils/logger';
+import { FileService } from '@/modules/files/file.service';
+import { File } from '@/modules/files/file.entity';
+import { MinioService } from '@/modules/files/minio.service';
+import { logger } from '@/utils/logger';
 
 // Mock dependencies
-vi.mock('@d8d/server/modules/files/minio.service');
-vi.mock('@d8d/server/utils/logger');
+vi.mock('@/modules/files/minio.service');
+vi.mock('@/utils/logger');
 vi.mock('uuid', () => ({
   v4: () => 'test-uuid-123'
 }));

web/tests/unit/server/modules/files/minio.service.test.ts → packages/server/tests/unit/modules/minio.service.test.ts

@@ -1,11 +1,11 @@
 import { describe, it, expect, beforeEach, vi, afterEach } from 'vitest';
-import { MinioService } from '@d8d/server/modules/files/minio.service';
+import { MinioService } from '@/modules/files/minio.service';
 import { Client } from 'minio';
-import { logger } from '@d8d/server/utils/logger';
+import { logger } from '@/utils/logger';
 
 // Mock dependencies
 vi.mock('minio');
-vi.mock('@d8d/server/utils/logger');
+vi.mock('@/utils/logger');
 
 // Mock process.env using vi.stubEnv for proper isolation
 beforeEach(() => {

web/tests/unit/server/modules/user.service.test.ts → packages/server/tests/unit/modules/user.service.test.ts

@@ -1,5 +1,5 @@
-import { UserService } from '@d8d/server/modules/users/user.service';
-import { UserEntity as User } from '@d8d/server/modules/users/user.entity';
+import { UserService } from '@/modules/users/user.service';
+import { UserEntity as User } from '@/modules/users/user.entity';
 import * as bcrypt from 'bcrypt';
 import { describe, it, expect, beforeEach, afterEach, vi } from 'vitest';
 

web/tests/unit/server/utils/backup.test.ts → packages/server/tests/unit/utils/backup.test.ts

@@ -1,5 +1,5 @@
 import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest'
-import { DatabaseBackup } from '@d8d/server/utils/backup'
+import { DatabaseBackup } from '@/utils/backup'
 import path from 'path'
 
 // Mock pg-dump-restore
@@ -25,7 +25,7 @@ vi.mock('fs', () => ({
 }))
 
 // Mock logger
-vi.mock('@d8d/server/utils/logger', () => ({
+vi.mock('@/utils/logger', () => ({
   logger: {
     db: vi.fn(),
     error: vi.fn(),
@@ -66,7 +66,7 @@ describe('DatabaseBackup', () => {
 
     it('应该在创建目录失败时抛出错误', async () => {
       const fs = await import('fs')
-      const { logger } = await import('@d8d/server/utils/logger')
+      const { logger } = await import('@/utils/logger')
 
       vi.mocked(fs.promises.mkdir).mockRejectedValueOnce(new Error('创建目录失败'))
 
@@ -147,7 +147,7 @@ describe('DatabaseBackup', () => {
   describe('cleanupOldBackups', () => {
     it('应该清理7天前的旧备份', async () => {
       const fs = await import('fs')
-      const { logger } = await import('@d8d/server/utils/logger')
+      const { logger } = await import('@/utils/logger')
 
       const now = Date.now()
       const oldFileTime = now - (8 * 24 * 60 * 60 * 1000) // 8天前
@@ -167,7 +167,7 @@ describe('DatabaseBackup', () => {
 
     it('应该在清理失败时记录错误但不抛出', async () => {
       const fs = await import('fs')
-      const { logger } = await import('@d8d/server/utils/logger')
+      const { logger } = await import('@/utils/logger')
 
       vi.mocked(fs.promises.readdir).mockRejectedValueOnce(new Error('读取目录失败'))
 
@@ -178,7 +178,7 @@ describe('DatabaseBackup', () => {
 
   describe('startScheduledBackups', () => {
     it('应该启动定时备份任务', async () => {
-      const { logger } = await import('@d8d/server/utils/logger')
+      const { logger } = await import('@/utils/logger')
 
       backup.startScheduledBackups()
 
@@ -189,7 +189,7 @@ describe('DatabaseBackup', () => {
 
   describe('stopScheduledBackups', () => {
     it('应该停止定时备份任务', async () => {
-      const { logger } = await import('@d8d/server/utils/logger')
+      const { logger } = await import('@/utils/logger')
 
       // 先启动再停止
       backup.startScheduledBackups()

web/tests/unit/server/utils/restore.test.ts → packages/server/tests/unit/utils/restore.test.ts

@@ -1,5 +1,5 @@
 import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest'
-import { DatabaseRestore } from '@d8d/server/utils/restore'
+import { DatabaseRestore } from '@/utils/restore'
 import path from 'path'
 
 // Mock pg-dump-restore
@@ -22,7 +22,7 @@ vi.mock('fs', async (importOriginal) => {
 })
 
 // Mock logger
-vi.mock('@d8d/server/utils/logger', () => ({
+vi.mock('@/utils/logger', () => ({
   logger: {
     db: vi.fn(),
     error: vi.fn(),
@@ -110,7 +110,7 @@ describe('DatabaseRestore', () => {
 
     it('应该在读取目录失败时返回null', async () => {
       const fs = await import('fs')
-      const { logger } = await import('@d8d/server/utils/logger')
+      const { logger } = await import('@/utils/logger')
 
       vi.mocked(fs.promises.readdir).mockRejectedValueOnce(new Error('读取目录失败'))
 
@@ -141,7 +141,7 @@ describe('DatabaseRestore', () => {
 
     it('应该在读取目录失败时返回空数组', async () => {
       const fs = await import('fs')
-      const { logger } = await import('@d8d/server/utils/logger')
+      const { logger } = await import('@/utils/logger')
 
       vi.mocked(fs.promises.readdir).mockRejectedValueOnce(new Error('读取目录失败'))
 

web/tests/utils/server/integration-test-db.ts → packages/server/tests/utils/integration-test-db.ts

@@ -1,8 +1,8 @@
 import { DataSource } from 'typeorm';
 import { beforeEach, afterEach } from 'vitest';
-import { UserEntity } from '@d8d/server/modules/users/user.entity';
-import { Role } from '@d8d/server/modules/users/role.entity';
-import { AppDataSource } from '@d8d/server/data-source';
+import { UserEntity } from '../../src/modules/users/user.entity';
+import { Role } from '../../src/modules/users/role.entity';
+import { AppDataSource } from '../../src/data-source';
 
 /**
  * 集成测试数据库工具类 - 使用真实PostgreSQL数据库

web/tests/utils/server/integration-test-utils.ts → packages/server/tests/utils/integration-test-utils.ts

@@ -1,8 +1,5 @@
-
 import { IntegrationTestDatabase } from './integration-test-db';
-import { UserEntity } from '@d8d/server/modules/users/user.entity';
-
-
+import { UserEntity } from '../../src/modules/users/user.entity';
 
 /**
  * 集成测试断言工具

packages/server/tests/utils/setup.ts

@@ -0,0 +1,21 @@
+import { beforeAll, afterAll } from 'vitest'
+
+/**
+ * 全局测试设置文件
+ * 这个文件在运行任何测试之前执行
+ */
+
+// 全局测试设置
+beforeAll(async () => {
+  // 设置全局测试环境变量
+  process.env.NODE_ENV = 'test'
+
+  // 可以在这里初始化全局测试资源
+  console.log('测试环境初始化完成')
+})
+
+// 全局测试清理
+afterAll(async () => {
+  // 清理全局测试资源
+  console.log('测试环境清理完成')
+})

packages/server/tsconfig.json

@@ -14,7 +14,7 @@
     "noUncheckedIndexedAccess": true,
     "noImplicitOverride": true,
     "outDir": "./dist",
-    "rootDir": "./src",
+    "rootDir": ".",
     "declaration": true,
     "skipLibCheck": true,
     
@@ -26,7 +26,8 @@
     }
   },
   "include": [
-    "src/**/*"
+    "src/**/*",
+    "tests/**/*"
   ],
   "exclude": [
     "node_modules",

packages/server/vitest.config.ts

@@ -0,0 +1,51 @@
+import { defineConfig } from 'vitest/config'
+import { resolve } from 'path'
+
+export default defineConfig({
+  test: {
+    globals: true,
+    environment: 'node',
+    include: [
+      'tests/unit/**/*.test.{ts,js}',
+      'tests/integration/**/*.test.{ts,js}'
+    ],
+    exclude: [
+      '**/node_modules/**',
+      '**/dist/**',
+      '**/build/**',
+      '**/coverage/**'
+    ],
+    alias: {
+      '@': resolve(__dirname, './src'),
+    },
+    testTimeout: 10000,
+    setupFiles: ['./tests/utils/setup.ts'],
+    // 覆盖率配置
+    coverage: {
+      provider: 'v8',
+      reporter: ['text', 'lcov', 'html'],
+      reportsDirectory: './coverage',
+      exclude: [
+        '**/node_modules/**',
+        '**/dist/**',
+        '**/build/**',
+        '**/coverage/**',
+        '**/*.d.ts',
+        'tests/**',
+        'scripts/**',
+        '**/index.ts',
+        '**/types.ts',
+        'vitest.config.ts',
+        'data-source.ts'
+      ],
+      thresholds: {
+        branches: 65,
+        functions: 65,
+        lines: 65,
+        statements: 65
+      }
+    },
+    // 关闭并行测试以避免数据库连接冲突
+    fileParallelism: false
+  },
+})

pnpm-lock.yaml

@@ -274,12 +274,18 @@ importers:
       '@types/pg':
         specifier: ^8.11.10
         version: 8.15.5
+      '@vitest/coverage-v8':
+        specifier: ^3.2.4
+        version: 3.2.4(vitest@3.2.4(@types/debug@4.1.12)(@types/node@24.9.1)(happy-dom@18.0.1)(jiti@2.6.1)(jsdom@24.1.3)(lightningcss@1.30.2)(sass@1.93.2)(stylus@0.64.0)(terser@5.44.0)(tsx@4.20.6)(yaml@2.8.1))
       tsc-alias:
         specifier: ^1.8.10
         version: 1.8.16
       typescript:
         specifier: ^5.8.3
         version: 5.8.3
+      vitest:
+        specifier: ^3.2.4
+        version: 3.2.4(@types/debug@4.1.12)(@types/node@24.9.1)(happy-dom@18.0.1)(jiti@2.6.1)(jsdom@24.1.3)(lightningcss@1.30.2)(sass@1.93.2)(stylus@0.64.0)(terser@5.44.0)(tsx@4.20.6)(yaml@2.8.1)
 
   web:
     dependencies:
@@ -10069,7 +10075,7 @@ snapshots:
 
   '@babel/generator@7.24.4':
     dependencies:
-      '@babel/types': 7.24.0
+      '@babel/types': 7.28.4
       '@jridgewell/gen-mapping': 0.3.13
       '@jridgewell/trace-mapping': 0.3.31
       jsesc: 2.5.2
@@ -10223,7 +10229,7 @@ snapshots:
 
   '@babel/parser@7.24.4':
     dependencies:
-      '@babel/types': 7.24.0
+      '@babel/types': 7.28.4
 
   '@babel/parser@7.28.4':
     dependencies:
@@ -10827,8 +10833,8 @@ snapshots:
       '@babel/helper-function-name': 7.24.7
       '@babel/helper-hoist-variables': 7.24.7
       '@babel/helper-split-export-declaration': 7.24.7
-      '@babel/parser': 7.24.4
-      '@babel/types': 7.24.0
+      '@babel/parser': 7.28.4
+      '@babel/types': 7.28.4
       debug: 4.4.3
       globals: 11.12.0
     transitivePeerDependencies:

web/package.json

@@ -19,7 +19,6 @@
     "test:api:coverage": "vitest run --coverage --project=node",
     "test:components:coverage": "vitest run --coverage --project=happy-dom",
     "test:unit": "vitest run tests/unit",
-    "test:integration:server": "vitest run tests/integration/server",
     "test:integration:client": "vitest run tests/integration/client",
     "test:e2e": "playwright test --config=tests/e2e/playwright.config.ts",
     "test:e2e:ui": "playwright test --config=tests/e2e/playwright.config.ts --ui",

web/tests/utils/server/service-mocks.ts

@@ -1,164 +0,0 @@
-import { vi } from 'vitest';
-
-/**
- * 创建HTTP服务mock
- */
-export function createHttpServiceMock() {
-  return {
-    get: vi.fn().mockResolvedValue({ data: {}, status: 200 }),
-    post: vi.fn().mockResolvedValue({ data: {}, status: 201 }),
-    put: vi.fn().mockResolvedValue({ data: {}, status: 200 }),
-    delete: vi.fn().mockResolvedValue({ data: {}, status: 204 }),
-    patch: vi.fn().mockResolvedValue({ data: {}, status: 200 }),
-  };
-}
-
-/**
- * 创建认证服务mock
- */
-export function createAuthServiceMock() {
-  return {
-    verifyToken: vi.fn().mockResolvedValue({ userId: 1, username: 'testuser' }),
-    generateToken: vi.fn().mockReturnValue('mock-jwt-token'),
-    refreshToken: vi.fn().mockResolvedValue({ accessToken: 'new-token', refreshToken: 'new-refresh-token' }),
-    invalidateToken: vi.fn().mockResolvedValue(undefined),
-  };
-}
-
-/**
- * 创建邮件服务mock
- */
-export function createEmailServiceMock() {
-  return {
-    sendWelcomeEmail: vi.fn().mockResolvedValue({ success: true }),
-    sendPasswordResetEmail: vi.fn().mockResolvedValue({ success: true }),
-    sendNotification: vi.fn().mockResolvedValue({ success: true }),
-  };
-}
-
-/**
- * 创建文件存储服务mock
- */
-export function createStorageServiceMock() {
-  return {
-    uploadFile: vi.fn().mockResolvedValue({ url: 'https://example.com/file.jpg', key: 'file-key' }),
-    deleteFile: vi.fn().mockResolvedValue({ success: true }),
-    getFileUrl: vi.fn().mockReturnValue('https://example.com/file.jpg'),
-    listFiles: vi.fn().mockResolvedValue([]),
-  };
-}
-
-/**
- * 创建支付服务mock
- */
-export function createPaymentServiceMock() {
-  return {
-    createPaymentIntent: vi.fn().mockResolvedValue({ clientSecret: 'pi_mock_secret', id: 'pi_mock_id' }),
-    confirmPayment: vi.fn().mockResolvedValue({ success: true, transactionId: 'txn_mock_id' }),
-    refundPayment: vi.fn().mockResolvedValue({ success: true, refundId: 'ref_mock_id' }),
-  };
-}
-
-/**
- * 创建短信服务mock
- */
-export function createSmsServiceMock() {
-  return {
-    sendVerificationCode: vi.fn().mockResolvedValue({ success: true, messageId: 'sms_mock_id' }),
-    sendNotification: vi.fn().mockResolvedValue({ success: true, messageId: 'sms_mock_id' }),
-  };
-}
-
-/**
- * 创建第三方API服务mock
- */
-export function createThirdPartyApiMock() {
-  return {
-    call: vi.fn().mockResolvedValue({ success: true, data: {} }),
-    validate: vi.fn().mockResolvedValue({ valid: true, errors: [] }),
-    webhook: vi.fn().mockResolvedValue({ received: true }),
-  };
-}
-
-/**
- * 模拟网络延迟
- */
-export function mockNetworkDelay(delayMs: number) {
-  return new Promise(resolve => setTimeout(resolve, delayMs));
-}
-
-/**
- * 模拟HTTP错误响应
- */
-export function mockHttpError(status: number, message: string) {
-  return {
-    response: {
-      status,
-      data: { error: message }
-    }
-  };
-}
-
-/**
- * 模拟超时错误
- */
-export function mockTimeoutError() {
-  return new Error('Request timeout');
-}
-
-/**
- * 模拟网络断开错误
- */
-export function mockNetworkError() {
-  return new Error('Network error');
-}
-
-/**
- * 服务mock工具类
- */
-export class ServiceMocks {
-  static http = createHttpServiceMock();
-  static auth = createAuthServiceMock();
-  static email = createEmailServiceMock();
-  static storage = createStorageServiceMock();
-  static payment = createPaymentServiceMock();
-  static sms = createSmsServiceMock();
-  static thirdParty = createThirdPartyApiMock();
-
-  /**
-   * 重置所有mock
-   */
-  static resetAll() {
-    Object.values(this).forEach(service => {
-      if (service && typeof service === 'object') {
-        Object.values(service).forEach(mock => {
-          if (mock && typeof mock === 'function' && 'mockClear' in mock) {
-            (mock as any).mockClear();
-          }
-        });
-      }
-    });
-  }
-
-  /**
-   * 设置所有mock为成功状态
-   */
-  static setupForSuccess() {
-    this.resetAll();
-    // 所有mock默认已经是成功状态
-  }
-
-  /**
-   * 设置所有mock为失败状态
-   */
-  static setupForFailure() {
-    this.resetAll();
-    Object.values(this.http).forEach(mock => mock.mockRejectedValue(mockNetworkError()));
-    Object.values(this.auth).forEach(mock => mock.mockRejectedValue(new Error('Auth failed')));
-    Object.values(this.email).forEach(mock => mock.mockRejectedValue(new Error('Email failed')));
-    Object.values(this.storage).forEach(mock => mock.mockRejectedValue(new Error('Storage failed')));
-    Object.values(this.payment).forEach(mock => mock.mockRejectedValue(new Error('Payment failed')));
-    Object.values(this.sms).forEach(mock => mock.mockRejectedValue(new Error('SMS failed')));
-    Object.values(this.thirdParty).forEach(mock => mock.mockRejectedValue(new Error('Third party failed')));
-  }
-}

web/tests/utils/server/service-stubs.ts

@@ -1,158 +0,0 @@
-import { vi } from 'vitest';
-
-/**
- * 创建模拟的用户服务
- */
-export function createMockUserService() {
-  return {
-    getUserById: vi.fn().mockResolvedValue(null),
-    getUserByUsername: vi.fn().mockResolvedValue(null),
-    getUserByEmail: vi.fn().mockResolvedValue(null),
-    createUser: vi.fn().mockResolvedValue({ id: 1, username: 'testuser' }),
-    updateUser: vi.fn().mockResolvedValue({ affected: 1 }),
-    deleteUser: vi.fn().mockResolvedValue({ affected: 1 }),
-    changePassword: vi.fn().mockResolvedValue({ affected: 1 }),
-    verifyPassword: vi.fn().mockResolvedValue(true),
-    assignRole: vi.fn().mockResolvedValue({ affected: 1 }),
-    removeRole: vi.fn().mockResolvedValue({ affected: 1 })
-  };
-}
-
-/**
- * 创建模拟的认证服务
- */
-export function createMockAuthService() {
-  return {
-    login: vi.fn().mockResolvedValue({
-      token: 'mock-jwt-token',
-      user: { id: 1, username: 'testuser' }
-    }),
-    logout: vi.fn().mockResolvedValue(undefined),
-    register: vi.fn().mockResolvedValue({ id: 1, username: 'newuser' }),
-    verifyToken: vi.fn().mockResolvedValue({ id: 1, username: 'testuser' }),
-    refreshToken: vi.fn().mockResolvedValue({ token: 'new-mock-jwt-token' }),
-    forgotPassword: vi.fn().mockResolvedValue({ success: true }),
-    resetPassword: vi.fn().mockResolvedValue({ success: true })
-  };
-}
-
-/**
- * 创建模拟的角色服务
- */
-export function createMockRoleService() {
-  return {
-    getRoles: vi.fn().mockResolvedValue([]),
-    getRoleById: vi.fn().mockResolvedValue(null),
-    createRole: vi.fn().mockResolvedValue({ id: 1, name: 'admin' }),
-    updateRole: vi.fn().mockResolvedValue({ affected: 1 }),
-    deleteRole: vi.fn().mockResolvedValue({ affected: 1 }),
-    assignPermission: vi.fn().mockResolvedValue({ affected: 1 }),
-    removePermission: vi.fn().mockResolvedValue({ affected: 1 })
-  };
-}
-
-/**
- * 创建模拟的通用CRUD服务
- */
-export function createMockCrudService() {
-  return {
-    findAll: vi.fn().mockResolvedValue([]),
-    findOne: vi.fn().mockResolvedValue(null),
-    create: vi.fn().mockResolvedValue({ id: 1 }),
-    update: vi.fn().mockResolvedValue({ affected: 1 }),
-    delete: vi.fn().mockResolvedValue({ affected: 1 }),
-    count: vi.fn().mockResolvedValue(0),
-    exists: vi.fn().mockResolvedValue(false)
-  };
-}
-
-/**
- * 创建模拟的邮件服务
- */
-export function createMockEmailService() {
-  return {
-    sendWelcomeEmail: vi.fn().mockResolvedValue({ success: true }),
-    sendPasswordResetEmail: vi.fn().mockResolvedValue({ success: true }),
-    sendNotification: vi.fn().mockResolvedValue({ success: true }),
-    verifyEmail: vi.fn().mockResolvedValue({ success: true })
-  };
-}
-
-/**
- * 创建模拟的文件服务
- */
-export function createMockFileService() {
-  return {
-    upload: vi.fn().mockResolvedValue({ url: 'https://example.com/file.jpg' }),
-    download: vi.fn().mockResolvedValue(Buffer.from('test content')),
-    delete: vi.fn().mockResolvedValue({ success: true }),
-    getSignedUrl: vi.fn().mockResolvedValue('https://example.com/signed-url')
-  };
-}
-
-/**
- * 服务stub工具类
- */
-export class ServiceStubManager {
-  private stubs = new Map<string, any>();
-
-  /**
-   * 创建服务stub
-   */
-  createStub<T>(serviceName: string, stubImplementation: Partial<T>): T {
-    const stub = { ...stubImplementation } as T;
-    this.stubs.set(serviceName, stub);
-    return stub;
-  }
-
-  /**
-   * 获取服务stub
-   */
-  getStub<T>(serviceName: string): T | undefined {
-    return this.stubs.get(serviceName);
-  }
-
-  /**
-   * 重置所有stub
-   */
-  resetAll(): void {
-    this.stubs.clear();
-  }
-
-  /**
-   * 重置特定stub
-   */
-  resetStub(serviceName: string): void {
-    this.stubs.delete(serviceName);
-  }
-}
-
-/**
- * 全局服务stub管理器
- */
-export const serviceStubs = new ServiceStubManager();
-
-/**
- * 设置服务mock
- */
-export function setupServiceMocks() {
-  // 用户服务mock
-  vi.mock('@d8d/server/modules/users/user.service', () => ({
-    UserService: vi.fn().mockImplementation(() => serviceStubs.createStub('UserService', createMockUserService()))
-  }));
-
-  // 认证服务mock
-  vi.mock('@d8d/server/modules/auth/auth.service', () => ({
-    AuthService: vi.fn().mockImplementation(() => serviceStubs.createStub('AuthService', createMockAuthService()))
-  }));
-
-  // 角色服务mock
-  vi.mock('@d8d/server/modules/roles/role.service', () => ({
-    RoleService: vi.fn().mockImplementation(() => serviceStubs.createStub('RoleService', createMockRoleService()))
-  }));
-
-  // 通用CRUD服务mock
-  vi.mock('@d8d/server/utils/generic-crud.service', () => ({
-    GenericCRUDService: vi.fn().mockImplementation(() => serviceStubs.createStub('GenericCRUDService', createMockCrudService()))
-  }));
-}

web/tests/utils/server/test-auth.ts

@@ -1,88 +0,0 @@
-import { vi } from 'vitest';
-
-/**
- * 创建模拟的认证上下文
- */
-export function createMockAuthContext(overrides: Partial<any> = {}) {
-  const baseContext = {
-    req: {
-      header: (name: string) => {
-        const headers: Record<string, string> = {
-          'authorization': 'Bearer test-token-123',
-          'content-type': 'application/json',
-          'user-agent': 'vitest/integration-test',
-          'x-request-id': `test_${Math.random().toString(36).substr(2, 9)}`
-        };
-        return headers[name.toLowerCase()] || null;
-      }
-    },
-    set: vi.fn(),
-    json: vi.fn().mockImplementation((data, status = 200) => ({
-      status,
-      body: data
-    })),
-    status: vi.fn().mockReturnThis(),
-    body: vi.fn().mockReturnThis(),
-    env: {
-      NODE_ENV: 'test',
-      DATABASE_URL: process.env.TEST_DATABASE_URL || 'mysql://root:test@localhost:3306/test_d8dai'
-    },
-    var: {},
-    get: vi.fn()
-  };
-
-  return { ...baseContext, ...overrides };
-}
-
-/**
- * 创建模拟的JWT用户信息
- */
-export function createMockJwtPayload(overrides: Partial<any> = {}) {
-  return {
-    sub: '1',
-    username: 'testuser',
-    email: 'test@example.com',
-    roles: ['user'],
-    iat: Math.floor(Date.now() / 1000),
-    exp: Math.floor(Date.now() / 1000) + 3600, // 1小时后过期
-    ...overrides
-  };
-}
-
-/**
- * 创建模拟的认证中间件
- */
-export function createMockAuthMiddleware() {
-  return vi.fn().mockImplementation(async (c: any, next: () => Promise<void>) => {
-    // 模拟认证用户信息
-    c.set('user', {
-      id: 1,
-      username: 'testuser',
-      email: 'test@example.com',
-      roles: ['user']
-    });
-    await next();
-  });
-}
-
-/**
- * 创建模拟的权限中间件
- */
-export function createMockPermissionMiddleware(requiredRoles: string[] = []) {
-  return vi.fn().mockImplementation(async (c: any, next: () => Promise<void>) => {
-    const user = c.get('user');
-
-    if (!user) {
-      return c.json({ error: 'Unauthorized' }, 401);
-    }
-
-    if (requiredRoles.length > 0) {
-      const hasRole = requiredRoles.some(role => user.roles?.includes(role));
-      if (!hasRole) {
-        return c.json({ error: 'Forbidden' }, 403);
-      }
-    }
-
-    await next();
-  });
-}

web/tests/utils/server/test-db.ts

@@ -1,157 +0,0 @@
-import { DataSource, EntityManager, Repository } from 'typeorm';
-import { vi, beforeEach, afterEach } from 'vitest';
-
-/**
- * 创建模拟的数据源
- */
-export function createMockDataSource() {
-  const manager = createMockEntityManager();
-  const mockDataSource = {
-    initialize: vi.fn().mockResolvedValue(undefined),
-    destroy: vi.fn().mockResolvedValue(undefined),
-    isInitialized: true,
-    manager,
-    getRepository: vi.fn().mockImplementation(() => createMockRepository()),
-    createQueryBuilder: vi.fn().mockReturnValue(createMockQueryBuilder()),
-    transaction: vi.fn().mockImplementation(async (callback) => {
-      return callback(manager);
-    }),
-    synchronize: vi.fn().mockResolvedValue(undefined),
-    dropDatabase: vi.fn().mockResolvedValue(undefined)
-  };
-
-  return mockDataSource;
-}
-
-/**
- * 创建模拟的实体管理器
- */
-export function createMockEntityManager(): EntityManager {
-  return {
-    find: vi.fn().mockResolvedValue([]),
-    findOne: vi.fn().mockResolvedValue(null),
-    save: vi.fn().mockImplementation((entity) => Promise.resolve(entity)),
-    update: vi.fn().mockResolvedValue({ affected: 1 }),
-    delete: vi.fn().mockResolvedValue({ affected: 1 }),
-    createQueryBuilder: vi.fn().mockReturnValue(createMockQueryBuilder()),
-    transaction: vi.fn().mockImplementation(async (callback) => {
-      return callback(createMockEntityManager());
-    }),
-    getRepository: vi.fn().mockImplementation(() => createMockRepository())
-  } as any;
-}
-
-/**
- * 创建模拟的Repository
- */
-export function createMockRepository<T extends object = any>(): Repository<T> {
-  return {
-    find: vi.fn().mockResolvedValue([]),
-    findOne: vi.fn().mockResolvedValue(null),
-    findOneBy: vi.fn().mockResolvedValue(null),
-    findOneByOrFail: vi.fn().mockResolvedValue(null),
-    findBy: vi.fn().mockResolvedValue([]),
-    findAndCount: vi.fn().mockResolvedValue([[], 0]),
-    findAndCountBy: vi.fn().mockResolvedValue([[], 0]),
-    save: vi.fn().mockImplementation((entity) => Promise.resolve(entity)),
-    update: vi.fn().mockResolvedValue({ affected: 1 }),
-    delete: vi.fn().mockResolvedValue({ affected: 1 }),
-    create: vi.fn().mockImplementation((entity) => ({ ...entity, id: Date.now() })),
-    createQueryBuilder: vi.fn().mockReturnValue(createMockQueryBuilder()),
-    count: vi.fn().mockResolvedValue(0),
-    countBy: vi.fn().mockResolvedValue(0),
-    exist: vi.fn().mockResolvedValue(false)
-  } as any;
-}
-
-/**
- * 创建模拟的QueryBuilder
- */
-export function createMockQueryBuilder() {
-  const mockQueryBuilder = {
-    select: vi.fn().mockReturnThis(),
-    from: vi.fn().mockReturnThis(),
-    where: vi.fn().mockReturnThis(),
-    andWhere: vi.fn().mockReturnThis(),
-    orWhere: vi.fn().mockReturnThis(),
-    leftJoin: vi.fn().mockReturnThis(),
-    innerJoin: vi.fn().mockReturnThis(),
-    orderBy: vi.fn().mockReturnThis(),
-    groupBy: vi.fn().mockReturnThis(),
-    having: vi.fn().mockReturnThis(),
-    skip: vi.fn().mockReturnThis(),
-    take: vi.fn().mockReturnThis(),
-    getMany: vi.fn().mockResolvedValue([]),
-    getOne: vi.fn().mockResolvedValue(null),
-    getCount: vi.fn().mockResolvedValue(0),
-    getRawMany: vi.fn().mockResolvedValue([]),
-    getRawOne: vi.fn().mockResolvedValue(null),
-    execute: vi.fn().mockResolvedValue(undefined),
-    setParameter: vi.fn().mockReturnThis(),
-    setParameters: vi.fn().mockReturnThis()
-  };
-
-  return mockQueryBuilder;
-}
-
-/**
- * 数据库测试工具类
- */
-export class TestDatabase {
-  private static dataSource: DataSource | null = null;
-
-  /**
-   * 初始化测试数据库
-   */
-  static async initialize(): Promise<DataSource> {
-    if (this.dataSource?.isInitialized) {
-      return this.dataSource;
-    }
-
-    // 使用SQLite内存数据库进行测试
-    this.dataSource = new DataSource({
-      type: 'better-sqlite3',
-      database: ':memory:',
-      synchronize: true,
-      logging: false,
-      entities: [
-        // 导入实际实体
-        (await import('@d8d/server/modules/users/user.entity')).UserEntity,
-        (await import('@d8d/server/modules/users/role.entity')).Role
-      ]
-    });
-
-    await this.dataSource.initialize();
-    return this.dataSource;
-  }
-
-  /**
-   * 清理测试数据库
-   */
-  static async cleanup(): Promise<void> {
-    if (this.dataSource?.isInitialized) {
-      await this.dataSource.destroy();
-      this.dataSource = null;
-    }
-  }
-
-  /**
-   * 获取当前数据源
-   */
-  static getDataSource(): DataSource | null {
-    return this.dataSource;
-  }
-}
-
-/**
- * 测试数据库生命周期钩子
- */
-export function setupDatabaseHooks() {
-  beforeEach(async () => {
-    await TestDatabase.initialize();
-  });
-
-  afterEach(async () => {
-    await TestDatabase.cleanup();
-  });
-}