# ecommerceadmin

**Repository Path**: maxlibs/ecommerceadmin

## Basic Information

- **Project Name**: ecommerceadmin
- **Description**: No description available
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-11-18
- **Last Updated**: 2026-05-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# E-commerce Backend Management System (Campus Training Version)

## 1. Project Introduction

This project is a **campus training case** designed specifically for college students majoring in Software Engineering, Computer Science, and related fields. It is suitable for the practical training phase following courses such as *Software Architecture* and *JavaEE Framework Technology*.

Adopting the **Spring Boot + MyBatis + MySQL** technology stack, the project simulates the core management processes of real-world e-commerce platforms. It focuses on basic and commonly used development technologies, helping students transform theoretical classroom knowledge into practical capabilities and establish a complete software development thinking framework.

Through this project training, students can proficiently master the core usage of Spring Boot and MyBatis, understand the layered architecture design concept, and lay a solid foundation for future employment or advanced learning.

## 2. Project Features

### 🔧 Beginner-Friendly Technology Selection
- Adopts enterprise-popular and easy-to-learn technology combinations (Spring Boot 2.7.x + MyBatis 3.5.x + MySQL 8+), avoiding complex technology stacks and focusing on core knowledge points.
- Simplifies the configuration process and provides a complete environment setup guide to lower the entry threshold.
- Selects streamlined and practical dependencies (only necessary dependencies such as Web, MyBatis, MySQL Driver, and Lombok are introduced).

### 🎯 Strong Targeting for Training Needs
- Strictly aligns with college students' training scenarios and covers core course examination points (e.g., Spring Boot automatic configuration, MyBatis dynamic SQL, paging queries, transaction management, etc.).
- Reasonably splits functional modules with a progressive difficulty curve (from basic login module to core product/order management).
- Features standardized and well-commented code for easy student understanding and imitation.

### 🚀 Focus on Ability Improvement
- Integrates enterprise-level development thinking such as layered architecture, modular design, data validation, and exception handling.
- Includes a complete process of "requirement analysis → architecture design → database design → coding implementation → testing and optimization" to cultivate software engineering thinking.
- Provides solutions to common problems and expansion directions to encourage students' independent exploration.

### 📚 Comprehensive Learning Resources
- Comes with complete database scripts, project source code, and API documentation.
- Supports direct testing with Postman, enabling function verification without additional front-end development.
- Reserves expansion space for students to upgrade functions based on the basic version.

## 3. Project Functions

Focusing on core e-commerce backend management scenarios, the project has clear functional modules covering core development scenarios required for training:

### 🔑 Basic Functions
- Administrator Login/Logout: Account and password verification.
- Homepage: Displays core statistical data such as total products, total orders, and total users.

### 📦 Core Functions
#### 3.1 Product Management Module
- Product List: Multi-condition filtering (name fuzzy query, category filtering, shelf status filtering) and paging query.
- Product Operations: Addition (including product image upload), editing, deletion, and shelf status switching.
- Data Validation: Mandatory field verification for product name, price, inventory, etc., and non-negative verification for price/inventory.

#### 3.2 Order Management Module
- Order List: Multi-condition filtering (order number, user ID, order status) and paging query.
- Order Operations: Viewing order details (associated with order items and product information) and updating order status (Pending Shipment → Shipped → Completed).
- Associated Queries: Display of associated data between orders, order items, products, and user tables.

#### 3.3 Category Management Module
- Category List: Display and paging query.
- Category Operations: Addition, editing, and deletion (with sub-category judgment to avoid accidental deletion).

#### 3.4 User Management Module
- User List: Paging query and filtering by mobile phone number/username.
- User Details: Viewing basic user information and historical order records.

## 4. Quick Start

### Environment Requirements
- JDK: 8 or 11
- Maven: 3.6+
- MySQL: 8.0
- Development Tools: IntelliJ IDEA, DBeaver, Postman (optional)

### Startup Steps
1. Clone this repository: `git clone [repository-url]`
2. Import the database: Execute the `sql/ecommerce_admin.sql` script to initialize data tables and test data.
3. Modify configuration files: Open `application.yml` and update database connection parameters (URL, username, password).
4. Start the project: Run the main class `EcommerceAdminApplication.java`.
5. API Testing: Access `http://localhost:8080/login` and log in with the default account (admin/admin123).

## 8. Acknowledgments

This project is a dedicated campus training case aimed at helping college students quickly get started with JavaEE development technologies. We appreciate the use and feedback from teachers and students. For any questions or suggestions, please feel free to submit Issues or Pull Requests!

---

**Note**:
- It is recommended to use this project with supporting PPT to help students quickly understand the project background and core content.
- Replace `[repository-url]` with the actual GitHub repository URL before use.