# 小帆若依

**Repository Path**: LiFan2004/xiaofan-ruoyi-node

## Basic Information

- **Project Name**: 小帆若依
- **Description**: 对java版本的若依进行二改 保留原来所有功能，后续会迭代新功能敬请期待
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2025-12-16
- **Last Updated**: 2026-02-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 小帆-若依 Node.js 版

一个基于原版若依Java管理系统改造的Node.js版本，完整保留了若依的所有功能模块，采用前后端分离架构。

## 📌 项目来源

本项目基于嘉仪大佬的开源项目二次开发、更新升级：https://gitee.com/auhgnep/JiaYi-NodeJs

## 📋 项目简介

本项目是对经典若依管理系统的Node.js重构版本，保持了原有的完整功能体系，并针对Node.js生态进行了优化和适配。项目采用现代化的前后端分离架构，后端使用Node.js + Express，前端使用Vue 2 + Element UI。

## 项目运行截图

![输入图片说明](image.png)
![输入图片说明](image1.png)
![输入图片说明](image2.png)
![输入图片说明](image3.png)
![输入图片说明](image4.png)

## 在线体验

http://119.91.33.120

## 🚀 技术栈

### 后端技术栈
- **Node.js** - JavaScript运行时环境
- **Express** - Web应用框架
- **MySQL2** - MySQL数据库驱动
- **Redis** - 缓存数据库
- **JWT** - 身份验证
- **BCrypt** - 密码加密
- **Sequelize** - ORM框架
- **Multer** - 文件上传
- **Node-schedule** - 定时任务

### 前端技术栈
- **Vue 2** - 渐进式JavaScript框架
- **Element UI** - UI组件库
- **Vue Router** - 路由管理
- **Vuex** - 状态管理
- **Axios** - HTTP客户端
- **ECharts** - 数据可视化
- **JS-Beautify** - 代码格式化
- **Clipboard** - 剪贴板操作
- **Screenfull** - 全屏功能

## 📁 项目结构

```
xiaofan-ruoyi/
├── xiaofan-ruoyi-node-server/      # 后端服务
│   ├── app.js                     # 应用入口
│   ├── config/                    # 配置文件
│   ├── models/                    # 数据模型
│   ├── controllers/               # 控制器
│   ├── services/                  # 业务逻辑
│   ├── routes/                    # 路由定义
│   ├── middleware/                # 中间件
│   └── package.json              # 后端依赖配置
├── xiaofan-ruoyi-node-web/        # 前端应用
│   ├── src/                       # 源代码
│   │   ├── views/                 # 页面组件
│   │   ├── components/            # 公共组件
│   │   ├── api/                   # API接口
│   │   ├── router/                # 路由配置
│   │   ├── store/                 # 状态管理
│   │   └── utils/                 # 工具函数
│   ├── public/                    # 静态资源
│   └── package.json               # 前端依赖配置
├── .gitignore                     # Git忽略文件
└── README.md                      # 项目说明文档
```

## 🔧 系统功能

### 用户管理
- 用户信息管理
- 角色权限分配
- 部门组织架构
- 岗位职能管理

### 系统管理
- 菜单权限管理
- 角色权限管理
- 字典数据管理
- 参数配置管理
- 通知公告管理
- 日志记录查看

### 系统监控
- 在线用户监控
- 定时任务管理
- 数据监控面板
- 服务监控信息
- 缓存监控管理
- 在线构建器

### 系统工具
- 表单构建器
- 代码生成器
- 系统接口文档

## 🛠️ 安装部署

### 环境要求
- Node.js >= 8.9.0
- npm >= 3.0.0
- MySQL >= 5.7
- Redis >= 3.0

### 后端部署

1. **克隆项目**

```bash
git clone https://gitee.com/LiFan2004/xiaofan-ruoyi.git
cd xiaofan-ruoyi/xiaofan-ruoyi-node-server
```

2. **安装依赖**

```bash
npm install
```

3. **配置数据库**
- 修改配置文件中的数据库连接信息
- 导入若依数据库结构

4. **启动服务（推荐：源码直接运行）**

源码直接运行适合开发和日常部署，**修改代码后无需重新打包**，重启服务即可生效。

```bash
npm start
```

5. **启动服务（打包运行）**

打包运行适合在环境一致、需要产出单文件的场景；但如果你要频繁改代码，仍推荐使用“源码直接运行”。

```bash
# 启动（使用的配置为 src/config/index.js）
npm run dev

# 测试环境打包（使用的配置为 src/config/sit.js）
npm run build:sit

# 生产环境打包（使用的配置为 src/config/prod.js）
npm run build:prod

# 生产启动（打包后会在 dist 内生成 server.bundle.js）
nohup node server.bundle.js &

# 生产启动（使用 pm2 启动，watch 可选）
pm2 start server.bundle.js --watch
```

5. **补丁描述**
patch-require.js文件是对linux、Ubtun系统的文件大小写命名的转义，当前系统保留的文件方法是大小驼峰，linux、Ubtun系统会自动转成小写导致文件无法找到，该补丁会对其修正

### 前端部署

1. **进入前端目录**

```bash
cd xiaofan-ruoyi-node-web
```

2. **安装依赖**

```bash
npm install
```

3. **开发环境运行**

```bash
npm run dev
```

4. **生产环境构建**

```bash
npm run build:prod
```

## 📖 使用说明

1. **初始化数据库**：首先需要导入若依系统的数据库结构
2. **配置系统参数**：修改配置文件中的数据库、Redis等连接参数
3. **启动后端服务**：确保Node.js后端服务正常运行
4. **启动前端服务**：开发环境或生产环境启动前端应用
5. **访问系统**：默认访问地址 `http://localhost:80`

## 🔐 默认账号

- 管理员账号：admin/123456

*注意：生产环境请修改默认密码*

## 📝 开发说明

### 项目特色
- ✅ **完整功能**：保留若依原版所有功能模块
- ✅ **技术迁移**：从Java生态平滑迁移到Node.js生态
- ✅ **架构优化**：采用现代化前后端分离架构
- ✅ **性能优化**：针对Node.js特性进行性能调优
- ✅ **易于维护**：代码结构清晰，便于二次开发

### 开发规范
- 遵循ESLint代码规范
- 使用Git Flow工作流
- 编写单元测试
- 完善代码注释

## 🤝 贡献指南

欢迎提交Issue和Pull Request来帮助改进项目：

1. Fork 本项目
2. 创建特性分支 (`git checkout -b feature/AmazingFeature`)
3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 开启 Pull Request

## 📄 许可证

本项目采用 MIT 许可证 - 查看 [LICENSE](LICENSE) 文件了解详情

## 📞 联系方式

- 项目地址：https://gitee.com/LiFan2004/xiaofan-ruoyi
- 问题反馈：请在Issues中提交
- 技术交流：欢迎在评论区讨论

## 🚀 版本规划

- [x] v1.0.0 - 基础功能完整迁移
- [ ] v1.1.0 - 性能优化和Bug修复
- [ ] v1.2.0 - 新增Node.js特色功能
- [ ] v2.0.0 - 微服务架构改造

---

## ⭐ 致谢

感谢若依原版项目提供的优秀架构和功能基础，以及所有为开源社区做出贡献的开发者们。

**后续将持续迭代新功能，敬请期待！** 🎉