Examinations & Question Paper Management

A fully governed, end-to-end Question Paper Management System (QPMS) — from paper pattern definition and teacher allocation, to paper submission, HOD review, approval, and secure archival. This documentation covers all pages under admin/papers/. Every examination paper produced by this system is traceable, version-controlled, and fully accountable.

graph LR
    A[Exam Coordinator
Issues HOD Allocation] --> B[allocate-to-teachers.php
HOD Sub-Allocates to Teachers]
    B --> C[Teacher Portal
Teacher Prepares & Submits Paper]
    C --> D[review-submissions.php
HOD Reviews Pending Papers]
    D -->|Approve| E[approved-papers.php
Approved Paper Archive]
    D -->|Send Back| C
    E --> F[download_paper.php
Secure Download]
    G[patterns.php
View Paper Patterns] --> B
    H[paper-allocations.php
All Allocations Overview] --> D
    

How the System Works — The Full Chain

The Question Paper Management System operates on a strict three-tier chain of command:

Page 1: View Paper Patterns (`admin/papers/patterns.php`)

The pattern library — a read-only reference page showing all active examination paper formats that have been defined and approved for use. HODs use this to understand the exact structure teachers must follow when preparing papers.

• Three Pattern Types:
  The system supports three distinct ways a paper format can be defined:
  • Template: A fully structured digital format — total marks defined, number of questions fixed, marks per question specified. Teachers fill their paper within this rigid, pre-validated structure.
  • Manual: A free-text pattern description that provides broad guidelines (e.g., "5 questions of 20 marks each") without strict digital enforcement.
  • File: A downloadable physical document (PDF or Word) that teachers download, print, and use as a reference format guide.
  Core Benefit: Template-type patterns are the most powerful — they automatically validate that a teacher's submitted paper matches the exact mark distribution required, preventing papers that are under or over-marked from being submitted.
• Instant Pattern Preview:
  Each pattern in the list has an eye button. Clicking it opens an overlay panel that displays the complete question structure — all sections, question numbers, mark allocations, and any special instructions — without leaving the page.
• HOD-Scoped View:
  HODs see only the patterns that are relevant to the papers assigned to their department — not all patterns in the system. This keeps the interface focused and prevents confusion across departments.

Page 2: HOD Allocation Manager (`admin/papers/allocate-to-teachers.php`)

The central HOD command center for paper preparation management. This is where the HOD receives assignments from the Exam Coordinator and distributes individual subject papers to specific teachers under their management.

• Three-Stage Allocation Status Tracking:
  Every assignment the HOD receives from the Exam Coordinator moves through three visible stages:
  • Pending — Received from EC, not yet sub-allocated to any teacher.
  • Allocated — Distributed to one or more teachers. Teachers can now see and work on their papers.
  • Completed — All assigned teachers have submitted their papers and the papers have been approved.
  Core Benefit: The HOD always has a live, visual snapshot of their department's examination preparation readiness — which papers are pending action, which are in progress, and which are fully done.
• Internal vs. External Paper Classification:
  Every assignment is tagged as either Internal (departmental assessment) or External (university-level examination). These are colour-coded differently in the list, ensuring the HOD never accidentally allocates a university paper to a teacher who should only be preparing departmental papers.
• Smart Filter Bar:
  The HOD can instantly narrow down the allocation list by Academic Year, Semester, and Status. The system automatically defaults to showing the most recent academic year's assignments first, preventing the HOD from working with outdated records.
• Sub-Allocation with Subject-Teacher Pairing:
  Clicking "Allocate" on a pending item opens a structured modal form. The HOD can add multiple teacher-subject rows, assigning different subjects within the same paper task to different teachers. The form shows only teachers who are under the HOD's direct management — it is impossible to accidentally assign to a teacher from another department.
  Core Benefit: A single EC assignment for "TY-BCA Semester 5 Exam" can be split across multiple teachers — Teacher A gets Physics, Teacher B gets Maths — in a single allocation session. This mirrors the real-world workflow where one exam requires multiple question papers from different subject experts.
• Existing Allocations Panel:
  When modifying an already-allocated task, the modal shows a separate "Existing Allocations" section listing all teachers already assigned. This prevents accidental duplication — the HOD can see what is already done before adding new rows.
• Live Pattern Viewer:
  An eye icon next to each pattern name in the allocation list lets the HOD view the complete paper structure without navigating away, so they can verify it before assigning to a teacher.
• Deadline Visibility:
  Every allocation row displays the submission deadline set by the Exam Coordinator in clear date format. The modal also prominently shows the deadline in red to ensure teachers are fully aware of the cutoff before the HOD finalizes the assignment.

Page 3: Review Pending Submissions (`admin/papers/review-submissions.php`)

The HOD's quality control inbox. Every paper a teacher submits for review lands here. The HOD reads the paper, assesses it against the pattern, and makes a formal decision.

