---
description: 项目架构描述，技术栈，功能项描述。
alwaysApply: true
---

# 项目架构描述

## 技术栈

- 语言：Java 21
- 框架：Spring Boot 3.5.12.RELEASE
- 数据库：PostgreSQL 15
- 构建工具：Maven 3.8.9
- 认证方式：JWT 认证
- 生产环境：linux
- 文件存储：FastDFS、MinIO 
- 缓存服务：Caffeine 本地缓存、Redis

## 功能模块

主要包括：
- 向Mcp客户端或Agent提供Tool工具列表
- 向Mcp客户端或Agent提供Tool工具的能力

## 项目层次约束

**该项目层次清晰，划分严格，指定功能模块必须严格按如下层次进行归类，不可随意归类或放置。**

- `src/main/java/com/shkpr/service/mcpcenterservice/`
    - `handler/` — 实际业务逻辑处理类
    - `mcptool/` — 定义所有的tool类
    - `commtools/` — 通用工具类
    - `components/` — 组件（如自定义验证器）封装类
    - `configuration/` — 各种配置类
    - `constants/` — 全局常量定义
    - `filters/` — 全局过滤封装类
    - `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. 在`mcptool`目录下定义所有向外提供的tool方法，其方法中实际的业务处理逻辑需放在`handler`目录下进行封装定义并实现。
2. 业务处理层（如 `PatrolPlanHelper`）必须通过 **`DBMgrProxy`** 调用数据库的 DAO 服务层。
3. **`DBMgrProxy`** 为数据库访问单例代理，管理多个数据源连接。
4. **`LogPrintMgr`** 为统一日志管理类。