POTA → OSM Updater

How it works

1. Select a country and region loaded from the active POTA CSV catalog.
2. Fetch active parks from the POTA CSV and use Overpass only to detect existing communication:amateur_radio:pota=<POTA reference> entities.
3. Search public OSM Photon results first, falling back to Nominatim when needed, with partial and fuzzy matching that prioritizes ways and relations.
4. Inspect candidates in OSM, then approve at most one candidate per POTA park.
5. Download an OsmChange file containing only approved modifications.

Authentication

OpenStreetMap is the only identity provider. Connect an OSM account through OAuth 2.0 Authorization Code with PKCE; the app requests read_prefs and write_api, keeps the token in an HttpOnly cookie, and adds Secure automatically for HTTPS deployments. The complete registration guide is in docs/osm-oauth-setup.md in the repository.

Safeguards

The app never uploads changes automatically from the review queue. After approval, choose direct upload or inspect the generated file in JOSM first.

PlantUML diagrams

The source diagrams are in the docs directory: architecture and reconciliation sequence. They use only core PlantUML syntax so they render on plantuml.com.