1 changed files with 1 additions and 77 deletions
@ -1,79 +1,3 @@ |
|||||||
# follow-me |
# follow-me |
||||||
|
|
||||||
Android tracker client for the OutsideTheBox `follow-me` service. |
android app for https://otb-tracker.outsidethebox.top tracking |
||||||
|
|
||||||
Operational app label: **otb-tcom** |
|
||||||
Project name / repo name: **follow-me** |
|
||||||
|
|
||||||
## MVP v0.1.0 |
|
||||||
|
|
||||||
- Android 6.0+ (`minSdk 23`) |
|
||||||
- Foreground location tracking service |
|
||||||
- HTTPS primary ingest endpoint with HTTP fallback |
|
||||||
- Auto-default to HTTP after 3 consecutive HTTPS fallback events on that device |
|
||||||
- Token-based header auth via `X-API-Key` |
|
||||||
- Moving mode: 10 second posts |
|
||||||
- Idle mode: 5 minute posts |
|
||||||
- Reboot restart if tracking was enabled before reboot |
|
||||||
- Simple installer/settings UI |
|
||||||
|
|
||||||
## Ingest behavior |
|
||||||
|
|
||||||
Primary: |
|
||||||
- `https://otb-tracker.outsidethebox.top/api/gps-ingest` |
|
||||||
|
|
||||||
Fallback: |
|
||||||
- `http://otb-tracker.outsidethebox.top/api/gps-ingest` |
|
||||||
|
|
||||||
Headers: |
|
||||||
- `X-API-Key: <device token>` |
|
||||||
- `Content-Type: application/json` |
|
||||||
|
|
||||||
JSON body: |
|
||||||
```json |
|
||||||
{ |
|
||||||
"latitude": 43.8971, |
|
||||||
"longitude": -78.8658, |
|
||||||
"speed_kmh": 0, |
|
||||||
"accuracy_m": 12, |
|
||||||
"heading_deg": 0, |
|
||||||
"altitude_m": 95, |
|
||||||
"recorded_at": "2026-03-16T14:32:10Z", |
|
||||||
"source": "otb-tcom" |
|
||||||
} |
|
||||||
``` |
|
||||||
|
|
||||||
## Build on ripper |
|
||||||
|
|
||||||
```bash |
|
||||||
cd /home/def/outsidethebox |
|
||||||
git clone ssh://git@git.etica-stats.org:5252/def/follow-me.git /home/def/outsidethebox/follow-me |
|
||||||
cd /home/def/outsidethebox/follow-me |
|
||||||
``` |
|
||||||
|
|
||||||
Copy this project into that directory, then build with Android Studio or the Gradle wrapper after generating it from Android Studio once. |
|
||||||
|
|
||||||
## Git bootstrap on ripper |
|
||||||
|
|
||||||
```bash |
|
||||||
mkdir -p /home/def/outsidethebox |
|
||||||
cd /home/def/outsidethebox |
|
||||||
[ -d follow-me/.git ] || git clone ssh://git@git.etica-stats.org:5252/def/follow-me.git follow-me |
|
||||||
cd /home/def/outsidethebox/follow-me |
|
||||||
git remote -v |
|
||||||
``` |
|
||||||
|
|
||||||
If the remote repo is empty and you want to seed it from this scaffold: |
|
||||||
|
|
||||||
```bash |
|
||||||
cd /home/def/outsidethebox/follow-me |
|
||||||
git add . |
|
||||||
git commit -m "Initial Android tracker scaffold for follow-me" |
|
||||||
git push -u origin master |
|
||||||
``` |
|
||||||
|
|
||||||
## Notes |
|
||||||
|
|
||||||
- The app label is intentionally discreet: `otb-tcom`. |
|
||||||
- Network onboarding, admin creation, drone enrollment, and role-specific install flows should be added once corresponding backend APIs exist. |
|
||||||
- On Android 8.0+, real-time background tracking requires a foreground service with a visible notification. |
|
||||||
Loading…
Reference in new issue