dealnews/chronicle repository overview

⁠Chronicle

Chronicle is a webhook-driven object history tracker. It ingests JSON payloads from external systems, parses them through a plugin layer, and stores a versioned log of every change to every object. A built-in web UI lets you browse sources, types, and the full diff history of any object.

⁠How It Works

1. An external system POSTs a JSON payload to /webhook/{source}/{type} with a Bearer API key.
2. Chronicle validates the key, looks up the source and type, and instantiates the configured plugin.
3. The plugin extracts the object ID, action (create/update/delete), change date, version, and data from the payload.
4. A log entry is persisted to the database.
5. The web UI shows the full chronological history for any object, with consecutive versions diffed side by side.