How getarbind/algebrabridge works
AlgebraBridge is a Grade 7–8 equation-learning app whose main workflow is a learner manipulating an equation in either a balance-scale or symbolic interface, receiving validation and adaptive scaffolding, and reviewing recorded activity. The README also documents instructor analytics and an optional telemetry collector. The supplied tree omits the app and collector source, so those documented components have no supported source path here; the only sampled runtime-related source is the offline analytics script.
Main entry points: analyze.py Benchmark Reports
Components 12
Learning Experience
- Balance Scale
- Equation Workspace
Instruction Engine
- Equation State
- Step Validation
- Problem Selection
- Adaptive Scaffolding
Telemetry and Insights
- Interaction Log
- Instructor Dashboard
- Telemetry Collector
- Benchmark Reports
analytics/analyze.py - Exported Events
Other components
- Learner
Connections 18
- Learner → Problem Selection: chooses problem
README.md - Learner → Balance Scale: manipulates blocks
README.md - Learner → Equation Workspace: enters moves
README.md - Balance Scale → Equation State: updates state
README.md - Equation Workspace → Equation State: updates state
README.md - Equation Workspace → Step Validation: validates steps
README.md - Step Validation → Equation State: checks against anchor
README.md - Step Validation → Adaptive Scaffolding: reports errors
README.md - Adaptive Scaffolding → Equation Workspace: provides feedback
README.md - Adaptive Scaffolding → Balance Scale: controls visibility
README.md - Balance Scale → Interaction Log: records visual activity
README.md - Equation Workspace → Interaction Log: records interactions
README.md - Adaptive Scaffolding → Interaction Log: records level changes
README.md - Interaction Log → Instructor Dashboard: summarizes activity
README.md - Interaction Log → Telemetry Collector: posts attempts
README.md - Interaction Log → Exported Events: exports events
README.md - Exported Events → Benchmark Reports: loads event data
analytics/analyze.py - Telemetry Collector → Benchmark Reports: collects JSONL input
analytics/analyze.py