4eabee8a46572c368eaa948d5cac62bc0a4efd80
🐛 Bug: 0参数方法返回null,导致回退到旧逻辑 ✅ 修复: - serviceParams !== null (而不是 length > 0) - 0参数方法返回空字符串 '' - getLocalAddonList() ✅ 不再错误地传参 📊 预期效果: 修复0参数方法调用
WWJCloud-Nest 🚀
基于NestJS v11的企业级全栈框架,对标Java Spring Boot和PHP ThinkPHP。
🏗️ 架构设计
WWJCloud NestJS企业级架构:
├── Config层 ✅ 框架配置中心 (NuCloud Config)
├── Common层 ✅ 基础设施层 (缓存/日志/监控/异常)
├── Vendor层 ✅ 第三方服务集成 (支付/短信/上传/通知)
├── Core层 🔄 通用业务逻辑 (会员/装修/字典)
└── App层 🔄 具体业务实现 (前台/管理端)
✨ 核心特性
- 🎯 企业级框架:完整的企业应用开发基础设施
- 🔧 配置中心:动态配置、热更新、多租户支持
- 💰 支付集成:微信支付、支付宝、线下支付
- 📱 多渠道支持:微信、小程序、H5、APP
- 🔐 多租户架构:SaaS/独立版混合部署
- 📊 监控告警:日志、指标、链路追踪
- 🛠️ 开发工具:代码生成器、插件系统
🚀 快速开始
环境要求
- Node.js 18+
- MySQL 8.0+
- Redis 6.0+
安装运行
# 1. 克隆项目
git clone <repository-url>
cd wwjcloud-nest
# 2. 安装依赖
npm install
# 3. 启动数据库 (Docker)
docker-compose up -d mysql redis
# 4. 启动应用
npm run start
# 5. 访问应用
http://localhost:3001
API测试
# 健康检查
curl http://localhost:3001/
# 配置状态
curl http://localhost:3001/config/status
# 查询配置
curl http://localhost:3001/config/value/WECHAT
📁 项目结构
src/
├── config/ # 配置中心
├── common/ # 基础设施
│ ├── cache/ # 缓存服务
│ ├── logging/ # 日志服务
│ ├── monitoring/ # 监控服务
│ ├── queue/ # 队列服务
│ ├── utils/ # 工具类
│ └── ...
├── vendor/ # 第三方集成
│ ├── pay/ # 支付服务
│ ├── sms/ # 短信服务
│ ├── upload/ # 上传服务
│ └── ...
├── core/ # 通用业务
└── main.ts # 应用入口
🏪 技术栈
后端技术
- 框架: NestJS 11 + TypeScript
- 数据库: MySQL 8.0 + TypeORM
- 缓存: Redis + BullMQ队列
- 文档: Swagger API文档
- 监控: Prometheus + OpenTelemetry
开发工具
- 构建: Nest CLI + Webpack
- 代码质量: ESLint + Prettier
- 测试: Jest + Supertest
- 容器: Docker + Docker Compose
🌟 对标说明
| 特性 | Java Spring Boot | PHP ThinkPHP | WWJCloud NestJS |
|---|---|---|---|
| 依赖注入 | ✅ Spring IoC | ✅ Container | ✅ NestJS DI |
| 配置管理 | ✅ Application.yml | ✅ Config | ✅ ConfigCenter |
| 数据库ORM | ✅ JPA/MyBatis | ✅ Model | ✅ TypeORM |
| 缓存支持 | ✅ Redisson | ✅ Cache | ✅ Redis |
| 队列系统 | ✅ Rabbit/Active | ✅ Queue | ✅ BullMQ |
| 监控告警 | ✅ Micrometer | ✅ Monitor | ✅ Prometheus |
📖 开发文档
🤝 贡献指南
- Fork 项目
- 创建特性分支 (
git checkout -b feature/amazing-feature) - 提交更改 (
git commit -m 'Add amazing feature') - 推送到分支 (
git push origin feature/amazing-feature) - 创建 Pull Request
📄 许可证
本项目采用 MIT 许可证 - 查看 LICENSE 文件了解详情。
👥 团队
- 架构师: WWJCloud团队
- 开发者: NestJS企业级开发团队
- 产品经理: SaaS平台产品团队
⭐ 如果这个项目对你有帮助,请给它一个星星!
Description
Languages
Vue
43.5%
JavaScript
26.8%
TypeScript
26%
CSS
2%
HTML
0.9%
Other
0.7%