---
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`** 为统一日志管理类。