# JambAdvisor

> JambAdvisor is an AI-powered admission counselor and decision engine for candidates applying to Nigerian universities via the Joint Admissions and Matriculation Board (JAMB).

## Overview
JambAdvisor helps students navigate the complex Nigerian university admission process by combining institutional requirements with AI-driven analysis. It assists with JAMB score evaluation, subject combination verification, university departmental cut-off marks, Post-UTME tracking, and Central Admissions Processing System (CAPS) status guidance.

## Core Features & Tools
- **AI Admission Counselor (`/chat`)**: Interactive AI chat powered by RAG (Retrieval-Augmented Generation) providing instant guidance on JAMB cutoffs, subject combinations, O'Level requirements, and university choices.
- **Admission Strategy Planner (`/admission-strategy`)**: Computes admission probability based on JAMB score, aggregate calculation rules, course competitiveness, and catchment area rules.
- **University Explorer (`/universities`)**: Detailed profiles of Nigerian federal, state, and private universities, offering catchment policies, post-UTME patterns, cutoffs, and tuition details.
- **Course & Subject Combination Checker (`/courses`, `/jamb-subject-combination`)**: Searchable database of university courses with mandatory JAMB subject combinations and O'Level subject requirements.
- **JAMB Score Analyzer (`/jamb-score`)**: Instant analysis of JAMB score bands (180–300+) detailing eligible universities and competitive options.
- **Can I Study Tool (`/can-i-study`)**: Specific eligibility check comparing candidate scores and subjects against target university/course benchmarks.
- **CAPS Guidance Assistant (`/caps-assistant`)**: Step-by-step breakdown of JAMB CAPS admission statuses (e.g., "Admitted", "Recommended", "Transfer Approval", "Not Admitted").
- **Guides & Articles (`/guides`)**: Educational articles on JAMB registration, Post-UTME preparation, O'Level subject grading, and admission processes.

## Key Technical Details
- **Architecture**: Next.js (App Router, TypeScript)
- **Data & Knowledge Base**: PostgreSQL via Prisma ORM containing structured data on Nigerian universities, courses, historical cutoffs, and JAMB regulations.