Community Job Board

A high-performance recruitment platform built with Laravel 12, Pest PHP and RESTful API.
Featuring real-time filtering, secure role-based access, and a pixel-perfect Tailwind UI.

---

🌟 Key Features

🛡️ Security & Authorization

We implemented a strict Policy-based security layer.

• Guests can view listings
• Registered users can create listings
• Strict Ownership: Only the creator of a listing can Update or Delete it, enforced via ListingPolicy.

🔍 Advanced Search & Discovery

• Full-text Search: Case-insensitive filtering of job listings by title.
• Many-to-Many Tagging: Comprehensive filtering system allowing users to browse jobs by tech stack (e.g., PHP, Vue, Laravel).
• SEO Friendly Slugs: Utilizes getRouteKeyName() to provide human-readable URLs (e.g., /listings/senior-laravel-developer) instead of database IDs.

🏗️ Technical Architecture

• RESTful API Integration: A fully functional JSON API located at /api/user/listings.
  It supports dynamic pagination and search, secured by Laravel Sanctum.
• Model Factories: Used extensively to ensure consistent data states across development and testing.
• Robust Seeding: Auto-generates an Admin Account (admin@example.com / password) and 30+ categorized listings with tags for instant testing.
• Service Layer: Centralized all business logic to ensure both the Web Controllers and API Controllers share the same logic, making the codebase "DRY" (Don't Repeat Yourself).
• FormRequest Validation: Decoupled validation logic for cleaner controllers and secure data entry.
• Carbon Integration: Dynamic "New" badge logic to identify listings posted within the last 24 hours.

🎨 Frontend & Design

• Tailwind CSS: Fully responsive UI built with Utility-First CSS for a modern, high-performance look.
• Dynamic Assets: Custom Logo integration and dynamic image handling via Laravel's Storage system.
• Blade Components: Reusable UI components (layout, flash message) to maintain design consistency.

---

🧪 Testing Suite (The "Gold Standard")

This project maintains high code quality through a rigorous testing suite using Pest PHP. We follow the AAA (Arrange, Act, Assert) pattern and utilize Parallel Testing for maximum efficiency.

Feature Tests Included:

• SearchTest: Verifies that search queries return accurate results and handle "no results" states gracefully.
• TagTest: Validates the many-to-many relationship and array-based filtering.
• ListingAuthorizationTest: Crucial security tests proving that:
  1. Owners can update their listings.
  2. Strangers are blocked (403 Forbidden) from modifying other users' data.

Run the tests:

php artisan test --parallel

---

📡 API Reference

GET /api/user/listings

• Auth: Bearer Token (Sanctum)
• Params: search (string), per_page (int, max 100)
• Function: Returns a paginated list of the authenticated user's job postings.

---

⚙️ Configuration & Setup

1️⃣ Prerequisites

Before you begin, ensure you have the following installed:

• XAMPP (with PHP 8.2+ and MySQL)
• Composer (PHP Package Manager)
• Node.js & NPM (For frontend assets)

2️⃣ Clone the Repository

git clone https://github.com/hashmat-mowahidi/community-job-board.git
cd community-job-board
composer install
npm install && npm run dev

3️⃣ Environment Configuration

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

• Open .env and configure your database settings to match XAMPP (usually)

4️⃣ Database Migration & Seeding & API

php artisan migrate --seed

# To initialize the API system and Sanctum:
php artisan install:api

Quick Demo:

• Login: admin@example.com

• Pass: password