From 778686e7ce011ff84939e2cd8a628fd717d7d10c Mon Sep 17 00:00:00 2001 From: David Kiania Date: Tue, 21 Apr 2026 16:01:38 +0300 Subject: [PATCH] =?UTF-8?q?docs:=20CLAUDE.md=20audit=20=E2=80=94=20add=20b?= =?UTF-8?q?ackup=20sidecar,=20missing=20files,=20update=20open=20items?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude Sonnet 4.6 --- CLAUDE.md | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/CLAUDE.md b/CLAUDE.md index 586282a..2b46201 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -45,6 +45,7 @@ This repository ingests the Tracksolid Pro API into a TimescaleDB/PostGIS databa | Visualisation | Grafana (provisioned via custom image) | | Workflow automation | n8n | | API source | Tracksolid Pro / Jimi IoT Open Platform (`eu-open.tracksolidpro.com/route/rest`) | +| Backup | pg_dump sidecar → rustfs S3 (`fleet-db` bucket), nightly | | Version control | Forgejo at `repo.rahamafresh.com` | --- @@ -84,6 +85,11 @@ docs/ # Reference docs (connections, API, KPIs, project co docs/superpowers/ # Pitch specs and implementation plans (not deployed code) 02_tracksolid_full_schema_rev.sql # Full schema bootstrap 03..06_*.sql # Incremental migrations (06 adds assigned_city, dispatch_log, ops.*) +07_analytics_views.sql # Analytics views migration (applied 2026-04-21) +Dockerfile # Custom image for ingest/webhook containers +pyproject.toml # Python project + uv dependency spec +OPERATIONS_MANUAL.md # Day-to-day ops runbook +backup/ # pg_dump sidecar scripts and config 01_BusinessAnalytics.md # SQL analytics library — read before writing queries 20260414_FS__Logistics - final_fixed.csv # 144-device driver/vehicle source data tracksolidApiDocumentation.md # API endpoint reference @@ -209,7 +215,7 @@ Latest full snapshot: `260412_baseline_report.md` | Priority | Item | |---|---| | HIGH | Run `import_drivers_csv.py --apply` — 144 X3/JC400P devices with names + plates waiting | -| HIGH | Register webhooks: `/pushobd` `/pushoil` `/pushtem` `/pushlbs` `/pushevent` | +| HIGH | Register webhooks: `/pushoil` `/pushtem` `/pushlbs` (auto-register on push now done — commit 257643c) | | HIGH | Investigate X3-63282 in Kampala — legitimate or unauthorised? | | MEDIUM | Set `fuel_100km` per vehicle type to activate fuel cost calculations | | MEDIUM | Investigate 44 silent devices (only 19 of 63 reporting) — SIM installed? Activated? |