| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778 |
- ---
- description: 项目架构描述，技术栈，功能项描述。
- alwaysApply: true
- ---
- # 项目架构描述
- ## 技术栈
- - 语言：Java 8
- - 框架：Spring Boot 2.1.3.RELEASE
- - 数据库：PostgreSQL 15
- - 构建工具：Maven 3.8.9
- - 认证方式：JWT 认证
- - 生产环境：linux
- - 文件存储：FastDFS、MinIO
- - 缓存服务：Caffeine 本地缓存、Redis
- ## 功能模块
- 主要包括：
- - 联合预警计划、联合预警事件、联合预警工单管理
- - 调度预案、调度事件、调度工单管理
- - 调度排班指令管理
- - 故障单管理
- - 查漏计划、查漏点、查漏项、查漏对象、查漏任务管理
- - 巡检计划、巡检片区、巡检项、巡检点、巡检对象、巡检任务管理
- - 抢修工单、抢修班组管理
- - 保养工单管理
- - 清洗工单管理
- ## 项目层次约束
- **该项目层次清晰，划分严格，指定功能模块必须严格按如下层次进行归类，不可随意归类或放置。**
- - `src/main/java/com/shkpr/service/alamdmaordertask/`
- - `busihandler/` — 实际业务逻辑处理类
- - `commtools/` — 通用工具类
- - `components/` — 组件（如自定义验证器）封装类
- - `configuration/` — 各种配置类
- - `constants/` — 全局常量定义
- - `controllerapi/` — API 控制器层（接收外部请求）
- - `controllercheck/` — 校验控制器层（对外部请求进行校验）
- - `controllerfilter/` — 过滤器控制器层（对外部请求进行前置过滤处理）
- - `dbdao/mapper/` — 主业务数据库访问的 Mapper 定义类
- - `dbdao/services/` — 数据库访问的 DAO 服务实现
- - `dbdao/services/intef/` — DAO 服务接口定义
- - `dbdao/providers/` — Mapper 动态 SQL 提供者
- - `dbdao/pgtype/` — PostgreSQL 自定义类型处理
- - `dbdao/tables/` — 表结构/字段常量说明
- - `dto/` — 数据库或业务层模型对象
- - `exception/` — 全局异常处理
- - `factorys/` — 工厂类
- - `globalcache/` — 全局缓存控制类
- - `globalmgr/` — 全局管理器
- - `jsonbean/` — 请求参数定义类
- - `queues/` — 自定义队列管理类
- - `services/` — 本项目调用第三方服务(或其他服务)的封装类
- - `subtask/` — 自定义子任务管理类
- - `src/main/resources/`
- - `application.properties` — 主配置
- - `logback.xml` — 日志配置
- - `sql.properties` — 数据库参数配置（常与 `global.sql.config.path` 配合）
- - `pom.xml` — 构建配置
- - `libs/` — 第三方本地 JAR（含 gbase 等）
- - `config/` — 外部业务参数配置
- ## 关键设计模式
- **该项目需要严格遵守该设计模式。**
- 1. JWT 相关认证、请求头相关验证均在 `controllerfilter/` 下的过滤器中处理，按业务模块细分。
- 2. 所有 API 控制器（如 `ThirdAlarmTaskController`）只接收 API 请求，实际业务处理必须调用 `com.shkpr.service.alamdmaordertask.busihandler` 下的业务处理类。
- 3. 业务处理层（如 `PatrolPlanHelper`）必须通过 **`DBMgrProxy`** 调用数据库的 DAO 服务层。
- 4. **`DBMgrProxy`** 为数据库访问单例代理，管理多个数据源连接。
- 5. **`LogPrintMgr`** 为统一日志管理类。
|
