# BV-SIS Navigation Structure
## Complete Navigation Hierarchy (Preserving Client Workflow)

**Document Version:** 1.0  
**Rule:** Navigation order, module names, and submenu names match the client BRD. Usability improvements are additive only.

---

## 1. Primary Sidebar Navigation

```
BV-SIS
├── 🏛 Institution Setup
├── 📚 Course Management
├── 📝 Student Admission
├── 💰 Student Finance
├── 👤 Student Registration
├── 🌐 Online Registration
├── 📋 Examination
├── ⚙️ Examination Configuration
├── ✏️ Examination Marking
├── 📊 Management Reports
├── 📱 BulkSMS and Email
├── 🔧 System Maintenance
└── 🪪 Student Identity Cards
```

---

## 2. Full Navigation Tree

### 2.1 Institution Setup
```
Institution Setup
└── Institution Structure Module
    ├── Institution
    ├── Campuses
    ├── Faculty
    ├── Area of Study
    ├── Programme of Study
    ├── Programme Track
    ├── Programme Structure
    ├── Academic Path
    ├── Sessions Setup
    ├── Study Plan Periods
    ├── Academic Intake
    └── Dashboard
```

**Breadcrumb Pattern:** `Institution Setup > [Submenu Item]`

**Contextual Navigation (Area of Study):**
- Faculty selector persists in page header when navigating within faculty-scoped views
- Breadcrumb: `Institution Setup > Area of Study > Faculty of Education`

**Contextual Navigation (Programme Structure):**
- Breadcrumb: `Institution Setup > Programme Structure > [Program] > [Track]`

---

### 2.2 Course Management
```
Course Management
├── Courses
├── Course Pre-requisite
└── Course Managers
```

**Breadcrumb Pattern:** `Course Management > [Submenu Item]`

**Shared Context:** Faculty selector available on all three pages (persisted in session)

---

### 2.3 Student Admission
```
Student Admission
├── Admission Settings
├── Entry Requirements
├── Template Letter
├── Application Data Entry
├── Registration Fees          [Enterprise addition — from BRD note]
└── Admission Form Templates   [Enterprise addition — from BRD note]
```

**Breadcrumb Pattern:** `Student Admission > [Submenu Item]`

---

### 2.4 Student Finance
```
Student Finance
├── Fee Setup
├── Course Fees
├── Invoice
├── Minimum Payments
├── Receipts
├── Student Clearance
├── Release Student Results
├── Release Session Results
└── Dashboard
```

**Breadcrumb Pattern:** `Student Finance > [Submenu Item]`

---

### 2.5 Student Registration
```
Student Registration
├── Computer Number
├── Update Student Id
├── Student Registration
│   └── [Student Detail — contextual tabs]
│       ├── Biodata
│       ├── Course Enrollment
│       ├── Courses
│       ├── Register Student
│       └── Program Structure
├── Online Registration Requests
├── Switch Program
├── Student Status
├── Student Offence
├── Student Courses              [Standalone view — also in student detail]
├── Students' Stat - Intake vs Program
├── Semester Vs Intake Stats
├── Semester Registration Status
├── Custom Reports
└── Class List
```

**Breadcrumb Pattern:** `Student Registration > [Submenu Item]`

**Student Detail Breadcrumb:** `Student Registration > Student Registration > [Student Number] > [Tab]`

---

### 2.6 Online Registration
```
Online Registration
├── Registration Portal         [Student-facing]
├── Pending Requests            [Links to admin queue]
└── Portal Settings             [Enterprise addition]
```

**Note:** Admin approval workflow remains under `Student Registration > Online Registration Requests` per BRD. Online Registration module hosts the student portal.

---

### 2.7 Examination
```
Examination
├── Exam Schedule
├── Exam Registration
├── Exam Venues
└── Invigilation
```

**Enterprise additions** — nav items inferred; submenu names configurable in System Maintenance.

---

### 2.8 Examination Configuration
```
Examination Configuration
├── Grading Schemes
├── Grade Boundaries
├── Exam Types
└── GPA Configuration
```

---

### 2.9 Examination Marking
```
Examination Marking
├── Mark Entry
├── Mark Moderation
├── Result Processing
└── Result Slips
```

---

### 2.10 Management Reports
```
Management Reports
├── Enrollment Reports
├── Financial Reports
├── Examination Reports
├── Custom Management Reports
└── Scheduled Reports
```

---

### 2.11 BulkSMS and Email
```
BulkSMS and Email
├── Send SMS
├── Send Email
├── Contact Groups
├── Message Templates
├── Send History
└── Gateway Settings          [Africa's Talking config]
```

---

