# express-manage

**Repository Path**: haobinjun/express-manage

## Basic Information

- **Project Name**: express-manage
- **Description**: 轻量级快递管理系统，包含快递基础管理功能和数据库初始化脚本
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-22
- **Last Updated**: 2026-01-25

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 快递管理系统 (Delivery Management System)

基于 JSP + Servlet + Maven + Tomcat 的快递管理系统。

## 功能特性

- 用户登录/登出
- 管理员和普通用户两种角色
- 快递信息管理（增删改查）
- 密码修改功能
- 系统统计数据展示

## 技术栈

- 后端: Servlet + JSP
- 构建工具: Maven
- Web服务器: Tomcat 8.5+
- 数据库: MySQL 5.7+
- 前端: HTML + CSS + JavaScript

## 项目结构

```
delivery-management-system/
├── pom.xml                          # Maven配置
├── src/
│   ├── main/
│   │   ├── java/
│   │   │   └── com/delivery/
│   │   │       ├── model/          # 实体类
│   │   │       ├── dao/            # 数据访问层
│   │   │       ├── servlet/        # 控制器
│   │   │       ├── filter/         # 过滤器
│   │   │       └── util/           # 工具类
│   │   ├── resources/
│   │   │   └── db.properties       # 数据库配置
│   │   └── webapp/
│   │       ├── WEB-INF/
│   │       │   └── web.xml         # Web配置
│   │       ├── assets/
│   │       │   └── css/
│   │       │       └── style.css   # 样式文件
│   │       ├── login.jsp           # 登录页面
│   │       ├── index.jsp           # 主框架页面
│   │       ├── dashboard.jsp       # 管理首页
│   │       ├── change-password.jsp # 修改密码页面
│   │       └── delivery.jsp        # 快递管理页面
│   └── test/
│       └── resources/
│           └── init.sql            # 数据库初始化脚本
```

## 快速开始

### 1. 环境要求

- JDK 1.8+
- Maven 3.6+
- Tomcat 8.5+
- MySQL 5.7+

### 2. 数据库配置

创建数据库并导入初始数据：

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

修改 `src/main/resources/db.properties` 中的数据库连接信息：

```properties
jdbc.url=jdbc:mysql://localhost:3306/delivery_management?useSSL=false&serverTimezone=Asia/Shanghai&characterEncoding=utf8&allowPublicKeyRetrieval=true
jdbc.username=root
jdbc.password=your_password
```

### 3. 编译部署

```bash
# 编译项目
mvn clean package

# 部署到Tomcat
cp target/delivery-management.war $TOMCAT_HOME/webapps/

# 启动Tomcat
cd $TOMCAT_HOME/bin
./startup.sh  # Linux/Mac
startup.bat   # Windows
```

### 4. 访问系统

启动Tomcat后，访问: http://localhost:8080/delivery-management/login.jsp

## 测试账号

| 角色 | 用户名 | 密码 |
|------|--------|------|
| 管理员 | admin | admin123 |
| 普通用户 | user | user123 |

## 主要功能

### 1. 登录功能
- 支持管理员和普通用户登录
- 验证码验证
- 密码加密存储

### 2. 管理首页
- 显示欢迎信息
- 统计数据展示（总快递数、待处理、已签收、运输中）

### 3. 快递管理
- 管理员可以添加、编辑、删除快递
- 普通用户只能查看自己创建的快递
- 支持按单号、姓名、电话搜索

### 4. 修改密码
- 用户可以修改自己的密码
- 需要验证旧密码

## 页面样式

系统完全复刻了原始设计，包括：

- **头部导航**: 蓝色背景 (#1e88e5)，包含Logo、用户信息和退出按钮
- **侧边栏**: 灰色背景 (#f5f5f5)，200px宽度，包含三个菜单项
- **欢迎框**: 黄色背景 (#fff9c4)，显示欢迎信息
- **数据表格**: 清晰的数据展示，支持状态标签

## 开发说明

### 添加新功能

1. 在 `com.delivery.model` 中创建实体类
2. 在 `com.delivery.dao` 中创建数据访问类
3. 在 `com.delivery.servlet` 中创建控制器
4. 在 `webapp` 下创建JSP页面
5. 在 `web.xml` 中注册Servlet

### 修改样式

所有样式集中在 `assets/css/style.css` 中，根据需要修改。

## 许可证

MIT License

## 作者

快递管理系统开发团队

---

版权所有 © 2025-2026 中关村软件园教育, 并保留所有权利。