房地产专家评估系统 (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

设计文档

📋 系统设计文档

🏗️ 系统架构

• 系统架构说明文档 - 整体架构设计、技术架构、安全架构
• 核心模块流程图 - 核心业务流程的详细流程图

🗄️ 数据库设计

• 数据库设计文档 - 29个核心数据表的详细设计
• 数据库ER图 - 完整的实体关系图

🧮 算法设计

• 模糊层次分析法 - FAHP算法详细说明
• 算法说明文档 - 核心算法总体说明

🚀 部署文档

📦 部署指南

• 部署文档 - 系统部署的完整指南
• MySQL配置 - MySQL 8.0安装配置
• License配置 - License验证机制配置
• 数据备份 - 数据备份策略

核心特性

📊 评估算法

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

🎯 业务特色

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

外部依赖

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

许可证

本项目采用专有许可证，详情请参考 License配置文档。

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