# Python-9-采购文件智能生成

**Repository Path**: sanxiadaer/Python-9

## Basic Information

- **Project Name**: Python-9-采购文件智能生成
- **Description**: 采购文件智能生成系统
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-10
- **Last Updated**: 2026-08-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 采购文件智能生成系统

基于 Vue 3 + FastAPI 的前后端分离项目，面向采购业务场景，覆盖**需求录入 → 智能解析 → 模板管理 → 文件生成 → 风险评估 → 法规库**的全流程。

---

## 一、项目简介

系统面向企业采购业务，通过自然语言描述采购需求，由后端自动解析出结构化字段（品类、金额、数量、交付周期等），结合模板库生成招标书/合同，并基于法规库对合同文本进行智能风险扫描，辅助采购人员完成合规、低风险的采购文件制作。

### 核心能力

| 模块 | 能力 |
|---|---|
| 用户认证 | 注册 / 登录 / JWT 鉴权 / bcrypt 密码加密 |
| 需求解析 | 自然语言 → 结构化字段（正则引擎，预留 LLM 升级接口） |
| 模板管理 | 招标书 / 合同模板的增删改查、搜索、分页、版本管理 |
| 文件生成 | 基于模板 + 解析数据自动生成采购文件 |
| 风险评估 | 供应商可信度评估 + 合同条款风险扫描（缺项、陷阱条款、法规命中） |
| 法规库 | 政府采购 / 招标投标 相关法规管理，按品类/金额自动匹配 |

---

## 二、技术栈

### 前端

- **Vue 3** + Composition API（`<script setup>`）
- **Element Plus** UI 组件库
- **Vite** 构建工具
- **Vue Router 4**（History 模式 + 嵌套路由）
- **Axios**（封装统一请求实例 + 请求拦截器自动携带 token）

### 后端

- **Python 3.13** + **FastAPI**
- **SQLAlchemy** ORM
- **Pydantic** 数据校验
- **JWT** + **bcrypt** 鉴权
- **Uvicorn** ASGI 服务器

### 数据库

- **MySQL 5.7+**（建议 8.0）
- 三张主表：`users` / `requirements` / `templates`
- 扩展表：`suppliers` / `regulations` / `risk_assessments` / `generated_documents`

---

## 三、项目结构

```
Python-9/
├── backend/                     # 后端 FastAPI
│   ├── app/
│   │   ├── main.py              # 入口：建表 + CORS + 路由挂载 + 种子初始化
│   │   ├── core/
│   │   │   ├── config.py        # 配置（数据库、密钥、token 过期）
│   │   │   └── security.py      # bcrypt + JWT
│   │   ├── db/
│   │   │   ├── session.py       # 数据库引擎 + get_db 依赖
│   │   │   └── seed.py          # 种子数据（10 供应商 + 20 法规 + 管理员）
│   │   ├── models/              # ORM 模型
│   │   │   ├── user.py
│   │   │   ├── requirement.py
│   │   │   ├── template.py
│   │   │   ├── supplier.py
│   │   │   ├── regulation.py
│   │   │   ├── risk_assessment.py
│   │   │   └── generated_document.py
│   │   ├── schemas/             # Pydantic 入参/出参校验
│   │   ├── api/
│   │   │   ├── deps.py          # 依赖：当前登录用户
│   │   │   └── v1/
│   │   │       ├── api.py       # 路由汇总
│   │   │       └── endpoints/    # 6 个接口模块
│   │   └── services/            # 业务逻辑
│   │       ├── risk_engine.py   # 风险评估引擎
│   │       └── document_generator.py
│   ├── run.py                   # 启动脚本
│   └── requirements.txt
├── frontend/                    # 前端 Vue3
│   ├── src/
│   │   ├── main.js
│   │   ├── App.vue
│   │   ├── router/index.js      # 路由配置（嵌套路由）
│   │   ├── api/request.js       # axios 实例 + 拦截器
│   │   └── views/
│   │       ├── Login.vue        # 登录注册
│   │       ├── Home.vue         # 主框架布局
│   │       ├── Dashboard.vue    # 首页工作台
│   │       ├── RequirementInput.vue   # 需求录入
│   │       └── TemplateManage.vue    # 模板管理
│   ├── vite.config.js
│   └── package.json
└── README.md
```

---

## 四、快速开始

### 1. 环境要求

| 工具 | 版本 | 说明 |
|---|---|---|
| Python | 3.10+ | 推荐 3.13 |
| Node.js | 18+ | 推荐 22.x |
| MySQL | 5.7+ | 推荐 8.0 |
| npm | 随 Node | — |

### 2. 数据库准备

```powershell
# 登录 MySQL
mysql -u root -p

# 在 MySQL 命令行中执行
CREATE DATABASE IF NOT EXISTS procurement_ai CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
```

如需修改数据库连接，编辑 [backend/app/core/config.py](backend/app/core/config.py)：

```python
DATABASE_URL = "mysql+pymysql://用户名:密码@localhost:3306/procurement_ai?charset=utf8mb4"
```

### 3. 启动后端

```powershell
cd D:\Python-9\backend

# 首次运行：安装依赖
pip install -r requirements.txt

# 启动（开发模式，自动重载）
python run.py
```

