Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/vruizz22/innova-backend-serverless/llms.txt

Use this file to discover all available pages before exploring further.

Innova Backend Serverless is the core API that drives the SuperProfe EdTech platform. It classifies procedural math errors for Chilean primary school students (grades 3–6), tracks per-student mastery using Bayesian Knowledge Tracing, and orchestrates AI-assisted grading across AWS Lambda, SQS, and S3. The API is live at https://api.superprofes.app.

Introduction

Understand what Innova does, who it’s for, and how the system fits together.

Quickstart

Make your first authenticated API call in under five minutes.

Architecture

Explore the full system diagram: Lambda functions, SQS queues, and storage layers.

API Reference

Browse every endpoint — request schemas, response shapes, and auth requirements.

What Innova Does

When a student submits a math attempt, the system runs through a four-layer classification pipeline:
1

Rule Engine (< 5 ms)

A deterministic Strategy + Factory pattern classifies the procedural error synchronously — no network calls, no latency.
2

BKT Mastery Update (< 1 ms)

A closed-form Bayesian update revises the student’s pKnown probability for the relevant topic.
3

LLM Fallback (async)

Attempts the rule engine can’t classify are pushed to SQS and handled by Claude in the innova-ai-engine service.
4

Teacher Alerts & Adaptive Practice

The mastery profile feeds the teacher dashboard (alerts, heatmaps) and the IRT-based practice recommender.

Key Features

Rule Engine

Deterministic procedural-error detection covering integers, fractions, decimals, ratios, powers, and linear algebra.

BKT Mastery Tracking

Closed-form Bayesian Knowledge Tracing with per-topic parameters and nightly recalibration.

Guides Pipeline

Teacher uploads a worksheet PDF; the system extracts questions, generates solution keys, and grades student photos.

Adaptive Practice

IRT 2PL Fisher-information item picker selects the exercise with maximum diagnostic value for each student.

Lambda Functions

Six Lambda functions handle HTTP, SQS workers, S3 triggers, and hourly cron alerts.

Authentication

Supabase JWT (RS256 JWKS) with role-based guards: STUDENT, TEACHER, PARENT, ADMIN.

Build docs developers (and LLMs) love