# BV-SIS — Student Registration Report

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

---

## Architecture

Mirrors Phases 1–2:

| Layer | Pattern |
|-------|---------|
| Controllers | `HandlesInstitutionCrud` + specialised workflow controllers |
| Repositories | `BaseRegistrationRepository` |
| Policies | `RegistrationPolicy` → `$user->can('student.*')` |
| Requests | `BaseRegistrationRequest` |
| Models | UUID, SoftDeletes, audit fields, activity log |
| Views | Aurora admin layout |

---

## Feature Coverage

### Numbering
- Computer numbers: campus + year prefix, sequential, locked sequences, searchable  
- Student numbers: programme/campus/year prefixes, auto + manual override (`student.id`)

### Student Profile
Full biodata, guardians, sponsors, emergency contacts, previous education, medical records, photo, signature, QR token, barcode value, ID preview.

### Course Registration
Semester registrations load programme structure courses; statuses: normal, repeat, deferred, withdrawn, exempted, carry_over, special_exam, incomplete, audit.

### Lifecycle
Active · Registered · Deferred · Suspended · Withdrawn · Graduated · Discontinued · Transferred · Alumni — with `student_status_changes` audit.

### Programme Switching / Transfers / Deferment / Withdrawal / Suspension
Dedicated CRUD modules with approval fields and reasons.

### Offences
Category, severity, committee, decision, penalty, appeal, resolution status.

### Documents & Notes
Upload metadata, verification status, private notes.

### Online Registration Requests
Approve / reject with notifications.

### Reports & Analytics
Class list, intake vs programme, semester stats, registration status, Chart.js dashboard.

---

## Services

| Service | Role |
|---------|------|
| ComputerNumberService | Locked sequence generation |
| StudentNumberService | Locked sequence + override |
| RegistrationWorkflowService | Steps + `convertFromApplication()` |
| CourseRegistrationService | Structure → course rows |
| StudentStatusService | Status change logging |
| StudentIdentityService | QR + barcode strings |
| RegistrationNotificationService | Email/log notifications |

---

*BIG VOICE TECHNOLOGIES — BV-SIS*
