diff --git a/src/Modules/Examination/components/gradeSheetList.jsx b/src/Modules/Examination/components/gradeSheetList.jsx
new file mode 100644
index 000000000..b3acdb901
--- /dev/null
+++ b/src/Modules/Examination/components/gradeSheetList.jsx
@@ -0,0 +1,134 @@
+import { useState } from "react";
+import { Table, Button, Group, Modal, Alert } from "@mantine/core";
+import { IconEye, IconDownload, IconAlertTriangle } from "@tabler/icons-react";
+import axios from "axios";
+import { generate_full_gradesheet_data } from "../routes/examinationRoutes";
+import { buildFullGradeSheetHTML } from "./gradeSheetTemplate";
+import { saveGradeSheetPDF } from "./gradeSheetPdf";
+import styles from "../styles/transcript.module.css";
+
+export default function GradeSheetList({ students }) {
+ const [busy, setBusy] = useState({});
+ const [error, setError] = useState(null);
+ const [preview, setPreview] = useState({ open: false, html: "", title: "" });
+
+ const setRowBusy = (roll, v) => setBusy((p) => ({ ...p, [roll]: v }));
+
+ const fetchFullGradeSheetHtml = async (rollNo) => {
+ const token = localStorage.getItem("authToken");
+ const { data } = await axios.post(
+ generate_full_gradesheet_data,
+ { student: rollNo },
+ { headers: { Authorization: `Token ${token}` } },
+ );
+ if (!data.semesters || data.semesters.length === 0) {
+ throw new Error("No graded semesters found for this student.");
+ }
+ return buildFullGradeSheetHTML(data.student_info, data.semesters);
+ };
+
+ const handlePreview = async (student) => {
+ setRowBusy(student.id_id, "preview");
+ setError(null);
+ try {
+ const html = await fetchFullGradeSheetHtml(student.id_id);
+ setPreview({ open: true, html, title: `Grade Sheet — ${student.id_id}` });
+ } catch (err) {
+ setError(err.message || "Failed to load grade sheet.");
+ } finally {
+ setRowBusy(student.id_id, null);
+ }
+ };
+
+ const handleDownload = async (student) => {
+ setRowBusy(student.id_id, "download");
+ setError(null);
+ try {
+ const html = await fetchFullGradeSheetHtml(student.id_id);
+ await saveGradeSheetPDF(html, `GradeSheet_${student.id_id}.pdf`);
+ } catch (err) {
+ setError(err.message || "Failed to download grade sheet.");
+ } finally {
+ setRowBusy(student.id_id, null);
+ }
+ };
+
+ return (
+
+ {error && (
+
}
+ mb="md"
+ withCloseButton
+ onClose={() => setError(null)}
+ >
+ {error}
+
+ )}
+ {students.length > 0 ? (
+
+
+
+ Roll Number
+ Programme
+ Actions
+
+
+
+ {students.map((student) => (
+
+ {student.id_id}
+ {student.programme}
+
+
+
+
+
+ ))}
+
+
+ ) : (
+
No students found for this batch.
+ )}
+
+
setPreview((p) => ({ ...p, open: false }))}
+ title={preview.title}
+ size="90%"
+ >
+
+
+
+ ${esc(c.code || "")}
+ ${esc(c.name)}
+ ${esc(c.credits)}
+ ${esc(c.grade)}
+ ${esc(symbol)}
+ `;
+ })
+ .join("");
+
+ const semesterBlockHTML = (sem) => {
+ const label = semesterLabel(sem);
+ const isSpecialCourse = (c) => {
+ const g = String(c.grade ?? "").trim();
+ return g !== "" && !Number.isNaN(Number(g));
+ };
+ const hasSpecialCourses = sem.courses.some(isSpecialCourse);
+ const specialCourseCodes = sem.courses
+ .filter(isSpecialCourse)
+ .map((c) => c.code)
+ .join(", ");
+ return `
+
+
+ Roll No.
+ ${esc(studentInfo.roll_no)}
+ Programme
+ ${esc(studentInfo.programme)}
+
+
+ Student Name
+ ${esc(studentInfo.name)}
+ Discipline
+ ${esc(studentInfo.discipline)}
+
+
+ Semester
+ ${esc(label)}
+ Academic Year
+ ${esc(sem.academic_year)}
+
+
+
+
+
+ Course No.
+ Course Title
+ Unit
+ Grade
+ Special
+
+${courseRowsFor(sem.courses)}
+
+
+
+
+ Result
+ SPI ${Number(sem.spi || 0).toFixed(1)}
+ CPI ${Number(sem.cpi || 0).toFixed(1)}
+
+
+${hasSpecialCourses ? `*In ${esc(specialCourseCodes)} student is awarded SPI based on performance in various evaluation in place of grade.
` : ""}
+`;
+ };
+
+ const legendBlockHTML = () => `
+
+
+
+ Grading
+
+
+
+ O=10 (Distinguished)
+ A+=10 (Outstanding)
+ A=9 (Excellent)
+ B+=8 (Very Good)
+ B=7 (Good)
+
+
+ C+=6 (Average)
+ C=5 (Below Average)
+ D+=4 (Marginal)
+ D=3 (Poor)
+ F=2 (Very Poor)
+
+
+ I=0 (Incomplete)
+ S=0 (Satisfactory)
+ X=0 (Unsatisfactory)
+
+
+
+
+
+
+
+
+ Abbreviations
+
+ SPI : Semester Performance IndexCPI : Cumulative Performance IndexAU : Indicates that the course has been AuditedCD : Indicates that the course has been Dropped due to a shortage of attendance
+
+
+
+
+
+
+ Special
+
+ ‘R’ after letter grade indicates that the course has been Repeated‘S’ after letter grade indicates that the course has been Substituted
+
+
+
+
+
+
+ • Medium of instruction is English
+ • Conversion from CPI to Percentage using (CPI×10) % formula
+
+
+ Minimum Graduating CPI: ${minCpi}
+ Maximum Graduating CPI: 10.0
+
+
+ ${esc(completionText)}
+
+
+
${semesterBlockHTML(sem)}
`)
+ .join(semesterGapHTML);
+ return `
+${blocks}
+${isLastPage ? legendBlockHTML() : ""}
+${footerBlockHTML(pageIdx, pages.length)}
+
`;
+ };
+
+ return `
+Grade Sheet - ${esc(studentInfo.roll_no)}
+
+
+${pages.map(pageHTML).join("\n")}
+`;
+}
diff --git a/src/Modules/Examination/examination.jsx b/src/Modules/Examination/examination.jsx
index 29d611567..58aaa1077 100644
--- a/src/Modules/Examination/examination.jsx
+++ b/src/Modules/Examination/examination.jsx
@@ -19,6 +19,7 @@ const COMPONENTS = {
checkResult: lazy(() => import("./checkResult.jsx")),
announceResult: lazy(() => import("./AnnounceResult.jsx")),
generateTranscript: lazy(() => import("./generateTranscript.jsx")),
+ gradeSheet: lazy(() => import("./gradeSheet.jsx")),
};
const StudentTranscript = lazy(
diff --git a/src/Modules/Examination/gradeSheet.jsx b/src/Modules/Examination/gradeSheet.jsx
new file mode 100644
index 000000000..817b0c9be
--- /dev/null
+++ b/src/Modules/Examination/gradeSheet.jsx
@@ -0,0 +1,168 @@
+import { useState, useEffect } from "react";
+import {
+ Alert,
+ Card,
+ Paper,
+ Select,
+ Button,
+ Stack,
+ Group,
+ Box,
+ SimpleGrid,
+ LoadingOverlay,
+ Text,
+} from "@mantine/core";
+import axios from "axios";
+import { useSelector } from "react-redux";
+import GradeSheetList from "./components/gradeSheetList.jsx";
+import { generate_full_gradesheet_form } from "./routes/examinationRoutes.jsx";
+
+export default function GradeSheet() {
+ const userRole = useSelector((state) => state.user.role);
+ const [formData, setFormData] = useState({ batch: "", specialization: "" });
+ const [formOptions, setFormOptions] = useState({
+ batches: [],
+ specializations: [],
+ });
+ const [students, setStudents] = useState(null);
+ const [loading, setLoading] = useState(false);
+ const [error, setError] = useState(null);
+
+ useEffect(() => {
+ const fetchFormOptions = async () => {
+ const token = localStorage.getItem("authToken");
+ if (!token) {
+ setError("No authentication token found!");
+ return;
+ }
+ try {
+ setLoading(true);
+ const { data } = await axios.get(generate_full_gradesheet_form, {
+ params: { role: userRole },
+ headers: { Authorization: `Token ${token}` },
+ });
+ const batches = (data.batches || []).slice().sort((a, b) => {
+ const yearA = parseInt(
+ (a.label || "").match(/(\d{4})/g)?.pop() || 0,
+ 10,
+ );
+ const yearB = parseInt(
+ (b.label || "").match(/(\d{4})/g)?.pop() || 0,
+ 10,
+ );
+ return yearB - yearA;
+ });
+ setFormOptions({
+ batches: batches.map((batch) => ({
+ value: batch.id.toString(),
+ label: batch.label,
+ })),
+ specializations: (data.specializations || []).map((s) => ({
+ value: s,
+ label: s,
+ })),
+ });
+ } catch (e) {
+ setError(`Error fetching form options: ${e.message}`);
+ } finally {
+ setLoading(false);
+ }
+ };
+ fetchFormOptions();
+ }, [userRole]);
+
+ const handleChange = (field) => (value) => {
+ setFormData((prev) => ({ ...prev, [field]: value }));
+ setStudents(null);
+ };
+
+ const handleSubmit = async (e) => {
+ e.preventDefault();
+ const token = localStorage.getItem("authToken");
+ if (!token) {
+ setError("No authentication token found!");
+ return;
+ }
+ if (!formData.batch) {
+ setError("Please select a batch.");
+ return;
+ }
+ try {
+ setLoading(true);
+ setError(null);
+ const { data } = await axios.post(
+ generate_full_gradesheet_form,
+ {
+ Role: userRole,
+ batch: formData.batch,
+ specialization: formData.specialization || undefined,
+ },
+ { headers: { Authorization: `Token ${token}` } },
+ );
+ setStudents(data.students || []);
+ } catch (err) {
+ setError(`Error fetching students: ${err.message}`);
+ } finally {
+ setLoading(false);
+ }
+ };
+
+ return (
+
+
+
+ {error}
+
+ )}
+
+
+
+ Every semester a student has been graded in, one course table per
+ semester, paginated by Academic Year — the institute's official
+ multi-page grade sheet.
+
+
+
+
+ {students !== null && (
+
+
+ )}
+
+
+ );
+}
diff --git a/src/Modules/Examination/pages.js b/src/Modules/Examination/pages.js
index dd28dbfb1..1b0799c29 100644
--- a/src/Modules/Examination/pages.js
+++ b/src/Modules/Examination/pages.js
@@ -102,4 +102,12 @@ export const EXAMINATION_PAGES = [
group: null,
roles: [...ACAD, ...PROGRAMME_ADMIN_ROLES],
},
+ {
+ key: "gradeSheet",
+ slug: "grade-sheet",
+ title: "Grade Sheet",
+ icon: "FileText",
+ group: null,
+ roles: [...ACAD, ...PROGRAMME_ADMIN_ROLES],
+ },
];
diff --git a/src/Modules/Examination/routes/examinationRoutes.jsx b/src/Modules/Examination/routes/examinationRoutes.jsx
index 1e8535d69..bebcaf7c5 100644
--- a/src/Modules/Examination/routes/examinationRoutes.jsx
+++ b/src/Modules/Examination/routes/examinationRoutes.jsx
@@ -38,3 +38,5 @@ export const grade_status = `${host}/examination/api/grade_status/`;
export const grade_summary = `${host}/examination/api/grade_summary/`;
export const grade_validation = `${host}/examination/api/grade_validation/`;
export const submit_phd_milestone_grades = `${host}/examination/api/submit_phd_milestone_grades/`;
+export const generate_full_gradesheet_form = `${host}/examination/api/generate_full_gradesheet_form/`;
+export const generate_full_gradesheet_data = `${host}/examination/api/generate_full_gradesheet_data/`;
diff --git a/vite.config.js b/vite.config.js
index 438fa2ded..ea7b156dc 100644
--- a/vite.config.js
+++ b/vite.config.js
@@ -13,7 +13,7 @@ export default defineConfig(({ mode }) => ({
"/aims",
"/academic-procedures",
"/programme_curriculum",
- "/examination",
+ "/examination/api",
"/eis",
"/spacs",
"/media",