https://github.com/mizcausevic-dev/learner-intervention-ledger
EdTech intervention ledger for outreach history, escalation tracking, and student support outcome analysis.
https://github.com/mizcausevic-dev/learner-intervention-ledger
advising edtech education-operations fastapi higher-education intervention-ledger outcome-tracking python student-success workflow-analytics
Last synced: 25 days ago
JSON representation
EdTech intervention ledger for outreach history, escalation tracking, and student support outcome analysis.
- Host: GitHub
- URL: https://github.com/mizcausevic-dev/learner-intervention-ledger
- Owner: mizcausevic-dev
- Created: 2026-05-12T17:49:54.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2026-05-17T05:13:29.000Z (about 1 month ago)
- Last Synced: 2026-05-17T07:27:31.317Z (about 1 month ago)
- Topics: advising, edtech, education-operations, fastapi, higher-education, intervention-ledger, outcome-tracking, python, student-success, workflow-analytics
- Language: HTML
- Homepage: https://kineticgain.com/
- Size: 598 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
Awesome Lists containing this project
README
# Learner Intervention Ledger
Learner Intervention Ledger is an EdTech workflow and audit layer for student success operations. It records outreach attempts, lane handoffs, channel history, resolution quality, and cycle time so institutions can see which interventions actually improved outcomes.
## Why this repo is good
- It completes the EdTech action cluster after `student-success-signal-hub`, `curriculum-knowledge-graph`, and `advisor-outreach-orchestrator`.
- It adds auditability and outcome quality instead of only queue scoring.
- It gives schools a cleaner closed-loop view of what happened after support teams acted.
## What it does
- Logs interventions with owner lanes, channels, event types, and response state.
- Scores closure quality from response, risk movement, touch count, age, and escalation depth.
- Shows which lanes and playbook patterns are resolving cases versus stalling them.
- Exposes both an operator-facing proof surface and a clean API.
## Proof
## Local run
```powershell
cd learner-intervention-ledger
py -3.11 -m venv .venv
.\.venv\Scripts\python.exe -m pip install -r requirements.txt
.\.venv\Scripts\python.exe -m app.main
```
Open:
- `http://127.0.0.1:4741/`
- `http://127.0.0.1:4741/outcomes`
- `http://127.0.0.1:4741/evidence`
- `http://127.0.0.1:4741/docs`
## Validation
```powershell
.\.venv\Scripts\python.exe -m unittest discover -s tests
.\.venv\Scripts\python.exe scripts\run_demo.py
.\.venv\Scripts\python.exe scripts\smoke_check.py
.\.venv\Scripts\python.exe scripts\render_readme_assets.py
```
## API shape
Endpoints:
- `/api/dashboard/summary`
- `/api/interventions`
- `/api/lanes`
- `/api/outcomes`
- `/api/interventions/{intervention_id}`
- `/api/sample`
## Repo layout
```text
app/
data/
services/
docs/
scripts/
screenshots/
tests/
```