综合管理信息系统 - 后端单体工程

项目简介

基于 Spring Boot 3.x + Java 17 构建的综合管理信息系统后端单体工程，作为信息管理分系统的核心管理平台和业务模块的统一入口。

技术栈

• Java 17
• Spring Boot 3.2.1
• Maven
• Knife4j 4.5.0 (OpenAPI 3 / Swagger 接口文档)
• 内存数据存储（当前阶段无外部数据库依赖）

模块结构

模块	包路径	需求标识
用户管理	controller.UserController, service.UserService	SRS-F-01-001
角色管理	controller.RoleController, service.RoleService	SRS-F-01-002
部门管理	controller.DeptController, service.DeptService	SRS-F-01-003
字典管理	controller.DictController, service.DictService	SRS-F-01-004
参数配置	controller.ConfigController, service.ConfigService	SRS-F-01-005
业务管理	controller.BusinessController, service.BusinessService	SRS-F-02-001~008
统计分析	controller.StatController, service.StatService	SRS-F-03-001~005
权限管理	controller.PermissionController, service.PermissionService	SRS-F-04-001~004
审计日志	controller.LogController, service.LogService	SRS-F-05-001~004
接口集成	controller.IntegrationController, service.IntegrationService	SRS-F-06-001~002

启动方式

前提条件

• JDK 17+
• Maven 3.6+

编译与启动

# 进入项目根目录
cd codegen-runs/codegen_a227418f648447d2936a850896c63889

# 编译
mvn clean package -DskipTests

# 启动
mvn spring-boot:run

# 或直接运行 jar
java -jar target/demo-management-1.0.0-SNAPSHOT.jar

运行测试

mvn test

接口文档访问

启动后可通过以下地址访问接口文档：

• Knife4j UI: http://localhost:8080/doc.html
• Swagger UI: http://localhost:8080/swagger-ui.html
• OpenAPI JSON: http://localhost:8080/v3/api-docs

健康检查

• http://localhost:8080/api/health

设计说明

1. 无外部基础设施依赖：当前阶段使用内存 ConcurrentHashMap 存储数据，所有业务逻辑可正常运行。
2. 预留扩展点：Service 层保持独立，后续可替换为 JPA/MyBatis 数据访问层；Controller 层接口设计遵循 RESTful 规范，便于对接前端。
3. 需求可追溯性：每个业务方法均通过 @requirement 标签关联 CSCI 需求标识，确保设计实现与需求的双向追溯。
4. 接口文档：集成 Knife4j，所有接口均标注 @Operation 和 @Tag 描述，便于前后端联调。