59 lines
2.3 KiB
Markdown
59 lines
2.3 KiB
Markdown
|
# FleetOps
|
||
|
|
|
||
|
|
Fleet **operations** analytics for the Tracksolid fleet — fuel, utilisation, distance and
|
||
|
|
driver behaviour. Sibling to **FleetNow** (live tracking); reuses the same warm-dark ops
|
||
|
|
palette so the two feel like one product.
|
||
|
|
|
||
|
|
This is a self-contained single-page app (`src/index.html`, inline CSS/JS + Chart.js from CDN)
|
||
|
|
served by **Caddy**. It reads the FleetOps analytics API (the `dashboard_api` `/analytics/*`
|
||
|
|
endpoints).
|
||
|
|
|
||
|
|
## Architecture
|
||
|
|
|
||
|
|
```
|
||
|
|
fleetops.fivetitude.com (staging) ─┐
|
||
|
|
fleetops.rahamafresh.com (prod) ─┼─► this SPA (Caddy :80, behind Traefik/Coolify)
|
||
|
|
└─► API_BASE → dashboard_api /analytics/*
|
||
|
|
```
|
||
|
|
|
||
|
|
- **Web server:** Caddy. Traefik (via Coolify) terminates TLS, so Caddy is a plain `:80` file
|
||
|
|
server. See `Caddyfile`.
|
||
|
|
- **Per-environment API base:** Caddy's `templates` directive renders `{{env "API_BASE"}}` into
|
||
|
|
`/env.js` at request time, so the **same image** serves staging and prod — just set the
|
||
|
|
`API_BASE` env var on each Coolify app:
|
||
|
|
- staging → `https://fleetapi.fivetitude.com`
|
||
|
|
- prod → `https://fleetapi.rahamafresh.com`
|
||
|
|
- if unset, `index.html` falls back to the staging API.
|
||
|
|
|
||
|
|
## Endpoints consumed
|
||
|
|
|
||
|
|
| Endpoint | Panel |
|
||
|
|
|---|---|
|
||
|
|
| `GET /analytics/filters` | cost-centre / city dropdowns |
|
||
|
|
| `GET /analytics/fleet-summary` | KPI strip + per-vehicle table |
|
||
|
|
| `GET /analytics/utilisation` | distance & idle daily-trend chart |
|
||
|
|
| `GET /analytics/driver-behaviour` | driver leaderboard |
|
||
|
|
| `GET /analytics/fuel` | fuel panel (data-gated) |
|
||
|
|
|
||
|
|
The SPA's origin must be in the API's `DASHBOARD_CORS_ORIGINS` (staging API already allows
|
||
|
|
`fleetops.fivetitude.com`).
|
||
|
|
|
||
|
|
## Deploy
|
||
|
|
|
||
|
|
Coolify app (Dockerfile → Caddy), one per environment, bound to a branch:
|
||
|
|
|
||
|
|
| Env | Domain | Branch | `API_BASE` |
|
||
|
|
|---|---|---|---|
|
||
|
|
| staging | `fleetops.fivetitude.com` | `staging` | `https://fleetapi.fivetitude.com` |
|
||
|
|
| prod | `fleetops.rahamafresh.com` | `main` | `https://fleetapi.rahamafresh.com` |
|
||
|
|
|
||
|
|
Promotion: feature → `staging` (auto-deploys staging via Forgejo webhook) → `main`
|
||
|
|
(auto-deploys prod).
|
||
|
|
|
||
|
|
## Local
|
||
|
|
|
||
|
|
```bash
|
||
|
|
docker build -t fleetops . && docker run --rm -p 8080:80 -e API_BASE=https://fleetapi.fivetitude.com fleetops
|
||
|
|
# open http://localhost:8080 (live data needs the localhost origin in the API CORS allowlist)
|
||
|
|
```
|