graham/aprs.me
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions 1
aprs.me/docs
History
Graham McIntire eb389af64b
Some checks failed
Build and Push / Build and Push Docker Image (push) Failing after 2s
Details
reliability: bound ingress buffers, payload limits, overflow telemetry 
- PacketProducer: 15s periodic buffer depth telemetry, overflow events
- MobileChannel: 500-packet ring buffer with overflow drops, payload validation
  (query max 20 chars, callsign max 20 chars, results capped at 200,
   bounds area max 1000 sq deg), rejection telemetry
- PromEx: buffer depth/max/overflow metrics, mobile overlay, payload rejected
- Tests: 2491 passed, 0 failures
- Handoff document: marked reliability #1 and #2 as done
2026-07-26 15:10:54 -05:00
..
architecture refactor: harden packet delivery and operations 2026-07-26 13:11:26 -05:00
contexts refactor: harden packet delivery and operations 2026-07-26 13:11:26 -05:00
development docs: add structured documentation covering architecture, contexts, web, infra, and dev setup 2026-07-21 11:01:27 -05:00
features add docs 2026-03-02 08:34:50 -06:00
infrastructure docs: add structured documentation covering architecture, contexts, web, infra, and dev setup 2026-07-21 11:01:27 -05:00
plans docs: add weather nearby API implementation plan 2026-03-22 11:27:45 -05:00
web refactor: harden packet delivery and operations 2026-07-26 13:11:26 -05:00
improvement-todos.md update 2026-02-18 14:14:49 -06:00
mobile-api.md feat(mobile): rate-limit socket + batch historical packet delivery 2026-04-21 09:38:51 -05:00
README.md docs: add structured documentation covering architecture, contexts, web, infra, and dev setup 2026-07-21 11:01:27 -05:00
refactor-implementation-handoff.md reliability: bound ingress buffers, payload limits, overflow telemetry 2026-07-26 15:10:54 -05:00
tracked-callsign-behavior.md fix: Show all packets for tracked callsigns including non-position data 2025-07-30 14:02:44 -05:00

README.md

aprs.me Documentation

APRS packet visualization and tracking platform built with Phoenix LiveView + PostGIS.

Architecture

Domain Contexts

  • Accounts — User registration, authentication, session management
  • Packets — Packet storage, querying, replay, weather, and spatial search
  • Devices — APRS device identification and registry

Web Layer

  • LiveView Map — MapLive architecture, real-time streaming, components
  • LiveView Pages — Packet streams, weather, status, info, auth pages
  • REST API — API v1 endpoints (callsign lookup, weather nearby)
  • Mobile WebSocket — MobileChannel protocol for iOS/Android apps

Infrastructure

  • Deployment — Kubernetes (ArgoCD), Fly.io, Docker, Nix dev shell
  • Observability — PromEx metrics, error tracking, telemetry

Development

  • Setup Guide — Local dev environment, required services, tooling

Features & Plans

API