JobSphere

JobSphere is a job portal application built with Laravel 10.

Table of Contents

• JobSphere
  • Table of Contents
  • Installation
  • Configuration
    • Database Configuration
    • SMTP Configuration
  • Usage
    • Running the Application
  • System Design
    • Class Diagram
  • Folder Structure
  • Features
  • Contribution
  • License

Installation

1. Clone the repository:

   git clone https://github.com/samiulislamsharan/JobSphere.git
   cd JobSphere

2. Install dependencies:

   composer install

3. Copy the example environment file and update the environment variables:

   cp .env.example .env

4. Generate an application key:

   php artisan key:generate

5. Run the database migrations:

   php artisan migrate

6. Seed the database with test data (optional):

   php artisan db:seed

7. Serve the application:

   php artisan serve

Configuration

Ensure to set up your .env file with the correct configuration for your database, mail, and other services.

Database Configuration

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3307
DB_DATABASE=job-sphere-db
DB_USERNAME=
DB_PASSWORD=

SMTP Configuration

MAIL_MAILER=smtp
MAIL_HOST=sandbox.smtp.mailtrap.io
MAIL_PORT=2525
MAIL_USERNAME=
MAIL_PASSWORD=
MAIL_ENCRYPTION=null
MAIL_FROM_ADDRESS="[email protected]"
MAIL_FROM_NAME="${APP_NAME}"

Usage

Running the Application

To run the application, use the following command:

php artisan serve

The application will be accessible at http://localhost:8000.

System Design

Class Diagram

Folder Structure

• app/ - Contains the core code of the application
• bootstrap/ - Contains the bootstrap files
• config/ - Contains the configuration files
• database/ - Contains database migrations, model factories, and seeds
• public/ - Contains the public assets such as JavaScript, CSS, and images
• resources/ - Contains the views and raw assets (LESS, SASS, JavaScript)
• routes/ - Contains all route definitions
• storage/ - Contains compiled Blade templates, file-based sessions, file caches, and other files generated by the framework
• tests/ - Contains test cases

Features

• Job listings with advanced search capabilities
• User registration and authentication
• Job application submissions
• Admin panel for managing job listings and user accounts

Contribution

Contributions are welcome!

• Feel free to submit a pull request.
• For major changes, please open an issue first to discuss what you would like to change.
• Please make sure to update tests as appropriate.

License

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