# learn

**Repository Path**: pang_le/learn

## Basic Information

- **Project Name**: learn
- **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-05-08
- **Last Updated**: 2026-05-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# Learn - 员工管理系统示例

这是一个基于 Spring Boot 构建的简单员工管理系统 REST API 示例项目，用于学习和演示 Spring Boot Web 应用的开发。

## 项目简介

本项目实现了一个完整的员工管理 REST API，支持员工的增删改查等基本操作。前端使用原生 HTML/CSS/JavaScript 实现了一个简洁的管理界面。

## 技术栈

- **后端**: Spring Boot 2.x
- **构建工具**: Maven
- **前端**: HTML5 + 原生 JavaScript

## 功能特性

- 查看所有员工列表
- 根据 ID 查询员工信息
- 添加新员工
- 更新员工信息
- 删除员工
- 按部门搜索员工

## API 接口

| 方法 | 路径 | 描述 |
|------|------|------|
| GET | /api/staff | 获取所有员工列表 |
| GET | /api/staff/{id} | 根据 ID 获取员工信息 |
| POST | /api/staff | 添加新员工 |
| PUT | /api/staff/{id} | 更新员工信息 |
| DELETE | /api/staff/{id} | 删除员工 |
| GET | /api/staff/search?department=xxx | 按部门搜索员工 |

## 数据模型

员工 (Staff) 包含以下字段：

- `id` - 员工ID
- `name` - 姓名
- `gender` - 性别
- `department` - 部门
- `title` - 职位
- `email` - 邮箱
- `phone` - 电话
- `entryDate` - 入职日期

## 快速开始

### 环境要求

- JDK 8 或更高版本
- Maven 3.x

### 构建运行

```bash
# 打包项目
./mvnw clean package

# 运行项目
./mvnw spring-boot:run
```

项目启动后，访问 http://localhost:8080 即可使用员工管理系统前端界面。

## 项目结构

```
src/
├── main/
│   ├── java/com/peidongqing/learn/
│   │   ├── LearnApplication.java      # Spring Boot 启动类
│   │   ├── controller/               # 控制层
│   │   │   └── StaffController.java # 员工 REST API 控制器
│   │   ├── model/                   # 模型层
│   │   │   └── Staff.java           # 员工实体类
│   │   ├── repository/              # 数据访问层
│   │   │   └── StaffRepository.java # 员工数据仓库
│   │   └── service/                 # 服务层
│   │       ├── StaffService.java   # 员工服务接口
│   │       └── impl/
│   │           └── StaffServiceImpl.java # 员工服务实现
│   └── resources/
│       └── static/
│           └── index.html           # 前端页面
└── test/
    └── java/                        # 测试类
```

## 许可证

本项目仅供学习交流使用。