# Student Learning Practical System (SLPS) — Revised Proposal

**Status:** The system is under development. The departments listed are suggested first departments; more will be added. The system is open for further guidance and input from top management and will be launched once approved.

## 1. Department and multi-campus structure

- The system is department-focused. Each module filters by **Department + Campus**.
- Each department at each campus has its own HOD (for example, HOD Business — Lusaka Campus and HOD Business — Chipata Campus).
- HODs can only see and manage students and data for their assigned department and campus.
- Top Management (DVC1 and Registrar) sees all departments across all campuses.

## 2. Student registration and login

### Student sign-up fields

1. Full Names
2. Valid Email Address
3. NRC Number (`157486/79/1`) or Passport Number for foreign students
4. Required Profile Picture upload
5. Department Selection (suggested first departments; more may be added)
6. Year / Level (Year 1, Year 2, Year 3, Year 4)
7. Campus Selection (all Rockview campuses)
8. Unique Student Number (for example, `RVU/2024/00123`; uniqueness is checked)
9. Auto-generated password: first six NRC digits plus two special characters. Example: `157486/79/1` becomes `157486@#`. For passport registration, use its first six characters. The system emails the password after account creation.

### Student login

Students log in with **Student Number + Generated Password**. Email is not needed for student login.

## 3. Staff role — HOD management

Staff/Admin can add an HOD using these details:

1. Full Name
2. Department Selection
3. Required Campus Assignment
4. NRC Number
5. Email Address
6. Auto-generated password sent to the HOD's email
7. Profile Picture
8. Role automatically set to HOD

## 4. HOD dashboard — 16 modules

1. **HOD Dashboard Overview** — total students, groups and pending submissions for the department and campus.
2. **Manage Students** — view, search and filter by year, campus, NRC and student number.
3. **Group Project Assignment** — find department students, select multiple students, create a group and assign a project immediately; notify students.
4. **Individual Project Assignment** — assign a project to one student.
5. **Zipped Project Submissions** — view submitted `.zip` files, extract them in the system, show a file tree and view code formats such as `.py`, `.php`, `.java`, `.html`, `.css`, `.js` and `.dart` in a code viewer.
6. **Practical Development Guide Management** — add step-by-step software installation guides and system development guides. Software guides include software name, download link, installation steps and an installation check (for example, `python --version`). Development stages include Requirements, Analysis, Design, Coding, Testing and Deployment.
7. **Past Papers Upload** — upload by department, course, exam year and semester; include course code and optionally attach a solution file.
8. **Grade & Feedback Center** — grade group projects with one group grade or grade individual projects; add comments.
9. **Student Logbook Verification** — digitally sign student logbooks.
10. **Practical Attendance** — mark attendance by QR code or manually.
11. **Notifications Center** — send announcements to all students in a department and campus.
12. **Analytics & Performance** — passed, failed and deferred results by intake and project.
13. **File Manager** — department files, past papers and guides.
14. **Messaging Module** — chat with students and groups like WhatsApp.
15. **Profile & Security** — change password and view login history.
16. **AI Assistant** — ask the system to guide the HOD.

## 5. Student dashboard — 16 modules

1. **My Dashboard** — projects, deadlines and grades.
2. **My Group** — group members, group name and group project.
3. **My Assignments** — group and individual practical projects.
4. **Submit Project** — upload a `.zip` project; the system validates the ZIP.
5. **Practical Guides** — step-by-step guides for the student's department.
6. **Past Papers Library** — view and download department past papers and attached solutions.
7. **Software Installation Lab** — software installation and confirmation guides.
8. **E-Logbook** — record daily practical activity.
9. **My Grades & Feedback** — marks and HOD comments.
10. **Attendance History** — practical attendance.
11. **Notifications** — project assignment, grading and announcement notices.
12. **File Manager** — submitted files.
13. **Internal Messaging** — chat with HOD and group members.
14. **Profile Management** — NRC, student number, department, campus and profile picture.
15. **AI Learning Assistant** — questions about practical learning.
16. **Calendar & Deadlines** — practical deadlines.

## 6. Staff / Top Management dashboard — 15 modules

1. System Overview — all campuses
2. Manage All HODs
3. Manage All Students — filter by department, campus and year
4. Department Management — add departments
5. Campus Management — add campuses
6. Past Papers Oversight — view papers by department
7. Practical Guides Oversight
8. All Submissions Monitor
9. Group Management Overview
10. Analytics Across Campuses
11. File Management — super-admin access
12. Request & Approval System
13. User Accounts & Security Logs
14. Messaging — broadcast to all
15. System Settings & Backup

## 7. Technical notes

- **Password logic:** first six NRC digits plus `@#`; for passports, use the first six characters.
- **Email service:** PHPMailer with SMTP to send passwords instantly.
- **ZIP extraction:** PHP ZipArchive extracts files and displays a file tree; Monaco Code Editor displays code.
- **Security:** NRC validation uses `XXXXXX/XX/X`; check unique student numbers and verify email.
- **Stack:** Dart/Flutter + PHP API + MySQL + Firebase notifications.

## Way forward

The system is under development. The listed departments are first-phase suggestions. The project is open to further guidance and input from top management and will launch once approved.
