oubaidhl/findiff repository overview

⁠FinDiff

FinDiff is a self-hosted, read-only observability platform that watches your financial databases for configuration drift — schema changes, parameter/rate-table edits, anything that shifted without a clean audit trail — and gives you a searchable, alertable history of exactly what changed, when, and by how much.

It never writes to anything it monitors. Connect it with a SELECT-only database role and even a bug in FinDiff can't touch your data — see docs/READONLY.md⁠ in the repo for the full guarantee.

⁠Supported engines

PostgreSQL · MySQL · MariaDB · Microsoft SQL Server · Oracle · SQLite — one static binary, no CGO, no per-engine client libraries to install.

⁠Quick start

docker run -d \
  --name findiff \
  -p 8080:8080 \
  -e FINDIFF_MASTER_KEY=$(openssl rand -base64 32) \
  -e FINDIFF_ADMIN_USERNAME=admin \
  -e FINDIFF_ADMIN_PASSWORD=changeme \
  -v findiff-data:/data \
  oubaidhl/findiff:latest

Then open http://localhost:8080 and log in with the admin credentials above. Change the password on first login — FinDiff will ask you to.

⁠Environment variables

⁠What's inside

• Row-level diffing with a live WebSocket timeline
• Table/column → business-name mapping, with an Excel export/import round-trip for non-technical reviewers
• Configurable alerts (Slack, Teams, SMTP, generic webhook)
• Drift comparison between two environments (e.g. staging vs. prod)
• An AI Copilot (bring your own provider — OpenAI, Anthropic, Gemini, or a local model via LM Studio/Ollama) for root-cause chat and auto-labeling, with persistent conversation history and file uploads
• Multi-user accounts, French/English UI, light/dark/system theme

⁠Source & documentation

Full README, architecture notes, and read-only guarantees: https://github.com/oubaidHL/FinDiff⁠

⁠Author

Built by Oubaid HLAIMI⁠ — Cloud Engineer, IT Consulting & Automation.