🧭 智途引航 (zhitu-pilot)

AI驱动的校招简历分析与岗位匹配系统

✨ 功能特点

• 📄 简历解析：上传 PDF/Word/图片 简历，自动提取教育背景、实习经历、技能点
• 🎯 岗位匹配：职位集市 + 智能匹配度分析，支持多岗位对比
• 💡 优化建议：针对目标岗位提供简历修改建议
• 🎤 面试准备：生成针对性的面试问题和准备指南
• 🎬 模拟面试：AI 驱动的语音视频面试模拟，支持实时语音识别与 AI 评价反馈
• 💬 智能对话：基于 Agent 架构的流式对话，支持记忆和工具调用
• 📂 多会话管理：会话历史、置顶、收藏功能
• 🌓 主题切换：支持深色/浅色模式
• 👤 用户系统：登录注册、个人中心

🏗️ 项目结构

zhitu-pilot/
├── backend/                      # 后端服务
│   ├── main.py                   # FastAPI 主应用入口，定义所有 API 路由
│   ├── database.py               # PostgreSQL 数据库连接池与 CRUD 操作
│   ├── utils.py                  # PDF/Word/图片解析工具
│   ├── jobs_data.py              # 预设岗位数据
│   ├── requirements.txt          # Python 依赖
│   ├── Dockerfile                # 后端 Docker 配置
│   │
│   ├── agent/                    # 智能 Agent 模块
│   │   ├── __init__.py           # 模块导出
│   │   ├── core.py               # Agent 核心，整合状态图/记忆/工具/LLM
│   │   ├── state_graph.py        # 状态图引擎，管理对话状态流转
│   │   ├── memory.py             # 记忆管理，对话历史与上下文
│   │   ├── tools.py              # 工具执行器，定义可调用的工具
│   │   ├── llm_client.py         # LLM 客户端，调用大模型 API
│   │   ├── prompts.py            # Agent 系统提示词模板
│   │   ├── cache.py              # LLM 响应缓存层
│   │   └── task_queue.py         # 异步任务队列
│   │
│   └── migrations/               # 数据库迁移脚本
│       ├── migrate_add_admin.py      # 添加管理员字段
│       ├── migrate_agent_tables.py   # Agent 相关表
│       └── migrate_resume_fields.py  # 简历字段扩展
│
├── frontend/                     # 前端应用 (React + Vite)
│   └── src/
│       ├── App.jsx               # 主应用，路由与布局
│       ├── main.jsx              # 应用入口
│       ├── index.css             # 全局样式，主题变量
│       ├── components/
│       │   ├── ChatInterface.jsx     # 聊天界面，流式消息渲染
│       │   ├── JobSelector.jsx       # 岗位选择器
│       │   ├── JobMarket.jsx         # 职位集市，岗位浏览与筛选
│       │   ├── SessionSidebar.jsx    # 会话侧边栏
│       │   ├── LoginPage.jsx         # 登录/注册页面
│       │   ├── UserProfile.jsx       # 个人中心
│       │   ├── FileUpload.jsx        # 文件上传组件
│       │   ├── FeedbackModal.jsx     # 需求反馈弹窗
│       │   └── ShareView.jsx         # 分享页面
│       └── utils/
│           └── clipboard.js          # 剪贴板工具函数
│
├── pg/                           # 数据库管理工具
│   ├── config.py                     # 数据库连接配置
│   ├── create_zhitu_database.py      # 创建数据库
│   ├── create_session_tables.py      # 创建会话相关表
│   ├── create_jobs_table.py          # 创建职位表
│   ├── create_feedback_table.py      # 创建反馈表
│   ├── import_jobs_data.py           # 导入职位数据
│   ├── migrate_jobs_favorites.py     # 职位收藏迁移
│   ├── migrate_user_profile.py       # 用户资料迁移
│   ├── view_database_info.py         # 查看数据库概览
│   ├── view_database_detail.py       # 查看表详情
│   ├── view_zhitu_table.py           # 查看指定表数据
│   ├── view_users_data.py            # 查看用户数据
│   ├── delete_row.py                 # 删除指定行
│   ├── drop_database.py              # 删除数据库
│   └── example_viewer.py             # 数据库浏览示例
│
├── docker-compose.yml            # Docker Compose 编排
├── nginx-proxy.conf              # Nginx 反向代理配置
├── clean_pycache.py              # 清理 Python 缓存文件
├── DEPLOY_SERVER.md              # 服务器部署文档
├── DEPLOY_80_PORT.md             # 80 端口部署文档
└── QUICK_DEPLOY.md               # 快速部署指南

🚀 快速开始

环境要求

• Python 3.10+
• Node.js 18+
• PostgreSQL 15+
• 阿里云 DashScope API Key

1. 配置环境变量

cd backend
cp env.example.txt .env

# 编辑 .env 文件
# DASHSCOPE_API_KEY=your_api_key
# PG_HOST=your_pg_host
# PG_USER=your_pg_user
# PG_PASSWORD=your_pg_password
# PG_DATABASE=zhitu

2. 初始化数据库

cd pg
pip install -r requirements.txt
python create_zhitu_database.py
python create_session_tables.py
python create_jobs_table.py
python import_jobs_data.py

3. 启动后端

cd backend
pip install -r requirements.txt
uvicorn main:app --reload --host 0.0.0.0 --port 8000

4. 启动前端

cd frontend
npm install
npm run dev

访问 http://localhost:3000 即可使用！

5. Docker 部署

docker-compose up -d

🔧 技术栈

层级	技术
前端	React 18 + Vite + Tailwind CSS
后端	FastAPI + Uvicorn + SSE 流式响应
数据库	PostgreSQL + 连接池
AI	阿里云 DashScope (Qwen) + Agent 架构
部署	Docker + Nginx

📄 License

MIT License

---

Made with ❤️ by zhitu-pilot Team