# 综合管理平台 (Demo)

基于 Spring Boot 3.x + Java 17 的单体后端工程，提供用户管理、角色权限、业务管理、统计分析、审计日志等 RESTful API。

## 技术栈

- **Java 17**
- **Spring Boot 3.2.5**
- **Maven**
- **Knife4j / Swagger OpenAPI 3** — 接口文档
- **Lombok**
- **内存数据存储**（无数据库依赖，基于 ConcurrentHashMap）

## 模块清单

| 模块 | 说明 |
|:---|:---|
| 用户管理 | 新增、编辑、删除、查询、启用/停用 |
| 角色管理 | 创建、修改、删除、查询、权限分配 |
| 部门管理 | 新增、编辑、删除、树形结构查询 |
| 字典管理 | 字典类型与字典项维护 |
| 参数配置 | 系统参数新增、编辑、查询 |
| 业务管理 | 业务全生命周期（新增→提交→审核→归档） |
| 统计分析 | 数据汇总、图表、自定义查询、报表导出、台账 |
| 权限管理 | RBAC 权限分配、菜单/按钮/数据权限 |
| 审计日志 | 登录日志、操作日志、异常日志、溯源查询 |
| 接口集成 | 预留标准化 RESTful API 及数据同步接口 |

## 快速启动

```bash
# 编译
mvn clean package

# 运行
mvn spring-boot:run
```

启动后访问：
- **Knife4j 文档**: http://localhost:8080/doc.html
- **Swagger 原生**: http://localhost:8080/swagger-ui/index.html
- **健康检查**: http://localhost:8080/api/health

## 接口规范

- 统一返回格式：`ApiResult<T>`（code + message + data + timestamp）
- 认证方式：预留 JWT Token 扩展（当前未启用鉴权中间件）
- 数据格式：JSON

## 需求追踪

所有业务方法均在 Javadoc 中通过 `@requirement` 标签关联至「需求可追踪性明细」中的 CSCI 需求标识。
