# adp

**Repository Path**: durcframework/adp

## Basic Information

- **Project Name**: adp
- **Description**: 一个纯净的后台管理系统，具备基本的RBAC权限校验功能，权限校验精确到按钮级别。前端使用Vue3、Vite5、Element-Plus、TypeScript、Pinia、Tailwindcss，后端采用SpringBoot4 + Java17 + MybatisFlex
- **Primary Language**: Java
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 4
- **Created**: 2026-02-23
- **Last Updated**: 2026-03-12

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# econ-admin (YiKong Admin)

> Simple and easy to use, easy to control.

## Introduction

A clean backend management system with basic RBAC permission verification function. Permission verification is accurate to the button level. The frontend uses Vue3, Vite5, Element-Plus, TypeScript, Pinia, Tailwindcss, and the backend adopts SpringBoot 3.4 + Java 17 + MybatisFlex.

Provides a code generation tool that automatically generates frontend and backend code, implementing complete CRUD functionality.

## Directory Structure

- `.claude`: Claude Code Skill
- `backend`: Backend code, based on SpringBoot 3.4 + Java 17 + MybatisFlex
- `frontend`: Frontend code, based on Vue3, Vite5, Element-Plus, TypeScript, Pinia, Tailwindcss
- `docs`: Documentation, introducing the usage of code generation tools
- `scripts`: Auxiliary scripts
- `build.sh`: Build script

## Getting Started

Clone the project: `git clone https://gitee.com/durcframework/econ-admin.git`

Open the project with IDEA and wait for Maven dependencies to download.

### Start Backend

> Requirements: JDK 17, MySQL 5.7+

- Initialize the database by importing [mysql.sql](./backend/mysql.sql)
- Use maven plugin to install `backend/dependency` module
- Open `backend/admin/admin-boot/src/main/resources/application-dev.properties` file and modify the database username and password
- Run `backend/admin/admin-boot/src/main/java/com/econ/admin/AdminApplication.java`

For detailed module documentation, see: [backend/README.md](./backend/README.md)

### Start Frontend

> Requirements: Node.js, version >= 18.18.0

`cd frontend` to switch to the frontend root directory in the command prompt.

- For macOS users, add `sudo` before commands

```shell
# Install pnpm
npm install -g pnpm

# Install dependencies
pnpm install

# Start
pnpm dev
```

Browser access: http://localhost:9125/

- Login account

Super administrator account: admin Password: 123456

### Change Port

The default server port is 8089. To modify it, you need to change both frontend and backend port configurations.

Assuming changing to 8090:

Open `backend/admin/admin-boot/src/main/resources/application-dev.properties` file and add configuration:

```properties
server.port=8090
```

Open `frontend/.env.development` file and modify VITE_BACKEND_URL configuration

Change to:

```text
VITE_BACKEND_URL = http://127.0.0.1:8090
```

## Documentation

Reference: [Documentation](./docs/README.md)

## Build Project

Execute `build.sh` in the root directory, the output directory is `dist`

The frontend and backend have been packaged together. Only the backend service needs to be started, and the frontend does not need to be deployed separately.

## Preview Images

- User Management

![1](./asset/1.png)

- Role Management

![2](./asset/2.png)

- Menu Management

![3](./asset/3.png)