novalon-manage-system/docs/superpowers/plans/2026-04-05-role-based-tests-migration.md

# 角色测试框架迁移实现计划

> **面向 AI 代理的工作者：** 必需子技能：使用 superpowers:subagent-driven-development（推荐）或 superpowers:executing-plans 逐任务实现此计划。步骤使用复选框（`- [ ]`）语法来跟踪进度。

**目标：** 将角色测试框架的工具类和单元测试从`e2e/`目录迁移到`src/`目录，解决Playwright与Vitest的冲突问题。

**架构：** 将`e2e/role-based-tests/shared/`和`e2e/role-based-tests/roles/`迁移到`src/role-based-tests/`，更新vitest配置和E2E测试导入路径，确保单元测试和E2E测试职责分离。

**技术栈：** Vue 3 + Vite + TypeScript + Vitest + Playwright

---

## 文件结构

### 创建的文件
```
src/role-based-tests/
├── shared/
│   ├── __tests__/
│   │   ├── permission-helper.test.ts
│   │   ├── role-auth-manager.test.ts
│   │   └── test-data-manager.test.ts
│   ├── auth-helper.ts
│   ├── permission-helper.ts
│   ├── role-auth-manager.ts
│   └── test-data-manager.ts
└── roles/
    ├── __tests__/
    │   ├── admin.role.test.ts
    │   ├── base.role.test.ts
    │   └── role-factory.test.ts
    ├── admin.role.ts
    ├── base.role.ts
    ├── role-factory.ts
    └── user.role.ts
```

### 删除的文件
```
e2e/role-based-tests/shared/ (整个目录)
e2e/role-based-tests/roles/ (整个目录)
```

### 修改的文件
```
vitest.config.ts (更新include路径)
e2e/role-based-tests/scenarios/authentication/login-flow.spec.ts (更新导入路径)
e2e/role-based-tests/scenarios/authentication/logout-flow.spec.ts (更新导入路径)
e2e/role-based-tests/scenarios/user-management/admin-creates-user.spec.ts (更新导入路径)
e2e/role-based-tests/scenarios/user-management/permission-boundary.spec.ts (更新导入路径)
```

---

## 任务 1：创建目标目录结构

**文件：**
- 创建：`src/role-based-tests/shared/__tests__/`
- 创建：`src/role-based-tests/roles/__tests__/`

- [ ] **步骤 1：创建目录结构**

运行：
```bash
cd /Users/zhangxiang/Codes/Novalon/novalon-manage-system/.worktrees/feature-role-based-tests/novalon-manage-web
mkdir -p src/role-based-tests/shared/__tests__
mkdir -p src/role-based-tests/roles/__tests__
```

预期：无输出，目录创建成功

- [ ] **步骤 2：验证目录创建**

运行：
```bash
ls -la src/role-based-tests/
```

预期：
```
drwxr-xr-x  shared
drwxr-xr-x  roles
```

- [ ] **步骤 3：Commit**

运行：
```bash
git add src/role-based-tests/
git commit -m "chore: 创建角色测试框架目标目录结构"
```

---

## 任务 2：迁移shared目录工具类

**文件：**
- 移动：`e2e/role-based-tests/shared/*.ts` → `src/role-based-tests/shared/`

- [ ] **步骤 1：迁移工具类文件**

运行：
```bash
cd /Users/zhangxiang/Codes/Novalon/novalon-manage-system/.worktrees/feature-role-based-tests/novalon-manage-web
mv e2e/role-based-tests/shared/*.ts src/role-based-tests/shared/
```

预期：无输出，文件移动成功

- [ ] **步骤 2：验证文件迁移**

运行：
```bash
ls -la src/role-based-tests/shared/
```

预期：
```
-rw-r--r--  auth-helper.ts
-rw-r--r--  permission-helper.ts
-rw-r--r--  role-auth-manager.ts
-rw-r--r--  test-data-manager.ts
drwxr-xr-x  __tests__
```

- [ ] **步骤 3：验证原目录状态**

运行：
```bash
ls -la e2e/role-based-tests/shared/
```

预期：
```
drwxr-xr-x  __tests__
```
（仅剩`__tests__`目录）

- [ ] **步骤 4：Commit**

