MedStudy — AI-Powered Medical Study Platform - Sell Project

Overview A full-stack web application designed for medical students to study smarter using AI-powered question generation, spaced repetition, collaborative study rooms, and detailed performance analytics. Built as a complete SaaS-ready product. Codebase Stats 165 files | 20,000 lines of TypeScript/TSX 25+ API routes | 18 pages | 20+ database tables Fully deployed on Railway with persistent SQLite storage Tech Stack LayerTechnology FrameworkNext.js 16 (App Router, Server Components) LanguageTypeScript (strict) DatabaseSQLite via better-sqlite3 + Drizzle ORM AI EngineGroq SDK (LLaMA 3.3 70B) — JSON mode + streaming StylingTailwind CSS 4 + shadcn/ui (Radix primitives) AuthCustom JWT (jose) + bcrypt password hashing EmailResend (password reset flows) ChartsRecharts DeploymentRailway (auto-deploy from GitHub) Core Features 1. AI Question Generation (5 Types) MCQ — Multiple choice with explanations Flashcards — Front/back with card types (definition, mechanism, clinical, mnemonic) Fill in the Blank — With alternative accepted answers Short Answer — AI-evaluated with key points scoring Clinical Cases — Full scenario + examination + investigations + rationale All generated from uploaded content with configurable: Difficulty (easy/medium/hard) Count (3–30 per type) Focus topic filtering Page range selection (for multi-lesson PDFs) 2. Content Library PDF upload with automatic text extraction MCQ Bank PDF import — AI parses existing exam papers into structured questions YouTube video import — transcript extraction + question generation Per-source question management with delete capability Subject/topic auto-detection 3. Study Sessions Mixed activity types in a single session Real-time scoring and progress tracking Question flagging during exams Session summary with score breakdown XP rewards on completion 4. AI Tutor (Chat) Streaming chat interface Personalized system prompt built from: User's weak topics (from analytics) Wrong answer history Uploaded content context Contextual medical explanations 5. Spaced Repetition (SM-2 Algorithm) Automatic card scheduling based on recall quality Due card queue with review interface Stats dashboard (cards due, reviewed, retention rate) 6. Exam Lab Upload doctor's past exams → AI analyzes the exam style Generate new questions that mimic the professor's style Exam profiles saved per professor Timed exam mode with flagging 7. AI Lesson Generator Enter any medical topic → AI generates a full structured lesson: Overview, multiple sections, summary, clinical relevance AI-generated SVG diagrams for visual learning In-lesson AI chat for Q&A 8. Question Folders Create custom folders (with color coding) Save any question to folders during study sessions "Study All" — start a session from folder contents Rename, recolor, delete folders 9. Wrong Answers Review Dedicated page listing all incorrectly answered questions "Quiz on All" — retry only the questions you got wrong Tracks improvement over time 10. Analytics Dashboard Performance line chart — score trends over time Subject radar chart — strengths/weaknesses visualization Topic breakdown bar — per-topic accuracy Weakness remediation — AI-suggested topics to focus on 11. Study Plan Calendar-based daily study planner Assign sources + activity types per day Track plan completion Integrated with dashboard "Today's Plan" card 12. Collaborative Study Rooms Create/join rooms with invite codes Real-time group chat (polling-based) Per-member study timer Voice chat (WebRTC signaling) Admin controls (mute members) 13. Social Features Friends system — send/accept requests by username Direct messaging — real-time chat with friends User profiles — name, username, bio 14. Gamification (Valorant-Style Ranking) 24-level ranking system: Unranked → Iron 1-3 → Bronze 1-3 → Silver 1-3 → Gold 1-3 → Platinum 1-3 → Diamond 1-3 → Immortal 1-3 → Radiant → Professor XP earned from: correct answers, session completion, perfect scores, exams Professor rank requires 100,000 XP (extremely hard) Progress bar showing XP to next rank 15. Streak System Daily study streak tracking Visual streak widget on dashboard Encourages consistent study habits 16. Summaries (Whiteboard) Create text/canvas summaries for topics AI evaluation — scores your summary completeness Subject/topic tagging 17. Admin Panel User management overview Database Schema (20 tables) users · contentsources · questions · studysessions · sessionresponses · studyplanitems · streakrecords · topicperformance · srcards · studygoals · userxp · examprofiles · lessons · summaries · studyrooms · roommembers · roommessages · voicesignals · passwordresetcodes · friendrequests · friendships · directmessages · doctorpdfs · questionfolders · folderquestions Authentication & Security Custom JWT-based auth (no third-party auth provider dependency) bcrypt password hashing Email verification / password reset via Resend Per-user data isolation (all queries scoped to userId) Cascade deletes for data integrity Deployment Platf...