# 校园生活智慧助手

**Repository Path**: kang-weizhen/campus-life-smart-assistant

## Basic Information

- **Project Name**: 校园生活智慧助手
- **Description**: No description available
- **Primary Language**: Python
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-06-13
- **Last Updated**: 2025-06-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 学习生活智能助手 项目说明

## 1. 项目背景

在当今数字化时代，大学生活和学习方式正在发生深刻变革。传统的学习管理系统往往功能单一，缺乏互动性和个性化服务，无法满足当代大学生多样化的需求。同时，随着人工智能技术的快速发展，如何将这些先进技术应用到教育领域，提升学习体验和效率，成为一个重要课题。在此背景下，我们开发了"学习生活智能助手"项目，旨在打造一个集学习、社交、生活服务于一体的综合性校园平台。在我们的助手中，人工智能赋能教育：利用AI聊天、实时更新（SSE）等技术提升交互体验与效率。一站式服务需求：整合学习（课程管理）、社交（贴吧）、生活（智能助手）场景，打造校园生态闭环。数据驱动优化：通过用户行为分析（如热门帖子、课程管理习惯）持续优化服务。满足了当代大学生的核心诉求，学习高效化AI助手答疑解惑，社交便捷化校园贴吧促进信息共享，生活便捷化。该平台整合了课程管理、社交互动、智能助手等多个功能模块，为大学生提供全方位的校园生活服务。
## 2. 技术与框架

- 后端框架：Flask、Starlette
- 数据库：MySQL
- 前端模板：Jinja2 (Flask templates)
- 实时通信：Server-Sent Events (SSE)，集成MCP服务实现流式聊天交互，掌握API调用与状态管理（开关控制）
- 依赖管理：pip + requirements.txt
- 其他：dotenv、SQLAlchemy、pymysql、mysql-connector-python


## 3. 系统设计与实现
### 3.1 系统架构图

![系统架构图](docs/architecture.jpg)

### 3.2 系统架构图

![时序图](docs/user_interaction.jpg)

### 3.3 数据库ER图

![ER图](docs/er_diagram.jpg)

#### 系统架构图与ER图说明：

- **系统架构图**：展示了前端、后端、数据库、AI服务等模块的交互关系。
- **时序图**：展示了用户与系统各模块的典型交互流程。
- **ER图**：详细描述了用户、课程、帖子、评论等数据表的结构及其关系。

## 4. 软件使用说明

4.1 **环境准备**
   - 安装 Python 3.8+
   - 安装 MySQL 数据库
   - 配置 .env 文件，填写数据库连接信息

4.2 **依赖安装**
   ```bash
   pip install -r requirements.txt
   ```

4.3 **初始化数据库**
   ```bash
   python db.py  # 运行相关初始化脚本
   ```

4.4 **运行项目**
    
   先运行mcp_server.py文件再运行app.py文件
   ```bash
   python mcp_server.py
   python app.py
   ```
   默认访问地址：http://127.0.0.1:8000

4.5 **主要功能**
   - 用户注册/登录/权限管理
   - 课表管理（增删改查、颜色标记、周期设置）
   - 校园贴吧（发帖、评论、点赞）
   - 智能问答助手
   - 系统设置（API配置等）

## 5. 主要功能模块

### 5.1 用户管理
- 支持用户注册、登录、登出、找回密码。
- 用户分为普通用户和管理员，权限分明。
- 管理员可对用户进行封禁、解封、信息管理。

### 5.2 课表管理
- 支持课程的添加、编辑、删除、查询。
- 课程可设置周期、颜色、地点、教师等详细信息。
- 支持按周、按天、按节次等多维度查看课表。
- 课表数据与用户账号绑定，支持个性化管理。

### 5.3 校园贴吧
- 支持发帖、评论、点赞、热门话题推荐。
- 支持帖子内容搜索、按时间/热度排序。
- 管理员可删除违规帖子和评论。

### 5.4 智能助手
- 基于AI模型的智能问答，支持流式对话。
- 可用于学习辅导、生活咨询、信息检索等多场景。
- 支持多轮对话，持续优化交互体验。

### 5.5 系统设置
- 支持API密钥、模型参数等配置。
- 支持管理员后台管理，系统参数动态调整。

## 6. 典型用户流程

1. **新用户注册**：填写用户名、密码等信息，完成注册。
2. **登录与身份验证**：输入账号密码登录，系统校验身份。
3. **完善个人信息**：登录后可补充/修改个人资料。
4. **课表管理**：进入课表模块，添加/编辑/删除课程，查看本周/本学期课表。
5. **参与贴吧互动**：浏览帖子，发布新帖，评论、点赞他人帖子，参与热门话题讨论。
6. **使用智能助手**：在智能助手模块输入问题，获取AI实时回复。
7. **系统设置与反馈**：用户可在设置中调整偏好，管理员可在后台管理用户和内容。

## 7. 贡献指南

- **代码规范**：请遵循PEP8（Python）和团队约定的代码风格。
- **分支管理**：建议每个新功能/修复使用独立分支，合并前请先自测。
- **提交信息**：请写明本次提交的主要内容和影响范围。
- **文档完善**：欢迎补充和优化项目文档。
- **联系方式**：可联系本团队所有人的QQ账号进行加入本项目。

欢迎任何人参与本项目开发！
- Fork 本仓库，提交 Pull Request
- 提交 Issue 反馈 Bug 或建议
- 参与文档完善

## 8. 许可证

本项目采用 MIT License 开源协议，允许自由复制、修改、分发，但需保留原作者信息和许可证声明。

## 9. 成员分工

| 姓名   | 主要职责 |
|:--------:|:-----------:|
| 项祉深   | 制作chat.html和ai.py文件。基于 HTML、CSS 和 JavaScript 的网页，实现用于创建一个 AI 聊天界面，前端的聊天界面和与 AI 模型进行交互的后端请求示例 ，上传git编写文档  |
| 康唯真  | 制作config.html，tieba.html和config.py，timetable.py文件。 Flask 模板引擎的 HTML 文件，用于实现课表管理的前端界面，使用 Flask 模板引擎的 HTML 文件，用于实现校园贴吧的前端界面，上传git并编写文档 |
| 吕玉芬   | 制作login.html和mcp_server.py文件，实现MySQL 数据库操作服务和用户登录页面，用户可以通过服务器提供的工具接口执行数据库操作，同时可以使用登录页面进行用户认证，上传git并编写文档 |
| 孙逸扬   | 制作base.html，home.html文件、db.py，fix_db_structure.py 文件实现修复 MySQL 数据库的结构和页面布局和导航栏，负责与数据库进行交互，为 Web 应用提供数据支持，上传git并编写文档 |
| 陆剑锋   | 制作register.html文件，timetable.html文件和app.py实现用户注册功能，采用了 HTML、Flask 模板语法和 Bootstrap 框架和，写app.py文件集成了用户认证、贴吧、课表管理、实时更新和聊天功能，上传git并编写文档 |

## 联系方式

| 团队成员联系方式 | QQ账号 |
| :---: | :---: |
| hjf | 3348437870 |
| syy | 3056238355 |
| kwz | 931019434 |
| xzs | 1198345846 |
| lyf | 3277508694 |

有问题可联系上述QQ账号

---
如需英文版说明，请参见 [README.en.md](README.en.md)