看到以下输出即成功：

```
INFO:     Uvicorn running on http://0.0.0.0:8000 (Press CTRL+C to quit)
INFO:     Application startup complete.
```

> 首次启动会自动建表，并初始化种子数据（10 个示例供应商 + 20 条法规 + 默认管理员账号）。

### 4. 启动前端

```powershell
cd D:\Python-9\frontend

# 首次运行：安装依赖
npm install

# 启动开发服务器
npm run dev
```

看到以下输出即成功：

```
VITE  v8.2.x  ready in xxx ms
➜  Local:   http://localhost:5173/
```

### 5. 访问系统

打开浏览器访问：**http://localhost:5173/**

---

## 五、默认账号

首次启动后，系统会自动创建以下账号（见 [backend/app/db/seed.py](backend/app/db/seed.py)）：

| 用户名 | 密码 | 角色 |
|---|---|---|
| `template_admin` | `admin123` | 模板管理员 |

也可以在登录页注册新账号。

---

## 六、API 文档

后端启动后，FastAPI 自动生成 Swagger 文档：

- **Swagger UI**：http://localhost:8000/docs
- **ReDoc**：http://localhost:8000/redoc

### 主要接口列表

| 模块 | 路径前缀 | 主要接口 |
|---|---|---|
| 认证 | `/api/v1/auth` | `POST /register`、`POST /login` |
| 需求解析 | `/api/v1/requirement` | `POST /parse`、`POST /save`、`GET /list`、`GET /{id}` |
| 模板管理 | `/api/v1/template` | `POST /create`、`PUT /update/{id}`、`DELETE /delete/{id}`、`GET /list` |
| 文件生成 | `/api/v1/document` | 基于模板生成采购文件 |
| 法规库 | `/api/v1/regulation` | 法规 CRUD + 分类筛选 |
| 风险评估 | `/api/v1/risk` | `POST /assess`、`POST /assess_contract`、`POST /assess_contract_file`、`GET /list` |

---

## 七、核心功能流程

```
用户登录
   ↓
录入采购需求（自然语言）
   ↓
点"智能解析" → 后端提取品类/金额/数量等结构化字段 + 置信度
   ↓
用户核对修改 → 确认保存
   ↓
选择模板 → 生成采购文件
   ↓
风险评估：
   ├─ 供应商可信度评估（资质/年限/违法记录/按时率/验收率/合作分）
   ├─ 合同条款风险扫描（缺项/陷阱条款/法规命中）
   └─ 输出综合风险等级 + 风险点清单 + 修改建议
```

---

## 八、端口说明

| 服务 | 端口 | 说明 |
|---|---|---|
| 前端 (Vite) | 5173 | 后端 CORS 白名单**只允许 5173**，不要改 |
| 后端 (FastAPI) | 8000 | 跨域配置在 [backend/app/main.py](backend/app/main.py) |
| MySQL | 3306 | 默认端口 |

> ⚠️ 前端必须跑在 5173，否则请求会被后端 CORS 拦截。如需修改端口，需同步修改 [backend/app/main.py](backend/app/main.py) 的 `allow_origins`。

---

## 九、常见问题

### Q1：后端启动报 `ModuleNotFoundError`

依赖没装全，执行：

```powershell
cd D:\Python-9\backend
pip install -r requirements.txt
```

### Q2：后端报 `Access denied for user`

MySQL 密码不对，编辑 [backend/app/core/config.py](backend/app/core/config.py) 改成你自己的密码。

### Q3：后端报 `Unknown column 'xxx' in 'field list'`

数据库表结构是旧的，需要重建。删除相关表让代码自动重建：

```powershell
mysql -u root -p procurement_ai -e "DROP TABLE 表名;"
```

然后重启后端，会按最新模型重新建表。

### Q4：前端 `Port 5173 is in use`

5173 被其他程序占用，需要：

1. 关掉占用程序（可能是之前的 Vite / 其他项目）
2. 或者在 PowerShell 中杀掉占用进程：
   ```powershell
   Get-NetTCPConnection -LocalPort 5173 | Select-Object OwningProcess
   Stop-Process -Id <上一步得到的PID> -Force
   ```

### Q5：前端能打开但登录提示 "Network Error"

后端没启动，或端口不对。访问 http://localhost:8000/ 确认后端正常。

### Q6：pip 装依赖时提示 click 版本冲突

这是 `anaconda-cli-base` 的警告，**不影响本项目运行**，可忽略。

---

## 十、构建生产版本

### 前端打包

```powershell
cd D:\Python-9\frontend
npm run build      # 输出到 dist/
npm run preview    # 本地预览生产构建
```

### 后端生产部署

```powershell
# 关闭热重载，用多进程
uvicorn app.main:app --host 0.0.0.0 --port 8000 --workers 4
```

---

## 十一、参与贡献

1. Fork 本仓库
2. 新建分支：`git checkout -b Feat_xxx`
3. 提交代码：`git commit -m "feat: 新增 xxx 功能"`
4. 推送分支：`git push origin Feat_xxx`
5. 新建 Pull Request

---

## 十二、许可证

本项目仅用于教学/课程作业用途。