Initial commit — 2026-07-15

README.md

@@ -0,0 +1,39 @@
+# FleetTracker360 — Live GPS Tracking Platform
+
+## Overview
+Self-hosted GPS tracking using Traccar (open source) with live dashboard, ETA predictions, vehicle telemetry, and Sho'Nuff integration.
+
+## Architecture
+```
+iPhone (Traccar Client)  →  Traccar Server (Docker)  →  HERE Maps API (traffic)
+OBD2 dongles             →                              →  Sho'Nuff (ETAs, alerts)
+Garrison's iPhone        →                              →  Live Dashboard (ops portal)
+```
+
+## Tech Stack
+- **Traccar** — GPS tracking server (Docker)
+- **Traccar Client** — iOS/Android app for phone tracking
+- **HERE Maps API** — Traffic-aware routing (250k free transactions/mo)
+- **Custom Dashboard** — Dark theme, live-updating HTML/JS
+- **Sho'Nuff** — AI agent for ETA queries, alerts, geofencing
+- **Domain:** fleettracker360.com (Cloudflare proxied)
+
+## Status
+- [ ] Fresh Traccar Docker deployment on netcup
+- [ ] iOS Traccar Client setup (Germaine + Garrison)
+- [ ] OBD2 dongle pairing (specs TBD)
+- [ ] HERE API key and routing integration
+- [ ] Live dashboard design and deploy
+- [ ] ETA automation (Sho'Nuff queries)
+- [ ] Geofence alerts (home, office, school)
+- [ ] Cancel old fleettracker Hetzner server
+
+## Directory Structure
+```
+fleettracker/
+├── README.md           <- This file
+├── server/             <- Docker compose, Traccar config
+├── dashboard/          <- Frontend HTML/CSS/JS
+├── api/                <- Scripts for Sho'Nuff integration
+└── ideas/              <- Feature ideas, mockups, research
+```