# 橘子管理系统

**Repository Path**: ttzhanshen/orange-management-system

## Basic Information

- **Project Name**: 橘子管理系统
- **Description**: 若依框架升级版
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-15
- **Last Updated**: 2026-05-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 橘子（juzi）后台（优化版）

基于 **Spring Boot 4** 与 **Vue 2** 的前后端分离快速开发平台，在经典前后端分离架构上完成 **橘子 / juzi** 品牌化与工程化定制，并做了安全、性能与体验方面的增强，适合作为企业后台与二次开发基座。

| 项目 | 说明 |
|------|------|
| 基线版本 | 3.9.2（参考社区开源 RuoYi-Vue 能力集） |
| 后端 | Spring Boot 4.0.x、JDK 17、MyBatis、Spring Security、Redis、JWT |
| 前端 | Vue 2、Element UI、Vite |

## 环境要求

- **JDK 17+**（必需）
- Maven 3.6+
- Node.js 与 npm（建议 LTS，用于前端）
- MySQL 5.7+ / 8.x
- Redis

未安装 JDK 17 时，可参考仓库内 [JAVA_SETUP_GUIDE.md](./JAVA_SETUP_GUIDE.md)（Windows 也可使用 `install-java17.bat`）。

## 技术栈摘要

**后端**：Spring Boot 4、MyBatis-Plus、Druid、PageHelper、JWT（0.12.x）、SpringDoc 等。

**前端**：Vue 2、Vuex、Vue Router、Element UI、Axios、ECharts；开发构建为 Vite。

## 目录结构

```
├── juzi-admin      # 启动入口与 Web 层
├── juzi-common     # 通用工具与常量
├── juzi-framework  # 安全、配置等框架能力
├── juzi-system     # 系统业务模块
├── juzi-quartz     # 定时任务
├── juzi-generator  # 代码生成
├── juzi-ui         # 前端工程（Vite）
├── deploy          # 部署示例（Nginx「橘子」站点）
└── sql             # 初始化脚本
```

## 快速开始

### 1. 数据库

创建数据库 **`juzi`**（品牌「橘子」业务库，与 `application-druid.yml` 中 JDBC 库名一致）后，按顺序执行 `sql` 目录中的脚本（例如 `juzi_20260417.sql`、`quartz.sql`；若有性能相关表结构，再执行 `performance_optimization.sql`）。在 `juzi-admin/src/main/resources/application-druid.yml`（及 `application.yml`）中配置数据源与 Redis。

### 2. 后端

```bash
cd juzi-admin
mvn spring-boot:run
```

或在 IDE 中运行 `com.juzi.JuziApplication`。默认服务端口为 **8080**（见 `application.yml`）。

### 3. 前端

```bash
cd juzi-ui
npm install
npm run dev
```

开发服务器默认端口由环境变量 `VITE_APP_PORT` 决定，未配置时为 **80**；接口通过 Vite 代理转发到 `http://localhost:8080`（见 `juzi-ui/vite.config.js`）。若 80 端口被占用，可在 `juzi-ui` 下的环境文件中设置 `VITE_APP_PORT`。

生产构建：

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

将生成静态资源，由 Nginx 等托管并与后端反向代理配合；可参考仓库内 **[deploy/nginx-juzi.example.conf](./deploy/nginx-juzi.example.conf)**（「橘子」站点示例）。

## 优化与扩展说明

本仓库在标准后台管理基线能力之外，包含安全加固、缓存与限流、慢 SQL 检测、健康检查、导出与前端体验等增强，详细说明见：

- [OPTIMIZATION_GUIDE.md](./OPTIMIZATION_GUIDE.md)
- [OPTIMIZATION_SUMMARY.md](./OPTIMIZATION_SUMMARY.md)
- [OPTIMIZATION_CHECKLIST.md](./OPTIMIZATION_CHECKLIST.md)
- [juzi-ui/FRONTEND_OPTIMIZATION.md](./juzi-ui/FRONTEND_OPTIMIZATION.md)

## 参考链接

- 在线演示：<http://vue.juzi.local>（演示环境账号以实际部署为准，常见为 `admin` / `admin123`）
- 文档：<http://doc.juzi.local>
- 开源参考仓库：<https://gitee.com/y_project/RuoYi-Vue>（上游技术基线，非「橘子」品牌站点）

## 许可证

开源许可以仓库根目录 **LICENSE** 文件为准。