Skip to content

KENYAN_UNIVERSITY_FEATURES.md

Latest commit

 

History

History
357 lines (289 loc) · 10 KB

KENYAN_UNIVERSITY_FEATURES.md

File metadata and controls

357 lines (289 loc) · 10 KB

Smart Track - Kenyan University Edition

🇰🇪 Localized Features for Kenyan Universities

Student Information

The system now uses authentic Kenyan student data:

  • Admission Numbers: Format IN17/00141/23 (e.g., Lennox Lewis Odhiambo - IN17/00141/23)
  • Course Codes: Proper Kenyan format like BIT 312, CSC 211, MTH 101
  • Kenyan Names: Akinyi Atieno, Brian Kiprop, Wanjiru Njoroge, etc.
  • Counties: Kisumu, Nairobi, Uasin Gishu, Kiambu, etc.
  • Phone Numbers: +254 format
  • National IDs: Kenyan ID numbers

Lecturers

  • Terresa Trizah - Information Technology Department
    • Teaches: BIT 111, BIT 113, BIT 211, BIT 215, BIT 312, BIT 316, BIT 318, BIT 413, BIT 417
  • Prof. Grace Njeri - Information Technology Department
  • Dr. Peter Mwangi - Computer Science Department
  • Dr. Wanjiku Kamau - System Administrator

Course Structure

Information Technology (BIT)

Year 1

  • BIT 111 - Introduction to Information Technology (4 credits)
  • BIT 113 - Programming Fundamentals (4 credits)
  • BIT 115 - Computer Organization (3 credits)

Year 2

  • BIT 211 - Object Oriented Programming (4 credits)
  • BIT 213 - Database Systems (4 credits)
  • BIT 215 - Web Development (4 credits)
  • BIT 217 - Systems Analysis and Design (3 credits)

Year 3

  • BIT 312 - Data Structures and Algorithms (4 credits)
  • BIT 314 - Software Engineering (4 credits)
  • BIT 316 - Network Administration (4 credits)
  • BIT 318 - Mobile Application Development (4 credits)
  • BIT 320 - Cyber Security Fundamentals (3 credits)

Year 4

  • BIT 411 - Cloud Computing (4 credits)
  • BIT 413 - Artificial Intelligence (4 credits)
  • BIT 415 - IT Project Management (4 credits)
  • BIT 417 - Research Project (6 credits)

Computer Science (CSC)

  • CSC 111 - Introduction to Computer Science
  • CSC 113 - Discrete Mathematics
  • CSC 211 - Data Structures
  • CSC 213 - Computer Architecture
  • CSC 215 - Operating Systems
  • CSC 311 - Algorithm Analysis
  • CSC 313 - Compiler Design
  • CSC 315 - Computer Networks

Kenyan University Grading System

The system uses the official Kenyan university grading scale:

Grade Percentage Classification
A 70-100% First Class Honours
B 60-69% Upper Second Class Honours
C 50-59% Lower Second Class Honours
D 40-49% Pass
E 0-39% Fail

GPA Scale: 0-5.0 (A=5, B=4, C=3, D=2, E=1)

NEW Kenyan-Specific Features

1. 💰 Fee Management System

Path: /admin/fees

A comprehensive fee tracking system tailored for Kenyan universities:

Features:

  • Fee Structure: KES 50,000 per semester
  • Payment Methods:
    • M-PESA (Most common in Kenya)
    • Bank Transfer
    • Bank Deposit
    • Cheque
    • Cash

Capabilities:

  • Track fee balances per student
  • Record payments with receipt numbers
  • Monitor outstanding balances
  • Generate fee statements
  • Exam Card Eligibility: Only students with cleared or minimal balances can sit exams
  • Export fee reports
  • Payment progress tracking
  • Critical balance alerts (> KES 30,000)

Fee Statistics:

  • Total collected
  • Outstanding fees
  • Students fully paid
  • Students with balances
  • Payment history

Integration with Alerts:

  • Automatic alerts for high fee balances
  • Exam card blocking for non-payment
  • Fee reminder notifications

2. 🏢 Industrial Attachment Tracking

Path: /admin/attachment

Complete management of student industrial placements:

Features:

  • Register student attachments
  • Track placement companies
  • Monitor attachment duration
  • Approve/reject placements
  • Track supervisors
  • Progress monitoring

Attachment Status:

  • Pending Approval
  • Not Started
  • Ongoing
  • Completed
  • Overdue

Company Tracking:

  • Safaricom PLC
  • Kenya Commercial Bank (KCB)
  • Other Kenyan organizations

Requirements:

  • Only Year 3 and Year 4 students eligible
  • Typical duration: 3-4 months
  • Industry supervisor assignment
  • University approval required

Progress Tracking:

  • Days remaining calculator
  • Percentage completion
  • Start and end dates
  • Placement location

3. 🎓 HELB Integration Ready

The system tracks HELB (Higher Education Loans Board) status:

  • Active: Student has active HELB loan
  • Applied: Application pending
  • Pending: Needs to apply
  • Not Applied: No loan application

HELB Status Tracking:

  • View HELB status per student
  • Link to fee balance
  • Track disbursement
  • Integration-ready for HELB API

4. 🏠 Hostel Management

Student records include hostel information:

  • On-Campus Hostels:
    • Block A, B, C, D
    • Room numbers tracked
  • Off-Campus: Tracked separately

Features:

  • Room allocation tracking
  • Hostel assignment per student
  • Space for hostel fees (future enhancement)

5. 📱 Kenyan Contact Information

