feat(P2): 实现质量保障类5项功能(无障碍/视觉回归/通知渠道/漏洞扫描/灾备)
## 新增功能 ### 1. 屏幕阅读器兼容性增强(a11y) - 无障碍工具库:src/shared/lib/a11y.ts - aria-live Hook:src/shared/hooks/use-aria-live.ts - a11y 组件:skip-link/visually-hidden/focus-trap/aria-status - 增强 UI:table.tsx 系统性 ARIA role,dialog.tsx aria-modal - 审计文档:docs/accessibility/a11y-audit.md(WCAG 2.1 AA 清单) ### 2. 视觉回归测试 - 测试套件:tests/visual/(homepage + 3 个 dashboard) - 3 视口(desktop/tablet/mobile)× 2 主题(light/dark) - 动态元素遮罩,避免误报 - playwright.config.ts 新增 visual-chromium 项目 - 文档:docs/testing/visual-regression.md ### 3. 短信/微信推送渠道集成 - 新模块:src/modules/notifications/ - 4 个渠道:SMS(阿里云/腾讯云)、WeChat(公众号)、Email(SMTP)、In-App - 分发器按用户偏好并行多渠道发送 - 外部 SDK 动态 import,Mock 模式开发可用 - 文档:docs/notifications/channels.md ### 4. 漏洞扫描 CI 集成 - CI security-scan job:npm audit + Snyk + Trivy FS + OWASP ZAP - 独立工作流 security.yml:每周一深度扫描 + 容器镜像扫描 - 配置:suppressions.json + .trivyignore - 本地脚本:security-scan.sh/ps1 - 文档:docs/security/scanning.md(SLA 分级) ### 5. 灾备方案 - 脚本:backup-verify/backup-offsite-sync/dr-drill/failover/health-check - CI 增强:备份后校验+异地同步,每周灾备演练 - 独立工作流 dr-drill.yml:每周一凌晨 4 点自动演练 - 文档:docs/dr/dr-plan.md(RTO 4h/RPO 24h)+ dr-runbook.md(6 故障场景) ## 验证 - npx tsc --noEmit:0 错误 - npm run lint:0 错误 0 警告
This commit is contained in:
59
tests/visual/helpers/auth.ts
Normal file
59
tests/visual/helpers/auth.ts
Normal file
@@ -0,0 +1,59 @@
|
||||
/**
|
||||
* 视觉测试认证辅助
|
||||
*
|
||||
* 提供登录辅助函数与 storageState 持久化能力,
|
||||
* 避免每个视觉测试用例都重复走登录流程。
|
||||
*/
|
||||
import type { Page } from "@playwright/test"
|
||||
import { STORAGE_STATE_DIR, type UserRole } from "../visual.config"
|
||||
|
||||
/** 测试账号配置(可通过环境变量覆盖) */
|
||||
export const TEST_ACCOUNTS: Record<UserRole, { email: string; password: string }> = {
|
||||
admin: {
|
||||
email: process.env.VISUAL_ADMIN_EMAIL ?? "admin@xiaoxue.edu.cn",
|
||||
password: process.env.VISUAL_ADMIN_PASSWORD ?? "123456",
|
||||
},
|
||||
teacher: {
|
||||
email: process.env.VISUAL_TEACHER_EMAIL ?? "admin@xiaoxue.edu.cn",
|
||||
password: process.env.VISUAL_TEACHER_PASSWORD ?? "123456",
|
||||
},
|
||||
student: {
|
||||
email: process.env.VISUAL_STUDENT_EMAIL ?? "admin@xiaoxue.edu.cn",
|
||||
password: process.env.VISUAL_STUDENT_PASSWORD ?? "123456",
|
||||
},
|
||||
}
|
||||
|
||||
/** 角色对应的 storageState 文件路径(相对项目根) */
|
||||
export function storageStatePath(role: UserRole): string {
|
||||
return `${STORAGE_STATE_DIR}/${role}.json`
|
||||
}
|
||||
|
||||
/**
|
||||
* 在页面上执行登录流程
|
||||
*
|
||||
* 走真实的 UI 登录流程,以便 next-auth cookie 写入浏览器上下文。
|
||||
*/
|
||||
export async function loginByUI(page: Page, role: UserRole): Promise<void> {
|
||||
const { email, password } = TEST_ACCOUNTS[role]
|
||||
await page.goto("/login")
|
||||
await page.getByLabel("Email").fill(email)
|
||||
await page.getByLabel("Password").fill(password)
|
||||
await page.getByRole("button", { name: "Sign In with Email" }).click()
|
||||
// 等待离开登录页
|
||||
await page.waitForURL((url) => !url.pathname.startsWith("/login"), { timeout: 30000 })
|
||||
}
|
||||
|
||||
/**
|
||||
* 设置认证状态
|
||||
*
|
||||
* 若已存在该角色的 storageState 文件,则直接复用;
|
||||
* 否则走 UI 登录流程并保存 storageState 以便后续复用。
|
||||
*
|
||||
* @param page Playwright Page 实例
|
||||
* @param role 角色
|
||||
*/
|
||||
export async function setupAuthState(page: Page, role: UserRole): Promise<void> {
|
||||
// Playwright 在 project 配置里通过 storageState 注入更高效,
|
||||
// 这里提供运行时降级方案:直接走 UI 登录。
|
||||
await loginByUI(page, role)
|
||||
}
|
||||
Reference in New Issue
Block a user