Version 1.0 (Gold Master)

Know and Guide Numeracy

Technical Implementation Master Plan

A high-fidelity NAPLAN numeracy assessment platform featuring an AI-powered "Maths Penpal" that generates curriculum-aligned questions and provides intelligent, progressive audio guidance.

Visit Application

Project Overview

This platform serves as a specialized application for Queensland Secondary schools. It replicates the 2016 NAPLAN Online interface while injecting modern AI capabilities.

Frontend
React (Vite), TypeScript, Tailwind CSS.
Backend
Python (FastAPI), Vertex AI (Gemini 2.0).
Infrastructure
Docker, Google Cloud Run (Serverless).

Implementation Phases

Phase 1

Core Architecture & UI

Goal: Replicate look and feel of 2016 NAPLAN Online.

  • Strict Tailwind CSS implementation (Blue/White palette).
  • 3-section header (Timer, Title, Tools).
  • Session State via React Context.
Phase 2

Assessment Engine

Goal: Handle complex question logic.

  • LaTeX rendering for Multiple Choice ($x^2$).
  • Validated Text/Numeric Inputs.
  • Cohort Logic (Year 7 vs Year 9).
Phase 3

Virtual Tools

Goal: Interactive manipulatives.

  • SVG Ruler with rotation.
  • Semi-transparent Protractor.
  • Scientific Calculator component.
Phase 4

Intelligence Layer

Goal: Endless content & smart assistance.

  • Gemini 2.0 Flash generation model.
  • Robust Retry logic (3x) for JSON failures.
  • Personas: Aura (Guide) & Robert (Tutor).
Key Innovation

Progressive Audio Hints

Goal: Assist without revealing answers.

  • Trigger: Ctrl + Hover.
  • Stage 1: "Quick Nudge" (TTS).
  • Stage 2 (>5s): "Detailed Strategy".
Phase 6

Production Deployment

Goal: Secure, scalable hosting.

  • Multi-stage Docker build.
  • FastAPI serving React SPA.
  • Deployed on Google Cloud Run (us-central1).

Current Version Status (v1.0)

✅ Exam Interface
✅ Virtual Tools
✅ AI Generation
✅ AI Hints
✅ Cloud Deployment