Students have complete Kenyan-specific contact details:

  • Phone Numbers: +254 format (Safaricom, Airtel)
  • National ID: Kenyan ID numbers
  • County of Origin: Track home county
  • Email: University email addresses (@student.ac.ke)

Sample Student Profiles

Lennox Lewis Odhiambo (IN17/00141/23)

  • Department: Information Technology
  • Year: 3
  • GPA: 3.2/5.0 (B)
  • Courses: BIT 312, BIT 314, BIT 316, BIT 318, BIT 320
  • Fee Balance: KES 15,000
  • HELB: Active
  • Hostel: Block C, Room 204
  • County: Kisumu
  • Phone: +254712345678
  • Risk Level: Low

Akinyi Atieno Omondi (IN17/00245/23)

  • Department: Information Technology
  • Year: 3
  • GPA: 4.2/5.0 (A)
  • Fee Balance: KES 0 (Fully Paid)
  • HELB: Active
  • Hostel: Block A, Room 105
  • County: Nairobi
  • Risk Level: Low

Juma Hassan Abdi (IN17/00589/23)

  • Department: Computer Science
  • Year: 1
  • GPA: 1.8/5.0 (E)
  • Fee Balance: KES 52,000 (Critical)
  • HELB: Not Applied
  • Attendance: 62%
  • Risk Level: High
  • Alerts: Multiple (GPA, Fee, Attendance)

Academic Calendar Integration

The system is designed for Kenyan academic calendar:

  • Semester 1: September - December
  • Semester 2: January - April
  • Industrial Attachment: Usually Year 3/4 during long vacation
  • Exam Period: December and April

Alert Types (Kenyan Context)

  1. GPA Alerts: Below 2.0 (failing)
  2. Attendance Alerts: Below 75% minimum
  3. Fee Balance Alerts: Outstanding fees blocking exams
  4. Exam Card Alerts: Cannot sit exams without clearance
  5. HELB Alerts: Loan application reminders
  6. Grade Drop Alerts: Significant performance decline

Intervention Types

  1. Academic Advising: Meet with academic advisor
  2. Tutoring: Peer or lecturer tutoring
  3. Financial Aid: Connect with bursary office, HELB
  4. Counseling: Student welfare services
  5. Mentoring: Senior student mentorship

Kenyan University Regulations

The system enforces:

  • Minimum 75% attendance to sit exams
  • Minimum 40% pass mark (Grade D)
  • 2.0 GPA minimum for good academic standing
  • Fee clearance required for exam cards
  • Industrial attachment mandatory for graduation

Module Summary - Kenyan Edition

Core Modules (14 total)

  1. ✅ User Management
  2. ✅ Student Directory (Kenyan data)
  3. ✅ Course Management (BIT/CSC codes)
  4. ✅ Fee Management (KES, M-PESA)
  5. ✅ Industrial Attachment Tracking
  6. ✅ Grade Management (Kenyan grading A-E)
  7. ✅ Attendance Tracking
  8. ✅ Alerts & Interventions
  9. ✅ ML Risk Prediction
  10. ✅ Analytics & Reports
  11. ✅ Student Comparison
  12. ✅ Notification Center
  13. ✅ Role-Based Dashboards
  14. ✅ System Architecture

Navigation - Admin Portal (12 pages)

  1. Dashboard
  2. User Management
  3. Student Directory ⭐
  4. Courses
  5. Fee Management 🇰🇪 NEW
  6. Industrial Attachment 🇰🇪 NEW
  7. Alerts
  8. ML Models
  9. Analytics
  10. Student Comparison
  11. Reports
  12. Settings

Kenya-Specific Integrations Ready

The system is architected to integrate with:

  • HELB API: Loan application and disbursement
  • M-PESA API: Real-time fee payment verification
  • KNEC: Kenya National Examinations Council
  • CUE: Commission for University Education
  • University ERP Systems: SAP, Oracle, etc.

Sample Companies for Industrial Attachment

  • Safaricom PLC
  • Kenya Commercial Bank (KCB)
  • Equity Bank
  • Co-operative Bank
  • KPLC (Kenya Power)
  • Kenya Airways
  • Safaricom Foundation
  • iHub Nairobi
  • BitPesa
  • M-KOPA Solar

Demo Credentials

Admin

Lecturer (Terresa Trizah)

Student (Lennox Lewis Odhiambo)

Technical Highlights

Data Localization

  • Kenyan names and counties
  • KES currency formatting
  • +254 phone number format
  • Kenyan university course codes
  • Local grading system

Payment Integration

  • M-PESA ready (most popular in Kenya)
  • Multiple payment method support
  • Receipt number tracking
  • Real-time balance updates

Regulatory Compliance

  • CUE standards
  • Kenyan grading system
  • Attendance requirements
  • Fee clearance policies

Future Enhancements (Kenyan Context)

  1. M-PESA Integration: Direct API connection for instant payment verification
  2. HELB Portal: Real-time loan status updates
  3. SMS Alerts: Via Safaricom/Airtel for fee reminders
  4. County Bursary Tracking: Track county government bursaries
  5. CDF Bursaries: Constituency Development Fund scholarships
  6. E-Clearance System: Digital clearance for graduands
  7. Academic Transcript Generation: Official university transcripts
  8. Certificate Verification: QR code-based verification
  9. Alumni Tracking: Post-graduation employment tracking
  10. Library Integration: Track book borrowing and returns

Smart Track - Kenyan University Edition is a complete, production-ready Student Management System designed specifically for Kenyan universities, with authentic data, local payment methods, proper grading systems, and integration readiness for Kenyan educational infrastructure.

🎓 Built with React, TypeScript, Tailwind CSS | Designed for Kenyan Higher Education