StudyMate AI — AI-Powered Study Companion (Independent Full-Stack Project)

StudyMate AI — breakdown تقني كامل للمنصة 🧱

بعد ما استقرت البنية التحتية، حبيت أشارككم نظرة شاملة على المنصة من زاوية الـ features والـ architecture.

📚 Student Features

→ Multi-format upload — PDF, PowerPoint, Word, images, audio, video

→ AI-generated study pack لكل محاضرة: overview، key concepts، definitions، key takeaways، وestimated reading time

→ Flashcards تولد تلقائيًا من محتوى المحاضرة

→ Quiz متعدد الخيارات مع topic tagging وexplanation لكل سؤال

→ Answer review — يشوف الطالب إجابته، الإجابة الصحيحة، والشرح لكل سؤال بعد التسليم

→ Quiz attempt history — كل محاولة تنحفظ منفصلة وتقدر ترجع لها لاحقًا

→ Exam readiness score يتحدث بعد كل محاولة

→ Weak/strong topic detection مبني على topic tags الأسئلة

→ AI Chat — scoped للمحاضرة فقط، ما يجاوب من خارج محتواها

→ Interactive Mind Map — يحول key concepts + definitions + takeaways لـ graph تفاعلي قابل للسحب والتكبير/التصغير

→ Full bilingual support (عربي/إنجليزي) مع automatic RTL mirroring

→ Light/Dark mode

→ Auth — Email + Google OAuth

⚙️ Architecture

→ Frontend: React + TanStack Router/Start

→ Styling: Tailwind CSS + shadcn/ui (Radix primitives)

→ Backend: Supabase — PostgreSQL + Row Level Security policies + Storage buckets للملفات المرفوعة

→ AI Layer: Google Gemini API عبر Vercel AI SDK (@ai-sdk/google) — multimodal input handling (PDF base64 inlining, text extraction) داخل TanStack server functions

→ Data fetching: TanStack Query

→ Mind Map rendering: React Flow (@xyflow/react)

→ Deployment: Vercel مع automatic CI/CD من GitHub — كل push لـ main ينشر production build تلقائيًا

🔒 Security

كل الجداول محمية بـ RLS policies تضمن إن كل طالب يقدر يوصل لبياناته فقط، وmediaTypes الملفات المرفوعة مخزنة في private storage bucket.

🛣️ Roadmap

قادم: Retry weak questions mode، Audio summary narration، Instructor dashboard، وcustom domain.

التطبيق shipped ومستقل بالكامل — من الـ database للـ deployment. لو عندك فيدباك، أسمعها بكل سرور 👇

github repo: https://lnkd.in/eDV7XSDe