### 2.12 System Maintenance
```
System Maintenance
├── Users
├── Roles & Permissions
├── System Settings
├── Audit Logs
├── Backup & Restore
├── Email Configuration
└── SMS Configuration
```

---

### 2.13 Student Identity Cards
```
Student Identity Cards
├── ID Card Capture
├── Card Templates
├── Print Queue
├── Reprint / Replacement
└── Issuance History
```

---

## 3. Top Navigation Bar (Global)

| Element | Position | Description |
|---------|----------|-------------|
| Logo + Institution Name | Left | From Institution setup |
| Global Search | Center | Search students, courses, applications |
| Notifications Bell | Right | In-app notifications |
| User Menu | Right | Profile, Settings, Dark Mode, Logout |
| Quick Actions (+) | Right | Context-sensitive shortcuts |

---

## 4. Student Detail Contextual Tabs (Preserved from BRD)

When a student is selected from Student Registration:

```
[Student Number] - [Full Name]
┌─────────┬──────────────────┬─────────┬─────────────────┬───────────────────┬───────┐
│ Biodata │ Course Enrollment│ Courses │ Register Student│ Program Structure │ Close │
└─────────┴──────────────────┴─────────┴─────────────────┴───────────────────┴───────┘
```

**Rule:** Tab order and names preserved exactly from BRD.

---

## 5. Layout Patterns (Preserved from BRD)

### Pattern A: Split Create / List (Left-Right)
Used in:
- Campuses, Faculty, Area of Study, Programme of Study, Programme Track
- Course Management (all three submenus)
- Sessions Setup, Academic Path

```
┌──────────────────┬─────────────────────────────┐
│   CREATE FORM    │      DATA TABLE / LIST      │
│   (35% width)    │      (65% width)            │
└──────────────────┴─────────────────────────────┘
```

### Pattern B: Filter + Table + Create Panel
Used in:
- Sessions Setup, Academic Intake, Study Plan Periods

```
┌─────────────────────────────────────────────────┐
│ FILTERS: [Dropdown] [Dropdown] [Dropdown]       │
├────────────────────────┬────────────────────────┤
│ CREATE FORM            │ TABLE                  │
└────────────────────────┴────────────────────────┘
```

### Pattern C: Selector + Dynamic Content
Used in:
- Programme Structure, Course Pre-requisite, Course Managers, Switch Program

```
┌─────────────────────────────────────────────────┐
│ SELECTORS: [Program ▼] [Track ▼]               │
├─────────────────────────────────────────────────┤
│ DYNAMIC CONTENT (structure tree / assignments)  │
└─────────────────────────────────────────────────┘
```

### Pattern D: Search + Results List + Detail
Used in:
- Student Registration, Student Status, Application Data Entry

```
┌─────────────────────────────────────────────────┐
│ SEARCH / ADVANCED FILTER                        │
├─────────────────────────────────────────────────┤
│ RESULTS LIST (paginated)                        │
├─────────────────────────────────────────────────┤
│ DETAIL VIEW (tabs)                              │
└─────────────────────────────────────────────────┘
```

---

## 6. Mobile Navigation

| Breakpoint | Behavior |
|------------|----------|
| Desktop (≥1280px) | Full sidebar expanded |
| Tablet (768–1279px) | Collapsible sidebar; icons + labels |
| Mobile (<768px) | Bottom tab bar for top 5 modules; hamburger for full menu |

**Mobile Priority Tabs:** Student Registration, Student Finance, Examination Marking, BulkSMS, Dashboard (user role dependent)

---

## 7. Keyboard Shortcuts (Usability Enhancement)

| Shortcut | Action |
|----------|--------|
| `Ctrl+K` | Global search |
| `Ctrl+S` | Save current form |
| `Esc` | Close detail view / modal |
| `/` | Focus search field |

---

## 8. Navigation State Persistence

- Last selected faculty (Course Management) persisted per user session
- Last selected programme/track (Programme Structure) persisted
- Student detail tab state preserved on back navigation
- Filter state saved in URL query parameters for shareable links

---

## 9. Role-Based Navigation Visibility

| Module | Hidden From |
|--------|-------------|
| System Maintenance | All except Super Admin, System Admin |
| Release Results | Non-finance, non-exams roles |
| BulkSMS and Email | Requires communications permission |
| Student Finance | Finance roles + read-only for registrars |

See `08_PERMISSION_MATRIX.md` for complete matrix.

---

## 10. Footer

```
Powered by BIG VOICE TECHNOLOGIES | © [Year] [Institution Name] | Version 1.0
```

Preserved from legacy: "POWERED BY BIG VOICE TECHN" branding requirement.

---

*End of Navigation Structure*