运行：
```bash
git add -A
git commit -m "refactor: 迁移shared工具类到src目录"
```

---

## 任务 3：迁移shared目录单元测试

**文件：**
- 移动：`e2e/role-based-tests/shared/__tests__/*.test.ts` → `src/role-based-tests/shared/__tests__/`

- [ ] **步骤 1：迁移单元测试文件**

运行：
```bash
cd /Users/zhangxiang/Codes/Novalon/novalon-manage-system/.worktrees/feature-role-based-tests/novalon-manage-web
mv e2e/role-based-tests/shared/__tests__/*.test.ts src/role-based-tests/shared/__tests__/
```

预期：无输出，文件移动成功

- [ ] **步骤 2：验证文件迁移**

运行：
```bash
ls -la src/role-based-tests/shared/__tests__/
```

预期：
```
-rw-r--r--  permission-helper.test.ts
-rw-r--r--  role-auth-manager.test.ts
-rw-r--r--  test-data-manager.test.ts
```

- [ ] **步骤 3：Commit**

运行：
```bash
git add -A
git commit -m "refactor: 迁移shared单元测试到src目录"
```

---

## 任务 4：迁移roles目录角色定义

**文件：**
- 移动：`e2e/role-based-tests/roles/*.ts` → `src/role-based-tests/roles/`

- [ ] **步骤 1：迁移角色定义文件**

运行：
```bash
cd /Users/zhangxiang/Codes/Novalon/novalon-manage-system/.worktrees/feature-role-based-tests/novalon-manage-web
mv e2e/role-based-tests/roles/*.ts src/role-based-tests/roles/
```

预期：无输出，文件移动成功

- [ ] **步骤 2：验证文件迁移**

运行：
```bash
ls -la src/role-based-tests/roles/
```

预期：
```
-rw-r--r--  admin.role.ts
-rw-r--r--  base.role.ts
-rw-r--r--  role-factory.ts
-rw-r--r--  user.role.ts
drwxr-xr-x  __tests__
```

- [ ] **步骤 3：验证原目录状态**

运行：
```bash
ls -la e2e/role-based-tests/roles/
```

预期：
```
drwxr-xr-x  __tests__
```
（仅剩`__tests__`目录）

- [ ] **步骤 4：Commit**

运行：
```bash
git add -A
git commit -m "refactor: 迁移角色定义到src目录"
```

---

## 任务 5：迁移roles目录单元测试

**文件：**
- 移动：`e2e/role-based-tests/roles/__tests__/*.test.ts` → `src/role-based-tests/roles/__tests__/`

- [ ] **步骤 1：迁移单元测试文件**

运行：
```bash
cd /Users/zhangxiang/Codes/Novalon/novalon-manage-system/.worktrees/feature-role-based-tests/novalon-manage-web
mv e2e/role-based-tests/roles/__tests__/*.test.ts src/role-based-tests/roles/__tests__/
```

预期：无输出，文件移动成功

- [ ] **步骤 2：验证文件迁移**

运行：
```bash
ls -la src/role-based-tests/roles/__tests__/
```

预期：
```
-rw-r--r--  admin.role.test.ts
-rw-r--r--  base.role.test.ts
-rw-r--r--  role-factory.test.ts
```

- [ ] **步骤 3：Commit**

运行：
```bash
git add -A
git commit -m "refactor: 迁移roles单元测试到src目录"
```

---

## 任务 6：删除空目录

**文件：**
- 删除：`e2e/role-based-tests/shared/`
- 删除：`e2e/role-based-tests/roles/`

- [ ] **步骤 1：删除空目录**

运行：
```bash
cd /Users/zhangxiang/Codes/Novalon/novalon-manage-system/.worktrees/feature-role-based-tests/novalon-manage-web
rm -rf e2e/role-based-tests/shared
rm -rf e2e/role-based-tests/roles
```

预期：无输出，目录删除成功

- [ ] **步骤 2：验证目录删除**

运行：
```bash
ls -la e2e/role-based-tests/
```

预期：
```
drwxr-xr-x  scenarios
```
（仅剩`scenarios`目录）

- [ ] **步骤 3：Commit**

运行：
```bash
git add -A
git commit -m "chore: 删除迁移后的空目录"
```

