Skip to content

agencyenterprise/qti-aipi

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

21 Commits
 
 
 
 
 
 
 
 

Repository files navigation

QTI Assessment Platform

A modern web application for creating, managing, and organizing educational assessments following the QTI 3.0 specification. This project demonstrates the implementation of a teacher-focused assessment platform similar to Edulastic.

Project Overview

This platform provides educators with tools to:

  • Create and manage QTI 3.0 compliant assessment items
  • Organize items into comprehensive tests
  • Manage curriculum-aligned content
  • Import/export QTI compatible content

Core Features

  1. Assessment Item Management

    • Multiple interaction types (choice, text-entry, etc.)
    • QTI 3.0 compliant structure
    • Rich content editing
    • Item bank organization
  2. Test Assembly

    • Section-based organization
    • Linear/non-linear navigation
    • Individual/simultaneous submission modes
    • QTI test part management
  3. Curriculum Integration

    • Subject-based organization
    • Grade level alignment
    • Educational standard mapping
    • Content hierarchies

Technical Architecture

Frontend Stack

  • Next.js with TypeScript
  • Material-UI components
  • Formik for form management
  • Yup for validation
  • Zustand for state management

API Integration

  • RESTful endpoints
  • QTI 3.0 validation
  • XML generation/parsing
  • Error handling patterns

Development Patterns

Error Handling Strategy

  1. Attempt operation
  2. Detect failure
  3. Show error
  4. Provide recovery option

Data Flow

  • Unidirectional data flow
  • Type-safe interfaces
  • Validated state updates
  • Consistent error handling

Getting Started

  1. Installation

    npm install
  2. Development

    npm run dev
  3. Building

    npm run build

Implementation Guidelines

Component Development

  • Use TypeScript for all components
  • Follow QTI 3.0 specification
  • Implement proper validation
  • Include error handling
  • Add loading states
  • Provide user feedback

API Integration

  • Connect to localhost:3000
  • Handle authentication
  • Manage requests/responses
  • Validate data structures

QTI Compliance

  • Follow 3.0 specification
  • Validate XML structure
  • Handle import/export
  • Maintain data integrity

Best Practices

  1. Form Handling

    • Client-side validation
    • Server-side validation
    • Error messaging
    • State management
  2. Data Management

    • Type safety
    • State consistency
    • Error recovery
    • Loading states
  3. User Experience

    • Clear feedback
    • Error recovery
    • Progress indication
    • Intuitive navigation

Documentation

Contributing

When contributing:

  1. Follow TypeScript patterns
  2. Maintain QTI 3.0 compliance
  3. Include error handling
  4. Add appropriate tests
  5. Update documentation

Support

For assistance:

  1. Review documentation
  2. Check existing issues
  3. Create detailed bug reports
  4. Follow error handling patterns

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published