-
-
Notifications
You must be signed in to change notification settings - Fork 34
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
1 parent
ebc2ee9
commit 40b5d72
Showing
1 changed file
with
104 additions
and
151 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
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") |