Student Dashboard

The moment a student logs in, this is the first page they see — a personalized, real-time command centre showing everything that needs their attention today.

① KPI Strip — 4 Live Counters

A horizontal row of 4 compact metric cards appears at the very top. These are scoped to the logged-in student's own data only.

② Today's Timetable

A visual card showing today's lecture schedule in chronological order. Pulled from the HOD-configured master timetable for the student's enrolled class.

• Lecture Rows: Each row shows time slot, subject name, teacher name, and room/location.
• Current Lecture Highlight: The ongoing lecture is highlighted with a green "Live" badge based on the current server time.
• Completed Lectures: Past lectures are shown in grey with a ✓ checkmark — helping students track what they attended today.
• No-Lecture Day: If no timetable is configured for today (e.g., Sunday, holiday), an empty state message appears: "No lectures scheduled for today."

③ Pending Assignments Panel

A card showing up to 5 assignments that are active and not yet submitted by this student. Ordered by deadline (earliest first).

• 5 Columns per Row:
  • Subject — Subject name and teacher who assigned it
  • Assignment Title — Short description with full title on hover
  • Due Date — Exact deadline with a countdown badge (e.g., "2 days left")
  • Status — Not Submitted / Late (past deadline)
  • Action — "Submit Now" button linking to the assignments page
• Deadline Urgency Colors:
  Green — More than 3 days   Amber — 1–3 days   Red — Due today or overdue
• "View All" Link: Navigates to the full Assignments page showing every active assignment.

④ Upcoming Tests Panel

A card showing all tests that are in the "Published" or "Active" status and have been assigned to the student's class, which the student has not yet attempted.

• Test Card Columns:
  • Test Name — Title and subject
  • Window — Available from/to date and time
  • Duration — Total time allowed (e.g., "30 minutes")
  • Questions — Total question count
  • Action — "Take Test" button (active only within the test window)
• Lock State: If the test window hasn't opened yet, the "Take Test" button is disabled and shows the exact start time. If the window has closed, it shows "Expired."
• Already Attempted: Tests the student has submitted appear with a green "Completed" badge instead of the action button.

⑤ Recent Notices

The latest 5 notices from the department, shown in descending order of publication date.

• Notice Card: Title, date, and a short excerpt (first 100 characters). Click to expand the full notice in a modal.
• New Badge: Notices published within the last 48 hours display a pulsing "New" badge.
• Priority Notices: HOD-pinned notices appear at the top with a gold ⭐ pin indicator.

⑥ Leave Status Summary

• Last Application: Status of the most recently applied leave — Pending Teacher / Approved Teacher / Approved HOD / Rejected, with the date and type.
• Quick Apply Button: One-click navigation to the Leave Application form.
• Leave Count Chips: Three small chips showing total Approved / Pending / Rejected leaves for the current academic year.

⑦ Attendance Alert Bar

A full-width alert bar displayed only when a student's attendance is below 75% in any subject. The bar shows which subjects are at risk with their current percentages.

• Critical Alert (below 60%): Red banner with icon "⚠ Critical: Your attendance in [Subject] is X%. Immediate improvement required."
• Warning Alert (60–74%): Amber banner — "⚠ Warning: [Subject] attendance is at X%."
• All-Clear: No banner shown when all subjects are above 75% — a subtle "✅ Attendance on track" chip is shown in the KPI strip instead.

⑧ Quick Action Buttons

A row of shortcut buttons in the dashboard sidebar (or bottom strip on mobile) providing one-click access to the most frequently used student actions:

• Submit Assignment — Direct link to the assignments list
• Apply for Leave — Opens the leave application form
• View My Marks — Jumps to marks module
• View Attendance — Opens attendance detail view
• Submit Feedback — Shows pending feedback forms
• AI Insights — Opens the Academic Insights AI page

Data Flow Sequence

sequenceDiagram
    participant SYS as System
    participant PHP as Dashboard Engine
    participant STU as Student Browser

    PHP->>SYS: Fetch student profile
    SYS-->>PHP: Student record + enrolled class
    PHP->>SYS: Request all student metrics
    SYS-->>PHP: Attendance %, assignments, tests, notices, leaves
    PHP->>PHP: Compute urgency levels, filter pending items
    PHP-->>STU: Render KPI strip + timetable + panels
    STU->>PHP: Click "Take Test" → redirect to secure test page
    STU->>PHP: Click "Submit Assignment" → file upload form