Assignment Submission
The Assignment module is the student's digital submission desk — view all active assignments, upload files, track evaluation status, and read teacher feedback, all from one place.
1. Assignment List View
A tabbed list of all assignments from all subjects assigned to the student's class. Sorted by submission deadline (earliest first).
1.1 Tab Filters
- All: Every assignment in the system for this class.
- Pending: Assignments where the student has not yet submitted.
- Submitted: Assignments where the student's file has been uploaded.
- Graded: Assignments where the teacher has entered marks and feedback.
- Late: Assignments where the student submitted after the deadline.
1.2 Assignment Card Columns
| Column | Content |
|---|---|
| Subject | Subject name and short code (e.g., "Data Structures — CS301") |
| Title | Assignment title. Click to expand full description and instructions. |
| Teacher | Who assigned the work |
| Due Date | Deadline with countdown badge (e.g., "2 days left" in amber, "Overdue" in red) |
| Max Marks | Total marks this assignment is worth |
| Status / Action | Submit button (if pending) or status badge (Submitted / Graded / Late) |
2. Submitting an Assignment
Clicking "Submit" on any pending assignment opens an inline submission panel (no page redirect).
2.1 Submission Form Fields
- File Upload: Drag-and-drop or click-to-browse file picker. Accepted formats: PDF, DOC, DOCX, ZIP, JPG, PNG. Max file size: 10 MB.
- Student Note (optional): A short text field for the student to add a note to the teacher (e.g., "Submitted with minor corrections on page 5").
- Submit Button: Shows a progress bar during upload. On success, the status changes to "Submitted" immediately.
2.2 After Submission
- Confirmation Toast: A green toast notification confirms successful submission with a timestamp.
- File Preview Link: The submitted file name is shown as a clickable link — students can re-open and verify what was uploaded.
- Re-submission: If the teacher returns the assignment for revision, the student can re-upload. The original file is preserved in the system's audit log.
- Late Flag: If submission happens after the deadline, the system automatically adds a "Late" badge to the submission. The teacher sees this when reviewing.
3. Viewing Graded Assignments
After a teacher grades a submission, the student's assignment card updates to show the result.
- Marks Received: e.g., "18 / 25 marks" displayed prominently.
- Teacher Feedback: The teacher's written evaluation comment is shown below the marks in a styled blockquote.
- Grade Badge: If the teacher entered a grade (A/B/C/etc.) in addition to marks, it appears as a colored badge.
- Download Graded File: If the teacher returned an annotated version of the file, the student can download it.
4. Assignment Details Modal
Clicking the assignment title expands a modal showing full details:
- Full Instructions: The complete assignment description entered by the teacher, including formatting.
- Reference Files: Any files the teacher attached as reference material (e.g., sample format, PDF handout).
- Rubric: Marks breakdown if the teacher defined a rubric (e.g., 10 marks for content, 8 for formatting, 7 for presentation).
- Class Submissions Summary: Aggregate count — "32 out of 48 students have submitted" — so students know where they stand relative to classmates.
Benefit: No more physical submission queues or misplaced files. Students submit from anywhere, any time, with an instant receipt. Teachers receive organized, timestamped digital submissions — eliminating the chaos of paper bundles handed in at the last minute.
Assignment Submission Flow
sequenceDiagram
participant STU as Student
participant PHP as Assignments Engine
participant SYS as System
participant TCH as Teacher Panel
STU->>PHP: Click "Submit" on assignment
PHP-->>STU: Show inline upload form
STU->>PHP: Upload file + optional note
PHP->>PHP: Validate file type, size, deadline
PHP->>SYS: Record assignment submission
SYS-->>PHP: Success
PHP-->>STU: Confirmation toast — "Submitted successfully"
Note over TCH: Teacher sees submission in their review queue
TCH->>SYS: Save marks and feedback
SYS-->>PHP: Status updated to 'graded'
PHP-->>STU: Assignment card shows "Graded — 18/25"
Overall Benefit: The Assignment module replaces physical submission queues, email attachments, and untracked paper submissions. Students know exactly what to submit, when to submit, and can verify their submission was received. The grading feedback loop reduces student uncertainty about their performance.