Academiax Dashboard

Smart Academic Management System — Admin Panel

A secure, enterprise-grade Flutter Web dashboard for university user management.

---

🎥 Demo Video

Showcasing Optimistic UI interactions, authentication, user management, role transitions, and responsive interface.

---

📋 Table of Contents

🔷 Overview

	Section
📌	About the Project	Overview
🚀	Key Capabilities	Highlights

⚙️ Technical

	Section
🏗	Architecture	MVVM · Repository
📂	Project Structure	lib/ tree
🔐	Authentication & Security	Dual JWT · Token Refresh
🌐	Network Layer	Dio · Interceptors
🧠	State Management	Cubit · BLoC
🧭	Routing	go_router
🛠	Tech Stack	Packages & Plugins

📦 Resources

	Section
📸	System Showcase	Screenshots
📊	Dashboard Capabilities	User Management · Data Tables
📱	Responsive Design	Web · Tablet · Desktop
🧪	Scalability & Extensibility	Future Expansion
🔗	Related Repositories	Flutter · NestJS · Python
👥	Contributors	2 contributors
🏆	Conclusion	Summary

---

📌 About the Project

The Academiax Administrative Dashboard is a secure, role-based web platform engineered to centralize university user management for System Administrators. Designed for enterprise-scale usage, the system emphasizes security, performance, and extensibility, while delivering a clean, intuitive, and responsive administrative experience.

A key UX enhancement is the integration of Optimistic UI, enabling instant feedback for user actions such as role changes, activation/deactivation, and data updates — even before the server confirms the operation. This ensures a smooth, seamless experience for administrators, particularly when working with large datasets.

---

🚀 Key Capabilities

• 👥 User Lifecycle Management: Create, activate, deactivate, and maintain accounts for students, instructors, and staff.
• 🔐 Secure Authentication & Session Handling: Enforce enterprise-grade JWT-based login with dual-token logic and session persistence.
• 🔄 Dynamic Role Assignment & Optimistic UI: Seamlessly assign, modify, and manage user roles with immediate interface feedback, improving workflow efficiency.
• 🔍 Advanced Data Control: Efficiently search, filter, and paginate large datasets with real-time updates.
• ⚙️ Enterprise-Scale Optimization: Designed for scalability, maintainability, and high-performance operations across Web, Tablet, and Desktop platforms.

This platform serves as a centralized control hub, enabling administrators to manage users efficiently while maintaining the highest security, usability, and responsiveness standards.

---

🏗 Architecture

The application strictly follows MVVM principles combined with the Repository Pattern for full data-source abstraction and testability.

💻 Presentation Layer → Flutter UI + Cubits (ViewModels)
⚙️ Core Layer         → Network, Caching, Error Handling, Utilities

Architectural Highlights

• Feature-based modular structure
• Repository pattern with abstraction
• Decoupled business logic
• Scalable and test-friendly design
• Centralized error handling

---

📂 Project Structure

lib/
├── core/
│   ├── cache/
│   ├── errors/
│   ├── network/
│   │   └── interceptors/
│   ├── utils/
│   └── widgets/
└── features/
    ├── auth/
    └── home/

Core Layer

Contains shared infrastructure:

• 🌐 Network abstraction (Dio + interceptors)
• 🔒 Secure & local storage
• 🛠 Error handling & logging
• 🧭 Routing configuration
• 🎨 Theming & reusable widgets

Features Layer

Each feature contains:

• data/ → models & repository implementations
• presentation/ → Cubits & UI

---

🔐 Authentication & Security

Dual JWT Token Strategy

The system implements a secure Access/Refresh token mechanism.

🔁 Automated Token Refresh Flow

1. API returns 401 Unauthorized
2. AuthInterceptor intercepts the error
3. Refresh token request is triggered
4. Failed requests are queued
5. New access token is stored securely
6. All queued requests are retried automatically

Security Enhancements

• 🔒 Flutter Secure Storage → Sensitive token storage
• ⚡ GetStorage → Lightweight fast caching
• 🧠 Concurrent-safe refresh logic (prevents multiple refresh calls)
• 🛡 Automatic session invalidation if refresh fails

This ensures uninterrupted user experience with maximum security.

---

🌐 Network Layer

Built on Dio with layered interceptors:

• AuthInterceptor
• RetryInterceptor
• HeaderInterceptor
• Logging Interceptor
• Network Connectivity Interceptor

Features:

• Centralized error mapping
• Automatic retry handling
• Clean API abstraction via ApiConsumer
• Reduced boilerplate across repositories

---

🧠 State Management

Uses flutter_bloc (Cubit) for:

• Predictable state transitions
• Clear loading/success/error flows
• Decoupled UI from business logic
• Efficient rebuild management

Each feature maintains isolated Cubits for scalability.

---

🧭 Routing

Declarative routing using go_router.

• Protected authenticated flows
• Shared layout using ShellRoute
• Clean separation between Auth and Dashboard routes
• Role-based navigation support

---

🛠 Tech Stack

Category	Technology
Framework	Flutter Web
Architecture	MVVM + Repository Pattern
State Management	flutter_bloc (Cubit)
Networking	Dio
Routing	go_router
Local Storage	Flutter Secure Storage, GetStorage
Data Tables	data_table_2
Responsiveness	flutter_screenutil
CI/CD	Automated Pipeline

---

📸 System Showcase

Visual overview of the SAMS Admin Dashboard, highlighting core modules, Optimistic UI interactions, and enterprise-grade workflows.

---

📊 Dashboard Capabilities

👥 User Management

Administrators can:

• Create new users
• Activate/Deactivate accounts instantly
• Dynamically switch user roles (e.g., Student ↔ Instructor)
• Perform global search
• Filter by role & status
• Navigate paginated high-density data tables

📋 Data Table Features

• Optimized for web
• Dynamic pagination
• Inline role modification
• Status badges
• High-performance rendering

---

📱 Responsive Design

Buil