# BV-SIS — Student Admission Report

**Date:** 10 July 2026  
**Module:** Student Admission  
**UI:** Aurora Design System (preserved)

---

## Architecture

Admission mirrors Phase 1 Institution Setup:

| Layer | Pattern |
|-------|---------|
| Controllers | `HandlesInstitutionCrud` + specialised workflow controllers |
| Repositories | `BaseAdmissionRepository` |
| Policies | `AdmissionPolicy` → `$user->can()` |
| Requests | `BaseAdmissionRequest` |
| Models | UUID, SoftDeletes, audit fields, activity log |
| Views | Aurora admin layout + guest portal layout |

---

## Feature Coverage

### Applicant Profile
Personal details, nationality, NRC/passport, gender, DOB, marital status, religion, disability, sponsor, guardian, emergency contact, residential/postal address, previous schools, qualifications, employment history, photo, signature, documents.

### Entry & Programme Requirements
Configurable per programme, campus, intake, session — grades, subjects, age, experience, JSON rules.

### Documents
Upload types (NRC, passport, certificates, transcripts, results, CV, recommendations, medical, photo, signature, other), versioning, verification status, download.

### Workflow Statuses
Draft → Submitted → Document Verification → Academic Review → Interview → Pending Decision → Approved / Rejected / Waitlisted → Offer Issued → Offer Accepted / Declined → Converted to Student.

Every transition logged in `application_status_logs`.

### Reviews & Interviews
Reviewer assignment, scores, notes, interview schedule, panel, venue/link, attendance, result.

### Decisions & Offers
Approve / Reject / Waitlist / Conditional / Deferred / Transfer.  
Offer templates with variables, QR token, PDF view, email delivery hooks, accept/decline.

### Registration Fees
Fee setups, invoices, payment status, receipts, print.

### Online Portal
Public multi-step apply wizard, autosave step, submit, tracking by application number.

### Reports & Analytics
Applications reports, funnel/status charts on dashboard and analytics pages.

### Notifications
`AdmissionNotificationService` + `AfricasTalkingSmsService` (logs when SMS credentials absent).

---

## Navigation

Full Student Admission sidebar under Aurora admin shell — Dashboard through Analytics (22 children).

---

## Security

- Spatie RBAC with expanded `admission.*` permissions  
- Policies on all models  
- Soft deletes, UUIDs, CSRF, FormRequest validation  
- Guest portal isolated from auth middleware  

---

*BIG VOICE TECHNOLOGIES — BV-SIS*
