# PROJECT_STATE.md

## Project
- Name: follow-me
- App label: otb-tcom
- Version: v0.1.0
- Build date: 2026-03-16
- Platform: Android
- Package: top.outsidethebox.followme
- Minimum Android version: 6.0 (API 23)

## Current scope
Working Android client scaffold for GPS tracking into OTB Tracker.

## Current implemented features
- Foreground tracking service
- HTTPS primary ingest endpoint
- HTTP fallback ingest endpoint
- Device-local default-to-HTTP after 3 consecutive HTTPS fallback events
- X-API-Key token header
- Minimal installer/settings screen
- Save/start/stop controls
- Reboot restart when tracking was already enabled
- Location payload fields aligned to provided ingest contract

## Not yet implemented
- Backend onboarding flow for freeadmin/drone install paths
- Token issuance / enrollment API
- Local queueing for offline retry backlog
- Battery optimization exemption helper UI
- Geofence pill creation in app
- Admin / drone role-aware UI behavior
- Play Store packaging / signing / release pipeline
- Linux and Windows tracker clients

## Endpoint contract
Primary:
- https://otb-tracker.outsidethebox.top/api/gps-ingest

Fallback:
- http://otb-tracker.outsidethebox.top/api/gps-ingest

Header:
- X-API-Key: token

Method:
- POST

## Source label
- Default source string: otb-tcom