项目简介
智学领航是一款基于 FastAPI + LangChain + 阿里云通义千问构建的智能学业规划平台，专为高校大学生提供全周期的学业规划指导服务。
核心技术架构
| 技术栈 | 说明 |
|---|---|
| FastAPI | 高性能异步 Web 框架 |
| SQLAlchemy (Async) | 异步 ORM，支持 MySQL (aiomysql) |
| LangChain | LLM 应用开发框架 |
| 阿里云百炼 API | 通义千问 Qwen3.6-plus 模型 |
核心功能模块
1. 智能 AI 助手
基于 LangChain 和流式响应技术，提供：
- 个性化学业规划：根据专业、年级、成绩生成四年完整方案
- 竞赛备考指导：智能推荐、生成备赛计划
- 实习就业辅助：岗位推送、简历面试指导
- 简历优化撰写：多场景模板、智能内容生成
- AI 智能答疑：选课、考试、竞赛等各类问题
2. 用户系统
- 注册 / 登录（支持用户名/手机号）
3. 简历管理
完整的简历模块 CRUD：
- 教育经历
- 实习经历
- 项目经历
- 技能证书
- 校园经历
- 简历附件上传
4. 会话管理
支持多会话 AI 对话：
- 多会话支持：用户最多可创建 3 个独立会话
- 会话隔离：每个会话独立保存上下文
- 会话管理：创建、重命名、删除会话
- 历史记录：查看、清空、删除单条/批量消息
- 默认会话：注册自动创建欢迎语
5. 个人信息管理
完善的学生档案系统：
- 基础信息：昵称、头像、性别、个人简介
- 学业信息：学校、学院、专业、年级、学历
- 成绩信息：GPA、实习经历
- 发展意向：兴趣方向、职业目标、技能、求职意向
- 联系方式：手机号、邮箱
项目结构
fastapi-study-my/
├── main.py # FastAPI 应用入口
├── config/
│ └── db_conf.py # 数据库配置
├── models/ # SQLAlchemy 模型
│ ├── users.py # 用户模型
│ ├── chat.py # 聊天/会话模型
│ └── resume.py # 简历模型
├── routes/ # API 路由
│ ├── users.py # 用户路由
│ ├── chat.py # AI 聊天路由
│ ├── resume.py # 简历路由
├── crud/ # 数据访问层
├── schemas/ # Pydantic 模型
├── utils/ # 工具函数
│ ├── auth.py # 认证
│ └── response.py # 统一响应
└── static/ # 前端页面
API 路由一览
| 前缀 | 功能 |
|---|---|
/api/user | 用户注册、登录、档案管理 |
/api/ai | AI 智能助手对话 |
/api/resume | 简历各模块管理 |
核心 API 接口
用户相关
POST /api/user/register- 用户注册POST /api/user/login- 用户登录GET /api/user/info- 获取用户信息PUT /api/user/info- 更新用户信息PUT /api/user/password- 修改密码GET /api/user/profile- 获取学生档案PUT /api/user/profile- 更新学生档案
AI 会话相关
POST /api/ai/chat- AI 对话（流式响应）POST /api/ai/session- 创建新会话GET /api/ai/session- 获取用户所有会话PUT /api/ai/session/{id}- 更新会话名称DELETE /api/ai/session/{id}- 删除会话GET /api/ai/history- 获取聊天历史DELETE /api/ai/history/{session_id}- 清空会话历史
技术亮点
- 全异步架构：基于
async/await实现高并发 - 流式响应：SSE 实现 AI 打字机效果
- 上下文感知：AI 根据学生档案提供个性化建议
- 会话管理：支持多会话、上下文记忆
- 统一响应格式：前后端交互标准化
快速启动
# 安装依赖
pip install -r requirements.txt
# 配置数据库
# 修改 config/db_conf.py 中的 ASYNC_DATABASE_URL
# 启动服务
uvicorn main:app --reload --host 0.0.0.0 --port 8000
