snowy-complete

Build a complete, production-ready **AI Exam Generator & Examination Platform** with a premium iOS-inspired **Liquid Glass / Glassmorphism UI**. Make it responsive for desktop, tablet and mobile, with Light/Dark/System themes, smooth animations, modern typography and professional enterprise styling. ## CORE PURPOSE Admin can upload ANY supported document or enter any text/topic. AI analyzes the content and automatically generates a professional exam. The system must support IT training but must also work with general educational/professional content. ## AUTHENTICATION Use simple **User + PIN** login. No email/password for normal users. Roles: * ADMIN * USER User fields: username, secure PIN hash, role, status, created date, last login. Features: * Login * Logout * Protected routes * Session management * Admin-only pages * Active/Inactive users * Reset PIN * Never expose raw PINs Demo accounts may be provided: Admin: admin / 1234 User: demo / 1111 Clearly mark demo credentials as configurable. ## ADMIN NAVIGATION Dashboard AI Generator Question Bank Exams Users Results Analytics Settings ## ADMIN DASHBOARD Show: Total Users Total Exams Total Questions Completed Exams Average Score Pass Rate Recent Exams Recent AI Generations Recent Activity Performance charts ## AI EXAM GENERATOR Create a prominent AI Generator page. Input methods: 1. DOCUMENT UPLOAD Support PDF, DOC, DOCX, TXT, PPT, PPTX, CSV, XLSX and images with OCR where available. Provide drag-and-drop upload. 2. TEXT INPUT Large text/topic editor for manually entering or pasting content. After input, AI should: * Extract text * Analyze content * Identify topics/subtopics * Identify concepts, definitions, procedures and examples * Generate questions * Check accuracy * Detect duplicates * Add explanations * Add source references ## EXAM SETTINGS Allow admin to choose: Questions: 10, 20, 30, 40, 50, 75, 100, Custom Difficulty: Easy / Medium / Hard / Mixed Question Types: MCQ True/False Fill in the Blank Short Answer Scenario Based Troubleshooting Matching Multiple Select Allow difficulty distribution customization. Passing score: configurable percentage. Time: No Limit / 10 / 20 / 30 / 45 / 60 minutes / Custom Options: Randomize questions Randomize answers Prevent duplicates ## AI QUESTION FORMAT Every question should contain: Question Type Difficulty Topic Options when applicable Correct Answer Explanation Source Document Source Page/Section when available Marks Tags Status Example: Question: What is the primary purpose of DHCP? A. Resolve domain names B. Automatically assign IP configuration C. Manage printers D. Encrypt traffic Correct: B Explanation: DHCP automatically provides network configuration. Difficulty: Easy Topic: Networking Marks: 1 ## AI QUALITY CONTROL AI must check: * Incorrect answers * Multiple correct answers * Ambiguous wording * Poor grammar * Duplicate/similar questions * Unsupported information * Question difficulty * Distractor quality Flag questionable questions for review. If source material cannot support the requested number of questions, DO NOT create filler questions. Tell admin how many high-confidence questions were generated and ask whether general domain knowledge may be used. ## QUESTION REVIEW Show question list on left and editor on right. Admin can: Edit Approve Reject Delete Regenerate Approve All Editable fields: Question, type, options, correct answer, explanation, difficulty, topic, marks and tags. ## QUESTION BANK Searchable and filterable by: Topic Difficulty Type Source Status Tags Statuses: Draft Approved Rejected Archived Actions: Edit Duplicate Delete Preview Add to Exam Use semantic duplicate detection and show possible duplicate questions. ## EXAM BUILDER Create Exam with: Title Description Instructions Questions Duration Passing Score Question Selection Availability Attempt Limit Result Visibility Questions can come from: AI-generated questions Question Bank Manual questions Ordering: Random / Manual Exam status: Draft / Published / Closed / Archived ## ASSIGN EXAMS Admin can assign exams to: All users Selected users User groups Show assigned, pending and completed status. ## USER DASHBOARD After User + PIN login show: Welcome message Available Exams Pending Exams Completed Exams Previous Results Exam card: Exam Name Question Count Duration Passing Score Status START EXAM button Users cannot access admin functions. ## EXAM INTERFACE Create a clean distraction-free examination interface. Show: Exam title Question X of Y Progress bar Question Answers Previous Next Mark for Review Review Answers Submit Automatically save answers periodically so temporary connection problems do not lose responses. ## TIMER If enabled, show countdown timer. Warnings at: 10 minutes 5 minutes 1 minute When time reaches zero, automatically submit. ## ANSWER REVIEW Before submission show: Answered Unanswered Marked for Review Question navigation grid with visual status. Require confirmation before final submission. ## AUTOMATIC SCORING After submission calculate: Total Questions Correct Incorrect Unanswered Marks Percentage Pass/Fail Time Used Store every attempt separately. ## RESULT PAGE Display: EXAM COMPLETED Score Percentage Pass/Fail Correct Incorrect Unanswered Time Used Admin controls whether users can see: Correct answers Explanations Detailed results Optional: Retake Exam View Answers Back to Dashboard ## ANALYTICS Admin analytics should show: Average Score Highest Score Lowest Score Pass Rate Failure Rate Average Completion Time Score Distribution Question Performance Topic Performance Exam Performance User Performance Show which questions/topics have high error rates. ## AI PERFORMANCE REPORT Generate an AI-assisted report from actual results: Overall performance Strong topics Topics needing improvement Suggested learning areas Do not invent performance data. ## USER MANAGEMENT Admin can: Create User Edit User Activate/Deactivate Reset PIN Delete Columns: Username Role Status Assigned Exams Completed Exams Average Score Last Login ## EXAM MANAGEMENT Admin can: View Edit Duplicate Publish Close Archive Delete Show: Exam name Question count Assigned users Attempts Average score Status ## DOCUMENT SOURCE TRACEABILITY Every generated question should retain: Document name Page number when available Section Source/reference Provide “View Source” so admin can verify the question against the uploaded material. ## AI ASSISTANT Add a floating round glass AI assistant. It should understand the current admin page and provide actions such as: Create exam Generate more questions Explain question Improve question Make harder Make easier Create scenarios Create troubleshooting questions Find duplicates Analyze results ## EXPORT Admin can export: Exam PDF Question PDF Answer Key Results PDF Results CSV Question Bank CSV Printable exam must NOT reveal answers. Generate separate answer key. ## DATABASE Use PostgreSQL/Supabase or equivalent. Tables: USERS DOCUMENTS QUESTIONS EXAMS ASSIGNMENTS ATTEMPTS RESULTS AUDIT_LOGS Store relationships properly and use secure database rules. ## SECURITY Implement: Secure PIN hashing Role-based access Protected APIs Input validation File validation Upload limits Rate limiting Session expiration Database security Audit logging AI API keys must remain server-side and never be exposed in frontend code. ## UI Premium Liquid Glass / iOS aesthetic: Glass cards Blur/transparency Rounded panels Soft shadows Subtle gradients Smooth transitions Micro-interactions Modern icons Professional charts Accessible contrast Avoid excessive decoration. AI Generator should be the visual centerpiece. ## LANDING PAGE Hero title: **AI EXAM GENERATOR** Subtitle: “Turn Any Document Into a Professional Exam” Buttons: CREATE EXAM LOGIN Feature cards: Any Document AI Question Generation Multiple Question Types Smart Analytics Simple User + PIN Login ## LOADING STATES During AI processing show: Analyzing document... Extracting content... Identifying topics... Generating questions... Checking quality... Removing duplicates... Preparing exam... Then show: ✓ Exam generated successfully. ## ERROR HANDLING Handle: Invalid file Unsupported format Large file Empty content AI failure Network failure Database failure Session expiration Submission failure Never lose saved exam answers. ## IT CONTENT Optimize AI generation for: Windows Windows Server Active Directory Microsoft 365 Networking TCP/IP DNS DHCP VPN Wi-Fi Routers Switches Firewalls Printers Hardware SSD/HDD/RAM/CPU BIOS/UEFI CCTV IP Cameras VoIP Help Desk Troubleshooting Cybersecurity Backup Cloud But do not restrict the platform to IT. ## TECHNOLOGY Preferred: React / Next.js Tailwind CSS Lucide icons PostgreSQL/Supabase Secure backend API LLM API through server-side environment variables Appropriate document parsers/OCR The application must be a REAL interconnected application, not static mockups. All major buttons must work. FINAL FLOW: ADMIN: Login → Dashboard → Upload Document/Enter Text → Configure Exam → AI Generate → Quality Check → Review → Approve → Question Bank → Build Exam → Preview → Publish → Assign Users → Analytics USER: User + PIN → Dashboard → Assigned Exam → Start → Answer → Review → Submit → Auto Score → Result Build the complete system with functional authentication, database persistence, AI generation, document processing, question management, exam creation, exam assignment, exam taking, scoring, results, analytics and exports.