novalon/novalon-manage-system
6
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
dev
novalon-manage-system/docs/superpowers/plans/2026-04-05-role-based-tests-migration.md
T
张翔 1e9ce8ee88 docs: 添加角色测试框架迁移实现计划 
目的：
- 提供详细的实施步骤，确保迁移过程可执行
- 每个任务包含具体代码、命令和预期输出

内容：
- 15个任务，覆盖文件迁移、配置更新、验证等所有步骤
- 详细的命令和预期输出
- 完整的自检清单
2026-04-05 08:44:58 +08:00

1018 lines
26 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 角色测试框架迁移实现计划
> **面向 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 执行任务，批量执行并设有检查点
**选哪种方式？**
Reference in New Issue View Git Blame Copy Permalink