# CUST Student Portal & Academic Dashboard

> The official modern, high-performance Progressive Web App (PWA) academic portal for Capital University of Science and Technology (CUST) students. Provides real-time academic announcements, course materials, assignment deadlines, quiz schedules, digital file sharing, live telemetry, and offline-capable student tools.

- [Main Student Portal](https://mycust.pages.dev/): Unified dashboard displaying enrolled courses, live announcements, upcoming assignment deadlines, upcoming quiz schedules, and student view counters.
- [Course Drive & Materials Hub](https://mycust.pages.dev/drive.html): Structured subject repository containing course folders, syllabus details, textbook resources, lecture slides, and official academic links.
- [Academic Cloud Sharing Hub](https://mycust.pages.dev/share.html): Collaborative peer-to-peer and community resource sharing platform for class notes, past examination papers, code repositories, and study guides.
- [System & Service Status Monitor](https://mycust.pages.dev/status.html): Real-time health monitoring, Supabase database latency metrics, uptime statistics, and maintenance announcements.

## Platform Capabilities
- **Real-Time Academic Synchronization**: Instant updates on coursework, class notices, quizzes, and grade announcements powered by Supabase Realtime and PostgreSQL.
- **Offline-First Resilience**: Full IndexedDB caching and Service Worker storage enabling uninterrupted offline viewing of previously loaded coursework and announcements.
- **Progressive Web App (PWA)**: Installable on iOS (Safari Home Screen) and Android (Chromium Install Prompt) with native app-like fullscreen responsiveness and background updates.
- **Push Notifications**: Firebase Cloud Messaging (FCM) integration for instant alerts on critical deadline changes and new announcements.
- **Security & Privacy**: Zero third-party tracker policy, authenticated student sessions, granular RLS access controls, and rate-limited API protection.

## Core Pages & Endpoints
- `https://mycust.pages.dev/`: Dashboard home for enrolled students.
- `https://mycust.pages.dev/drive.html`: Course drive materials and syllabus documents.
- `https://mycust.pages.dev/share.html`: Student study files and past paper sharing hub.
- `https://mycust.pages.dev/status.html`: Live uptime, latency, and system operational metrics.
- `https://mycust.pages.dev/sitemap.xml`: Complete search engine indexing sitemap.