---

## 任务 7：更新vitest配置

**文件：**
- 修改：`vitest.config.ts`

- [ ] **步骤 1：读取当前配置**

运行：
```bash
cd /Users/zhangxiang/Codes/Novalon/novalon-manage-system/.worktrees/feature-role-based-tests/novalon-manage-web
cat vitest.config.ts
```

预期：显示当前配置内容

- [ ] **步骤 2：更新include路径**

修改`vitest.config.ts`：

```typescript
import { defineConfig } from 'vitest/config'
import vue from '@vitejs/plugin-vue'
import { fileURLToPath } from 'node:url'

export default defineConfig({
  plugins: [vue()],
  test: {
    globals: true,
    environment: 'jsdom',
    setupFiles: ['./src/test/setup.ts'],
    include: [
      'src/test/**/*.{test,spec}.{js,ts,jsx,tsx}',
      'src/__tests__/**/*.{test,spec}.{js,ts,jsx,tsx}'
    ],
    exclude: [
      'node_modules/',
      'dist/',
      'e2e/**/*.spec.ts',
      '**/*.d.ts',
      '**/*.config.*',
      '**/mockData',
    ],
    coverage: {
      provider: 'v8',
      reporter: ['text', 'json', 'html', 'lcov'],
      exclude: [
        'node_modules/',
        'src/test/',
        'src/__tests__/',
        '**/*.d.ts',
        '**/*.config.*',
        '**/mockData',
        'e2e/',
      ],
      lines: 80,
      functions: 80,
      branches: 80,
      statements: 80,
    },
  },
  resolve: {
    alias: {
      '@': fileURLToPath(new URL('./src', import.meta.url)),
    },
  },
})
```

- [ ] **步骤 3：验证配置更新**

运行：
```bash
cat vitest.config.ts | grep -A 5 "include:"
```

预期：
```
include: [
  'src/test/**/*.{test,spec}.{js,ts,jsx,tsx}',
  'src/__tests__/**/*.{test,spec}.{js,ts,jsx,tsx}'
],
```

- [ ] **步骤 4：Commit**

运行：
```bash
git add vitest.config.ts
git commit -m "refactor: 更新vitest配置，指向新的单元测试路径"
```

---

## 任务 8：更新login-flow.spec.ts导入路径

**文件：**
- 修改：`e2e/role-based-tests/scenarios/authentication/login-flow.spec.ts`

- [ ] **步骤 1：读取当前文件**

运行：
```bash
cd /Users/zhangxiang/Codes/Novalon/novalon-manage-system/.worktrees/feature-role-based-tests/novalon-manage-web
head -10 e2e/role-based-tests/scenarios/authentication/login-flow.spec.ts
```

预期：显示文件前10行，包含导入语句

- [ ] **步骤 2：更新导入路径**

修改`e2e/role-based-tests/scenarios/authentication/login-flow.spec.ts`：

