# 🚀 AI 恢复模块快速启动（针对 wwjcloud-nest-v1/apps/api）

## 目标
- 在开发环境以最简配置验证 AI 恢复队列的闭环（事件→入队→处理→收敛）

## 预备条件
- Node.js 18+
- `wwjcloud-nest-v1` 中的 `apps/api` 可运行

## 环境变量（开发最简闭环）
```bash
NODE_ENV=development
PORT=3001
AI_ENABLED=true
GLOBAL_PREFIX=api
QUEUE_DRIVER=memory     # 免 Redis/Kafka 干扰
TELEMETRY_ENABLED=false
REDIS_ENABLED=false
KAFKA_ENABLED=false
JWT_SECRET=dev-secret    # 若开启守卫需配置
AUTH_ENABLED=true
RBAC_ENABLED=false
```

## 启动示例
> 推荐在 `wwjcloud-nest-v1` 目录下执行：
```bash
# 以 apps/api 方式启动（端口 3001）
NODE_ENV=development JWT_SECRET=dev-secret AI_ENABLED=true AUTH_ENABLED=true RBAC_ENABLED=false GLOBAL_PREFIX=api QUEUE_ENABLED=false PORT=3001 npm run start -- api
```

## 本地验证命令
```bash
# 1) 初始队列大小（应为 0）
curl -s http://localhost:3001/api/ai/recovery/status

# 2) 模拟失败（入队增长）
curl -s "http://localhost:3001/api/ai/recovery/simulate-failure?taskId=T1&severity=high&reason=quick-start"

# 3) 再次查看队列（应增长）
curl -s http://localhost:3001/api/ai/recovery/status

# 4) 处理一个（队列收敛）
curl -s -X POST http://localhost:3001/api/ai/recovery/process-one

# 5) 清空队列（可选）
curl -s -X POST http://localhost:3001/api/ai/recovery/drain
```

## 常见问题
- Kafka 报错但驱动为 `memory`：可忽略，不影响路由与内存队列
- 路由前缀：`GLOBAL_PREFIX=api` 下基础设施路由保留原始状态码（已在异常过滤器处理）
- 根应用与 apps/api：两端可挂载 AI 模块；开发推荐统一在 `apps/api`（3001）验证

## 参考文档
- `docs/AI-RECOVERY-DEV.md`
- `docs/CONFIG_SETUP.md`
- `docs/DEVELOPMENT-GUIDE.md`
- `docs/PRODUCTION-DEPLOYMENT.md`