Skip to content

samiulislamsharan/JobSphere

Repository files navigation

JobSphere

JobSphere is a job portal application built with Laravel 10.

Table of Contents

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

job-shpere-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.