🚀 TalentSync

AI-Powered Career Assistant | AI驱动的智能求职助手

Resume Analysis, Job Matching, Cover Letter Generation 简历分析、职位匹配、求职信生成

TalentSync is a full-stack web application that helps job seekers improve their success rate through AI technology. The platform provides resume-to-job matching analysis, intelligent cover letter generation, and more. It supports multiple AI models (GPT-4o, GPT-o1, Google Gemini) to help users optimize resumes, target applications, and prepare for interviews.

TalentSync 是一个全栈 Web 应用，帮助求职者通过 AI 技术提升求职成功率。平台提供简历与职位匹配度分析、智能求职信生成等核心功能，支持多种 AI 模型（GPT-4o、GPT-o1、Google Gemini），帮助用户优化简历、精准投递、做好面试准备。

🔗 Visit Demo | 访问演示

Currently in test mode - all features are free to experience 当前为测试运营版本，所有功能免费开放体验

• ATS Analysis | ATS 分析: Keyword matching, format checking, pass probability assessment
• Ranking Analysis | 排名分析: Predict ranking percentile, compare with top candidates
• HR Analysis | HR 分析: First impression assessment, interview recommendation, expression issue identification
• Technical Analysis | 技术分析: Credibility assessment, risk identification, expected interview questions prediction

• Automatically generate personalized cover letters based on resume and target job
• Highlight relevant experience and skill matching
• Support multiple languages and styles
• One-click PDF export

• Intelligent job description parsing (JD Parsing)
• Structured job information storage
• Job status tracking (Saved, Applied, Interviewing, Offered, Rejected)

• Email registration/login
• Google OAuth 2.0 login
• JWT authentication
• Subscription management (Free, Premium, Enterprise)

• Framework: React 18.2.0
• Routing: react-router-dom v6.30.0
• State Management: Redux Toolkit v2.6.1
• Styling: Tailwind CSS + Material-UI v7.0.0
• Animation: Framer Motion v12.12.1
• PDF Processing: jspdf + html2pdf.js
• Charts: ECharts v5.6.0

• Runtime: Node.js
• Framework: Express.js v4.21.2
• Database: MongoDB + Mongoose v8.13.0
• Authentication: JWT + Google OAuth 2.0 + bcryptjs
• AI Services: OpenAI (GPT-4o, GPT-o1) + Google Gemini
• Payment: Stripe v18.1.0
• File Processing: multer + pdf-parse + pdfkit

• Frontend: Vercel
• Backend: Railway
• Database: MongoDB Atlas

TalentSync/
├── backend/                        # Backend service
│   ├── app.js                      # Express app entry
│   ├── setup.js                    # Initialization
│   ├── models/                     # Mongoose models
│   │   ├── User.js                 # User model
│   │   ├── Subscription.js         # Subscription model
│   │   ├── Resume.js               # Resume model
│   │   ├── Analysis.js             # Analysis model
│   │   ├── CoverLetter.js          # Cover letter model
│   │   └── UserJob.js              # User-job relation
│   ├── controllers/                # Business controllers
│   ├── routes/                     # Route definitions
│   ├── middleware/                 # Middleware
│   ├── services/                   # Business services
│   └── config/                     # Configuration
├── frontend/                       # Frontend project
│   ├── src/
│   │   ├── pages/                  # Page components
│   │   ├── components/             # Reusable components
│   │   ├── store/                  # Redux state management
│   │   └── services/               # API services
│   └── public/                     # Static assets
└── README.md                       # Project documentation

• Node.js >= 16.0.0
• MongoDB (local or MongoDB Atlas)
• npm or yarn

1. Clone the repository

git clone https://github.com/songzhiyuan98/TalentSync.git
cd talentsync

2. Install backend dependencies

cd backend
npm install

3. Install frontend dependencies

cd ../frontend
npm install

4. Configure environment variables

Create backend/.env:

MONGO_URI=mongodb://localhost:27017/talentsync
OPENAI_API_KEY=sk-proj-...
GEMINI_API_KEY=...
JWT_SECRET=your_jwt_secret
PORT=3001
GOOGLE_CLIENT_ID=...
GOOGLE_CLIENT_SECRET=...
API_URL=http://localhost:3001
FRONTEND_URL=http://localhost:3000
STRIPE_SECRET_KEY=sk_test_...
STRIPE_PUBLISHABLE_KEY=pk_test_...
STRIPE_PREMIUM_PRICE_ID=price_...
STRIPE_ENTERPRISE_PRICE_ID=price_...
STRIPE_WEBHOOK_SECRET=whsec_...

Create frontend/.env:

REACT_APP_API_URL=http://localhost:3001

5. Start development servers

Start backend (port 3001):

cd backend
npm start

Start frontend (port 3000):

cd frontend
npm start

6. Access the application

Open http://localhost:3000 in your browser

• POST /api/auth/register - User registration
• POST /api/auth/login - User login
• GET /api/auth/google - Google OAuth login
• GET /api/auth/me - Get current user info
• GET /api/auth/logout - Logout

• POST /api/resumes/upload - Upload resume
• GET /api/resumes - Get all resumes
• GET /api/resumes/active - Get active resume
• PUT /api/resumes/:id/set-active - Set active resume
• DELETE /api/resumes/:id - Delete resume

• POST /api/jobs/parse - Parse job description
• POST /api/jobs - Save job
• GET /api/jobs/user - Get user's jobs
• GET /api/jobs/:id - Get job details

• POST /api/analysis - Create analysis
• GET /api/analysis/:id - Get analysis details
• GET /api/analysis - Get user's analyses

• POST /api/cover-letters - Generate cover letter
• GET /api/cover-letters/:id - Get cover letter
• GET /api/cover-letters/:id/download - Download PDF

• POST /api/payment/create-checkout-session - Create payment session
• GET /api/payment/get-subscription-status - Get subscription status
• POST /api/payment/cancel-subscription - Cancel subscription

For more API details, see PROJECT_DOCUMENTATION.md

• JWT Token authentication
• Password bcrypt encryption
• Google OAuth 2.0 secure login
• Stripe secure payment integration
• File upload size limit (10MB)
• CORS configuration
• Helmet security headers

• Frontend: React functional components only, no class components
• State Management: Redux Toolkit with unified action naming
• API Requests: Use axios, all API paths start with /api/
• Code Style: ES6+ syntax, use async/await
• Naming: camelCase (variables/functions), PascalCase (component files)

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

This project is licensed under the MIT License - see the LICENSE file for details.

• Email: songzhiyuan98@gmail.com
• Project Link: https://github.com/songzhiyuan98/TalentSync
• Live Demo: https://talentsync-green.vercel.app

• OpenAI - GPT-4o, GPT-o1 API
• Google Gemini - Gemini API
• Stripe - Payment services
• Vercel - Frontend deployment
• Railway - Backend deployment