84 lines
2.3 KiB
Markdown
84 lines
2.3 KiB
Markdown
# 实验检验过程平台业务管理系统
|
||
|
||
## 项目说明
|
||
|
||
本工程为实验检验过程平台业务管理系统的后端单体应用，基于 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
|