Student Module

Location: backend/src/student/

The student module manages student records for a school. Students are the core entities who get enrolled in classes, assigned to subjects, and graded on assessments.

Files

File	Purpose
student.module.ts	Module definition
student.controller.ts	API endpoints
student.service.ts	Business logic
dto/create-student.dto.ts	Validation for creation
dto/update-student.dto.ts	Validation for updates

Data Model

Students are stored in the student schema (not public).

Field	Type	Description
id	UUID	Primary key
first_name	string	Student's first name
last_name	string	Student's last name
gender	string	Student's gender
date_of_birth	date?	Optional date of birth
school_id	UUID	The school the student belongs to
is_active	boolean	Whether the student is currently active
enrollement_date	date?	Optional enrollment date

API Endpoints

All endpoints require AuthGuard. Students are automatically scoped to the user's school.

GET /api/students

Returns all students for the user's school.

Query Parameters:

Param	Required	Description
search	No	Search by first or last name (case-insensitive partial match)

Response: Array of student objects.

---

GET /api/students/:id

Returns a single student by ID.

---

POST /api/students

Creates a new student. The school is determined from the authenticated user's profile.

Body:

{
  "firstName": "Jane",
  "lastName": "Doe",
  "gender": "female",
  "dateOfBirth": "2015-03-15",
  "enrollementDate": "2025-09-01"
}

Field	Required	Notes
firstName	Yes
lastName	Yes
gender	Yes
dateOfBirth	No
enrollementDate	No

Error Handling:

• Duplicate name within the same school → 409 Conflict

---

PATCH /api/students/:id

Updates a student. All fields are optional, plus isActive can be toggled.

Body:

{
  "firstName": "Jane",
  "isActive": false
}