# 项目交接文档

## 1. 项目概述

- **项目名称**：InvestBoot 政府投资报审系统
- **项目描述**：政府投资项目报审管理系统，提供项目审批、预警管理、价格信息管理等功能
- **项目组**：com.biutag.supervision

## 2. 技术栈

### 2.1 核心框架
- Spring Boot 3.3.2
- MyBatis Plus 3.5.7
- Dynamic Datasource 4.3.1（多数据源）
- Redis Reactive

### 2.2 数据库
- MySQL（主要数据库）
- PostgreSQL（邮箱相关）
- 支持多种数据库：达梦(DM)、SQL Server、GBase

### 2.3 文件存储
- FastDFS 分布式文件系统

### 2.4 API文档
- Knife4j OpenAPI3（基于Swagger）

### 2.5 工具类
- Hutool 5.8.29
- EasyExcel 4.0.1
- Fastjson 2.0.53
- Aspose.Words 15.8.0（Word文档处理）

### 2.6 其他组件
- Lombok
- Druid 连接池
- Freemarker 模板引擎
- Logstash 日志编码
- JIT AuthSDK 3.0.3（数字证书）

## 3. 环境配置

### 3.1 开发环境
- JDK 17
- Maven 3.6+
- IDE：推荐 IntelliJ IDEA

### 3.2 配置文件
- 主配置文件：`application.yml`
- 环境配置文件：
  - `application-local.yml`（本地开发环境）
  - `application-dev.yml`（开发环境）
  - `application-prod.yml`（生产环境）

### 3.3 数据库配置
- 主数据源（master）：MySQL
- 从数据源（多个）：用于不同业务模块
- Redis：缓存，端口6379

### 3.4 文件服务配置
- FastDFS：分布式文件存储
- 预览URL配置：`http://172.31.217.20:31664`

## 4. 项目结构

```
src/main/java/com/biutag/supervision/
├── InvestBootApplication.java      # 应用启动类
├── common/                         # 通用类
├── config/                         # 配置类
├── constants/                      # 常量定义
├── controller/                     # 控制器层
├── exception/                      # 异常处理
├── flow/                           # 流程相关
├── job/                            # 定时任务
├── mapper/                         # 数据访问层
├── pojo/                           # 数据模型
│   ├── domain/                     # 领域模型
│   ├── dto/                        # 数据传输对象
│   ├── entity/                     # 实体类
│   ├── enums/                      # 枚举类
│   ├── model/                      # 模型类
│   ├── param/                      # 参数类
│   └── vo/                         # 视图对象
├── service/                        # 业务逻辑层
├── support/                        # 支持类
└── util/                           # 工具类
```

## 5. 核心功能模块

### 5.1 认证与授权
- 登录认证：`LoginController`
- 用户角色权限管理：基于RBAC模型
- Token管理：Redis存储，有效期168小时

### 5.2 文件管理
- 文件上传下载：`FileController`
- 文件分类管理：`FileClassService`
- 文件存储：FastDFS分布式存储

### 5.3 项目预警管理
- 预警信息处理
- 预警相关接口：`controller/warning/`

### 5.4 价格信息库管理
- 价格信息录入与查询
- 相关接口：`controller/price/`

### 5.5 项目报审、报表管理
- 相关接口：`controller/report/ReportProjectController.java`

### 5.6 工作流管理
- 相关接口：`controller/report/ReportFlowController.java`

### 5.7 服务单位管理
- 服务单位信息维护
- 相关接口：`controller/serviceUnit/`

## 6. API文档

### 6.1 访问地址


### 6.2 接口分组
- plugin：插件相关接口
- 各功能模块独立接口组

## 7. 关键配置项

### 7.1 服务器配置
- 端口：8080
- 时区：Asia/Shanghai

### 7.2 文件上传配置
- 最大文件大小：100MB
- 最大请求大小：100MB

### 7.3 缓存配置
- Redis数据库索引：1
- 连接超时：10s

### 7.4 FastDFS配置
- Tracker列表：172.31.217.20:32060, 172.31.217.20:31882
- 连接超时：10000ms

## 8. 部署说明

### 8.1 打包方式
- Maven打包：`mvn clean package`
- 最终生成JAR包：`investBoot.jar`

### 8.2 环境切换
- 本地：`-Dspring.profiles.active=local`
- 开发：`-Dspring.profiles.active=dev`
- 生产：`-Dspring.profiles.active=prod`

### 8.3 运行命令
```
java -jar investBoot.jar --spring.profiles.active=环境名称
```

## 9. 注意事项

### 9.1 数据库配置
- 首次部署需要执行SQL脚本初始化数据库
- SQL脚本位置：`sql/`目录

### 9.2 外部依赖
- 需确保Redis服务正常运行
- 需确保FastDFS服务正常运行
- 部分证书相关功能依赖JIT AuthSDK

### 9.3 特殊配置
- Word文档处理功能依赖Aspose.Words，需注意许可证配置
- 视频检查相关功能依赖外部服务

## 10. 联系人信息