# ecommerce-admin

**Repository Path**: libingquan/ecommerce-admin

## Basic Information

- **Project Name**: ecommerce-admin
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-27
- **Last Updated**: 2026-08-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 🛒 电商后台管理系统

面向中小商户的 SaaS 电商管理平台，基于 Spring Boot 3 + MyBatis-Plus 构建。

## 技术栈

| 技术 | 版本 | 说明 |
|------|------|------|
| JDK | 17 | 运行环境 |
| Spring Boot | 3.3.0 | 基础框架 |
| MyBatis-Plus | 3.5.6 | ORM + 分页 |
| MySQL | 8.0+ | 关系型数据库 |
| Redis | 7.0+ | 缓存（预留） |
| Spring Security | 6.x | 认证授权 |
| jjwt | 0.12.6 | JWT 令牌 |
| Knife4j | 4.5.0 | 接口文档 |

## 快速开始

### 1. 初始化数据库

```bash
mysql -u root -p < src/main/resources/db/init.sql
```

### 2. 修改配置

编辑 `src/main/resources/application.yml`，修改数据库连接信息：

```yaml
spring:
  datasource:
    url: jdbc:mysql://localhost:3306/ecommerce_admin?...
    username: root
    password: your_password
```

### 3. 启动项目

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

### 4. 访问接口文档

```
http://localhost:8080/doc.html
```

## 测试账号

| 用户名 | 密码 |
|--------|------|
| admin | 123456 |

## 项目结构

```
ecommerce-admin/
├── pom.xml
├── src/main/java/com/example/ecommerce/
│   ├── EcommerceAdminApplication.java     # 启动类
│   ├── common/                             # 公共组件
│   │   ├── Result.java                     # 统一响应
│   │   ├── ResultCode.java                 # 状态码枚举
│   │   ├── BusinessException.java          # 业务异常
│   │   ├── GlobalExceptionHandler.java     # 全局异常拦截
│   │   ├── JwtUtils.java                   # JWT 工具
│   │   └── UserContext.java                # 当前用户上下文
│   ├── config/                             # 配置
│   │   ├── SecurityConfig.java             # Spring Security
│   │   ├── JwtAuthFilter.java              # JWT 认证过滤器
│   │   ├── MybatisPlusConfig.java          # 分页插件
│   │   ├── Knife4jConfig.java              # 接口文档
│   │   ├── CorsConfig.java                 # 跨域
│   │   ├── JacksonConfig.java              # 日期格式化
│   │   └── AutoFillHandler.java            # 自动填充
│   ├── controller/                         # 控制器
│   │   ├── HealthController.java           # 健康检查
│   │   ├── UserController.java             # 用户管理
│   │   ├── CategoryController.java         # 分类管理
│   │   ├── ProductController.java          # 商品管理
│   │   └── OrderController.java            # 订单管理
│   ├── service/                            # 服务层
│   │   ├── UserService.java / impl
│   │   ├── CategoryService.java / impl
│   │   ├── ProductService.java / impl
│   │   └── OrderService.java / impl
│   ├── mapper/                             # 数据访问层
│   │   ├── UserMapper.java
│   │   ├── CategoryMapper.java
│   │   ├── ProductMapper.java
│   │   ├── OrderMapper.java
│   │   └── OrderItemMapper.java
│   ├── entity/                             # 实体
│   │   ├── BaseEntity.java                 # 基类
│   │   ├── User.java
│   │   ├── Category.java
│   │   ├── Product.java
│   │   ├── Order.java
│   │   ├── OrderItem.java
│   │   └── OrderStatus.java                # 订单状态枚举
│   └── dto/                                # 数据传输对象
│       ├── LoginRequest.java / RegisterRequest.java / UserVO.java
│       ├── CategoryRequest.java / CategoryVO.java
│       ├── ProductRequest.java / ProductPageRequest.java / ProductVO.java
│       └── OrderRequest.java / OrderVO.java / OrderItemVO.java
└── src/main/resources/
    ├── application.yml                      # 配置文件
    └── db/
        └── init.sql                         # 数据库初始化脚本
```

## API 概览

### 用户模块

| 方法 | 路径 | 说明 | 认证 |
|------|------|------|------|
| POST | /api/user/register | 注册 | 无需 |
| POST | /api/user/login | 登录 | 无需 |
| GET | /api/user/me | 当前用户信息 | Bearer Token |

### 分类模块

| 方法 | 路径 | 说明 |
|------|------|------|
| GET | /api/category/tree | 树形列表 |
| GET | /api/category/{id} | 详情 |
| POST | /api/category | 新增 |
| PUT | /api/category/{id} | 更新 |
| DELETE | /api/category/{id} | 删除 |

### 商品模块

| 方法 | 路径 | 说明 |
|------|------|------|
| GET | /api/product/page | 分页查询 |
| GET | /api/product/{id} | 详情 |
| POST | /api/product | 新增 |
| PUT | /api/product/{id} | 更新 |
| DELETE | /api/product/{id} | 删除 |
| PUT | /api/product/{id}/status | 上架/下架 |

### 订单模块

| 方法 | 路径 | 说明 |
|------|------|------|
| GET | /api/order/page | 分页查询 |
| GET | /api/order/{id} | 详情 |
| POST | /api/order | 创建订单 |
| PUT | /api/order/{id}/cancel | 取消 |
| PUT | /api/order/{id}/pay | 支付 |
| PUT | /api/order/{id}/ship | 发货 |
| PUT | /api/order/{id}/complete | 确认收货 |

## 订单状态机

```
待支付(0) ──pay()──→ 已支付(1) ──ship()──→ 已发货(2) ──complete()──→ 已完成(3)
    │                    │
    └──cancel()──────────└──cancel()────→ 已取消(4)
```

## 数据库表

| 表名 | 说明 |
|------|------|
| sys_user | 用户表 |
| sys_category | 商品分类表（树形结构） |
| sys_product | 商品表 |
| sys_order | 订单表 |
| sys_order_item | 订单项表 |

## 常用命令

```bash
# 编译
mvn compile -Dmaven.repo.local=.m2

# 打包
mvn package -Dmaven.repo.local=.m2 -DskipTests

# 运行
java -jar target/ecommerce-admin-1.0.0-SNAPSHOT.jar
```