jobifygarden/README.md

JobifyGarden

A comprehensive job aggregator platform built with Laravel 13 that fetches, stores, and displays job listings from multiple free job APIs.

Requirements

• PHP: 8.3.x or higher
• MySQL: 8.0+ or MariaDB 10.3+
• Composer: 2.x
• Node.js: 18.x or 20.x
• Redis: 6.x+ (for caching and queues)

Features

Core Functionality

• Multi-Source Job Aggregation: Fetch jobs from multiple APIs
• Advanced Search & Filtering: Full-text search, location, job type, experience level, salary range
• Smart Deduplication: Automatic detection and removal of duplicate listings
• Job Enrichment: Auto-categorization, geocoding, salary normalization
• Real-time Analytics: Track job views, searches, and user engagement

SEO & Marketing

• Dynamic Meta Tags: Job-specific title, description, and keywords
• Structured Data: Schema.org JobPosting markup for Google Jobs integration
• XML Sitemaps: Automatic sitemap generation for search engines
• Social Sharing: Open Graph and Twitter Card support
• Mobile-First: Responsive design optimized for all devices

Performance

• Redis Caching: Aggressive caching strategy for fast page loads
• Database Optimization: Proper indexing and query optimization
• Queue Processing: Background job processing for API fetching
• Asset Optimization: Minified CSS/JS with lazy loading

Monitoring & Analytics

• API Metrics: Track success rates, response times, errors
• User Analytics: Popular searches, viewed jobs, click-through rates
• Admin Dashboard: Real-time monitoring and statistics
• Error Tracking: Comprehensive logging and error handling

Installation

Development Setup

1. Clone the repository

git clone <repository-url>
cd jobifygarden

2. Install dependencies

composer install
npm install

3. Configure environment

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

4. Update .env with your database credentials

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=jobifygarden
DB_USERNAME=your_username
DB_PASSWORD=your_password

5. Run migrations

php artisan migrate

6. Seed the database (optional)

php artisan db:seed

7. Build frontend assets

npm run dev

8. Start the development server

php artisan serve

Visit http://localhost:8000 to view the application.

Docker Setup (Laravel Sail)

# Install dependencies
composer install

# Start Docker containers
./vendor/bin/sail up -d

# Run migrations
./vendor/bin/sail artisan migrate

# Build assets
./vendor/bin/sail npm install
./vendor/bin/sail npm run dev

Production Deployment

See DEPLOYMENT.md for detailed production deployment instructions.

Available Commands

Job Management

# Fetch jobs from all sources
php artisan jobs:fetch

# Clean expired jobs
php artisan jobs:clean

# Remove duplicate jobs
php artisan jobs:deduplicate

# Enrich job data (categories, experience levels)
php artisan jobs:enrich

# Test API integrations
php artisan jobs:test-apis

Database Optimization

# Optimize database tables and rebuild indexes
php artisan db:optimize

Cache Management

# Clear all caches
php artisan cache:clear
php artisan config:clear
php artisan route:clear
php artisan view:clear

# Build caches for production
php artisan config:cache
php artisan route:cache
php artisan view:cache

Project Structure

app/
├── Console/Commands/      # Artisan commands
├── Http/Controllers/      # Web and API controllers
├── Models/               # Eloquent models
├── Repositories/         # Data access layer
├── Services/             # Business logic
└── Traits/               # Reusable traits

database/
├── migrations/           # Database migrations
└── seeders/             # Database seeders

resources/
├── views/               # Blade templates
├── js/                  # JavaScript files
└── css/                 # CSS files

routes/
├── web.php              # Web routes
└── api.php              # API routes

API Endpoints

Public API

GET  /api/jobs                    # List jobs with filters
GET  /api/jobs/{id}               # Get job details
GET  /api/categories              # List categories
GET  /api/jobs/autocomplete/titles      # Title autocomplete
GET  /api/jobs/autocomplete/locations   # Location autocomplete
GET  /api/jobs/autocomplete/companies   # Company autocomplete

Technology Stack

Backend

• Laravel 13: PHP framework
• MySQL 8: Primary database
• Redis: Caching and queues
• Guzzle: HTTP client for API requests

Frontend

• Blade Templates: Server-side rendering
• Alpine.js: Lightweight JavaScript framework
• TailwindCSS: Utility-first CSS framework
• Vite: Frontend build tool

License

This project is open-sourced software licensed under the MIT license.

---

About Laravel

Laravel is a web application framework with expressive, elegant syntax. We believe development must be an enjoyable and creative experience to be truly fulfilling. Laravel takes the pain out of development by easing common tasks used in many web projects, such as:

• Simple, fast routing engine.
• Powerful dependency injection container.
• Multiple back-ends for session and cache storage.
• Expressive, intuitive database ORM.
• Database agnostic schema migrations.
• Robust background job processing.
• Real-time event broadcasting.

Laravel is accessible, powerful, and provides tools required for large, robust applications.

Learning Laravel

Laravel has the most extensive and thorough documentation and video tutorial library of all modern web application frameworks, making it a breeze to get started with the framework.

In addition, Laracasts contains thousands of video tutorials on a range of topics including Laravel, modern PHP, unit testing, and JavaScript. Boost your skills by digging into our comprehensive video library.

You can also watch bite-sized lessons with real-world projects on Laravel Learn, where you will be guided through building a Laravel application from scratch while learning PHP fundamentals.

Agentic Development

Laravel's predictable structure and conventions make it ideal for AI coding agents like Claude Code, Cursor, and GitHub Copilot. Install Laravel Boost to supercharge your AI workflow:

composer require laravel/boost --dev

php artisan boost:install

Boost provides your agent 15+ tools and skills that help agents build Laravel applications while following best practices.

Contributing

Thank you for considering contributing to the Laravel framework! The contribution guide can be found in the Laravel documentation.

Code of Conduct

In order to ensure that the Laravel community is welcoming to all, please review and abide by the Code of Conduct.

Security Vulnerabilities

If you discover a security vulnerability within Laravel, please send an e-mail to Taylor Otwell via taylor@laravel.com. All security vulnerabilities will be promptly addressed.

License

The Laravel framework is open-sourced software licensed under the MIT license.