JobHunt - Open Source Job Board Platform in TypeScript

JobHunt is an open-source job board platform that enables employers to post job listings and job seekers to search and apply for jobs. The platform is built using Express.js and GraphQL, making it efficient and flexible for managing job-related interactions. This repository contains the source code for JobHunt, and we welcome contributions from the community to enhance its features and capabilities.

Features

Employer Dashboard: Employers can easily create accounts, log in, and post job listings.
Job Seeker Profile: Job seekers can create profiles, search for jobs, and apply using their profiles.
Job Listings: Display job with detailed descriptions, requirements, and application instructions.
Application Tracking: Employers can track and manage job applications through the dashboard.
GraphQL API: Utilize a powerful GraphQL API for seamless job listing retrieval and user interactions.
Open Source: JobHunt is open source, allowing you to customize and contribute to its development.
Refresh Token: JobHunt is featured by refresh token to enhance user experience.

Installation

Follow these steps to set up and run JobHunt locally on your machine:

Clone the repository:

git clone https://github.com/BaseMax/JobHuntTS.git

Navigate to the project directory:

cd JobHuntTS

Install dependencies:

npm install

Configure environment variables:

Rename .env.example to .env and fill in your environment variables.

Run the development server:

tsc
npm run dev

Open your browser and visit http://localhost:4000 to access JobHunt.

GraphQL

Type	Name	Description
Mutation	`createJob`	Create a new job .
Query	`getJobs`	Get a list of all available jobs.
Query	`getJobById`	Get details of a specific job by its ID.
Query	`getJobByTitle`	Search for jobs by title.
Query	`getJobByCategory`	Filter jobs by category.
Query	`getFeaturedJobs`	Get a list of featured job listings.
Query	`getUserApplications`	Get user applications...
Mutation	`updateJob`	Update details of an existing job .
Mutation	`deleteJob`	delete an existing job .
Mutation	`applyForJob`	Apply for a job using user's profile.
Mutation	`withdrawApplication`	Withdraw a job application by its ID.
Mutation	`acceptApplication`	Accept a job application for a job
Mutation	`rejectApplication`	Reject a job application for a job.
Mutation	`signUp`	Create a new user profile.
Query	`getApplications`	Get all job applications for a job listing.
Mutation	`updateUserProfile`	Update user profile
Mutation	`deleteUserProfile`	Delete a user profile by its ID.
Query	`getUserProfiles`	Get a list of all registered users.
Query	`getCategories`	Get a list of all available job categories.
Mutation	`createCategory`	Create a new job category.
Mutation	`updateCategory`	Update a job category's details.
Mutation	`deleteCategory`	Delete a job category by its ID.
Query	`getSimilarJobs`	Get a list of jobs similar to a given job.
Query	`getRecentJobs`	Get a list of recently posted job listings.
Query	`getJobCountByCategory`	Get the number of jobs in a specific category.
Mutation	`addBookmark`	Add a job to a user's bookmarks.
Mutation	`removeBookmark`	Remove a job from a user's bookmarks.
Query	`getBookmarkedJobs`	Get a list of jobs bookmarked by a user.
Query	`getUserBookmarkCount`	Get the number of bookmarks for a user.
Mutation	`createReview`	Create a review for a specific a job.
Mutation	`updateReview`	Update a review's content or rating.
Mutation	`deleteReview`	Delete a review by its ID.
Query	`getReviewsForJob`	Get all reviews for a specific job .
Query	`getTopCategories`	Get the most popular job categories.
Query	`getJobsWithApplications`	Get a job and count of associated applications.
Query	`getOpenApplications`	Get a list of open job applications.

GraphQL Schema

type Job {
  id: ID!
  title: String!
  company: String!
  category: String!
  salary: Float
  description: String!
  requirements: [String]
  location: String
  featured: Boolean
  applications: [Application]
  reviews: [Review]
}

type User {
  id: ID!
  name: String!
  email: String!

}

type Application {
  id: ID!
  user: User!
  job: Job!
  status: String!
  createdDate: String!
}

type Review {
  id: ID!
  user: User!
  job: Job!
  rating: Int!
  content: String!
}

type Category {
  id: ID!
  name: String!
  jobs: [Job]
}

type Bookmark {
  id: ID!
  user: User!
  job: Job!
}

type JobCountByCategory {
  category: String!
  count: Int!
}

type CategoryWithJobCount {
  id: ID!
  name: String!
  jobCount: Int!
}

type ApplicationWithStatus {
  id: ID!
  user: User!
  job: Job!
  status: String!
}

type JobWithApplications {
  id: ID!
  title: String!
  applicationCount: Int!
}

type ApplicationStatus {
  status: String!
  count: Int!
}

