# express-track

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

## Basic Information

- **Project Name**: express-track
- **Description**: 快递单号跟踪系统，专注于物流信息查询和跟踪功能
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-01-21
- **Last Updated**: 2026-09-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

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

基于 JSP + Servlet + MySQL + Maven 的快递管理系统，复刻 DouPHP 风格界面。

## 项目简介

这是一个经典的 Java Web 项目，使用原生 Servlet + JSP 技术栈开发，适合作为实训或学习项目。

## 技术栈

- **后端**: Servlet、JDBC
- **前端**: JSP、JSTL、CSS、JavaScript
- **数据库**: MySQL 5.7+
- **构建工具**: Maven
- **服务器**: Tomcat 8/9 (使用 Maven 内置插件)
- **连接池**: Druid

## 项目结构

```
express-system/
├── src/
│   ├── main/
│   │   ├── java/
│   │   │   └── com/
│   │   │       └── express/
│   │   │           ├── dao/           # 数据访问层
│   │   │           ├── entity/        # 实体类
│   │   │           ├── servlet/       # Servlet控制器
│   │   │           └── util/          # 工具类
│   │   ├── resources/
│   │   │   ├── db.properties          # 数据库配置
│   │   │   └── init.sql               # 数据库初始化脚本
│   │   └── webapp/
│   │       ├── WEB-INF/
│   │       │   ├── jsp/               # JSP页面
│   │       │   └── web.xml            # Web配置
│   │       ├── css/                   # 样式文件
│   │       └── login.jsp              # 登录页
│   └── pom.xml                        # Maven配置
└── README.md
```

## 功能模块

1. **用户登录/退出**
   - 登录验证 (默认账号: admin / admin123)
   - Session 会话管理
   - 退出登录

2. **管理首页**
   - 欢迎信息展示
   - 系统功能介绍

3. **修改密码**
   - 原密码验证
   - 新密码加密存储

4. **快递管理**
   - 快递列表查询 (支持分页、搜索)
   - 新增快递
   - 编辑快递
   - 删除快递

## 快速开始

### 1. 环境要求

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

### 2. 数据库配置

1. 创建数据库并执行初始化脚本:

```sql
source src/main/resources/init.sql
```

2. 修改数据库配置文件 `src/main/resources/db.properties`:

```properties
db.url=jdbc:mysql://localhost:3306/express_system?...
db.username=root
db.password=your_password
```

### 3. 运行项目

使用 Maven Tomcat 插件启动:

```bash
# 进入项目目录
cd express-system

# 编译项目
mvn clean compile

# 启动 Tomcat (使用 tomcat7 插件)
mvn tomcat7:run

# 或使用 tomcat8 插件
mvn tomcat8:run
```

### 4. 访问系统

- 访问地址: http://localhost:8080/express
- 默认账号: `admin`
- 默认密码: `admin123`

## 默认账号

| 用户名 | 密码 | 说明 |
|--------|------|------|
| admin | admin123 | 系统管理员 |

## 开发说明

### Servlet 映射

| Servlet | URL | 功能 |
|---------|-----|------|
| LoginServlet | /login | 登录处理 |
| LogoutServlet | /logout | 退出登录 |
| IndexServlet | /index | 首页 |
| PasswordServlet | /password | 修改密码 |
| ExpressServlet | /express | 快递管理 |

### 数据库表

- `user` - 用户表
- `express` - 快递表
- `express_track` - 快递轨迹表 (预留)

## 界面预览

- **登录页**: 简洁的蓝色渐变背景
- **管理首页**: 经典的后台布局 (顶部导航 + 左侧菜单 + 主内容区)
- **快递列表**: 支持分页和搜索的数据表格
- **表单页面**: 清晰的表单布局，支持新增和编辑

## 注意事项

1. 确保 MySQL 服务已启动
2. 确保 8080 端口未被占用
3. 首次运行前需执行数据库初始化脚本
4. 密码采用 MD5 加密存储

## 许可证

版权所有 © 2025-2026 中关村软件园教育