# 房地产专家评估系统 (Estate Expert Backend)

## 项目简介

房地产专家评估系统是一个基于Spring Boot的建筑工程安全风险评估平台，采用微服务架构设计，支持综合体系评估和设备体系评估两种评估模式。系统通过专业的评估算法和专家知识库，为建筑工程提供科学、准确的安全风险评估服务。

## 技术栈

- **后端框架**: Spring Boot 2.7.18
- **数据库**: MySQL 8.0.36
- **ORM框架**: JPA/Hibernate
- **构建工具**: Maven 3.6+
- **Java版本**: OpenJDK 17
- **Web服务器**: Nginx
- **外部服务**: 高德地图API、模糊评估API

## 核心功能

### 🏗️ 项目管理
- 项目信息管理
- 委托方管理
- 评估计划制定
- 合同管理

### 👥 用户管理
- 用户认证授权
- 角色权限管理
- 会话管理
- 部门层级管理

### 📊 评估体系
- **综合体系评估**: 质量检查、安全检查、管理行为
- **设备体系评估**: 塔式起重机、施工升降机、架桥机等
- **实测实量评估**: 主体过程、精装修

### 🔍 评估算法
- **打分算法**: 基于问题扣分的评分机制
- **模糊评估算法**: 基于模糊层次分析法(FAHP)的风险评估
- **专家系统**: 支持打分专家和模糊专家两种类型

### 📋 任务管理
- 检查任务创建
- 问题记录管理
- 评估结果生成
- 报告模板管理

### 🚗 设备管理
- 设备信息管理
- 设备使用记录
- 车辆管理
- 签到管理

## 系统架构

系统采用分层架构模式，结合领域驱动设计(DDD)思想：

```
┌─────────────────────────────────────────────────────────────┐
│                    表现层 (Presentation Layer)                │
├─────────────────────────────────────────────────────────────┤
│  Controller Layer  │  API Gateway  │  Web Security         │
├─────────────────────────────────────────────────────────────┤
│                    业务层 (Business Layer)                   │
├─────────────────────────────────────────────────────────────┤
│  Service Layer    │  Domain Logic  │  Business Rules       │
├─────────────────────────────────────────────────────────────┤
│                    数据层 (Data Layer)                      │
├─────────────────────────────────────────────────────────────┤
│  Repository Layer │  Entity Layer  │  Database Layer       │
└─────────────────────────────────────────────────────────────┘
```

## 项目结构

```
estate-expert-backend/
├── common-lib/                    # 公共库模块
│   ├── auth/                      # 认证授权
│   ├── config/                    # 配置管理
│   ├── context/                   # 上下文管理
│   ├── domain/                    # 领域对象
│   └── enums/                     # 枚举定义
├── admin-server/                  # 管理服务模块
│   ├── component/                 # 组件层
│   ├── config/                    # 配置类
│   ├── controller/                # 控制器层
│   ├── domain/                    # 领域模型
│   ├── service/                   # 服务层
│   └── MainApplication.java       # 启动类
└── docs/                          # 项目文档
    └── 设计文档/                   # 设计文档目录
```

## 快速开始

### 环境要求
- Java 17+
- MySQL 8.0+
- Maven 3.6+
- IDEA 2025.1+

### 编译调试
执行common-lib的install命令
执行admin-server的install命令

进行调试运行

### 配置文件
- **本地开发**: `src/main/resources/application.yml`
- **服务器部署**: `src/main/resources/application-test-aliyun.yml`

## 设计文档

### 📋 系统设计文档

#### 🏗️ 系统架构
- [**系统架构说明文档**](./docs/设计文档/系统架构说明文档.md) - 整体架构设计、技术架构、安全架构
- [**核心模块流程图**](./docs/设计文档/核心模块流程图.md) - 核心业务流程的详细流程图

#### 🗄️ 数据库设计
- [**数据库设计文档**](./docs/设计文档/数据库/数据库设计文档.md) - 29个核心数据表的详细设计
- [**数据库ER图**](./docs/设计文档/数据库/数据库ER图.md) - 完整的实体关系图

#### 🧮 算法设计
- [**模糊层次分析法**](./docs/设计文档/核心算法/模糊层次分析法.pdf) - FAHP算法详细说明
- [**算法说明文档**](./docs/设计文档/核心算法/算法说明-总20210817.pdf) - 核心算法总体说明

### 🚀 部署文档

#### 📦 部署指南
- [**部署文档**](./docs/设计文档/部署/部署文档.md) - 系统部署的完整指南
- [**MySQL配置**](./docs/设计文档/部署/mysql-配置.md) - MySQL 8.0安装配置
- [**License配置**](./docs/设计文档/部署/License配置.md) - License验证机制配置
- [**数据备份**](./docs/设计文档/部署/数据备份.md) - 数据备份策略

## 核心特性

### 📊 评估算法
- **打分算法**: 基于层级树的问题扣分机制
- **模糊评估**: 基于FAHP的多层次模糊综合评估
- **专家系统**: 支持多种专家类型和权重配置

### 🎯 业务特色
- **多体系支持**: 综合体系、设备体系、实测实量
- **灵活配置**: 支持自定义层级、问题、专家配置
- **实时评估**: 支持在线评估和结果生成
- **报告生成**: 自动生成专业评估报告

## 外部依赖

- **高德地图API**: 地址转坐标服务
- **模糊评估API**: 外部模糊评估计算服务
- **MySQL数据库**: 数据持久化存储

## 许可证

本项目采用专有许可证，详情请参考 [License配置文档](./docs/设计文档/部署/License配置.md)。

---

**注意**: 本系统需要有效的License才能正常运行，请确保正确配置License密钥。