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:
@@ -2,6 +2,50 @@
|
||||
|
||||
## 2026-06-17
|
||||
|
||||
### P2 质量保障类实现(5 项全部完成)
|
||||
|
||||
#### 1. 屏幕阅读器兼容性增强(a11y)
|
||||
- 新增无障碍工具库:`src/shared/lib/a11y.ts`(useA11yId/mergeA11yProps/describeInput/loadingAria)
|
||||
- 新增 Hook:`src/shared/hooks/use-aria-live.ts`(aria-live 区域管理)
|
||||
- 新增组件:`src/shared/components/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. 视觉回归测试(Visual Regression)
|
||||
- 配置:`tests/visual/visual.config.ts`(3 视口 × 2 主题)
|
||||
- 测试套件:homepage/admin-dashboard/teacher-dashboard/student-dashboard
|
||||
- 辅助函数:auth.ts(登录态管理)、visual-helpers.ts(视口/主题/遮罩)
|
||||
- 更新 playwright.config.ts:新增 visual-chromium 项目,maxDiffPixelRatio 0.01
|
||||
- 文档:`docs/testing/visual-regression.md`
|
||||
|
||||
#### 3. 短信/微信推送渠道集成(notifications)
|
||||
- 新增模块:`src/modules/notifications/`
|
||||
- 渠道实现:SMS(阿里云/腾讯云/Mock)、WeChat(公众号模板消息)、Email(Nodemailer SMTP)、In-App
|
||||
- 分发器:按用户通知偏好并行多渠道发送
|
||||
- Server Actions:sendNotificationAction、sendClassNotificationAction
|
||||
- 外部 SDK 动态 import,Mock 模式开发环境可用
|
||||
- 配置:`.env.example`,文档:`docs/notifications/channels.md`
|
||||
|
||||
#### 4. 漏洞扫描 CI 集成(security)
|
||||
- 增强 CI:security-scan job(npm audit + Snyk + Trivy FS + OWASP ZAP)
|
||||
- 独立工作流:`.gitea/workflows/security.yml`(每周一深度扫描,含容器镜像扫描)
|
||||
- 配置:`.gitea/suppressions.json`(Snyk 抑制)、`.trivyignore`(Trivy CVE 忽略)
|
||||
- 本地脚本:`scripts/security-scan.sh` + `scripts/security-scan.ps1`
|
||||
- 文档:`docs/security/scanning.md`(含 SLA:critical 24h/high 7d/medium 30d/low 90d)
|
||||
|
||||
#### 5. 灾备方案(DR)
|
||||
- 脚本:backup-verify.sh(完整性校验)、backup-offsite-sync.sh(S3/OSS/NFS 异地同步)、dr-drill.sh/ps1(灾备演练)、failover.sh(故障切换)、health-check.sh(健康检查)
|
||||
- CI 增强:scheduled-backup 添加校验+异地同步,新增 weekly-dr-drill job
|
||||
- 独立工作流:`.gitea/workflows/dr-drill.yml`(每周一凌晨 4 点自动演练)
|
||||
- 文档:`docs/dr/dr-plan.md`(RTO 4h/RPO 24h)、`docs/dr/dr-runbook.md`(6 大故障场景操作手册)
|
||||
- 配置:`.env.example` 灾备环境变量
|
||||
|
||||
#### 验证
|
||||
- `npx tsc --noEmit`:0 错误
|
||||
- `npm run lint`:0 错误 0 警告
|
||||
|
||||
---
|
||||
|
||||
### P2 功能扩展类实现(功能扩展 + 质量保障首批)
|
||||
|
||||
#### 1. 选课管理模块(elective)
|
||||
|
||||
Reference in New Issue
Block a user