Marks & Results

The Marks module gives students transparent, real-time access to internal marks, component-wise breakdowns, final results, and a digital grievance system.

1. Internal Marks Overview

Subject-wise view of all internal marks entered by teachers and approved by the HOD for the current semester.

One Card per Subject: Shows all mark components (Internal Exam, Assignment, Viva, Practical) with Marks Obtained / Max Marks and percentage per component.
Status Indicators: Published (visible to student), Pending (teacher hasn't submitted yet), Draft (entered but not yet shared by HOD).
Total Summary Bar: Aggregate marks across all components with overall percentage.
Semester Filter: View marks from previous semesters and academic years.

2. Final Result Card

The consolidated marksheet — all subjects together for a given examination term.

Column	Description
Subject	Subject name and code
Internal / External / Practical	Marks per component category
Total	Sum across all components
Grade	Auto-computed letter grade (O / A+ / A / B / C / F)
Result	Pass / Fail per subject

Overall Summary: Total Marks, Percentage, Aggregate Grade, and Pass/Fail result at the bottom.
Download PDF: Students can download a styled PDF of the result card.

3. Marks Grievance

Raise a formal grievance if marks appear incorrect — without visiting the office.

Form Fields: Subject, Component, Current Marks (auto-filled), Expected Marks, Reason, Supporting Document (optional attachment).
Deadline Enforced: Grievances can only be filed within the HOD-configured window (e.g., 5 days after marks are published). Form is disabled outside this window.
One Per Component: No duplicate grievances for the same subject/component.

4. Track My Grievances

Status Timeline: Pending → Teacher Reviewed (Accepted / Rejected) → Escalated to HOD (optional) → Final Resolution.
Escalation: If the teacher rejects, the student can escalate to HOD for a final ruling — one escalation per grievance.
Marks Auto-Update: When a grievance is accepted, marks are corrected in the system automatically and the result card reflects the change.

Benefit: The digital grievance system eliminates long office queues during result season. Every dispute is tracked, documented, and audited — protecting both students and teachers with a full paper trail.

Grievance Resolution Flow

sequenceDiagram
    participant STU as Student
    participant TCH as Teacher Panel
    participant HOD as HOD Panel
    participant SYS as System

    STU->>SYS: Submit grievance (subject, component, expected_marks, reason)
    SYS-->>TCH: Appears in teacher's review queue
    TCH->>SYS: Accept (update marks) OR Reject (with reason)
    alt Accepted
        SYS-->>STU: Status = "Accepted", marks updated
    else Rejected
        SYS-->>STU: Status = "Rejected" + rejection reason
        STU->>SYS: Escalate to HOD
        HOD->>SYS: Final ruling
        SYS-->>STU: Final status updated
    end