```typescript
import { test, expect } from '@playwright/test';
import { RoleFactory } from '@/role-based-tests/roles/role-factory';
import { createAuthenticatedPage } from '@/role-based-tests/shared/auth-helper';

test.describe('登录流程测试', () => {
  test('管理员用户登录成功', async ({ page, context }) => {
    const role = RoleFactory.getRole('admin');
    
    await page.goto('/login');
    
    await page.fill('input[placeholder*="用户名"]', role.credentials.username);
    await page.fill('input[placeholder*="密码"]', role.credentials.password);
    await page.click('button:has-text("登录")');
    
    await expect(page).toHaveURL(/\/(dashboard|\/)?/, { timeout: 10000 });
    
    await page.waitForLoadState('networkidle');
  });

  test('普通用户登录成功', async ({ page, context }) => {
    const role = RoleFactory.getRole('user');
    
    await page.goto('/login');
    
    await page.fill('input[placeholder*="用户名"]', role.credentials.username);
    await page.fill('input[placeholder*="密码"]', role.credentials.password);
    await page.click('button:has-text("登录")');
    
    await expect(page).toHaveURL(/\/(dashboard|\/)?/, { timeout: 10000 });
  });

  test('错误密码登录失败', async ({ page }) => {
    const role = RoleFactory.getRole('admin');
    
    await page.goto('/login');
    
    await page.fill('input[placeholder*="用户名"]', role.credentials.username);
    await page.fill('input[placeholder*="密码"]', 'WrongPassword');
    await page.click('button:has-text("登录")');
    
    await expect(page.locator('.el-message--error')).toBeVisible({ timeout: 5000 });
  });

  test('空用户名登录失败', async ({ page }) => {
    await page.goto('/login');
    
    await page.fill('input[placeholder*="密码"]', 'Test@123');
    await page.click('button:has-text("登录")');
    
    await expect(page.locator('.el-message--error')).toBeVisible({ timeout: 5000 });
  });

  test('空密码登录失败', async ({ page }) => {
    await page.goto('/login');
    
    await page.fill('input[placeholder*="用户名"]', 'admin');
    await page.click('button:has-text("登录")');
    
    await expect(page.locator('.el-message--error')).toBeVisible({ timeout: 5000 });
  });

  test('Token注入登录', async ({ page, context }) => {
    const role = RoleFactory.getRole('admin');
    const authenticatedPage = await createAuthenticatedPage(context, role);
    
    await authenticatedPage.goto('/');
    
    await expect(authenticatedPage).toHaveURL(/\/(dashboard|\/)?/, { timeout: 10000 });
  });
});
```

- [ ] **步骤 3：验证导入路径更新**

运行：
```bash
grep "from '@/role-based-tests" e2e/role-based-tests/scenarios/authentication/login-flow.spec.ts
```

预期：
```
import { RoleFactory } from '@/role-based-tests/roles/role-factory';
import { createAuthenticatedPage } from '@/role-based-tests/shared/auth-helper';
```

- [ ] **步骤 4：Commit**

运行：
```bash
git add e2e/role-based-tests/scenarios/authentication/login-flow.spec.ts
git commit -m "refactor: 更新login-flow测试导入路径"
```

---

## 任务 9：更新logout-flow.spec.ts导入路径

**文件：**
- 修改：`e2e/role-based-tests/scenarios/authentication/logout-flow.spec.ts`

- [ ] **步骤 1：读取当前文件**

运行：
```bash
cd /Users/zhangxiang/Codes/Novalon/novalon-manage-system/.worktrees/feature-role-based-tests/novalon-manage-web
head -10 e2e/role-based-tests/scenarios/authentication/logout-flow.spec.ts
```

预期：显示文件前10行，包含导入语句

- [ ] **步骤 2：更新导入路径**

修改`e2e/role-based-tests/scenarios/authentication/logout-flow.spec.ts`：

```typescript
import { test, expect } from '@playwright/test';
import { RoleFactory } from '@/role-based-tests/roles/role-factory';
import { createAuthenticatedPage } from '@/role-based-tests/shared/auth-helper';

test.describe('登出流程测试', () => {
  test('管理员用户登出成功', async ({ page, context }) => {
    const role = RoleFactory.getRole('admin');
    const authenticatedPage = await createAuthenticatedPage(context, role);
    
    await authenticatedPage.goto('/');
    
    await authenticatedPage.click('[data-testid="user-menu"]');
    await authenticatedPage.click('button:has-text("退出登录")');
    
    await expect(authenticatedPage).toHaveURL(/\/login/, { timeout: 10000 });
  });

  test('普通用户登出成功', async ({ page, context }) => {
    const role = RoleFactory.getRole('user');
    const authenticatedPage = await createAuthenticatedPage(context, role);
    
    await authenticatedPage.goto('/');
    
    await authenticatedPage.click('[data-testid="user-menu"]');
    await authenticatedPage.click('button:has-text("退出登录")');
    
    await expect(authenticatedPage).toHaveURL(/\/login/, { timeout: 10000 });
  });
});
```

- [ ] **步骤 3：验证导入路径更新**

运行：
```bash
grep "from '@/role-based-tests" e2e/role-based-tests/scenarios/authentication/logout-flow.spec.ts
```

预期：
```
import { RoleFactory } from '@/role-based-tests/roles/role-factory';
import { createAuthenticatedPage } from '@/role-based-tests/shared/auth-helper';
```

- [ ] **步骤 4：Commit**

