# 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
```