​

SKOLE-ADMN — Admission Form Module

​

1. Overview

​

Scope In

• Multi-step admission: student info → parent/guardian info → address info
• Public endpoints (no JWT) so prospective parents can submit
• Edit each section individually after initial submission
• Grade lookup and student info lookup by roll_no

​

Scope Out

• Payment collection during admission
• Document upload (birth certificate, ID proof)

​

2. Requirements

​

Functional Requirements (FR)

• SKOLE-ADMN-FR001: The module shall allow any user with a school link to submit an admission form without requiring authentication.
• SKOLE-ADMN-FR002: The module shall capture comprehensive student, parent, guardian, and address information through a multi-step flow.
• SKOLE-ADMN-FR003: The module shall automatically create synchronized records in students, parent_details, student_guardian, and student_address tables upon submission.
• SKOLE-ADMN-FR004: The module shall allow admins to query submitted records by skole_id and roll number.
• SKOLE-ADMN-FR005: The module shall provide available grades for the school in a dynamic dropdown.
• SKOLE-ADMN-FR006: The module shall enable section-level updates for student, parent, guardian, and address info post-submission.

​

Non-Functional Requirements (NFR)

• SKOLE-ADMN-NFR001: The module shall perform as a public-facing gateway by marking all admission endpoints as @Public().
• SKOLE-ADMN-NFR002: The module shall behave reliably by identifying the target school via the skole_id provided in the query or form body.

​

Constraints

• C001: We must utilize database transactions during admission creation to ensure all related records (student, parent, guardian, etc.) are created atomically.
• C002: We must ensure the public form is stateless as it cannot rely on JWT-based sessions.

​

3. Sub-modules / Backlog

​

4. Logical Implementation

​

Admission Create Flow

POST /web-app/admission-form
  ├─ Input: { student: StudentDto, parent: ParentDetailsDto,
  │           guardian: StudentGuardianDto, address: StudentAddressDto }
  ├─ BEGIN TRANSACTION
  │    ├─ INSERT students (or find existing by roll_no)
  │    ├─ INSERT parent_details
  │    ├─ INSERT student_guardian
  │    └─ INSERT student_address
  └─ COMMIT → return { success, student_id, roll_no }

​

Grade Lookup

GET /web-app/grades?skole_id=
  --> SELECT DISTINCT grade FROM students WHERE skole_id = ?

​

5. UI Requirements

​

Web App — Admission Form

​

6. Conditional Expressions

​

7. Database Tables

​

8. API Endpoints