c4e588a2fe
- ✅ 成功运行迁移工具，生成28个模块的完整NestJS代码 - ✅ 生成所有实体、服务、控制器、验证器等组件 - ✅ 修复npm依赖冲突，更新package-lock.json - ✅ 添加Docker测试脚本和配置文件 - ✅ 完善迁移工具的调试日志和错误处理 - 🔧 包含增量更新工具和质量检查工具 - 📊 迁移统计：28个模块，数千个文件，耗时26.47秒 主要变更： - wwjcloud-nest/src/core/* - 生成的业务模块代码 - tools/* - 迁移工具和辅助脚本 - wwjcloud-nest/package.json - 依赖更新 - docker/* - 容器化配置和测试脚本
149 lines
4.1 KiB
Markdown
149 lines
4.1 KiB
Markdown
# 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+
|
||
|
||
### 安装运行
|
||
|
||
```bash
|
||
# 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测试
|
||
|
||
```bash
|
||
# 健康检查
|
||
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 |
|
||
|
||
## 📖 开发文档
|
||
|
||
- [架构设计文档](./ARCHITECTURE.md)
|
||
- [迁移指南](./MIGRATION_GUIDE.md)
|
||
- [开发计划](./DEVELOPMENT_PLAN.md)
|
||
|
||
## 📚 快速入口
|
||
|
||
- AI 恢复端点开发指南：`docs/AI-RECOVERY-DEV.md`
|
||
- AI 工作流指南：`docs/AI-WORKFLOW-GUIDE.md`
|
||
- 配置设置指南（含 AI 配置与验证）：`docs/CONFIG_SETUP.md`
|
||
- 开发指南（AI 集成与测试）：`docs/DEVELOPMENT-GUIDE.md`
|
||
- 生产部署手册：`docs/PRODUCTION-DEPLOYMENT.md`
|
||
- 工具集 v1（针对 wwjcloud-nest-v1）：`tools-v1/`
|
||
|
||
## 🤝 贡献指南
|
||
|
||
1. Fork 项目
|
||
2. 创建特性分支 (`git checkout -b feature/amazing-feature`)
|
||
3. 提交更改 (`git commit -m 'Add amazing feature'`)
|
||
4. 推送到分支 (`git push origin feature/amazing-feature`)
|
||
5. 创建 Pull Request
|
||
|
||
## 📄 许可证
|
||
|
||
本项目采用 MIT 许可证 - 查看 [LICENSE](LICENSE) 文件了解详情。
|
||
|
||
## 👥 团队
|
||
|
||
- **架构师**: WWJCloud团队
|
||
- **开发者**: NestJS企业级开发团队
|
||
- **产品经理**: SaaS平台产品团队
|
||
|
||
---
|
||
|
||
⭐ 如果这个项目对你有帮助，请给它一个星星！ |