Job Recruitment Management System

A Secure Web Application for Job Listings, Applications, and Evaluations

Project Overview

As an application developer, you are tasked by the Public Service Recruitment Secretariat to build a simplified system that:

• Manages job listings and candidate applications.

• Implements secure authentication and role-based access control.

• Automates application scoring based on resume quality and job location.

Part 1: Authentication & Authorization System

Functional Requirements

1. User Registration & Secure Login

• Registration Endpoint:

  • Stores user credentials securely using bcrypt password hashing.

• Login Endpoint:

  • Returns a JWT (JSON Web Token) or session token upon successful authentication.

2. Password Reset Functionality

• Allow users to reset passwords via email verification.

3. Role-Based Access Control (RBAC)

• Roles: Admin, Editor, Viewer.

• Restricted Access: Certain routes/resources are only accessible based on user roles.

4. Session Management

• Secure storage of session tokens.

• Implement session expiration and logout functionality.

5. API Key Authentication

• Secure APIs for third-party services using API key validation.

Part 2: Job Recruitment System

Core Functionalities

I. Job Listings Management

• Add Jobs:

  • Fields: Title, Department, Location, Salary.

• View Active Jobs:

  • Display all available job postings.

II. Candidate Application Handling

• Submit Application:

  • Candidate provides:

    • Name, Email, Position ID.

    • Resume text or profile summary.

• Storage: Applications stored in a relational database (PostgreSQL/MySQL).

• Constraint: Each candidate can apply only once per job.

III. Location-Based Priority Scoring

• Scoring Rules:

  Job Location	Priority Points
  Remote	+3
  DAR ES SALAAM	+2
  Other Locations	+1

IV. Application Review & Scoring

1. Resume Quality Score (Mocked: 1-10).

2. Location Priority Score (Based on job location).

3. Final Score Calculation:

   Final Score = Resume Score + Location Priority Points  

4. Review Summary Output:

   Name: Ally Mdoka  
   Position: Software Engineer  
   Resume Score: 7  
   Location Priority: 3  
   Final Score: 10  

Technical Implementation Guidelines

Backend

• Framework: Django (Python), Spring Boot (Java), Laravel (PHP), or Flask (Python).

• Database: PostgreSQL or MySQL.

• Security:

  • Password hashing (bcrypt).

  • JWT/Session-based authentication.

  • Role-based permissions.

Frontend (Optional)

• Framework: React, Angular, or Vue.js.

• Features:

  • Job listing display.

  • Application submission form.

  • Admin dashboard for managing jobs/applications.

Constraints & Best Practices

✔ Separation of Concerns: Use classes/modules for clean architecture.
✔ Database Storage: Jobs and applications must persist in a database.
✔ Error Handling & Logging: Ensure robust validation and logging.
✔ No Plaintext Passwords: Always hash passwords before storage.

Sample Workflow

1. Add Jobs:

   • Software Engineer, IT, Remote, Tsh 1,200,000

   • HR Officer, Human Resources, DAR ES SALAAM, Tsh 750,000

2. Candidate Applies:

   Name: Ally Mdoka  
   Email: amdoka@example.com  
   Position: Software Engineer  
   Resume: "Experienced in Python and Java."  

3. System Output:

   Job Listings:  
   1. Software Engineer (Remote) - Tsh. 1,200,000  
   2. HR Officer (DAR ES SALAAM) – Tsh. 750,000  
   
   Application Received:  
   Name: Ally Mdoka  
   Position: Software Engineer  
   Resume Score: 7  
   Location Priority: 3  
   Final Score: 10  
   Status: Processed Successfully  

Conclusion

This system ensures:
✅ Secure user authentication & role-based access.
✅ Efficient job posting & application management.
✅ Automated, fair scoring based on resume & job location.