# 小橘子后台管理系统

**Repository Path**: TuXiaobo/backend-management-system

## Basic Information

- **Project Name**: 小橘子后台管理系统
- **Description**: 基于Vue3 + NestJS 开发
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 2
- **Forks**: 0
- **Created**: 2025-02-07
- **Last Updated**: 2025-06-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: vue3, Nestjs

## README

# 小橘子后台管理系统

## 项目概述

本项目是一个基于 Vue3 和 NestJS 的后台管理系统，旨在提供一个高效、可扩展的管理界面和后端服务。系统采用前后端分离架构，具有完善的权限管理、动态路由、国际化等特性。

## 演示地址

- 演示地址：[https://home.xjzgzs.cn](https://home.xjzgzs.cn)
- 测试账号：admin/123456

## 技术栈

### 前端技术栈

- **核心框架**: Vue 3
- **构建工具**: Vite
- **状态管理**: Pinia
- **路由管理**: Vue Router

### 后端技术栈

- **核心框架**: NestJS
- **数据库**: MySQL
- **ORM**: TypeORM

### 开发工具

- **包管理工具**: pnpm
- **开发工具**: VS Code（推荐）
- **代码规范**: ESLint + Prettier

## 环境要求

- Node.js 16+
- pnpm 8+
- MySQL 5.7+

## 项目结构

```
├── Vue-admin/          # 前端项目目录
│   ├── src/            # 源代码
│   │   ├── api/        # 接口定义
│   │   ├── assets/     # 静态资源
│   │   ├── components/ # 通用组件
│   │   ├── layout/     # 布局组件
│   │   ├── router/     # 路由配置
│   │   ├── stores/     # 状态管理
│   │   ├── utils/      # 工具函数
│   │   └── views/      # 页面组件
├── server/            # 后端项目目录
│   ├── src/           # 源代码
│   │   ├── modules/   # 业务模块
│   │   ├── common/    # 公共模块
│   │   ├── config/    # 配置文件
│   │   └── utils/     # 工具函数
└── script/           # 部署脚本

```

## 安装步骤

1. 确保您的开发环境满足上述环境要求。

2. 克隆项目仓库到本地：

   ```bash
   git clone https://gitee.com/TuXiaobo/backend-management-system.git
   ```

3. 进入项目目录并安装依赖：

   ```bash
   cd backend-management-system
   pnpm install
   ```

4. 配置环境变量：
   - 前端配置：复制 `Vue-admin/.env.example` 到 `Vue-admin/.env`，并根据实际情况修改配置
   - 后端配置：复制 `server/.env.example` 到 `server/.env`，配置数据库等相关信息

## 开发指南

1. 启动后端服务：

   ```bash
   cd server
   pnpm dev
   ```

2. 启动前端开发服务器：

   ```bash
   cd Vue-admin
   pnpm dev
   ```

3. 打开浏览器，访问 `http://localhost:3001` 查看项目运行效果。

## 项目特性

- 🚀 基于 Vue 3 + Vite 构建，开发体验极致
- 📦 自动按需引入组件，减小打包体积
- 🎨 可配置的主题和布局
- 🔐 完善的权限管理系统
- 🌍 内置国际化支持
- 📱 响应式设计，支持多端适配
- 🔥 动态路由，支持菜单配置
- 📋 标签页快速导航

## 部署指南

1. 构建前端项目：

   ```bash
   cd Vue-admin
   pnpm build
   ```

2. 构建后端项目：

   ```bash
   cd server
   pnpm build
   ```

3. 使用 script 目录下的部署脚本进行自动化部署。

## 贡献指南

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) 文件了解详情。