2026-07-10 03:11:59 +00:00
|
|
|
|
# 实验检验过程平台业务管理系统
|
2026-07-10 02:09:46 +00:00
|
|
|
|
|
2026-07-10 03:11:59 +00:00
|
|
|
|
## 项目说明
|
|
|
|
|
|
|
|
|
|
|
|
本工程为实验检验过程平台业务管理系统的后端单体应用，基于 Spring Boot 3.x + Java 17 + Maven 构建。
|
|
|
|
|
|
|
|
|
|
|
|
## 技术栈
|
|
|
|
|
|
|
|
|
|
|
|
- **Java 17**
|
|
|
|
|
|
- **Spring Boot 3.2.5**
|
|
|
|
|
|
- **Maven**
|
|
|
|
|
|
- **Knife4j 4.5.0 (OpenAPI 3 / Swagger)**
|
|
|
|
|
|
- 内存假数据（无外部数据库依赖）
|
|
|
|
|
|
|
|
|
|
|
|
## 功能清单
|
|
|
|
|
|
|
|
|
|
|
|
### 用户管理
|
|
|
|
|
|
- 用户新增、编辑、查询、删除
|
|
|
|
|
|
|
|
|
|
|
|
### 业务流程管理
|
|
|
|
|
|
- 业务新增、编辑、删除
|
|
|
|
|
|
- 业务提交、审核、驳回、归档
|
|
|
|
|
|
- 业务查询筛选
|
|
|
|
|
|
|
|
|
|
|
|
### 数据统计
|
|
|
|
|
|
- 业务数据分类汇总统计
|
|
|
|
|
|
|
|
|
|
|
|
## 快速启动
|
|
|
|
|
|
|
|
|
|
|
|
### 编译运行
|
|
|
|
|
|
|
|
|
|
|
|
```bash
|
|
|
|
|
|
# 编译
|
|
|
|
|
|
mvn clean compile
|
|
|
|
|
|
|
|
|
|
|
|
# 运行测试
|
|
|
|
|
|
mvn test
|
|
|
|
|
|
|
|
|
|
|
|
# 打包
|
|
|
|
|
|
mvn clean package
|
|
|
|
|
|
|
|
|
|
|
|
# 启动
|
|
|
|
|
|
mvn spring-boot:run
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
### 访问地址
|
|
|
|
|
|
|
|
|
|
|
|
| 名称 | 地址 |
|
|
|
|
|
|
|:---|:---|
|
|
|
|
|
|
| 应用主页 | http://localhost:8080 |
|
|
|
|
|
|
| Knife4j 接口文档 | http://localhost:8080/doc.html |
|
|
|
|
|
|
| Swagger 接口文档 | http://localhost:8080/swagger-ui/index.html |
|
|
|
|
|
|
| OpenAPI JSON | http://localhost:8080/v3/api-docs |
|
|
|
|
|
|
| 健康检查 | http://localhost:8080/api/health |
|
|
|
|
|
|
|
|
|
|
|
|
## 项目结构
|
|
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
|
src/main/java/com/example/demo/
|
|
|
|
|
|
├── DemoApplication.java # 应用启动类
|
|
|
|
|
|
├── config/
|
|
|
|
|
|
│ └── OpenApiConfig.java # OpenAPI/Knife4j 配置
|
|
|
|
|
|
├── controller/
|
|
|
|
|
|
│ ├── HealthController.java # 健康检查控制器
|
|
|
|
|
|
│ ├── BusinessController.java # 业务流程控制器
|
|
|
|
|
|
│ └── UserController.java # 用户管理控制器
|
|
|
|
|
|
├── service/
|
|
|
|
|
|
│ ├── BusinessService.java # 业务流程服务
|
|
|
|
|
|
│ └── UserService.java # 用户管理服务
|
|
|
|
|
|
└── model/
|
|
|
|
|
|
├── ApiResponse.java # 通用API响应
|
|
|
|
|
|
├── BusinessItem.java # 业务信息模型
|
|
|
|
|
|
├── BusinessStatus.java # 业务状态枚举
|
|
|
|
|
|
├── StatisticsResult.java # 统计数据模型
|
|
|
|
|
|
└── UserItem.java # 用户信息模型
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
## 设计说明
|
|
|
|
|
|
|
|
|
|
|
|
- 当前阶段使用 `ConcurrentHashMap` 作为内存数据存储，所有数据在应用重启后丢失
|
|
|
|
|
|
- 预留了 `repository` 扩展点，后续可替换为 MyBatis + MySQL 实现
|
|
|
|
|
|
- 业务状态流转规则：`draft → submitted → approved → archived` 或 `submitted → rejected`
|
|
|
|
|
|
- 遵循分层架构：Controller → Service → Model
|
