Job Listing Retrieval and Pagination

[Cybermaxi7]

📚 Overview

Implement a feature that allows freelancers and guests to view a list of job postings with pagination. This will efficiently present job opportunities in a manageable format.

🔍 Background

The job listings need to be easily navigable by users. This feature ensures that users can filter, sort, and page through job postings smoothly, with the newest jobs displayed first.

🚀 Specifications

• Public Route: Accessible without authentication, with optional filters.
• Pagination: Use query parameters (page and limit) to control pagination.
• Sorting: Jobs should be sorted by date (newest first).

🛠️ Tasks

1. Implement the findAll method in the job service (located in src/jobs/jobs.service.ts).
2. Update the job controller in src/jobs/jobs.controller.ts to support new query parameters for pagination.
3. Ensure the response is structured with total count, items, and page information.

📌 Impacted Files

• src/jobs/jobs.service.ts
• src/jobs/jobs.controller.ts

🚧 Contribution Guidelines

• Assign the issue before submitting a PR.
• Complete the implementation within 2–3 days.
• Include "Close Job Listing Retrieval and Pagination #8" in the PR description.
• Ensure the contribution guide is read and followed.

Follow the contribution guide for detailed instructions.

🎯 Acceptance Criteria

• Job listings are retrieved and paginated properly.
• The API response includes total count, items list, and current page details.
• Pagination and sorting work as expected.

[clintjeff2]

Hello, I'm Jefferson, a backend engineer based in Cameroon with expertise in developing scalable and performant APIs. My tech stack includes NestJS, Express, TypeScript, Node.js, PostgreSQL, TypeORM, and JWT authentication.

I’m available to implement the public job listings feature with pagination and sorting as specified. Below is my plan of action:

Implementation Plan

1. Service Enhancement

   • Implement the findAll method in jobs.service.ts to:
     • Accept page, limit, and optional filter parameters.
     • Retrieve jobs sorted by creation date in descending order.
     • Return paginated results along with total count and pagination metadata.

2. Controller Update

   • Modify jobs.controller.ts to:
     • Accept and validate query parameters: page, limit, and optional filters.
     • Route should remain public with no authentication guard applied.

3. Response Structure

   • Ensure the API response includes:
     • items: List of job postings for the current page.
     • total: Total number of jobs available.
     • page: Current page number.
     • limit: Number of items per page.

4. Consistency & Standards

   • Follow existing patterns in the job module.
   • Ensure clear error messages for invalid query parameters.
   • Maintain code readability and alignment with the contribution guide.

Deliverables

• Paginated and sorted findAll method in jobs.service.ts.
• Updated jobs.controller.ts to handle query parameters.
• Proper response format with pagination metadata.
• Publicly accessible endpoint for job listings.

Timeline

Estimated completion: 24 hours.
Telegram: @JeffersonYouashi

Looking forward to your assignment.

[clintjeff2]

Hello, I'm Jefferson, a backend engineer based in Cameroon with expertise in developing scalable and performant APIs. My tech stack includes NestJS, Express, TypeScript, Node.js, PostgreSQL, TypeORM, and JWT authentication.

I’m available to implement the public job listings feature with pagination and sorting as specified. Below is my plan of action:

Implementation Plan

1. Service Enhancement

   • Implement the findAll method in jobs.service.ts to:

     • Accept page, limit, and optional filter parameters.
     • Retrieve jobs sorted by creation date in descending order.
     • Return paginated results along with total count and pagination metadata.

2. Controller Update

   • Modify jobs.controller.ts to:

     • Accept and validate query parameters: page, limit, and optional filters.
     • Route should remain public with no authentication guard applied.

3. Response Structure

   • Ensure the API response includes:

     • items: List of job postings for the current page.
     • total: Total number of jobs available.
     • page: Current page number.
     • limit: Number of items per page.

4. Consistency & Standards

   • Follow existing patterns in the job module.
   • Ensure clear error messages for invalid query parameters.
   • Maintain code readability and alignment with the contribution guide.

Deliverables

• Paginated and sorted findAll method in jobs.service.ts.
• Updated jobs.controller.ts to handle query parameters.
• Proper response format with pagination metadata.
• Publicly accessible endpoint for job listings.

Timeline

Estimated completion: 24 hours. Telegram: @JeffersonYouashi

Looking forward to your assignment.

Could you assign the task?

[AbdulSnk]

Hi, I would like to work on the job postings pagination feature! I’ve built APIs with JavaScript/TypeScript and handled query parameters for features like pagination and sorting.