메뉴
执行OAuth2系统的完整端到端(E2E)测试，验证用户登录、授权码流程、token交换、RBAC权限控制和受保护API访问的完整功能。当用户需要在代码变更后验证整个OAuth2认证流程、测试用户登录和权限管理、验证修复后的安全功能、或在生产部署前进行完整的功能验证时使用此技能。
기본적으로 소스를 먼저 확인하는 Prompt가 선택됩니다. 직접 명령으로 전환하거나 로컬 사본을 다운로드할 수도 있습니다.
설치 여부를 결정하기 전에 SKILL.md와 SkillsMP에 표시된 보조 파일을 읽어 보세요.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
직접 명령은 검토 Prompt를 거치지 않습니다. 실행하기 전에 소스를 확인하세요.
npx skills add https://github.com/voidvec/fulla --skill e2e-test명령은 한 줄로 유지됩니다. 복사하기 전에 가로로 스크롤해 전체 내용을 확인하세요.
로컬 사본을 원하시나요? SkillsMP에서 현재 제공할 수 있는 파일을 다운로드하세요.
SKILL.md 표시 중
| name | e2e-test |
| description | 执行OAuth2系统的完整端到端(E2E)测试，验证用户登录、授权码流程、token交换、RBAC权限控制和受保护API访问的完整功能。当用户需要在代码变更后验证整个OAuth2认证流程、测试用户登录和权限管理、验证修复后的安全功能、或在生产部署前进行完整的功能验证时使用此技能。 |
执行完整的OAuth2授权码流程和RBAC权限控制测试，验证系统从前端登录到后端API保护的完整认证链路。
# 自动选择最佳环境
$env:FULLA_ENV_MODE = "auto"
# 检查 Docker 是否可用
docker ps | Out-Null
if ($?) {
Write-Host "🐳 Docker 检测到，使用 Docker 模式"
$env:FULLA_ENV_MODE = "docker"
} else {
Write-Host "💻 使用本地模式"
$env:FULLA_ENV_MODE = "local"
}
# Docker 模式推荐流程
if ($env:FULLA_ENV_MODE -eq "docker") {
Write-Host "使用 Docker 完整测试流程..."
# 跳到步骤 2 的 Docker 模式
} else {
Write-Host "使用本地测试流程..."
# 继续传统本地流程
}
# 使用 Docker 专项脚本
scripts/backend/full_test_docker.bat
# 此脚本会自动完成所有测试步骤
# 重置数据库
cd /path/to/project
$env:PGPASSWORD='123456'
psql -U fulla_user -d postgres -c "DROP DATABASE IF EXISTS fulla_db;"
psql -U fulla_user -d postgres -c "CREATE DATABASE fulla_db;"
for f in apps/server/migrations/V*.sql; do
psql -U fulla_user -d fulla_db -f "$f"
done
for f in apps/server/seed/*.sql; do
psql -U fulla_user -d fulla_db -f "$f"
done
# 编译服务（如果需要）
.\manage.ps1 build-backend -release
# 使用统一管理接口编译
.\manage.ps1 build-backend -release
# 停止旧服务
taskkill /F /IM fulla-server.exe 2>$null
# 启动服务（preset 构建路径：build/<preset>/apps/server/Release/）
$serverPath = "build/windows-msvc/apps/server/Release/fulla-server.exe"
if (Test-Path $serverPath) {
Start-Process -FilePath $serverPath -WindowStyle Hidden
Write-Host "✅ Server started from: $serverPath"
} else {
Write-Host "❌ Server executable not found at: $serverPath"
exit 1
}
# 等待服务启动
Start-Sleep -Seconds 3
# 验证服务状态
$response = Invoke-WebRequest -Uri "http://localhost:5555/health" -UseBasicParsing -TimeoutSec 5
if ($response.StatusCode -eq 200) {
Write-Host "✅ Server is responding"
} else {
Write-Host "❌ Server health check failed"
exit 1
}
# 完整 Docker 测试（推荐）
scripts/backend/full_test_docker.bat
# 此脚本包含：
# 1. PostgreSQL 容器启动
# 2. 数据库初始化
# 3. ORM 模型生成
# 4. 项目构建
# 5. 单元测试
# 6. 服务启动
# 7. OAuth2 端点测试
# 8. 清理和停止
# 手动 Docker 测试流程
.\manage.ps1 docker-up
Start-Sleep -Seconds 10
# 在 Docker 容器中运行测试（前提：已 `.\manage.ps1 docker-up` 拉起完整栈。
# 注意：full_test_docker.bat 只启动 pg+redis 容器并在宿主机本地跑 server，
# 不会启动 fulla-backend 容器，因此下面的 docker exec 需先 docker-up）
docker exec fulla-backend /bin/bash -c "ctest --output-on-failure"
# OAuth2 端点测试
# ... (后续步骤)
# 清理
.\manage.ps1 docker-down
curl -s -X POST "http://localhost:5555/oauth2/login" \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "username=admin&password=admin&client_id=vue-client&redirect_uri=http://localhost:5173/callback&scope=openid&state=e2e_test"
预期结果: HTTP 302重定向，包含授权码
# 提取授权码并交换token
CODE="<从上一步响应中提取的授权码>"
curl -s -X POST "http://localhost:5555/oauth2/token" \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "grant_type=authorization_code&code=${CODE}&client_id=vue-client&redirect_uri=http://localhost:5173/callback"
预期结果: 返回access_token, refresh_token, roles数组
# 使用access_token访问admin dashboard
ACCESS_TOKEN="<从上一步响应中提取的access_token>"
curl -s -X GET "http://localhost:5555/api/admin/dashboard" \
-H "Authorization: Bearer ${ACCESS_TOKEN}"
预期结果: 返回admin dashboard数据
# 停止服务
taskkill /F /IM fulla-server.exe 2>$null
# 检查端口占用
netstat -ano | findstr :5555
# 检查服务日志
cd build/windows-msvc/apps/server/Release
.\fulla-server.exe
# 验证数据库连接
psql -U fulla_user -d fulla_db -c "SELECT 1;"
# 检查客户端数据
psql -U fulla_user -d fulla_db -c "SELECT * FROM oauth2_clients;"
# 验证用户存在
psql -U fulla_user -d fulla_db -c "SELECT * FROM users WHERE username='admin';"
# 验证客户端配置
psql -U fulla_user -d fulla_db -c "SELECT * FROM oauth2_clients WHERE client_id='vue-client';"
# 完整E2E测试脚本
$ErrorActionPreference = "Stop"
# 1. 启动服务
Write-Host "Starting fulla-server..."
cd build/windows-msvc/apps/server/Release
Start-Process -FilePath ".\fulla-server.exe" -WindowStyle Hidden
Start-Sleep -Seconds 3
# 2. 登录
Write-Host "Testing Login..."
$LoginResp = curl -s -X POST "http://localhost:5555/oauth2/login" `
-H "Content-Type: application/x-www-form-urlencoded" `
-d "username=admin&password=admin&client_id=vue-client&redirect_uri=http://localhost:5173/callback&scope=openid&state=e2e_test"
if ($LoginResp -match "code=([a-f0-9\-]+)") {
$Code = $matches[1]
Write-Host "✅ Login successful, code: $Code"
# 3. 交换Token
Write-Host "Exchanging token..."
$TokenResp = curl -s -X POST "http://localhost:5555/oauth2/token" `
-H "Content-Type: application/x-www-form-urlencoded" `
-d "grant_type=authorization_code&code=$Code&client_id=vue-client&redirect_uri=http://localhost:5173/callback" | ConvertFrom-Json
if ($TokenResp.access_token) {
Write-Host "✅ Token obtained: $($TokenResp.access_token)"
# 4. 访问Admin API
Write-Host "Testing admin API access..."
$ApiResp = curl -s -X GET "http://localhost:5555/api/admin/dashboard" `
-H "Authorization: Bearer $($TokenResp.access_token)"
if ($ApiResp -match "success") {
Write-Host "✅ E2E test completed successfully!"
} else {
Write-Error "❌ API access failed"
}
} else {
Write-Error "❌ Token exchange failed"
}
} else {
Write-Error "❌ Login failed"
}
# 5. 清理
Write-Host "Stopping service..."
taskkill /F /IM fulla-server.exe 2>$null
# .github/workflows/e2e-test.yml
name: E2E Tests
on: [push, pull_request]
jobs:
e2e:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v3
- name: Start Docker services
run: docker-compose up -d
- name: Run E2E tests
run: scripts/backend/full_test_docker.bat
- name: Stop Docker services
run: docker-compose down