- 将wwjcloud目录重命名为wwjcloud-nest-v1作为项目根目录 - 将原nestjs目录重命名为wwjcloud作为NestJS后端目录 - 实现真正的前后端分离架构 - 恢复工作区中丢失的目录结构 - 更新相关配置文件路径引用 - 清理重复和嵌套目录问题 目录结构: wwjcloud-nest-v1/ ├── wwjcloud/ # NestJS 后端 ├── admin/ # 管理端前端 ├── web/ # PC端前端 ├── uni-app-x/ # 移动端前端 ├── wwjcloud-web/ # 部署根目录 ├── docker/ # Docker 配置 ├── docs/ # 文档 └── tools/ # 工具集
1.8 KiB
1.8 KiB
🚀 AI 恢复模块快速启动(针对 wwjcloud-nest-v1/apps/api)
目标
- 在开发环境以最简配置验证 AI 恢复队列的闭环(事件→入队→处理→收敛)
预备条件
- Node.js 18+
wwjcloud-nest-v1中的apps/api可运行
环境变量(开发最简闭环)
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目录下执行:
# 以 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
本地验证命令
# 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.mddocs/CONFIG_SETUP.mddocs/DEVELOPMENT-GUIDE.mddocs/PRODUCTION-DEPLOYMENT.md