VEDV One app, four roles, turning

VEDV

One app, four roles, turning printed textbooks into a connected school platform. Overview

VEDV is a Flutter app (iOS, Android, web/desktop) that serves as VEDV Publication's all-in-one school platform. From a single codebase it presents four different experiences based on login , Student, Teacher, School Admin, or Guest/Parent with UI gated by role flags. At its core, it turns printed textbooks into connected digital lessons: students scan a QR code on a physical book and land directly on the matching video, PDF, quiz, or test. Around that sits a full learning library, three Gemini-powered AI assistants, and a School Hub that auto-generates school documents all layered over one educational-safety policy that keeps AI responses age- and subject-appropriate.

For teachers and admins, the same app doubles as a school-operations backbone: attendance, marks, marksheet and ID-card generation, certificates, fees, notices, calendars, and real-time 1:1 chat. The Problem

Schools run on disconnected tools one system for content, another for attendance, spreadsheets for fees, WhatsApp for parent updates with no link between a printed textbook and any digital follow-up. A publisher's book is a dead end once printed. The result is duplicated data entry and no single, trustworthy view into a child's attendance, results, or fees. VEDV bridges that gap: one role-aware app where the QR scan turns a static book into an interactive lesson, and the same platform runs the school's day-to-day operations so content and operations reinforce each other instead of living in silos. Key Features

QR Book Scan — Scans a printed textbook's QR code and opens the exact matching content (video, PDF, quiz, audiobook), filtered by role, students see learning material, teachers additionally get lesson plans and answer keys.

AI Assistant with Chapter-PDF & Multi-Format Export (Unique) — Type, speak, or photograph a question; the AI answers grounded in the actual chapter PDF and can export a real downloadable worksheet, lesson, or presentation as PDF, PowerPoint, or Word.

School Hub AI Design Generator (Unique) — Describes a poster, ID card, or notice in plain language, asks smart follow-up questions, then generates a print-ready design using the school's real logo and brand colors.

STEAM-L AI Tutoring Suite (Unique) — Six subjects (Science, Tech, Engineering, Arts, Math, Languages), each with an AI tutor, auto-generated quizzes, an English corrector, and a full voice-mode conversation gamified with streaks, XP, and hearts. Tech Stack

Mobile: Flutter · Dart · GetX (state, routing, DI) · GetStorage (local persistence). Backend: REST API via Dio · Laravel · MySQL · Firebase (Auth, Realtime Database for chat/presence, Cloud Messaging). AI: Google Gemini (routed through a shared safety-guardrail layer). Infra: GitHub · Sentry (crash/performance monitoring). Results & Key Takeaways

AI responses are unreliable in raw form the real fix was building a robust clean-up layer that recovers useful content even from malformed AI output, rather than trusting the model directly.

Never hard-wire a single AI model each request tries a preferred model and falls back through alternatives with retries, since models get updated or retired often.

Security gap flagged for next iteration: AI API keys currently live inside the app itself and should move server-side before wider distribution.

The same AI-handling logic (retries, fallbacks, safety rules) was duplicated across features next step is consolidating it into one shared component.

The "one app, four roles" model worked well but role-permission logic is scattered across screens recommend centralizing role management into a single control point.