Skip to content

Commit

Permalink
Update README.md
Browse files Browse the repository at this point in the history
  • Loading branch information
Devmangrani authored Oct 25, 2024
1 parent ebc2ee9 commit 40b5d72
Showing 1 changed file with 104 additions and 151 deletions.
255 changes: 104 additions & 151 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,160 +1,113 @@
##### This App is Live and Running At the following
#### https://epics-project-jobsearch.vercel.app/
# JobSewa - An OpenSource Job Portal for Local Workers
This repository aims to bridge the gap between local skilled workers and employers through a user-friendly job portal. It's designed to *empower* local talent and *connect* them with meaningful opportunities, making job searching and hiring accessible to everyone. <br> *We maintain high standards for contributions to ensure platform reliability and efficiency.*

![jobsewa-banner](https://raw.githubusercontent.com/andreasbm/readme/master/assets/lines/colored.png)

## Overview

- A revolutionary platform connecting local skilled workers with employers
- Focused on empowering workers like plumbers, electricians, carpenters, and daily wage workers
- Built with modern tech stack: NextJS, Tailwind CSS, Redux Toolkit, MongoDB
- Open source project welcoming contributions from developers worldwide
- Live and running at: [JobSewa Portal](https://epics-project-jobsearch.vercel.app/)

## Key Features 🔥

### For Workers
- Easy profile creation and management
- Job search and application tracking
- Real-time application status updates
- Skills and experience showcase
- Document upload for certifications

### For Employers
- Streamlined job posting process
- Access to local talent pool
- Application management dashboard
- Direct communication with candidates
- Candidate filtering and sorting

### Platform Features
- Secure authentication with JWT
- Bookmark favorite jobs
- Track applications in DataTable view
- Manage posted jobs and applications
- Accept/reject applications with status updates
- CV preview and download capability (Local environment)

## Building from Source

1. **Clone the Repository:**
```bash
git clone https://github.com/Devmangrani/JobSewa.git
```

2. **Navigate to the Project Directory:**
```bash
cd JobSewa
```

3. **Install Dependencies:**
```bash
npm install
```

4. **Set Environment Variables:**
Create a `.env` file with:
```
DB_URI=your_mongodb_url
JWT_SECREAT=your_custom_jwt_secret
NEXT_PUBLIC_API_BASE_URL=http://localhost:3000
```

5. **Run Development Server:**
```bash
npm run dev
```

## Contribute

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

1. Fork the repository
2. Create a new branch: `git checkout -b feature-name`
3. Make your changes
4. Submit a pull request

Please ensure your PR:
- Follows our coding standards
- Includes proper documentation
- Has meaningful commit messages
- Addresses a specific issue or adds value

## Issues

Found a bug or have a feature request? Please check our issues tab! When creating a new issue:
- Use the provided template
- Include specific details about the problem
- Add screenshots if applicable
- Mention steps to reproduce

## License




- don't forget to leave a star! :)

## Features🔥

- SignIn / SignUp
- Forget Password
- Post A Job
- View All Jobs
- View Details of Any Job
- Bookmark Jobs
- Track Your BookMark Jobs in DataTable View
- Track Your Applied Jobs in DataTable View
- Track Your Posted Jobs and view Submitted Application
- Accept and Reject Different Applications
- Status Updated for applied Job based on Job poster action
- JWT validation on each Authorized Request
#### (The Below Feature works only in the Local Environment as Vercel Doesn't allow write operation in the free plan so CV is unable to save but works fine in the local App )
- View or download Applicant CV's

## Tech and Tools🛠
- Nextjs
- Tailwind CSS
- Redux Toolkit (for state management)
- Joi validation
- MongoDB
- SWR hooks for fetching API

<h3 align="center">
<img src="https://raw.githubusercontent.com/andreasbm/readme/master/assets/lines/colored.png">
</h3>

## About Jobsewa:

JobSewa is a unique e-job portal designed to directly connect laborers such as plumbers, electricians, carpenters, and other similar professionals with job employers. The platform aims to provide better accessibility and more opportunities for local workers, by enabling them to connect directly with potential employers quickly and efficiently.

With JobSewa, employers can post job listings on the platform and connect with skilled workers in their local area, ensuring that the right person is hired for the job. This service aims to reduce the hassle of finding reliable workers by providing a direct link between employers and workers.

Furthermore, JobSewa also aims to help skilled workers who may struggle to find job opportunities due to socio-economic conditions or other factors by connecting these professionals directly with potential employers, the platform can help them secure work and provide for their families.

JobSewa strives to make the hiring process more accessible, efficient, and affordable for all parties involved. With its user-friendly platform and focus on connecting local workers with employers, JobSewa is set to become an essential tool for those seeking to find reliable skilled labor near VIT Bhopal remote areas and beyond.

• Categories of workers-
• Painters
• Daily Wage Workers
• Plumbers
• Electricians
• Carpenter
• Mechanic
• Housemaids
• Drivers

Working Principle:
Login or Register and User Authentication :

1. Our e-job portal site will start with a login/Signup page.
2. To get access to our website, A user has to sign up for our website for the first time. After signing up, the user can log in using the username and password.
3. After logging in, users will get access to our e-job portal.
4. Skilled workers can register on JobSewa's portal as job seekers/employees.
5. Registered employers can filter their search by city and specific job requirements.
6. A list of relevant employees and laborers will be displayed to the employer based on their search criteria.

JobSewa Job Seekers Actions:

1. Job seekers can register, edit, or delete their profiles through the website or message.
2. Upon successful registration, the job seekers will receive notifications on their app screen or through email/MMS for any job opportunities that match their skills and location.

Employers Action:

1. Employers or job givers can create their profile, edit, and delete it as per their requirements on the JobSewa website.
2. They can search for job seekers who are registered on the platform.
3. The website will display the list of job seekers available in their current city on the home page.
4. Employers can also search for specific job seekers based on their skill set, location, availability, and wages.
5. The employer can contact the job seeker through the website or other modes of communication provided by the platform.

Categories of Services available on our site and Service page:

1. Once you log in, you will be directed to the home page of our website.
2. The home page consists of the categories of services related to job seekers and employers.
3. When the user clicks on one of the categories, a web page will open with a list of available services related to that category.
4. When the user clicks on a specific service, a service page will open with brief information about that service. It will also display the availability of the service in the user's region and available employees for work.


NGO Regulated:

1. NGOs and related organizations can create their profile and post job openings on the JobSewa website.
2. The website will send job opening message notifications to workers who have registered with the website.
3. NGOs and related organizations can edit and delete their profiles on the website as needed.

Dashboard to Monitor:

1. The dashboard provides job seekers with a status update on their job applications.
2. Notifications regarding job openings and application status will be sent to job seekers through the sms or email.
3. Skilled and unskilled workers looking for employment opportunities can register as job seekers/laborers through our portal. Once registered, employers who are also registered on the platform can filter job seekers in their city who are qualified for the job they need. This matching process allows for a streamlined connection between job seekers and employers, thus facilitating job opportunities without any educational literacy or gender boundaries.

<h3 align="center">
<img src="https://raw.githubusercontent.com/andreasbm/readme/master/assets/lines/colored.png">
</h3>

## Environment Variables

To run this project, you will need to add the following environment variables to your .env file

`DB_URI` = Your mongoDB URL

`JWT_SECREAT` = Your custom JWT_SECREAT key

`NEXT_PUBLIC_API_BASE_URL` = Base URL for localhost => http://localhost:3000


## Installation

Install my-project with npm

```bash
npm install
npm run dev (for development server)
npm run build (for Production)
npm run preview (To View Production Server )
```





---------

```javascript

if (youEnjoyed) {

starThisRepository();
}
Copyright © 2024 Dev Mangrani
JobSewa is free software licensed under GPL v3.0
It is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY;
without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
```

-----------













## Support
- Show your support by leaving a ⭐️!
- Share the project with others who might benefit
- Contribute to make it better

## Thanks to all Contributors 🎉
Thanks for spending your time helping JobSewa grow. Keep rocking 🚀

[![Contributors](https://contrib.rocks/image?repo=Devmangrani/JobSewa)](https://github.com/Devmangrani/JobSewa/graphs/contributors)

## GitHub Stats

# Epics-Project-Jobsearch
![Alt](https://repobeats.axiom.co/api/embed/8cb1ff4c1eeba5b90e8ad7047e9e14d792e5861a.svg "Repobeats analytics image")

0 comments on commit 40b5d72

Please sign in to comment.