• Focused Pending-Only View:
  This page exclusively shows papers that are actively waiting for a decision. Papers already approved or sent back are removed from this queue, keeping the HOD's attention strictly on unresolved submissions.
  Core Benefit: Eliminates review fatigue. The HOD never needs to filter or search — the page is always a clean, focused list of exactly what needs their attention right now.
• In-Browser Paper Rendering:
  For template-type papers, clicking "View" renders the complete question paper directly inside the portal in a scrollable preview panel — no file download, no external application. The HOD can read the full paper in-context.
  For file-type and manual-type papers, clicking "View" opens the uploaded document in a new browser tab for direct inspection.
• Approve or Send Back — With Comments:
  The HOD has two actions available for each paper:
  • Approve: Moves the paper to the approved archive. The allocation status updates to reflect completion. The paper becomes available in the approved paper library immediately.
  • Send Back: Returns the paper to the teacher for corrections. The HOD can add written feedback explaining exactly what needs to change. The teacher is notified and the allocation reverts to an editable state for re-submission.
  Core Benefit: Every review decision — approval or rejection — is permanently recorded with a timestamp and optional comments. This creates an unbreakable paper trail for institutional audits, NAAC inspections, and grievance resolution.
• Teacher Identity Display:
  Each submission shows the teacher's name with an initial avatar. The HOD can see at a glance who prepared which paper — critical in departments with many faculty members submitting simultaneously.

Page 4: Approved Papers Archive (`admin/papers/approved-papers.php`)

The permanent, searchable repository of all examination papers that have completed the review process. This is the institutional record of approved examination content.

• Multi-Dimensional Search & Filter:
  The archive supports simultaneous filtering by Academic Year, Semester, Pattern Type (Template / File / Manual), and a free-text search across teacher name, subject name, and class name. All filters can be combined, enabling precise retrieval even from a library of hundreds of papers.
  Core Benefit: Finding any approved paper — even from three academic years ago — takes seconds. The search capability makes this archive genuinely useful for reference, rather than a passive dump of records.
• Dual Timestamps per Paper:
  Each entry shows both the original submission date (when the teacher uploaded) and the approval date (when the HOD approved). This dual dating makes the review turnaround time visible, supporting process improvement and accountability tracking.
• In-Browser Viewing:
  Template-type approved papers can be viewed directly within the portal in a rendered, formatted preview. The preview shows the complete question structure with question numbers, sub-questions, and mark allocations in a clean, print-optimized layout.
• Secure Paper Download:
  Template-type papers can be downloaded as formatted documents via a dedicated download handler. The download process validates the requester's authorization before serving the file, ensuring only authorized personnel can obtain question paper content.
  Core Benefit: Approved question papers are never directly accessible via public file paths. Every download is gated through the authorization system, preventing unauthorized access to confidential examination content.
• Paginated for Large Archives:
  The archive displays up to 50 papers per page with intelligent pagination controls. For large departments with years of records, the HOD is never overwhelmed by a single massive, unnavigable list.
• Department-Scoped Records:
  HODs see only the approved papers belonging to their department. Papers from other departments are never visible, maintaining strict data confidentiality across the institution.

Page 5: All Allocations Overview (`admin/papers/paper-allocations.php`)

A comprehensive list of every paper allocation the HOD's department is involved in — covering all statuses and all academic years. Primarily used for retrospective auditing and status tracking.

• Full Allocation History:
  Unlike the Review page (which shows only pending items), this page shows every allocation — Pending, Allocated, Approved, Sent Back, and Completed — in one searchable view. It is the complete department-wide record of all paper preparation activity.
• Quick Navigation to Review:
  Papers with pending review status have direct action links that navigate to the Review Submissions page with that specific paper pre-selected, eliminating extra navigation steps during busy review periods.

The Complete Paper Lifecycle

Every question paper moves through a defined sequence of stages. The system enforces this order — no stage can be skipped:

Security & Confidentiality Architecture

The examination paper management system applies multiple layers of access control to ensure the highest level of confidentiality for sensitive exam content:

• Role-Based Access at Every Step:
  HODs can only view, allocate, review, and download papers belonging to their own department. The Exam Coordinator sees all departments. Teachers see only their own assigned papers. These restrictions are enforced independently on every single page — no single URL can be guessed to bypass them.
• Gated File Downloads:
  Approved papers are not stored at publicly accessible file paths. Every download request passes through an authorization handler that verifies the requester's identity and role before serving any file. Direct URL access to the file storage location is blocked.
• Immutable Review Records:
  Once a review action (Approve or Send Back) is recorded, the decision and its timestamp are permanently stored. No one can retroactively alter or delete a review decision, ensuring full accountability for who approved what and when.
• Transaction Safety:
  All allocation operations are wrapped in protected transaction blocks. If any part of an allocation or approval fails, the entire operation is rolled back to its previous state — preventing partial saves that could leave data in an inconsistent state.
  Core Benefit: The examination paper system is designed to meet institutional and university audit requirements. Every action — allocation, submission, review, approval — is permanently recorded, timestamped, and attributable to a specific user.