kianiadee/fleet-platform
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
No description
44 commits 1 branch 0 tags 848 KiB
Python 35.4%
PLpgSQL 30.2%
JavaScript 17.1%
HTML 16.8%
Dockerfile 0.4%
Find a file
kianiadee 6dc63e0720
Some checks are pending
build / build-push (push) Blocked by required conditions
Details
build / lint-test (push) Successful in 38s
Details
Merge branch 'chore/registry-image-deploy'
2026-05-29 02:46:56 +03:00
.forgejo/workflows CI: install node+git in slim container so actions/checkout can run 2026-05-29 01:25:37 +03:00
app Fix CI lint failures so build-push can run and push an image 2026-05-29 01:11:19 +03:00
db/migrations Add low_accuracy flag to live view + amber ring/popup for LBS/WIFI fixes 2026-05-29 00:42:00 +03:00
scripts Fix CI lint failures so build-push can run and push an image 2026-05-29 01:11:19 +03:00
tests Fix camera/tracker dedup (device_type at provision + backfill) and finish refresh-token flow 2026-05-29 00:08:56 +03:00
web Add low_accuracy flag to live view + amber ring/popup for LBS/WIFI fixes 2026-05-29 00:42:00 +03:00
.env.example UI: arrow + plate-short label + cost-centre marker palette + hover popup; richer state.live_positions + serve.fn_live_view v2; multi-target poll plumbing 2026-05-23 09:29:04 +03:00
.gitignore Phase 1 — foundation, push gateway, parser, projector, live view, frontend 2026-05-23 00:53:42 +03:00
260522_fleet_platform_architecture_final.md Phase 1 — foundation, push gateway, parser, projector, live view, frontend 2026-05-23 00:53:42 +03:00
260522_fleet_platform_prd_final.md Phase 1 — foundation, push gateway, parser, projector, live view, frontend 2026-05-23 00:53:42 +03:00
20260427_FSG_Vehicles_mitieng.csv Roster import: COALESCE-fill API-managed fields (device_type/lifecycle/activation_at/model) on existing rows; CSV is authoritative only for driver/phone/iccid/expiration/device_group 2026-05-24 03:59:32 +03:00
docker-compose.coolify.yml Deploy by pulling CI-built registry image (so /health reports real SHA) 2026-05-29 01:08:26 +03:00
docker-compose.dev.yml Phase 1 — foundation, push gateway, parser, projector, live view, frontend 2026-05-23 00:53:42 +03:00
Dockerfile Revert "Bake git SHA into image so /health reports it under Coolify source builds" 2026-05-29 00:58:56 +03:00
LICENSE Initial commit 2026-05-22 17:35:05 +00:00
pyproject.toml Fix CI lint failures so build-push can run and push an image 2026-05-29 01:11:19 +03:00
README.md README: note CI live 2026-05-23 01:12:36 +03:00

README.md

fleet-platform

Greenfield rebuild of the Rahamafresh fleet telematics platform — CI is live on Forgejo Actions.

One FastAPI codebase, one Docker image, three container roles (gateway / worker / cron) from the same image. Event-sourced ingest into TimescaleDB + PostGIS. JWT-mandatory reads. Image-tag deploys via Coolify from a self-hosted Forgejo registry.

See:

  • 260522_fleet_platform_prd_final.md — product spec (P1–P4)
  • 260522_fleet_platform_architecture_final.md — engineering design (phases A–G)
  • ~/.claude/plans/you-are-an-experienced-majestic-planet.md — approved Phase 1 plan

Quick start (dev)

cp .env.example .env
# edit .env: at minimum set POSTGRES_PASSWORD, JWT_SECRET, TRACKSOLID_PUSH_TOKEN
docker compose -f docker-compose.dev.yml up

Health checks:

curl http://localhost:8001/health/gateway
curl http://localhost:8001/health/worker   # via worker container's exposed port
curl http://localhost:8001/health/cron

Layout

app/                   one FastAPI codebase
  entrypoints/         three role entrypoints from the same image
    gateway.py         /push/jimi/*, /api/views/*, /api/auth/token
    worker.py          LISTEN parser + projectors
    cron.py            polling + SLO + contract checker
  models/              Pydantic models (Jimi contracts, view shapes)
  parsers/             one function per msg_type / poll endpoint
  projectors/          single-writer projectors per state table
db/migrations/         dbmate forward-only SQL
scripts/               operational utilities (parity_check, entrypoint.sh)
tests/                 pytest
web/                   fleet-core.js + index-live.html + login.html

Container roles

The same image runs in three roles, selected by APP_ROLE:

Role Workload
gateway HTTP: Tracksolid push receivers + dashboard read API + JWT issuance
worker LISTEN events_raw_new / events_parsed_new → parser → projectors
cron APScheduler: polled ingest (60s/10m), SLO measurement, contract checker

Failure isolation is the point: a heavy report in worker does not stall gateway.

Deploy

CI (Forgejo Actions) builds on push to main, tags <registry>/fleet-platform:<sha> and :latest. Coolify deploys by tag. Rollback is coolify deploy :<prev-sha>.

dbmate up runs on platform-worker startup before the worker serves traffic; gateway and cron wait on a startup probe that confirms migration completion.