ILS Developer Guide

Welcome to the ILS Developer Guide

This guide is your authoritative reference for developing, extending, and maintaining the Intelligent Learning System (ILS). All content is based strictly on the live implementation in ILS-dev.

Guide Structure

The Developer Guide is organized into clear, focused categories. Use the sidebar to navigate, or explore the summaries below:

Guide Categories

**Architecture & Model**  
System architecture, backend/frontend split, domain separation, and the data model (entities, junction tables, snapshots).

**Curriculum Design**  
Course, class, and module authoring, outcome links, and teaching method support.

**Developer Workflows**  
Grading, snapshot, heatmap, and cockpit lifecycles. API reference for backend routes and high-value endpoints.

**Setup & Support**  
Local preview, application setup, troubleshooting, and release validation.

**Decisions & Terms**  
Technical decisions, rationale, and a glossary of ILS terminology.

Quick Navigation

Architecture & Model
  • Architecture: system principles, backend/frontend split
  • Data Model: entities, junctions, snapshots
Curriculum Design
  • Institutions: top-level organization and admin flow
  • Campuses: campus list and reporting rule support
  • Course Creation: authoring, metadata
  • Classes: session setup, module assignments, enrollment
  • Themes: learning themes and module linking
  • Outcomes: learning goals, mastery, and calculation rules
  • Module Creation: authoring, outcomes, teaching methods
Developer Workflows
  • Workflows: grading, reporting, intelligence
  • Users: account management, roles, and campus assignment
  • Heatmap: classroom mastery matrix and drilldown evidence
  • Reporting Rules: campus intelligence thresholds and save validation
  • Teacher Roster: teacher class roster, student activity, and cockpit links
  • Student Cockpit: action list for at-risk students
  • Classroom Intelligence: report interpretation and cohort patterns
  • Grading Cockpit: submission scoring and rubric evaluation
  • Assignments: assignment authoring and rubric linking
  • Rubrics: rubric authoring, criteria, and rating management
  • Criteria Bank: cross-rubric criterion visibility and outcome links
  • Mapping Matrix: assignment–outcome coverage audit
  • API Reference: backend routes, requests
Setup & Support
  • Setup: local preview, app reference
  • Troubleshooting: build/runtime support
  • Release Plan: validation, release prep
Decisions & Terms
  • Decisions: design rationale
  • Glossary: ILS terminology

Repo Boundaries

This documentation covers only the docs repository (ILS-doc). The application code is in ILS-dev.

  • ILS-doc: documentation site content, navigation, and authoring
  • ILS-dev: application source code, backend, frontend, and migrations

Only make documentation changes in ILS-doc unless explicitly asked to modify ILS-dev.

Last updated: 2026-07-08