staff-mgr 员工管理模块
Web 版本人事系统的员工管理后端服务,提供员工 CRUD、敏感信息脱敏、变更记录、操作审计日志、工号查重及部门缓存接口。
技术栈
- Spring Boot 3.2 / Spring Data JPA / Spring Security + JWT
- MySQL 8.0(生产)/ H2(本地开发与测试)
- Maven
接口
基础路径:/api/v1/staff,除 Swagger 与 H2 控制台外均需 Authorization: Bearer <token>。
| 方法 | 路径 | 说明 |
|---|---|---|
| POST | /api/v1/staff |
创建员工 |
| GET | /api/v1/staff |
分页列表查询 |
| GET | /api/v1/staff/{id} |
员工详情(按角色脱敏/数据权限) |
| PUT | /api/v1/staff/{id} |
部分更新员工 |
| DELETE | /api/v1/staff/{id} |
逻辑删除员工 |
| POST | /api/v1/staff/batch-delete |
批量删除 |
| GET | /api/v1/staff/{id}/change-logs |
变更记录 |
| GET | /api/v1/staff/audit-logs |
操作日志(Admin 专属) |
| GET | /api/v1/staff/check/employee-no |
工号查重 |
| GET | /api/v1/staff/departments |
部门缓存列表 |
本地运行
# 开发环境(H2 内存库)
mvn spring-boot:run
# 生产环境(MySQL)
mvn spring-boot:run -Dspring-boot.run.profiles=mysql
测试
mvn test
Description
Languages
Java
100%