type ReviewWithAuthor {
  id: ID!
  rating: Int!
  content: String!

}

type UserWithBookmarks {
  id: ID!
  username: String!
  bookmarkCount: Int!
}

type Query {
  getJobs: [Job]
  getJobById(id: ID!): Job
  getJobByTitle(title: String!): [Job]
  getJobByCategory(category: String!): [Job]
  getFeaturedJobs: [Job]
  getUserProfile(username: String!): User
  getUserApplications(userID: ID!): [Application]
  getCategories: [Category]
  getUsers: [User]
  getApplications(jobID: ID!): [Application]
  getSimilarJobs(jobID: ID!): [Job]
  getRecentJobs: [Job]
  getJobCountByCategory(category: String!): Int
  getBookmarkedJobs(userID: ID!): [Job]
  getReviewsForJob(jobID: ID!): [Review]
  getTopCategories(limit: Int!): [CategoryWithJobCount]
  getUserBookmarkCount(userID: ID!): Int
  getJobsWithApplications: [JobWithApplications]
  getOpenApplications: [ApplicationWithStatus]
  getReviewFeedbackByID(id: ID!): ReviewFeedback
  getReviewFeedbackForReview(reviewID: ID!): [ReviewFeedback]
  getReviewByID(id: ID!): Review
  getReviewByRating(rating: Int!): [Review]
  getReviewByAuthor(userID: ID!): [Review]
  getCategoryByID(id: ID!): Category
  getCategoryByName(name: String!): Category
  getCategoriesWithJobs: [CategoryWithJobCount]
  getJobsWithCategories: [JobWithCategories]
  getUsersWithReviews: [UserWithReviews]
  getReviewsWithFeedback: [ReviewWithAuthor]
  getUsersWithApplicationsAndBookmarks: [UserWithBookmarks]
  getApplicationsWithUserAndJob: [ApplicationWithStatus]
}

type Mutation {
  createJobListing(input: CreateJobInput!): Job
  updateJobListing(id: ID!, input: UpdateJobInput!): Job
  deleteJobListing(id: ID!): Job
  applyForJob(jobID: ID!, userID: ID!): Application
  withdrawApplication(applicationID: ID!): Application
  createUserProfile(input: CreateUserInput!): User
  updateUserProfile(userID: ID!, input: UpdateUserInput!): User
  deleteUserProfile(userID: ID!): User
  acceptApplication(applicationID: ID!): Application
  rejectApplication(applicationID: ID!): Application
  createCategory(name: String!): Category
  updateCategory(id: ID!, name: String!): Category
  deleteCategory(id: ID!): Category
  addBookmark(userID: ID!, jobID: ID!): Bookmark
  removeBookmark(userID: ID!, jobID: ID!): Bookmark
  createReview(jobID: ID!, userID: ID!, rating: Int!, content: String!): Review
  updateReview(reviewID: ID!, content: String!): Review
  deleteReview(reviewID: ID!): Review
  createApplication(userID: ID!, jobID: ID!): Application
  updateApplication(
    applicationID: ID!
    input: UpdateApplicationInput!
  ): Application
  deleteApplication(applicationID: ID!): Application
  updateApplicationStatus(applicationID: ID!, status: String!): Application
  createReviewFeedback(
    reviewID: ID!
    userID: ID!
    helpful: Boolean!
  ): ReviewFeedback
  updateReviewFeedback(id: ID!, helpful: Boolean!): ReviewFeedback
  deleteReviewFeedback(id: ID!): ReviewFeedback
  createBookmark(userID: ID!, jobID: ID!): Bookmark
  deleteBookmark(id: ID!): Bookmark
}

input CreateJobInput {
  title: String!
  company: String!
  category: String!
  salary: Float
  description: String!
  requirements: [String]
  location: String
  featured: Boolean
}

input UpdateJobInput {
  title: String
  company: String
  category: String
  salary: Float
  description: String
  requirements: [String]
  location: String
  featured: Boolean
}

input CreateUserInput {
  name: String!
  email: String!
}

input UpdateUserInput {
  name: String
  email: String
}

input UpdateApplicationInput {
  status: String
}

Contributing

We encourage contributions from the open-source community to make JobHunt even better. Here's how you can contribute:

Fork the repository.
Create a new branch for your feature or bug fix:

git checkout -b <feature-name>

Make your changes and commit them with descriptive commit messages.
Push your changes to your forked repository.
Create a pull request (PR) to the main branch of the JobHunt repository.

Feedback and Support

If you encounter any issues or have suggestions for improvements, please open an issue. For general inquiries and discussions, join our community Discord server.

License

JobHunt is open-source software released under the GPL-3.0 License.

BaseMax / JobHuntTS