wwjcloud-nest-v1/wwjcloud-nest-v1

WWJCloud NestJS v1 Framework

基于 NestJS v11 的企业级全栈框架，超越 Java 的企业能力

🎯 项目概述

WWJCloud NestJS v1 是一个基于 NestJS v11 构建的企业级全栈框架，旨在提供超越 Java 框架的企业能力，包括：

• 🚀 高性能: 基于 NestJS v11 的现代化架构
• 🤖 AI 治理: 内置 AI 自愈、性能优化和安全防护
• 🏗️ 企业级: 完整的基础设施层（Boot + AI + Core）
• 🔄 无缝迁移: Java 到 NestJS 的一键迁移工具

📁 项目结构

wwjcloud-nest-v1/
├── wwjcloud/              # NestJS 后端核心
│   ├── apps/api/          # API 应用入口
│   ├── libs/              # 核心库
│   │   ├── wwjcloud-boot/ # 基础设施层
│   │   ├── wwjcloud-ai/   # AI 治理层  
│   │   ├── wwjcloud-core/ # 业务核心层
│   │   └── wwjcloud-addon/# 插件扩展层
│   ├── src/               # 业务代码
│   └── test/              # 测试文件
├── admin/                 # 管理端前端
├── web/                   # PC端前端
├── uni-app-x/             # 移动端前端 (uni-app x)
├── wwjcloud-web/          # 统一部署目录
├── docker/                # Docker 配置
├── docs/                  # 文档目录
└── tools/                 # 开发工具
    ├── tools-v1/          # Java 迁移工具
    └── tools-uni/         # uni-app 迁移工具

🚀 快速开始

环境要求

• Node.js 20+
• Docker & Docker Compose
• MySQL 8.0+
• Redis 7+

安装依赖

# 安装后端依赖
cd wwjcloud
npm install

# 安装前端依赖
cd admin
npm install

开发环境启动

# 启动后端服务
cd wwjcloud
npm run start:dev

# 启动前端管理面板
cd admin  
npm run dev

Docker 全栈启动

cd docker
docker-compose up -d

📚 详细文档

核心文档

• V1 框架指南 - 📖 完整开发与运维指南
• AI 能力说明 - 🤖 AI 治理能力详解
• 基础设施配置 - 🏗️ Boot 层配置指南

开发工具

• Java 迁移工具 - ⚡ Java 到 NestJS 迁移
• uni-app 迁移 - 📱 uni-app 到 uni-app-x 迁移

🔧 核心特性

基础设施层 (Boot)

• 请求追踪: 全局请求 ID 和链路追踪
• 健康检查: 多层次健康检查端点
• 指标监控: Prometheus 指标暴露
• 缓存系统: 多级缓存和分布式锁
• 国际化: 完整的 i18n 支持

AI 治理层 (AI)

• 自愈系统: 自动故障检测和恢复
• 性能优化: 智能缓存和查询优化
• 安全防护: 异常检测和访问控制
• 预测分析: 系统负载和性能预测

业务核心层 (Core)

• 模块化架构: 完整的业务模块体系
• 统一 API: 标准化的接口规范
• 数据层: TypeORM 实体和仓储
• 权限系统: RBAC 权限控制

🧪 测试与部署

单元测试

cd wwjcloud
npm run test
npm run test:e2e

性能测试

cd docker
docker-compose up k6  # K6 压测

生产部署

# 构建镜像
docker-compose build

# 启动生产环境
docker-compose -f docker-compose.prod.yml up -d

🤝 贡献指南

1. 查看 开发规范
2. 遵循 命名约定
3. 提交时请使用标准的 commit 格式

📄 许可证

本项目采用 MIT 许可证 - 查看 LICENSE 文件了解详情。