🎯 Geezap-Job Aggregator

A comprehensive job aggregation platform that brings opportunities from multiple sources into one place.

📌 Project Overview

Geezap-Job Aggregator is a Laravel-based application that simplifies the job search process by aggregating job listings from various platforms including:

• LinkedIn
• Upwork
• Indeed
• ZipRecruiter
• And more...

The platform not only consolidates job listings but also provides tools to enhance the job application process and preparation.

🚀 Key Features

• Job Aggregation

  • Unified search across multiple job platforms
  • Real-time job updates
  • Detailed job information in a standardized format

• Application Management

  • Track application status (Applied, Saved)
  • Save jobs for later application
  • Application history dashboard

• Cover Letter Generation

  • AI-powered cover letter generation based on job details
  • Customizable templates
  • Export options

🛠️ Installation

1. Clone the repository

git clone https://github.com/theihasan/geezap.git
cd geezap

2. Install dependencies

composer install
npm install

3. Configure environment variables

cp .env.example .env
php artisan key:generate

4. Set up required API keys in .env:

OPENAI_API_KEY=your_openai_api_key

# Cloudflare Turnstile
CLOUDFLARE_TURNSTILE_SITE_KEY=your_site_key
CLOUDFLARE_TURNSTILE_SECRET_KEY=your_secret_key

Also you may need to set turnstile widget from cloudflare dashboard

5. Run migrations

php artisan migrate

6. Set up Laravel Reverb for WebSocket:

php artisan reverb:install
php artisan reverb:start

7. Start the development server

php artisan serve
npm run dev

8. Add Job Category

• Add a job category via the admin panel: /geezap/job-categories.
• Admin credential are available in the seeder class

9. Add API-Key

• Add API Keys for job search via admin panel: /geezap/api-keys.

10. Run the Scheduler

php artisan schedule:run

1. Run the queue worker

php artisan queue:work

Notes

• If you don't get expected behavior check laravel.log file
• Following command might be helpful in some cases

php artisan cache:clear

💻 Technologies Used

• Laravel 11.x
• Laravel Reverb for WebSocket
• OpenAI API
• MySQL
• Livewire (Frontend)
• TailwindCSS

🔜 Upcoming Big Features (Version 3.0.0)

Interview Preparation Module

• Quiz System
  • Generate relevant interview questions based on job descriptions
  • Practice mode with instant feedback
  • Track quiz performance and progress
  • Customized question sets based on job requirements

Additional Planned Features

• Personalized Job Recommendations

  • AI-driven suggestions based on user activity, preferences, and saved searches.

• Advanced Job Matching

  • AI-powered job recommendations
  • Skill compatibility scoring

• Social Media Sharing

  • Share job listings on platforms like LinkedIn, Twitter, and Facebook.

🤝 Contributing

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

📝 License

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