# 智慧评标-主观分助手 (Smart Bid Evaluation Assistant)

> 深度集成的AI辅助工具，助力专家高效、公平完成主观分评审。

## 📖 项目简介
**智慧评标-主观分助手** 是一款基于 **LLM (Large Language Model)** 和 **RAG (Retrieval-Augmented Generation)** 技术的智能评审辅助系统。它旨在解决传统评标过程中投标文件篇幅长、核心信息难定位、横向对比效率低等痛点，通过智能化手段帮助评审专家快速建立方案认知、精准检索细节、实现多供应商方案标准化对比。

## ✨ 核心功能

- **📊 概括总结 (Document Summary)**
  - 自动提取投标文件目录结构。
  - 生成各章节的核心内容摘要，帮助专家快速把握方案重点。
  - 支持原文跳转，一键查看原始文档。

- **💬 智能问答 (Smart Q&A)**
  - 基于 RAG 技术，支持自然语言提问。
  - 精准检索投标文件内容，提供有理有据的回答。
  - 支持单文档深挖与多文档跨文件对比提问。

- **⚖️ 横向对比 (Horizontal Comparison)**
  - 支持多供应商、多维度方案对比。
  - 自动生成标准化对比矩阵，直观呈现优劣差异。
  - 辅助专家进行客观、公正的打分。

- **📝 评审与评分 (Review & Scoring)**
  - 内置评审意见填写与自动保存功能。
  - 与智慧评审系统无缝集成，数据实时同步。

## 🛠️ 技术栈

本项目采用现代化的微服务架构与 AI 技术栈：

- **后端核心**: Java 17, Spring Boot 3.5.7
- **数据库**:
  - MySQL 8.0+: 业务数据存储
  - PostgreSQL (pgvector): 向量数据存储
  - Redis: 缓存与会话管理
- **AI & LLM**:
  - DeepSeek API: 强大的通用大语言模型
  - RAG Framework: 自研检索增强生成流程
- **文档处理**:
  - Apache PDFBox: PDF 文档解析
  - Tabula-Java: PDF 表格数据提取
- **API 文档**: SpringDoc (Swagger / OpenAPI 3)

## 🚀 快速开始

### 环境要求
- JDK 17+
- Maven 3.8+
- Docker & Docker Compose (可选，用于部署依赖服务)

### 本地开发

1. **克隆项目**
   ```bash
   git clone <repository-url>
   cd gdyd_zhpb_zgf
   ```

2. **配置环境**
   修改 `src/main/resources/application.yml` (或创建 `application-dev.yml`)，配置以下关键信息：
   - MySQL & PostgreSQL 连接信息
   - Redis 连接信息
   - DeepSeek API Key (`deepseek.api-key`)

3. **启动依赖服务 (Docker)**
   如果本地没有安装数据库，可以使用 Docker Compose 快速启动：
   ```bash
   docker-compose up -d
   ```

4. **运行项目**
   ```bash
   ./mvnw spring-boot:run
   ```
   启动成功后，访问: `http://localhost:8080`

### 部署与构建

**构建 JAR 包**:
```bash
./mvnw clean package -DskipTests
```

**构建 Docker 镜像**:
```bash
docker build -t gdyd_zhpb_zgf:latest .
```

## 📚 API 文档
项目启动后，可访问 Swagger UI 查看完整的 API 接口文档：
- 地址: `http://localhost:8080/swagger-ui.html`

## 📄 许可证
[License Name] - 查看 LICENSE 文件获取更多信息。
