Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/samiulislamsharan/jobsphere

JobSphere is a Open-Source job portal made with Laravel 10
https://github.com/samiulislamsharan/jobsphere

job-portal job-portal-laravel laravel laravel-project php

Last synced: 11 days ago
JSON representation

JobSphere is a Open-Source job portal made with Laravel 10

Awesome Lists containing this project

README

        

# JobSphere

JobSphere is a job portal application built with Laravel 10.

## Table of Contents

- [JobSphere](#jobsphere)
- [Table of Contents](#table-of-contents)
- [Installation](#installation)
- [Configuration](#configuration)
- [Database Configuration](#database-configuration)
- [SMTP Configuration](#smtp-configuration)
- [Usage](#usage)
- [Running the Application](#running-the-application)
- [System Design](#system-design)
- [Class Diagram](#class-diagram)
- [Folder Structure](#folder-structure)
- [Features](#features)
- [Contribution](#contribution)
- [License](#license)

## Installation

1. **Clone the repository:**

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

2. **Install dependencies:**

```powershell
composer install
```

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

```powershell
cp .env.example .env
```

4. **Generate an application key:**

```powershell
php artisan key:generate
```

5. **Run the database migrations:**

```powershell
php artisan migrate
```

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

```powershell
php artisan db:seed
```

7. **Serve the application:**

```powershell
php artisan serve
```

## Configuration

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

### Database Configuration

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

### SMTP Configuration

```powershell
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:

```powershell
php artisan serve
```

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

## System Design

### Class Diagram

![job-shpere-class-diagram](https://github.com/user-attachments/assets/75dfcfcc-727f-4db9-b33b-801dd509ce6c)

## 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](https://opensource.org/license/mit).