Compare commits
No commits in common. "main" and "feat/map-layers-shell" have entirely different histories.
main
...
feat/map-l
2 changed files with 14 additions and 65 deletions
60
README.md
60
README.md
|
|
@ -3,17 +3,13 @@
|
|||
A single-file map console that **merges live vehicle positions and historical
|
||||
trips** into one view for the Fireside Communications / Tracksolid fleet.
|
||||
|
||||
> **Status:** v2 — live at <https://fleetnow.rahamafresh.com>. Deployed from this
|
||||
> repo via Coolify (Dockerfile → nginx). Reads the `dashboard_api` read-API at
|
||||
> `fleetapi.rahamafresh.com`.
|
||||
> **Status:** v2 — **feature-frozen 2026-06-07** (two-tier bottom dock + clustering
|
||||
> + tracker/camera dedup). Live at <https://fleetnow.rahamafresh.com>. Deployed
|
||||
> from this repo via Coolify (Dockerfile → nginx). Reads the `dashboard_api`
|
||||
> read-API at `fleetapi.rahamafresh.com`.
|
||||
>
|
||||
> **2026-06-08 additions:** fleet segmentation (specialist vehicle icons that
|
||||
> never cluster), per-department colour coordination + collapsible **Key** legend,
|
||||
> persistent POIs (Fireside HQ, Safaricom HQ), and a **toggleable map-overlay
|
||||
> layer system** (first layer: 232 Shell fuel stations). See *Map overlay layers*.
|
||||
>
|
||||
> **Deploy auto-fires on push to `main`** via Coolify (~2–3 min build); if it
|
||||
> lags, hit Redeploy in Coolify.
|
||||
> Deploy is **manual** — push, then hit Redeploy in Coolify (no auto-deploy
|
||||
> webhook wired yet).
|
||||
|
||||
## What it does
|
||||
|
||||
|
|
@ -34,15 +30,6 @@ trips** into one view for the Fireside Communications / Tracksolid fleet.
|
|||
Leaflet.MarkerCluster style, via `supercluster`); click a bubble to zoom and
|
||||
expand it. Clusters disband into individual pins at ~city zoom (z11). Clustering
|
||||
honours the active filter and applies to the live view only (not trip routes).
|
||||
- **Fleet segmentation & department colours.** Specialist vehicles (crane /
|
||||
motorbike / pick-up) get their own marker icons and are **never clustered**
|
||||
(always individually visible); every cost centre has a fixed, distinct colour,
|
||||
with a collapsible **Key** legend (bottom-left) listing only the centres on
|
||||
screen. Non-operational vehicles (personal / management / Uganda-MTN) are
|
||||
filtered out upstream in the read-API, so the live map shows the operational
|
||||
fleet only.
|
||||
- **Persistent POIs** — Fireside HQ and Safaricom HQ (Waiyaki Way) as labelled
|
||||
reference markers.
|
||||
- **Filters** (bottom-right card) apply to the live map *instantly*:
|
||||
- **Number plate** — multi-select, sorted A→Z; picking a vehicle auto-fills its
|
||||
cost centre + city.
|
||||
|
|
@ -78,8 +65,7 @@ the existing dashboard read-API — it does **not** talk to the database directl
|
|||
|
||||
```
|
||||
index.html → the entire SPA
|
||||
layers/*.geojson → static overlay data (gas stations, …), served at /layers/
|
||||
Dockerfile → bakes index.html + layers/ into an nginx:alpine image (port 80)
|
||||
Dockerfile → bakes index.html into an nginx:alpine image (port 80)
|
||||
nginx.conf → static serve + /healthz + no-cache on index.html
|
||||
```
|
||||
|
||||
|
|
@ -100,38 +86,6 @@ exposes:
|
|||
(`DASHBOARD_CORS_ORIGINS`). It is in the code default; make sure the deployed
|
||||
`dashboard_api` container's env includes it, then restart that container.
|
||||
|
||||
## Map overlay layers
|
||||
|
||||
Toggleable reference overlays (gas stations, etc.) sit behind the **Layers**
|
||||
control (top-right, collapsed, all **off** by default). Each is a static GeoJSON
|
||||
in `layers/`, rendered as a MapLibre **symbol** layer that **auto-declutters**
|
||||
(`icon-allow-overlap: false` — sparse when zoomed out, all points reveal as you
|
||||
zoom in), with a zoom-scaled icon (~8→16 px) and a **hover** label (one reused
|
||||
popup, so only ever one is visible). Overlays render *under* the vehicle markers.
|
||||
|
||||
Shipped layers:
|
||||
|
||||
| Layer | Data | Points |
|
||||
|---|---|---|
|
||||
| Shell stations | `layers/shell_stations.geojson` (OSM `kenya-260605`) | 232 |
|
||||
|
||||
**To add a layer (≈2 min):**
|
||||
1. Drop its point GeoJSON in `layers/<name>.geojson`.
|
||||
2. Add one entry to the `OVERLAYS` array near the top of the `<script>` in
|
||||
`index.html`:
|
||||
```js
|
||||
{ id: '<name>', label: '<Label>', url: 'layers/<name>.geojson',
|
||||
iconSvg: <40×40 SVG string>, nameKey: 'name', defaultOn: false }
|
||||
```
|
||||
`iconSvg` is registered as the marker image (reuse `SHELL_ICON_SVG` as a
|
||||
template). Nothing else to wire — `addOverlay()` builds the source + symbol
|
||||
layer, and the Layers control lists it automatically.
|
||||
3. Commit + push. The `Dockerfile` already `COPY`s `layers/` into nginx.
|
||||
|
||||
> The Shell layer was extracted from a Kenya OSM `.pbf` — the reproducible
|
||||
> workflow (filter `amenity=fuel`, `brand=Shell`) lives in the `tracksolid` repo:
|
||||
> `scripts/export_osm_pois.py` + `docs/OSM_POI_EXPORT.md`.
|
||||
|
||||
## Deploy (Coolify, git-based)
|
||||
|
||||
1. In Coolify, create a new **Application** from this git repo
|
||||
|
|
|
|||
15
index.html
15
index.html
|
|
@ -635,7 +635,6 @@ const OVERLAYS = [
|
|||
iconSvg: SHELL_ICON_SVG, nameKey: 'name', defaultOn: false },
|
||||
// future layers: add { id, label, url, iconSvg, nameKey, defaultOn } here.
|
||||
];
|
||||
let overlayPopup = null; // single reused hover popup for overlay points (only one ever shown)
|
||||
|
||||
function registerOverlayIcon(def) {
|
||||
return new Promise(resolve => {
|
||||
|
|
@ -668,18 +667,14 @@ async function addOverlay(def) {
|
|||
'visibility': def.defaultOn ? 'visible' : 'none',
|
||||
},
|
||||
});
|
||||
// Hover (not click) shows a single label — one reused popup, so only ever
|
||||
// one is visible; mousemove keeps it on whichever station is under the cursor.
|
||||
map.on('mouseenter', lyrId, () => { map.getCanvas().style.cursor = 'pointer'; });
|
||||
map.on('mousemove', lyrId, e => {
|
||||
const f = e.features[0]; if (!f) return;
|
||||
const p = f.properties || {};
|
||||
if (!overlayPopup) overlayPopup = new maplibregl.Popup({ closeButton: false, closeOnClick: false, offset: 12 });
|
||||
overlayPopup.setLngLat(f.geometry.coordinates)
|
||||
map.on('click', lyrId, e => {
|
||||
const p = (e.features[0] && e.features[0].properties) || {};
|
||||
popup.setLngLat(e.lngLat)
|
||||
.setHTML(`<div class="ov-pop"><b>${escapeHtml(p[def.nameKey] || def.label)}</b><div class="ov-sub">${escapeHtml(p.brand || 'fuel station')}</div></div>`)
|
||||
.addTo(map);
|
||||
});
|
||||
map.on('mouseleave', lyrId, () => { map.getCanvas().style.cursor = ''; if (overlayPopup) overlayPopup.remove(); });
|
||||
map.on('mouseenter', lyrId, () => { map.getCanvas().style.cursor = 'pointer'; });
|
||||
map.on('mouseleave', lyrId, () => { map.getCanvas().style.cursor = ''; });
|
||||
}
|
||||
buildLayersControl();
|
||||
}
|
||||
|
|
|
|||
Loading…
Reference in a new issue