# express

**Repository Path**: JunHual/express

## Basic Information

- **Project Name**: express
- **Description**: 专门为高校学生实现快递代领的一款软件产品。分为普通用户、配送员和管理员。普通用户能够注册登录、下单支付、订单查询、意见反馈、订单评价等功能；配送员能够接单、订单管理等功能；管理员能够用户管理、订单管理、反馈管理等功能。
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2023-03-19
- **Last Updated**: 2023-04-25

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

## 快递代领系统

### 介绍
专门为高校学生实现快递代领的一款软件产品。分为普通用户、配送员和管理员。普通用户能够注册登录、下单支付、订单查询、意见反馈、订单评价等功能；配送员能够接单、订单管理等功能；管理员能够用户管理、订单管理、反馈管理等功能。

### 相关技术栈

1. **前端：** Thymeleaf、Bootstrap、Ajax、JQuery
2. **开发环境：** IDEA 、SpringBoot 2.6.14、Maven
3. **数据库与缓存**：MySQL 5.7、Mybatis-Plus、Redis
4. **安全框架**：Shiro

### 主要功能

1. **登陆与注册：** 用户名密码
2. **权限：** 普通用户、配送员、后台管理员
3. **普通用户**：下单支付、订单查询、意见反馈、订单评价
4. **配送员**：接单、订单管理、意见反馈、订单评价
5. **系统管理员**：用户管理、订单管理、反馈管理

### 默认用户

当您运行初始脚本后，默认存在以下用户，便于测试：

|登录名|密码|用户角色|
|:----:|:---:|:-----:|
|user1|123|普通用户|
|courier1|123|配送员|
|admin1|123|管理员|

### 项目运行

#### 数据库配置【必须】

1. 本地安装 MySQL 环境，所需版本为 `5.7+`

2. 创建数据库名为 `express`，数据库编码采用 `utf8mb4`，排序规则为 `utf8mb4_general_ci`

    ```
    CREATE DATABASE IF NOT EXISTS express default charset utf8mb4 COLLATE utf8mb4_general_ci;
    ```

3. 导入项目中 `/src/main/resources/db/express.sql` 到 `express`库。

    **注：不要使用 Navicat 等图形化导入工具（会导致导入失败），请使用 source 命令！！**

    ```powershell
    use express; # 选择数据库
    source /your/path/express.sql; # Source 导入
    ```

4. 编辑 `application.yml` 文件，修改数据库连接信息。

   ```yml
   datasource:
       driver-class-name: com.mysql.cj.jdbc.Driver # MySQL驱动，无需修改
       # 数据库连接URL，以下为连接本地的 express 库的 url 示例
       url: jdbc:mysql://localhost:3306/express?useUnicode=true&serverTimezone=Asia/Shanghai&useUnicode=true&characterEncoding=utf-8
                                                       &zeroDateTimeBehavior=convertToNull&useSSL=false&allowPublicKeyRetrieval=true
       username: root # 数据库连接名
       password: root # 数据库连接密码
   ```

#### Redis配置【必须】

1. 本地安装 Redis 环境，如果你使用的是 Windows 平台，请[点击这里](<https://github.com/MicrosoftArchive/redis/releases>)下载 Windows 版本。如果是 Linunx or Mac 系统，请自行百度即可。

2. 编辑 `application.yml` 文件，修改 Redis 连接信息。

   ```yml
   redis:
     host: 127.0.0.1 # Redis地址，本地为127.0.0.1
     port: 6379 # Redis端口号，默认为6379
     password: # Redis密码，没有请保持为空
     ...
   ```