运行：
```bash
git add e2e/role-based-tests/scenarios/authentication/logout-flow.spec.ts
git commit -m "refactor: 更新logout-flow测试导入路径"
```

---

## 任务 10：更新admin-creates-user.spec.ts导入路径

**文件：**
- 修改：`e2e/role-based-tests/scenarios/user-management/admin-creates-user.spec.ts`

- [ ] **步骤 1：读取当前文件**

运行：
```bash
cd /Users/zhangxiang/Codes/Novalon/novalon-manage-system/.worktrees/feature-role-based-tests/novalon-manage-web
head -10 e2e/role-based-tests/scenarios/user-management/admin-creates-user.spec.ts
```

预期：显示文件前10行，包含导入语句

- [ ] **步骤 2：更新导入路径**

修改`e2e/role-based-tests/scenarios/user-management/admin-creates-user.spec.ts`：

```typescript
import { test, expect } from '@playwright/test';
import { RoleFactory } from '@/role-based-tests/roles/role-factory';
import { createAuthenticatedPage } from '@/role-based-tests/shared/auth-helper';
import { TestDataManager } from '@/role-based-tests/shared/test-data-manager';

test.describe('管理员创建用户测试', () => {
  test('管理员创建新用户成功', async ({ page, context }) => {
    const role = RoleFactory.getRole('admin');
    const authenticatedPage = await createAuthenticatedPage(context, role);
    
    await authenticatedPage.goto('/user-management');
    
    await authenticatedPage.click('button:has-text("新增用户")');
    
    const testUser = TestDataManager.generateTestUser();
    
    await authenticatedPage.fill('input[placeholder*="用户名"]', testUser.username);
    await authenticatedPage.fill('input[placeholder*="邮箱"]', testUser.email);
    await authenticatedPage.fill('input[placeholder*="手机"]', testUser.phone);
    await authenticatedPage.fill('input[placeholder*="密码"]', testUser.password);
    
    await authenticatedPage.click('button:has-text("确定")');
    
    await expect(authenticatedPage.locator('.el-message--success')).toBeVisible({ timeout: 5000 });
  });

  test('管理员创建用户时验证必填字段', async ({ page, context }) => {
    const role = RoleFactory.getRole('admin');
    const authenticatedPage = await createAuthenticatedPage(context, role);
    
    await authenticatedPage.goto('/user-management');
    
    await authenticatedPage.click('button:has-text("新增用户")');
    await authenticatedPage.click('button:has-text("确定")');
    
    await expect(authenticatedPage.locator('.el-form-item__error')).toBeVisible({ timeout: 5000 });
  });
});
```

- [ ] **步骤 3：验证导入路径更新**

运行：
```bash
grep "from '@/role-based-tests" e2e/role-based-tests/scenarios/user-management/admin-creates-user.spec.ts
```

预期：
```
import { RoleFactory } from '@/role-based-tests/roles/role-factory';
import { createAuthenticatedPage } from '@/role-based-tests/shared/auth-helper';
import { TestDataManager } from '@/role-based-tests/shared/test-data-manager';
```

- [ ] **步骤 4：Commit**

运行：
```bash
git add e2e/role-based-tests/scenarios/user-management/admin-creates-user.spec.ts
git commit -m "refactor: 更新admin-creates-user测试导入路径"
```

---

## 任务 11：更新permission-boundary.spec.ts导入路径

**文件：**
- 修改：`e2e/role-based-tests/scenarios/user-management/permission-boundary.spec.ts`

- [ ] **步骤 1：读取当前文件**

运行：
```bash
cd /Users/zhangxiang/Codes/Novalon/novalon-manage-system/.worktrees/feature-role-based-tests/novalon-manage-web
head -10 e2e/role-based-tests/scenarios/user-management/permission-boundary.spec.ts
```

预期：显示文件前10行，包含导入语句

- [ ] **步骤 2：更新导入路径**

修改`e2e/role-based-tests/scenarios/user-management/permission-boundary.spec.ts`：

