Akhbar Elyom Academy Icon

Akhbar Elyom Academy

Student Portal Mobile App

Published on Google Play
View App

Project Overview

An official student portal app for Akhbar Elyom Academy, enabling students to securely access their academic summaries, GPA metrics, and detailed course results from their mobile device.

Akhbar Elyom Academy is a full-stack mobile application built to serve as the go-to academic companion for thousands of students across the academy's Credit and Semester study systems. The app provides real-time access to student dashboards, GPA tracking, semester results, carried subjects, and financial clearance status. All protected by JWT-based authentication and encrypted local storage. The backend acts as a secure abstraction layer over a legacy PostgreSQL database, transforming raw data into clean, structured payloads for the mobile client.

Project Stats

Store Rating 4.9
Installs 3,000+
Duration Jun 2025 - Present

Key Features

  • Secure student login with JWT authentication
  • Real-time academic dashboard with GPA & credit hours
  • Detailed course-level results & grades
  • Dual study system support
  • Financial clearance status checks
  • Full Arabic & English localization
  • Encrypted local token storage
  • Offline data caching
  • Over-the-Air updates via Shorebird
  • Crash reporting & performance monitoring

Technologies Used

Flutter
Python
FastAPI
PostgreSQL / Supabase
Firebase
Cloudflare
Linux VPS (Hosting)
Git & GitHub

Screenshots

Akhbar Elyom Academy Login Screen Screenshot Akhbar Elyom Academy Dashboard Screenshot Akhbar Elyom Academy Results View Screenshot Akhbar Elyom Academy Course Details Screenshot

Technical Implementation

My technical contributions to this project include (but may not be limited to):

  • Architected the mobile client with Flutter using the MVVM pattern and Provider for state management, enforcing strict separation between Views, ViewModels, and Repositories.
  • Designed and built a FastAPI (Python) backend serving as a secure abstraction layer over a legacy PostgreSQL/Supabase database, with fully async endpoints using SQLAlchemy and asyncpg.
  • Implemented stateless JWT authentication with bcrypt password hashing, encrypted token storage via flutter_secure_storage, and automatic Dio interceptors for Bearer token injection.
  • Built a polymorphic dual study system engine that dynamically routes data processing and UI rendering, supporting both Credit System (GPA, hours, points) and Semester System (levels, grades, percentages) profiles.
  • Enforced multi-layered access control including financial clearance lockouts, administrative visibility gating, and rate-limited endpoints for brute-force protection.
  • Implemented full Arabic-first localization with Flutter's .arb framework and RTL-safe directional layouts for seamless Arabic/English switching.
  • Integrated Firebase Analytics, Crashlytics, Performance Monitoring, and Remote Config for real-time observability and dynamic feature management without app updates.
  • Configured Supabase with PgBouncer connection pooling and a query timeout to handle concurrent load spikes during peak grade publishing periods.
  • Deployed the backend on a Linux VPS with Nginx & PM2 for process management and Cloudflare for API tunneling, DDoS protection, SSL termination, and CDN caching.
  • Enabled Over-the-Air updates via Shorebird, allowing instant Dart-level patches to be pushed to users without requiring a full Play Store release cycle.
  • Built a global exception shielding pipeline that logs full stack traces server-side while returning sanitized, localized error messages to the client — preventing any internal database schema details from leaking.