# bid-ai-platform

**Repository Path**: cxuq/bid-ai-platform

## Basic Information

- **Project Name**: bid-ai-platform
- **Description**: 招投标AI平台
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-27
- **Last Updated**: 2026-07-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



```markdown
# 招投标AI智能平台

本项目是一个基于 **FastAPI** (后端) 和 **Vue3** (前端) 构建的智能化招投标管理系统。它集成了人工智能技术，旨在实现招标、投标、评标、风控及客服的自动化与智能化。

## 核心功能

1.  **智能评标 (AI Evaluation)**
    *   **技术评分**: 根据招标文件自动评估投标文件的技术方案。
    *   **商务评分**: 分析投标报价，评估价格竞争力及合理性。
    *   **资格审核**: 智能检查投标人的资质是否符合要求。
    *   **合规检查**: 验证投标文件的完整性与合规性。

2.  **围串标检测 (Collusion Detection)**
    *   **IP关联分析**: 识别多家投标单位是否存在IP地址重叠等异常关联。
    *   **报价规律分析**: 通过算法检测投标报价中的“幽灵报价”、“雷同报价”等围标行为。
    *   **文本相似度**: 利用 NLP 技术检测标书内容的相似程度，识别围标线索。

3.  **AI 客服**
    *   支持智能问答，解答关于招标流程、截止时间、政策法规等常见问题。
    *   具备意图识别和情感分析能力。

4.  **全流程管理**
    *   招标项目管理（发布、变更、状态追踪）。
    *   投标文件在线提交与管理。
    *   数据大屏与可视化统计报表。

## 技术栈

### 后端 (Backend)
*   **语言**: Python 3.11+
*   **框架**: FastAPI (高性能异步框架)
*   **数据库**: SQLite (开发/测试环境) / 兼容 PostgreSQL/MySQL
*   **ORM**: SQLAlchemy
*   **认证**: JWT (JSON Web Token)
*   **AI 库**: Python 标准库及数据结构算法

### 前端 (Frontend)
*   **框架**: Vue.js 3
*   **构建工具**: Vite
*   **样式**: CSS (原生支持或预处理)

## 项目结构

```text
├── backend/                 # 后端项目根目录
│   ├── app/
│   │   ├── ai/             # AI 核心模块
│   │   │   ├── bid_evaluation.py
│   │   │   ├── collusion_detect.py
│   │   │   ├── customer_service.py
│   │   │   └── text_similarity.py
│   │   ├── core/           # 核心配置与安全 (JWT, 依赖注入)
│   │   ├── models/         # 数据库模型定义 (User, Tender, Bid, Evaluation)
│   │   ├── routers/        # API 路由接口
│   │   │   ├── auth.py
│   │   │   ├── tender.py
│   │   │   ├── bid.py
│   │   │   ├── evaluation.py
│   │   │   ├── collusion.py
│   │   │   └── customer_service.py
│   │   ├── main.py         # FastAPI 应用入口
│   │   └── database.py     # 数据库连接配置
│   ├── tests/              # 后端自动化测试用例 (Pytest)
│   └── requirements.txt    # Python 依赖列表
│
├── frontend/               # 前端项目根目录
│   ├── src/
│   │   ├── views/          # 页面视图组件
│   │   ├── router/         # 前端路由配置
│   │   ├── stores/         # 状态管理 (Pinia/Vuex)
│   │   └── ...
│   └── package.json        # 前端依赖配置
│
└── README.md               # 项目说明文档
```

## 快速开始

### 环境准备
*   Python 3.11+
*   Node.js 16+

### 1. 后端服务启动

进入后端目录并安装依赖：

```bash
cd backend
pip install -r requirements.txt
```

初始化数据库（首次运行）：

```bash
python -m app.init_db
```

启动开发服务器：

```bash
uvicorn app.main:app --reload
```

*后端服务默认运行在 `http://localhost:8000`*

### 2. 前端服务启动

进入前端目录并安装依赖：

```bash
cd frontend
npm install
```

启动开发服务器：

```bash
npm run dev
```

*前端服务默认运行在 `http://localhost:5173` (或 Vite 配置的端口)*

## API 文档

FastAPI 提供了自动交互式 API 文档。

*   **Swagger UI**: [http://localhost:8000/docs](http://localhost:8000/docs)
*   **ReDoc**: [http://localhost:8000/redoc](http://localhost:8000/redoc)

## 测试

后端包含完整的单元测试和集成测试，覆盖认证、评标、风控等核心模块。

进入后端目录运行测试：

```bash
cd backend
pytest
```

## 许可证

本项目遵循开源协议。
```