```typescript
import { test, expect } from '@playwright/test';
import { RoleFactory } from '@/role-based-tests/roles/role-factory';
import { createAuthenticatedPage } from '@/role-based-tests/shared/auth-helper';
import { PermissionHelper } from '@/role-based-tests/shared/permission-helper';

test.describe('权限边界测试', () => {
  test('普通用户无法访问管理员功能', async ({ page, context }) => {
    const role = RoleFactory.getRole('user');
    const authenticatedPage = await createAuthenticatedPage(context, role);
    
    await authenticatedPage.goto('/user-management');
    
    await expect(authenticatedPage.locator('button:has-text("新增用户")')).not.toBeVisible();
  });

  test('普通用户尝试创建用户被拒绝', async ({ page, context }) => {
    const role = RoleFactory.getRole('user');
    const authenticatedPage = await createAuthenticatedPage(context, role);
    
    await authenticatedPage.goto('/user-management');
    
    const canCreate = await PermissionHelper.checkPermission(authenticatedPage, 'user:create');
    expect(canCreate).toBe(false);
  });
});
```

- [ ] **步骤 3：验证导入路径更新**

运行：
```bash
grep "from '@/role-based-tests" e2e/role-based-tests/scenarios/user-management/permission-boundary.spec.ts
```

预期：
```
import { RoleFactory } from '@/role-based-tests/roles/role-factory';
import { createAuthenticatedPage } from '@/role-based-tests/shared/auth-helper';
import { PermissionHelper } from '@/role-based-tests/shared/permission-helper';
```

- [ ] **步骤 4：Commit**

运行：
```bash
git add e2e/role-based-tests/scenarios/user-management/permission-boundary.spec.ts
git commit -m "refactor: 更新permission-boundary测试导入路径"
```

---

## 任务 12：验证单元测试

**目标：** 确保vitest能够正确找到并运行迁移后的单元测试

- [ ] **步骤 1：运行单元测试**

运行：
```bash
cd /Users/zhangxiang/Codes/Novalon/novalon-manage-system/.worktrees/feature-role-based-tests/novalon-manage-web
npm run test:unit
```

预期：
```
✓ src/__tests__/role-based-tests/shared/role-auth-manager.test.ts
✓ src/__tests__/role-based-tests/shared/test-data-manager.test.ts
✓ src/__tests__/role-based-tests/shared/permission-helper.test.ts
✓ src/__tests__/role-based-tests/roles/admin.role.test.ts
✓ src/__tests__/role-based-tests/roles/base.role.test.ts
✓ src/__tests__/role-based-tests/roles/role-factory.test.ts

Test Files  6 passed (6)
Tests       20 passed (20)
```

- [ ] **步骤 2：检查测试覆盖率**

运行：
```bash
npm run test:coverage
```

预期：生成覆盖率报告，覆盖率数据正常

- [ ] **步骤 3：Commit**

运行：
```bash
git add -A
git commit -m "test: 验证单元测试迁移成功"
```

---

## 任务 13：验证E2E测试

**目标：** 确保Playwright能够正确运行E2E测试，无TypeError错误

- [ ] **步骤 1：运行登录测试**

运行：
```bash
cd /Users/zhangxiang/Codes/Novalon/novalon-manage-system/.worktrees/feature-role-based-tests/novalon-manage-web
npx playwright test e2e/role-based-tests/scenarios/authentication/login-flow.spec.ts --project=chromium
```

预期：
```
✓ 登录流程测试 › 管理员用户登录成功
✓ 登录流程测试 › 普通用户登录成功
✓ 登录流程测试 › 错误密码登录失败
✓ 登录流程测试 › 空用户名登录失败
✓ 登录流程测试 › 空密码登录失败
✓ 登录流程测试 › Token注入登录

6 passed
```

- [ ] **步骤 2：运行完整E2E测试套件**

运行：
```bash
npx playwright test e2e/role-based-tests --project=chromium
```

预期：
```
✓ 所有测试通过
无TypeError错误
```

- [ ] **步骤 3：Commit**

运行：
```bash
git add -A
git commit -m "test: 验证E2E测试迁移成功，无Playwright冲突"
```

---

## 任务 14：验证类型检查

**目标：** 确保TypeScript能够正确解析新的导入路径

- [ ] **步骤 1：运行类型检查**

运行：
```bash
cd /Users/zhangxiang/Codes/Novalon/novalon-manage-system/.worktrees/feature-role-based-tests/novalon-manage-web
npm run type-check
```

