# youlai-nest
**Repository Path**: git.mrxu.net/youlai-nest
## Basic Information
- **Project Name**: youlai-nest
- **Description**: 基于 Node、Nest 11、TypeScript、MongoDB、Vue 3 和 Element-Plus 构建的前后端分离权限管理系统，适合想入门全栈开发的前端人员。项目持续优化更新中。有问题可以加群有人解答问题
- **Primary Language**: JavaScript
- **License**: MIT
- **Default Branch**: master
- **Homepage**: https://vue.youlai.tech/template
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 35
- **Created**: 2025-07-19
- **Last Updated**: 2025-07-19
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
## 📢 项目简介
**在线预览**: [https://vue.youlai.tech](https://vue.youlai.tech)
基于 node18、nest.js、mongoDB、JWT、Redis、阿里云oss、Vue 3、Element-Plus 构建的前后端分离单体权限管理系统。
- **🚀 开发框架**: 使用 nest.js 和 Vue 3，以及 Element-Plus 等主流技术栈，实时更新。
- **🔐 安全认证**: 结合 NestJS 的自定义 AuthGuard 和 JWT，提供安全、无状态、分布式友好的身份验证和授权机制。
- **🔑 权限管理**: 基于 RBAC 模型，实现细粒度的权限控制，涵盖接口方法和按钮级别。
- **🛠️ 功能模块**: 包括用户管理、角色管理、菜单管理、部门管理、字典管理等多个功能。
- **📘 接口文档**: 自动生成接口文档，支持在线调试，提高开发效率。
## 🌈 项目源码
| 项目类型 | Gitee | Github | GitCode |
| -------------- | -------------------------------------------------------------------------- | ---------------------------------------------------------------------------- | ------------------------------------------------------------------------- |
| ✅ Node 后端 | [youlai-nest](https://gitee.com/youlaiorg/youlai-nest) | [youlai-nest](https://github.com/youlaitech/youlai-nest) | [youlai-nest](https://gitcode.com/youlai/youlai-nest) |
| vue3 前端 | [vue3-element-template](https://gitee.com/youlaiorg/vue3-element-template) | [vue3-element-template](https://github.com/youlaitech/vue3-element-template) | [vue3-element-template](https://gitcode.com/youlai/vue3-element-template) |
| uni-app 移动端 | [vue-uniapp-template](https://gitee.com/youlaiorg/vue-uniapp-template) | [vue-uniapp-template](https://github.com/youlaitech/vue-uniapp-template) | [vue-uniapp-template](https://gitcode.com/youlai/vue-uniapp-template) |
## 📚 项目文档
| 文档名称 | 访问地址 |
| ------------------ | -------------------------------------------------------------------------------------------------------- |
| 在线接口文档 | [https://www.apifox.cn/apidoc](https://www.apifox.cn/apidoc/shared-195e783f-4d85-4235-a038-eec696de4ea5) |
| 项目介绍与使用指南 | [https://www.youlai.tech/youlai-nest/](https://www.youlai.tech/youlai-nest/) |
## 🚀 项目启动
📚 完整流程参考: [项目启动](https://www.youlai.tech/youlai-nest/1.%E9%A1%B9%E7%9B%AE%E5%90%AF%E5%8A%A8/)
1. **数据库初始化**
- **命令行导入**
MongoDB 脚本放在项目的根目录 mongodb 下 ，复制到指定目录下(./mongodb/ ), 然后执行以下命令还原数据库：
```bash
mongorestore -d youlai_nest ./mongodb/
```
- **Navicat 导入**
参考 [Navicat 导入](https://www.youlai.tech/youlai-nest/1.%E9%A1%B9%E7%9B%AE%E5%90%AF%E5%8A%A8/#%E6%96%B9%E6%B3%95%E4%BA%8C-navicat-%E5%8F%AF%E8%A7%86%E5%8C%96%E5%AF%BC%E5%85%A5) 进行数据库导入。
2. **修改配置**
默认连接`有来`线上环境的 MongoDB/Redis（仅读权限），本地开发时请修改 [.env.dev](.env.dev) 中的 MongoDB/Redis 连接信息。
3. **启动项目**
```bash
# 克隆代码
git clone https://gitee.com/youlaiorg/youlai-nest.git
# 切换目录
cd youlai-nest
# 安装 pnpm
npm install pnpm -g
# 设置镜像源(可忽略)
pnpm config set registry https://registry.npmmirror.com
# 安装依赖
pnpm install
# 启动运行
pnpm run start:dev
```
访问接口文档地址 [http://localhost:9090/apiDoc](http://localhost:9090/doc.html) 验证项目启动是否成功.
## 💖 加交流群
① 关注「有来技术」公众号，点击菜单 **交流群** 获取加群二维码（此举防止广告进群，感谢理解和支持）。
② 直接添加微信 **`haoxianrui`** 备注「前端/后端/全栈」。
