text_project/README.md

53 lines
1.7 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 综合管理平台 (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 需求标识。