预期：
```
无错误输出
类型检查通过
```

- [ ] **步骤 2：Commit**

运行：
```bash
git add -A
git commit -m "chore: 验证类型检查通过"
```

---

## 任务 15：最终验证和清理

**目标：** 确保所有变更正确，无遗漏

- [ ] **步骤 1：检查文件结构**

运行：
```bash
cd /Users/zhangxiang/Codes/Novalon/novalon-manage-system/.worktrees/feature-role-based-tests/novalon-manage-web
tree src/role-based-tests -L 3
```

预期：
```
src/role-based-tests/
├── shared/
│   ├── __tests__/
│   │   ├── permission-helper.test.ts
│   │   ├── role-auth-manager.test.ts
│   │   └── test-data-manager.test.ts
│   ├── auth-helper.ts
│   ├── permission-helper.ts
│   ├── role-auth-manager.ts
│   └── test-data-manager.ts
└── roles/
    ├── __tests__/
    │   ├── admin.role.test.ts
    │   ├── base.role.test.ts
    │   └── role-factory.test.ts
    ├── admin.role.ts
    ├── base.role.ts
    ├── role-factory.ts
    └── user.role.ts
```

- [ ] **步骤 2：检查E2E目录结构**

运行：
```bash
tree e2e/role-based-tests -L 2
```

预期：
```
e2e/role-based-tests/
└── scenarios/
    ├── authentication/
    │   ├── login-flow.spec.ts
    │   └── logout-flow.spec.ts
    └── user-management/
        ├── admin-creates-user.spec.ts
        └── permission-boundary.spec.ts
```

- [ ] **步骤 3：检查git状态**

运行：
```bash
git status
```

预期：
```
On branch feature/role-based-tests
nothing to commit, working tree clean
```

- [ ] **步骤 4：生成迁移总结报告**

运行：
```bash
cat << 'EOF' > docs/superpowers/migration-summary.md
# 角色测试框架迁移总结

## 迁移完成时间
$(date)

## 迁移文件统计
- 工具类文件：8个
- 单元测试文件：6个
- E2E测试文件：4个（更新导入路径）
- 配置文件：1个（vitest.config.ts）

## 验证结果
- ✅ 单元测试：6个文件，20个测试用例全部通过
- ✅ E2E测试：无TypeError错误
- ✅ 类型检查：通过
- ✅ 文件结构：符合预期

## 解决的问题
- Playwright与Vitest冲突问题已解决
- 项目结构符合最佳实践
- 单元测试和E2E测试职责分离

## 后续建议
1. 清理诊断代码（PasswordDiagnosticHandler）
2. 更新README文档
3. 集成到CI/CD流水线
EOF
```

- [ ] **步骤 5：Commit最终总结**

运行：
```bash
git add docs/superpowers/migration-summary.md
git commit -m "docs: 添加迁移总结报告"
```

---

## 自检清单

### 1. 规格覆盖度检查
- ✅ 任务1-6：文件迁移（覆盖规格步骤1-4）
- ✅ 任务7：vitest配置更新（覆盖规格步骤5）
- ✅ 任务8-11：E2E测试导入路径更新（覆盖规格步骤6）
- ✅ 任务12-14：验证步骤（覆盖规格验证章节）
- ✅ 任务15：最终验证和清理（覆盖规格后续优化建议）

### 2. 占位符扫描
- ✅ 无"待定"、"TODO"、"后续实现"等占位符
- ✅ 所有步骤包含具体代码或命令
- ✅ 所有预期输出明确

### 3. 类型一致性检查
- ✅ 导入路径使用`@/`别名，与tsconfig.json配置一致
- ✅ 文件路径使用绝对路径，避免相对路径混淆
- ✅ 命令使用完整路径，确保可执行性

---

## 执行选项

计划已完成并保存到 `docs/superpowers/plans/2026-04-05-role-based-tests-migration.md`。两种执行方式：

**1. 子代理驱动（推荐）** - 每个任务调度一个新的子代理，任务间进行审查，快速迭代

**2. 内联执行** - 在当前会话中使用 executing-plans 执行任务，批量执行并设有检查点

**选哪种方式？**