# java第17组电力安全工器具Agent

**Repository Path**: LittleSogo/java-group-17

## Basic Information

- **Project Name**: java第17组电力安全工器具Agent
- **Description**: 电力安全工器具全生命周期管理Agent——成群结队
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-09-06
- **Last Updated**: 2026-09-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# SpringBoot + Vue User Management System

A modern user management system built with a SpringBoot backend and Vue 3 frontend, using a decoupled architecture.

## Technology Stack

### Backend
- **Spring Boot** - Application framework
- **MyBatis-Plus** - ORM persistence framework
- **MySQL** - Database

### Frontend
- **Vue 3** - Progressive frontend framework
- **Element Plus** - UI component library
- **Vite** - Build tool
- **Pinia** - State management

## Features

### Authentication Module
- User registration
- User login
- Logout
- Retrieve current user information

### User Management
- Paginated user list query
- Keyword search
- View user details
- Create/edit/delete users
- Change password
- Avatar upload

### Dashboard
- User statistics (total users / enabled / disabled)

## Project Structure

```
springboot/                    # SpringBoot backend project
├── src/main/java/com/base/
│   ├── BaseApplication.java   # Application entry point
│   ├── common/                # Common components
│   │   ├── AuthHelper.java    # Authentication helper
│   │   ├── LoginInterceptor.java  # Login interceptor
│   │   ├── PageResult.java    # Pagination result
│   │   ├── Result.java        # Unified response format
│   │   └── RoleConstants.java # Role constants
│   ├── controller/            # Controller layer
│   │   ├── AuthController.java    # Authentication endpoints
│   │   ├── DashboardController.java   # Dashboard endpoints
│   │   ├── FileController.java   # File upload endpoints
│   │   ├── ProfileController.java    # User profile endpoints
│   │   └── UserController.java   # User management endpoints
│   ├── entity/                # Entity classes
│   │   ├── DashboardStats.java # Statistics data
│   │   ├── User.java          # User entity
│   │   └── UserExt.java       # Extended user entity
│   ├── exception/             # Exception handling
│   │   ├── BusinessException.java
│   │   └── GlobalExceptionHandler.java
│   ├── mapper/                # Data access layer
│   │   └── UserMapper.java
│   └── service/               # Business logic layer
│       ├── FileStorageService.java
│       ├── UserService.java
│       └── impl/
└── resources/
    └── application.yml        # Application configuration

vue/                           # Vue frontend project
├── src/
│   ├── api/                   # API interfaces
│   ├── components/           # Common components
│   ├── layout/               # Layout components
│   ├── router/               # Routing configuration
│   ├── store/                # State management
│   ├── styles/               # Style files
│   ├── utils/                # Utility functions
│   └── views/                # Page views
├── index.html
├── package.json
└── vite.config.js
```

## Quick Start

### Environment Requirements

- JDK 8+
- Node.js 16+
- MySQL 5.7+
- Maven 3.6+

### Backend Configuration

1. Create a database and import the initialization script:

```bash
# Execute sql/base.sql to initialize the database
```

2. Update the database connection settings in `springboot/src/main/resources/application.yml`:

```yaml
spring:
  datasource:
    url: jdbc:mysql://localhost:3306/your_database
    username: your_username
    password: your_password
```

3. Start the backend service:

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

The backend service runs by default at http://localhost:8080

### Frontend Configuration

1. Install dependencies:

```bash
cd vue
npm install
```

2. Start the development server:

```bash
npm run dev
```

The frontend service runs by default at http://localhost:5173

### Build Production Version

```bash
# Build frontend
cd vue
npm run build
```

## API Endpoints

### Authentication
| Method | Path | Description |
|--------|------|-------------|
| POST | /api/auth/login | User login |
| POST | /api/auth/register | User registration |
| POST | /api/auth/logout | Logout |
| GET | /api/auth/me | Get current user |

### User Management
| Method | Path | Description |
|--------|------|-------------|
| GET | /api/users | Get user list (paginated) |
| GET | /api/users/{id} | Get user details |
| POST | /api/users | Create user |
| PUT | /api/users/{id} | Update user |
| DELETE | /api/users/{id} | Delete user |

### User Profile
| Method | Path | Description |
|--------|------|-------------|
| PUT | /api/profile | Update profile |
| PUT | /api/profile/password | Change password |
| POST | /api/profile/avatar | Upload avatar |

### Dashboard
| Method | Path | Description |
|--------|------|-------------|
| GET | /api/dashboard/stats | Get statistics |

### File Upload
| Method | Path | Description |
|--------|------|-------------|
| POST | /api/files/upload | Upload file |

## Default Accounts

After initialization, use the following default accounts to log in:

- Admin: admin / admin123
- Regular user: user / user123

## License

This project is for learning and reference purposes only.