RecruIT/README.md

🚀 RecruIT - QuizzCabm

RecruIT (also known as QuizzCabm) is a high-performance, multi-tenant SaaS application designed to streamline and revolutionize the recruitment process through automated assessments, AI analysis, and data-driven decision making.

✨ Main Features

🏢 Multi-Tenant Architecture

• Organizational Isolation: Manage multiple independent companies (tenants) within a single instance.
• Custom Environments: Each tenant has its own isolated set of candidates, job positions, and quizzes.

👤 Advanced Candidate Management

• Centralized Tracking: Monitor candidate progression from application to final selection.
• Rich Profiles: Linked profiles with CVs, LinkedIn URLs, phone numbers, and internal recruiter notes.
• Status Management: Dynamic statuses and a selection toggle (is_selected) for "Shortlisted" candidates.

🎓 Dynamic Quiz System

• Automated Skill Assessment: Create and manage customizable quizzes for specific job positions.
• Real-time Scoring: Automatic calculation of quiz scores with support for manual adjusted scoring if needed.
• Attempt Tracking: Monitor when candidates start and finish their assessments.

🤖 AI-Powered Analysis

• Automated Screening: Integrated AI analysis to evaluate candidate profiles and documents.
• Smart Insights: Get data-driven summaries of candidate strengths and weaknesses.

📊 Precision Scoring System

• Weighted Global Score: A proprietary algorithm calculates a score out of 20 by balancing:
  • CV Evaluation (20 pts)
  • Motivation (10 pts)
  • Interview Performance (30 pts)
  • Best Quiz Attempt (20 pts)
• Comparative Dashboard: Visual tools to compare candidates side-by-side.

🛠️ Administrative Excellence

• Dashboard Analytics: High-level statistics on candidate throughput, average scores, and top performers.
• User & Role Management: Secure access control for administrators and recruiters.
• Data Integrity: Built-in backup systems and audit logs of administrative actions.

💻 Tech Stack

• Backend: Laravel 13+ (PHP 8.3+)
• Frontend: Vue 3 via Inertia.js
• Styling: Tailwind CSS
• Interactivity: Ziggy for Laravel routing in JS
• Parsing: PDFParser for automated document reading

🚀 Getting Started

Prerequisites

• PHP 8.3+
• Composer
• Node.js & NPM

Installation

1. Clone the repository

   git clone <repository-url>
   cd QuizzCabm
   

2. Run Initialization Script RecruIT comes with a built-in setup command:

   composer run setup
   

   This command will install dependencies (PHP & NPM), generate the application key, run migrations, and build assets.

3. Environment Configuration Edit your .env file to configure your database and other service providers.

4. Start the Development Server

   composer run dev
   

   This starts the Laravel server, Vite dev server, and the queue listener concurrently.

📜 License

This project is licensed under the MIT License.