Orbit Edu Guardian Self-Service Portal, Live Turnstile Event Stream & Academic Desk

1. System Topology & Architectural Ingress

The Guardian Self-Service Portal is implemented in apps/edu/src/app/portal/page.tsx and supported by backend customer proxy layers. It operates as a responsive web and mobile application designed to connect guardians directly to campus event streams and financial ledgers.

+----------------------------------------------------------------------------------------------------+
|                                  GUARDIAN SELF-SERVICE ARCHITECTURE                                |
|                                                                                                    |
|   +-----------------------+     +-----------------------+     +--------------------------------+   |
|   |  MULTI-CHILD SWITCHER |     |  TURNSTILE EVENT BUS  |     |   BURSAR & FINANCIAL HUB       |   |
|   |  - Enrolled Siblings  |     |  - Sub-Second RFID    |     |   - 12-Digit 1Bill Consumer ID |   |
|   |  - Class & Roll Num   |     |  - Gate Timestamp     |     |   - 3-Part Bank Challan PDF    |   |
|   |  - Historical GPA     |     |  - Ingress / Egress   |     |   - Online Settle Modal        |   |
|   |  - Attendance Metrics |     |  - Arrival Status     |     |   - Payment Verification Stat  |   |
|   +-----------+-----------+     +-----------+-----------+     +---------------+----------------+   |
|               |                             |                                 |                    |
|               +----------------------+      |      +--------------------------+                    |
|                                      |      |      |                                               |
|                                      v      v      v                                               |
|                      +-----------------------------------------------+                             |
|                      |             GUARDIAN PORTAL CONSOLE           |                             |
|                      |          apps/edu/src/app/portal/             |                             |
|                      |                  page.tsx                     |                             |
|                      +-----------------------+-----------------------+                             |
|                                              |                                                     |
|                      +-----------------------+-----------------------+                             |
|                      |                                               |                             |
|                      v                                               v                             |
|   +------------------------------------+   +---------------------------------------------------+   |
|   |     EXAMINATION & MARKSHEETS       |   |             HOMEWORK & DIARY DESK                 |   |
|   |   - Terminal Report Cards          |   |   - Daily Subject Homework Logs                   |   |
|   |   - Broadview Academic Transcripts |   |   - Teacher Remarks & Circulars                   |   |
|   |   - Position Ranks & Letter Grades |   |   - Urgent Campus Closure Bulletins               |   |
|   +------------------------------------+   +---------------------------------------------------+   |
+----------------------------------------------------------------------------------------------------+

1.1 Client Data Schema

The portal maintains state for all children associated with the authenticated guardian's national identity number (CNIC):

export interface EnrolledChild {
  id: string;
  name: string;
  admissionNumber: string;
  rollNumber: string;
  className: string;
  sectionName: string;
  gender: string;
  attendanceRate: number;
  todayStatus: 'PRESENT' | 'ABSENT' | 'LATE';
  arrivalTime: string;
  gateName: string;
  monthlyFee: number;
  feeStatus: 'UNPAID' | 'PAID' | 'PAYMENT_PENDING_VERIFICATION';
  dueDate: string;
  consumerId: string;
  challanId?: string;
  latestGpa: number;
  latestGrade: string;
  classRank: string;
}

2. Interactive Operator Interface

The Guardian Mobile Portal provides parents with real-time arrival feeds, rapid payment shortcuts, and academic progress updates:

3. Sub-Second Turnstile Ingress Event Streaming

When a student scans their RFID credential at an entry turnstile, the event propagates from the edge kiosk to the guardian portal:

4. Financial Ergonomics: 1Bill Copy & Settle Fee Workflows

The portal streamlines parental fee settlements through commercial banking and integrated card gateways:

4.1 12-Digit 1Bill Copy Mechanics

To eliminate manual typing errors in mobile banking applications (such as Meezan Bank, HBL, or JazzCash), the portal renders a 1-click clipboard copy utility:

ConsumerNumber = BillerPrefix + PadZeroes(ExtractDigits(AdmissionNumber), 6)

Clicking Copy ID copies 100829000001 into the mobile clipboard and displays a visual confirmation toast: 1Bill Consumer Number Copied.

4.2 Online Digital Fee Settlement Modal

Parents who prefer settling dues via Visa, Mastercard, or digital wallets can open the integrated PortalPaymentModal. The workflow executes:

1. Transaction Initialization:
   • The portal requests a cryptographic payment session token from the billing backend.
2. Payment Processing:
   • The parent completes payment authorization.
3. Instant Ledger Advancement:
   • The payment gateway returns an encrypted confirmation payload.
   • The server marks the challan as PAID.
   • The portal immediately updates the status badge from red UNPAID to emerald PAID, releasing any financial holds.

5. Architectural Verification & Throughput Telemetry

The portal event streaming and API layers are benchmarked under concurrent morning check-in loads:

6. Failure Modes & Recovery SOP

The following operational contingency protocols resolve portal and notification exceptions:

7. Cross-Vertical Internal Linkages

The guardian portal coordinates with all key academic and administrative modules:

• Composite Fee Challans & 1Bill Integration — Powers 12-digit consumer number generation and vector 3-part bank challan downloads.
• RFID Turnstile Gate Kiosk & Tardiness Escalation — Streams real-time gate attendance timestamps and tardiness warnings to the portal.
• BISE Tabulation Gazette & Examination Broadsheets — Displays verified term examination marks, letter grades, and GPA summaries.
• Pastoral Conduct Scoring & Detention Proctoring — Shares student conduct standing, commendation badges, and detention notices.
• School Transport Fleet Telemetry & Route Stoppages — Shows vehicle route assignments, stop schedules, and transit fee allocations.