From aaf3aff64d99772e6aee2d93756142f1ee8b3f04 Mon Sep 17 00:00:00 2001
From: zhangzf1119 <zzfloveown@163.com>
Date: Sat, 13 Dec 2025 23:15:36 +0800
Subject: [PATCH] =?UTF-8?q?=E6=9B=B4=E6=96=B0=E8=87=AA=E8=BF=B0=E6=96=87?=
 =?UTF-8?q?=E6=A1=A3?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 README.md | 96 +++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 96 insertions(+)
 create mode 100644 README.md

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..1b38a5b
--- /dev/null
+++ b/README.md
@@ -0,0 +1,96 @@
+# 智慧评标-主观分助手 (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 文件获取更多信息。