# knowledge_base_tech

**Repository Path**: huxiqing/knowledge_base_tech

## Basic Information

- **Project Name**: knowledge_base_tech
- **Description**: 校园信息中控平台
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: codex/auth-teacher-portal
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-07-08
- **Last Updated**: 2026-07-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 校园信息问答中台

面向校园场景的知识库与智能问答系统。项目包含 Vue 3 前端、Spring Boot 业务后端和 FastAPI AI 服务，支持学生与教师门户、知识问答、课程管理及文档导入。

![校园信息问答中台背景](web-vue/public/images/campus-chat-background.png)

## 项目预览

学生工作台将智能问答、常用校园服务、近期事项和使用概览集中在一个页面中，并支持明暗主题与快捷导航。

![学生工作台](docs/images/student-home.png)

## 功能

- 学生端：校园问答、历史记录、收藏、通知和个人资料
- 教师端：数据看板、课程管理和资料导入
- AI 检索：文档切分、向量检索、重排和答案生成
- 数据服务：MySQL、MongoDB、Milvus 和 MinIO
- 身份认证：学生与教师角色登录及路由权限控制

## 技术栈

| 模块 | 技术 |
| --- | --- |
| 前端 | Vue 3、Vue Router、Vite、Axios |
| 业务后端 | Java 17、Spring Boot 3、Spring Data JPA |
| AI 服务 | Python 3.11+、FastAPI、LangChain、LangGraph |
| 数据存储 | MySQL、MongoDB、Milvus、MinIO |

## 系统组成

```text
浏览器（Vue 3）
   ├── 访问 Spring Boot：登录、用户、课程与校园业务
   └── 访问 FastAPI：文档导入、知识检索与智能问答
                         ├── Milvus：向量检索
                         ├── MongoDB：文档数据
                         ├── MySQL：业务数据
                         └── MinIO：文件存储
```

## 目录结构

```text
backend/       Spring Boot 业务后端
web-vue/       Vue 3 前端
web/           FastAPI AI 服务及接口
processor/     文档导入与查询处理流程
database/      MySQL 初始化脚本
config/        应用配置模块
```

## 环境要求

- Python 3.11+
- Node.js 20+ 与 npm
- Java 17 与 Maven 3.9+
- MySQL、MongoDB、Milvus、MinIO
- 推荐使用 `uv` 管理 Python 依赖

## 本地启动

1. 创建本地配置：

   ```powershell
   Copy-Item .env.example .env
   ```

   编辑 `.env`，填写模型 API、数据库、Milvus 和 MinIO 配置。不要提交 `.env`。

2. 安装 Python 与前端依赖：

   ```powershell
   uv sync
   Set-Location web-vue
   npm ci
   Set-Location ..
   ```

3. 初始化 MySQL：依次执行 `database/mysql/schema.sql`、`auth.sql` 和 `student_features.sql`；如需演示数据，再执行 `test_data.sql`。

4. 启动全部服务：

   ```powershell
   .\start-all.ps1
   ```

启动成功后可访问：

- 前端：<http://127.0.0.1:5173/>
- 业务后端：<http://127.0.0.1:8080/>
- AI 服务文档：<http://127.0.0.1:9000/docs>

## 分别启动

```powershell
# AI 服务（项目根目录）
uv run python web/ai_service.py

# Spring Boot 后端
Set-Location backend
mvn spring-boot:run

# Vue 前端
Set-Location web-vue
npm run dev
```

## 构建与测试

```powershell
# 前端生产构建
Set-Location web-vue
npm run build

# 后端测试
Set-Location ../backend
mvn test
```

## 常见问题

- 服务无法启动：检查对应的 `*.err.log`，并确认 5173、8080、9000 端口未被占用。
- 数据库连接失败：核对 `.env` 与 `backend/src/main/resources/application.properties` 中的连接配置。
- 模型或向量检索失败：确认模型路径/API 密钥、Milvus 集合和向量维度配置一致。

## 安全说明

仓库已忽略 `.env`、日志、构建产物、虚拟环境、IDE 配置和本地临时文件。提交前仍应检查变更，避免上传密钥或生产数据。