| | |
|---|
| | | ## estate_expert |
|---|
| | | # 房地产专家评估系统 (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密钥。 |
|---|
