Files
NextEdu/.env.example
SpecialX 6585e10c6f 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 警告
2026-06-17 20:18:29 +08:00

68 lines
2.0 KiB
Plaintext

# Next_Edu 环境变量示例
# 复制此文件为 .env.local 并填写实际值
# ===== 基础配置 =====
DATABASE_URL="mysql://user:password@localhost:3306/next_edu"
NODE_ENV="development"
NEXTAUTH_SECRET="your-nextauth-secret"
NEXTAUTH_URL="http://localhost:8015"
NEXT_PUBLIC_APP_URL="http://localhost:8015"
# ===== AI 配置(可选) =====
AI_API_KEY=""
AI_BASE_URL=""
AI_MODEL=""
# ===== 灾备配置 =====
# 异地备份后端类型: s3|oss|nfs|none
BACKUP_OFFSITE_BACKEND=none
# 远程存储路径
# - s3: s3://bucket-name/backups/
# - oss: oss://bucket-name/backups/
# - nfs: /mnt/nfs/backups/
BACKUP_OFFSITE_REMOTE=
# 存储桶名称(仅 s3/oss)
BACKUP_OFFSITE_BUCKET=
# 访问密钥
BACKUP_OFFSITE_ACCESS_KEY=
# 秘密密钥
BACKUP_OFFSITE_SECRET_KEY=
# 区域(默认 us-east-1)
BACKUP_OFFSITE_REGION=us-east-1
# 远程备份保留天数(默认 90)
BACKUP_OFFSITE_RETENTION_DAYS=90
# ===== 灾备演练配置 =====
# 演练测试数据库名(默认 next_edu_dr_drill)
DR_DRILL_TEST_DB=next_edu_dr_drill
# 演练报告目录(默认 docs/dr/reports)
DR_DRILL_REPORT_DIR=docs/dr/reports
# ===== 健康检查配置 =====
# 应用健康检查 URL(默认 http://localhost:8015)
HEALTH_CHECK_URL=http://localhost:8015
# 磁盘空间阈值百分比(默认 90)
HEALTH_CHECK_DISK_THRESHOLD=90
# 备份最大年龄(小时,默认 24)
HEALTH_CHECK_BACKUP_MAX_AGE=24
# ===== 故障切换配置 =====
# 备库连接 URL(故障切换时使用)
DATABASE_URL_STANDBY=
# 应用容器名(默认 nextjs-app)
FAILOVER_APP_NAME=nextjs-app
# 应用 URL(默认 http://localhost:8015)
FAILOVER_APP_URL=http://localhost:8015
# 配置文件路径(默认 .env.local)
FAILOVER_CONFIG_FILE=.env.local
# 切换日志路径(默认 docs/dr/logs/failover.log)
FAILOVER_LOG_FILE=docs/dr/logs/failover.log
# ===== 备份配置 =====
# 备份目录(默认 ./backups)
BACKUP_DIR=./backups
# 本地备份保留天数(默认 30)
RETENTION_DAYS=30
# 备份校验最小文件大小(字节,默认 1024)
BACKUP_VERIFY_MIN_SIZE=1024