# Table Mutation Tracker

> Detect retroactive grade and assignment changes in a student information system, with n8n orchestration and a calendar diff UI.

- [Introduction](https://docs.amazingzebra.com/index.md): Catch retroactive grade and assignment changes in a student information system, and see exactly what changed and when.
- [How it works](https://docs.amazingzebra.com/concepts/how-it-works.md): Five runtime boundaries, two repositories, and one orchestrator that owns the data flow.
- [Data model](https://docs.amazingzebra.com/concepts/data-model.md): The snapshot files n8n commits and the rolling index the scraper maintains.
- [Change detection](https://docs.amazingzebra.com/concepts/change-detection.md): How two snapshots are compared, what counts as a change, and why the calendar and day view always agree.
- [n8n workflow](https://docs.amazingzebra.com/guides/n8n-workflow.md): The daily scrape pipeline node by node, with its success path, fallback, and error handling.
- [Runbook](https://docs.amazingzebra.com/operations/runbook.md): Routine operations: deploy the scraper, rebuild the index, rotate the webhook secret, and work with test data.
- [Troubleshooting](https://docs.amazingzebra.com/operations/troubleshooting.md): Symptoms seen in this system, what causes them, and how to fix them.
- [Changelog](https://docs.amazingzebra.com/changelog.md): Notable changes to the tracker, newest first.
- [API overview](https://docs.amazingzebra.com/api-reference/overview.md): Authentication, response conventions, and how n8n uses the scraper endpoints.
- [Run a scrape](https://docs.amazingzebra.com/api-reference/scraping/run-a-scrape.md): Log in to the SIS portal, scrape every configured class, and return the normalized snapshot as JSON.
- [Append a snapshot to the rolling index](https://docs.amazingzebra.com/api-reference/rolling-index/append-a-snapshot-to-the-rolling-index.md): Diff one snapshot against the previous index entry and append the result to `rolling_index.json`.
- [Rebuild the rolling index](https://docs.amazingzebra.com/api-reference/rolling-index/rebuild-the-rolling-index.md): Diff every consecutive pair of snapshots in the data repo and rewrite `rolling_index.json` from scratch.
- [Health check](https://docs.amazingzebra.com/api-reference/operations/health-check.md): Return `{"status": "ok"}` when every required environment variable is set. Does not contact the SIS or GitHub.

## OpenAPI Specs

- [openapi](/openapi.json)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.