experiment/README.md

实验检验过程平台业务管理系统

项目说明

本工程为实验检验过程平台业务管理系统的后端单体应用，基于 Spring Boot 3.x + Java 17 + Maven 构建。

技术栈

• Java 17
• Spring Boot 3.2.5
• Maven
• Knife4j 4.5.0 (OpenAPI 3 / Swagger)
• 内存假数据（无外部数据库依赖）

功能清单

用户管理

• 用户新增、编辑、查询、删除

业务流程管理

• 业务新增、编辑、删除
• 业务提交、审核、驳回、归档
• 业务查询筛选

数据统计

• 业务数据分类汇总统计

快速启动

编译运行

# 编译
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