# drip-admin-vue

**Repository Path**: dripai/drip-admin-vue

## Basic Information

- **Project Name**: drip-admin-vue
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-14
- **Last Updated**: 2026-07-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Drip Admin Vue

Drip Admin Vue 是一个可直接复制使用的后台系统母版项目。开发企业后台、权限系统、配置中心、定时任务、日志审计、字典管理、打印模板等管理类系统时，可以从本项目复制目录结构、接口契约、前端页面和基础模块，再按具体业务扩展。

项目采用前后端分离结构，后端 API、前端管理端和移动端目录独立维护；Java 是接口契约源，同时提供 Go、Python、Rust 的同契约后端实现。

## 技术栈

### 后端

Java 后端：

- Java 25
- Spring Boot 4.1
- Spring Web MVC
- Spring Validation
- Spring JDBC
- Spring Data Redis
- Spring AOP
- MySQL
- MyBatis-Plus 3.5
- Sa-Token 1.45
- SpringDoc OpenAPI 3.0
- Spring Boot Admin 4.0
- EasyExcel 4.0
- Maven

Go 后端：

- Gin
- GORM
- GORM MySQL Driver
- go-redis
- Viper
- zap
- swaggo/gin-swagger
- excelize
- testing
- testify

Python 后端：

- FastAPI
- Uvicorn
- SQLAlchemy 2 async
- asyncmy
- redis-py asyncio
- Pydantic v2
- pydantic-settings
- openpyxl
- pytest

Rust 后端：

- Axum、Tokio、Tower
- Rbatis、rbdc-mysql
- deadpool-redis
- config、tracing、tracing-subscriber
- validator
- utoipa、utoipa-swagger-ui
- rust_xlsxwriter
- cargo test

### 前端

- Vue 3
- TypeScript
- Vite 8
- Ant Design Vue 4
- Pinia
- Vue Router
- Axios
- Sass
- vue-plugin-hiprint
- Vitest
- ESLint
- Prettier
- pnpm

## 项目结构

```text
.
├── backend/    # Java Spring Boot 后端服务
├── backend-go/ # Go 后端服务
├── backend-python/ # Python FastAPI 后端服务
├── backend-rust/ # Rust Axum 后端服务
├── frontend/   # Vue 管理端
├── mobile/     # 移动端工程目录
├── scripts/    # 脚本目录
├── pic/        # 项目界面截图
└── README.md
```

## 后端说明

项目支持 Java、Go、Python、Rust 四个后端实现。Java 是 API 契约源；其余后端保持相同的 `/api` 路径、请求字段、响应结构、权限码、异常码和 Long 字符串序列化。四个后端默认端口均为 `9001`，一次只启动其中一个。

### Java

Java 后端位于 `backend/`，默认接口上下文为 `/api`。开发环境配置位于 `backend/src/main/resources/application-dev.yml`，默认连接本地 MySQL 和 Redis。

常用命令：

```bash
cd backend
mvn spring-boot:run
```

### Go

Go 后端位于 `backend-go/`，默认读取 `backend-go/config.yaml`，可通过 `DRIP_GO_CONFIG` 指定其他配置文件。

常用命令：

```bash
cd backend-go
./start.sh dev
./start.sh build
./start.sh prod
go test ./...
```

OpenAPI：`/api/v3/api-docs`、`/api/swagger-ui.html`。

### Python

Python 后端位于 `backend-python/`，默认读取 `backend-python/config.yaml`。

```bash
cd backend-python
./setup.sh
./start.sh
./start.sh build
pytest
```

OpenAPI：`/api/v3/api-docs`、`/api/swagger-ui.html`。

### Rust

Rust 后端位于 `backend-rust/`，默认读取 `backend-rust/config.yaml`，可通过 `DRIP_RUST_CONFIG` 指定其他配置文件。

```bash
cd backend-rust
./start.sh
./start.sh build
cargo test
```

OpenAPI：`/api/v3/api-docs`、`/api/swagger-ui/index.html`。

各后端的独立说明见 [Go](backend-go/README.md)、[Python](backend-python/README.md)、[Rust](backend-rust/README.md)。

数据库 SQL 由根目录 `scripts/db` 维护，不随 Java 后端资源打包。当前只保留一份完整初始化脚本：

```text
scripts/db/schema.sql
```

导出当前本地库为基线 SQL：

```bash
python scripts/db/manage_database.py export-baseline
```

手工应用 SQL 文件：

```bash
python scripts/db/manage_database.py apply scripts/db/schema.sql
```

## 前端说明

前端管理端位于 `frontend/`，使用 Vite 启动。开发环境中，`/api` 请求会代理到 `http://localhost:9001`。

常用命令：

```bash
cd frontend
pnpm install
pnpm dev
```

构建与检查：

```bash
pnpm build
pnpm lint
pnpm test
```

## 功能模块

- 登录认证与会话管理
- 用户、角色、菜单与权限管理
- 系统配置与字典管理
- 操作日志、登录日志、在线用户
- 定时任务与任务执行日志
- Excel 导出能力
- 打印模板管理
- Swagger/OpenAPI 接口文档
- Spring Boot Admin 监控接入

## 界面预览

![系统首页](pic/sys.png)

![用户管理](pic/sys_user.png)

![菜单管理](pic/sys_menu.png)

![个人中心](pic/sys_person.png)

![定时任务](pic/sys_cron.png)

![单层菜单](pic/sys_single_layer.png)

![双层菜单](pic/sys_double_layer.png)

![混合菜单](pic/sys_mix_layer.png)

## 开发约定

- 后端 API 统一挂载在 `/api` 下。
- 前端通过 Vite 代理访问后端服务。
- 后端分页查询使用公共分页 DTO。
- 数据库基线脚本由根目录 `scripts/db/schema.sql` 维护，后端不内置建表或迁移脚本。
- 新业务模块按 controller、dto、entity、mapper、service 分层组织。