b5826ee469
🚀 新增功能: - wwjcloud-nest-v1: 完整的 NestJS 智能框架 - AI 自愈机制: @wwjcloud/auto-healing 模块 - 智能代码生成: tools-v1/php-tools 迁移工具链 - AI 能力规划: v1/docs/AI-CAPABILITY-ROADMAP.md 📦 核心模块: - libs/wwjcloud-ai: AI 策略和恢复服务 - libs/wwjcloud-boot: 启动和配置管理 - libs/wwjcloud-core: 核心基础设施 - libs/wwjcloud-addon: 插件系统 🏗️ 架构特性: - 分层渐进式 AI 策略 - 微服务导向的模块化设计 - 与 PHP 项目 100% 业务一致性 - Docker 容器化部署支持 📋 版本信息: - 版本: v0.1.0 - 发布日期: 2025-01-25 - 分支: v1
59 lines
1.8 KiB
Markdown
59 lines
1.8 KiB
Markdown
# 🚀 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` |