darkdwigt/assessment-analysis

Assessment Analysis is an AI-powered tool designed to help South African teachers effortlessly review and audit exam papers Assessment Analysis 💻 Intelligent Curriculum & Cognitive Level Mapping for South African Educators Assessment Analysis is an AI-powered tool designed to help South African teachers effortlessly review and audit exam papers. By uploading an assessment, the tool automatically parses the document, categorizes questions by curriculum topics, and maps them to standard CAPS Cognitive Levels (Bloom's Taxonomy). ✨ Key Features Multi-Format Support & OCR: Upload scanned exam papers (Images, PDFs) or digital documents (Word, Excel). The tool handles text extraction and Optical Character Recognition automatically. Secure API Key Handling: Provide your own free Google Gemini API key directly in the user interface. The key is kept safely in your browser's temporary memory and is never saved to your public repository. Custom Teaching Plans (ATP): Upload your term's Annual Teaching Plan (or type it in manually) so the AI can accurately categorize questions based on what you have taught. CAPS Cognitive Grid Auditing: Select your subject (Physical Sciences P1/P2 or Mathematics) to load official CAPS target weightings. The dashboard visually flags if your paper is too heavily weighted towards lower or higher cognitive levels (alerts trigger at >5% deviation). Question-by-Question Breakdown: Get a detailed table showing question numbers, matched topics, mark allocations, and cognitive levels. Targeted Revision Generator: Filter the results by specific topics or cognitive levels where your class struggled, and instantly copy a targeted revision question list to share with learners. 🛠️ Tech Stack Frontend: React & Next.js (Static Export) Styling: Custom "Cyber" CSS Theme (Self-contained, no external CSS frameworks required) AI Engine: Google Gemini 2.5 Flash (Multimodal Vision & Text) Document Parsing: pdf.js (PDF handling & rendering) mammoth.js (Word/Docx extraction) SheetJS (Excel/CSV extraction) 🚀 How to Use Upload a Paper: Drag and drop your exam paper into the / …