🏢 Part-Timer-Web

Connecting Part-Time Job Seekers with Recruiters

A modern Laravel + Livewire application featuring a role-based job marketplace with job postings, applications, in-app messaging, and user ratings.

Features • Tech Stack • Getting Started • Screenshots • Testing

---

📋 Course Information

Field	Details
Course	CSE391
Name	Al-Saihan Tajvi
Student ID	23301219
Email	al.saihan.tajvi@g.bracu.ac.bd

---

📑 Table of Contents

• 🚀 Features
• 🛠 Tech Stack
• 📦 Requirements
• ⚡ Getting Started
• 📸 Screenshots
• 🧪 Testing
• 🐛 Known Issues
• 📚 Resources
• 🔮 Future Enhancements
• 🤝 Contributing
• 📄 License

---

🚀 Features

👥 User Management Role-based access (Job Seeker / Recruiter) User profiles & account management Reputation tracking with ratings	💼 Job System Post jobs with descriptions & requirements Requirements-based validation Quick-apply flow for seekers
💬 Communication In-app chat system Application status tracking Notification support	⚡ Modern UI Livewire-driven reactive interface Minimal frontend JavaScript Responsive design with Tailwind

---

🛠 Tech Stack

PHP 8.2

Laravel 12

Livewire

Tailwind CSS

Vite

Category	Technologies
Backend	PHP 8.2, Laravel 12, Livewire (Flux & Volt)
Authentication	Laravel Fortify, Laravel Sanctum
Frontend	Tailwind CSS, Vite
Package Managers	Composer, npm

---

📦 Requirements

Before you begin, ensure you have the following installed:

Requirement	Version
PHP	8.2+
Composer	Latest
Node.js	18+
npm	Latest
Database	MySQL / PostgreSQL
Redis	Optional (for sessions/queues)

---

⚡ Getting Started

1️⃣ Clone the Repository

git clone https://github.com/yourusername/Part-Timer-Web.git
cd Part-Timer-Web

2️⃣ Install Dependencies

# Install PHP dependencies
composer install

# Install JavaScript dependencies
npm install

3️⃣ Environment Setup

# Copy environment file
cp .env.example .env

# Generate application key
php artisan key:generate

4️⃣ Database Setup

# Run migrations
php artisan migrate

# (Optional) Seed the database
php artisan db:seed

5️⃣ Start Development Server

# Start the Laravel development server
php artisan serve

# In a separate terminal, start Vite
npm run dev

🎉 Visit http://localhost:8000 to see the application!

---

📸 Screenshots

🏠 Landing Page

🔐 Sign-in Page

📋 Job Detail

📝 Posted Jobs (Recruiter)

📊 Recruiter Dashboard

👤 Profile Section

📄 Seeker Extra Profile

⭐ Ratings View

---

🧪 Testing

Run the test suite using PHPUnit:

# Run all tests
php artisan test

# Run with coverage
php artisan test --coverage

# Run specific test file
php artisan test tests/Feature/DashboardTest.php

---

🐛 Known Issues

⚠️ This project is a work-in-progress for learning and prototyping purposes.

• Chat system is not real-time (requires page refresh)
• Some edge cases in job application flow may not be handled
• Mobile responsiveness may need improvements in some areas

---

📚 Online Resources Used

• Laravel Documentation
• Livewire Documentation
• Tailwind CSS Documentation
• Laravel Fortify
• Laravel Sanctum

---

🔮 Future Enhancements

• Real-time chat using WebSockets (Laravel Echo + Pusher)
• Email notifications for job applications
• Advanced job search with filters
• Resume/CV upload functionality
• Admin dashboard for platform management
• Job bookmarking/favorites feature
• Application status timeline

---

🤝 Contributing

Contributions are welcome! Here's how you can help:

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

---

📄 License

This project is open-sourced for educational purposes.

---

Made with ❤️ using Laravel & Livewire

⭐ Star this repo if you find it helpful!