128 lines
5.8 KiB
Markdown
128 lines
5.8 KiB
Markdown
# DMRmap
|
|
|
|
A web app that visualizes DMR repeaters on an interactive map. Filter by band and network, search by callsign or address, find repeaters along a driving route, and export CPS-ready channel configurations.
|
|
|
|
**Live:** https://dmrmap.kida.io
|
|
|
|
## Features
|
|
|
|
- Interactive OpenStreetMap with repeater markers (blue = VHF/2m, red = UHF/70cm)
|
|
- Band filtering (2m / 70cm) and network filtering (BrandMeister, DMR+, TGIF, Other)
|
|
- Toggle visibility of personal hotspots and inactive repeaters
|
|
- Free-text search by callsign, city, or DMR ID
|
|
- Address-to-address routing via OSRM with adjustable corridor width
|
|
- Click-to-pin with adjustable radius search
|
|
- Detailed repeater popups (frequencies, color code, timeslots, hardware, power, antenna height, BrandMeister status)
|
|
- Real-time Last Heard heatmap via BrandMeister WebSocket
|
|
- CPS Studio: manage talk groups, set timeslots, export Motorola CPS 2.0 compatible XML
|
|
- Coordinate display with Maidenhead grid locator
|
|
- Dark mode (follows system preference)
|
|
- Internationalization (English, German, Spanish, French, Italian, Polish)
|
|
- No external CDN dependencies — all assets served locally
|
|
|
|
## Tech Stack
|
|
|
|
- **Backend:** Go (stdlib `net/http`), PostgreSQL 17 via `pgx/v5`, migrations via `goose/v3`
|
|
- **Frontend:** TypeScript (bundled with esbuild), Leaflet, i18next
|
|
- **Testing:** Vitest (92 unit tests)
|
|
- **Infrastructure:** Docker Compose, multi-stage Dockerfile
|
|
|
|
## External Services
|
|
|
|
| Service | Usage | Auth |
|
|
|---------|-------|------|
|
|
| [RadioID](https://radioid.net/database/dumps) | Repeater database (seeded from `rptrs.json` dump) | None |
|
|
| [BrandMeister API](https://wiki.brandmeister.network/index.php/API) | Device status sync (`/v2/device/{id}`), talk group registry (`/v2/talkgroup`) | None (public read) |
|
|
| [BrandMeister WebSocket](https://wiki.brandmeister.network/index.php/API/Last_Heard) | Real-time Last Heard feed for heatmap via socket.io | None |
|
|
| [Nominatim](https://nominatim.openstreetmap.org) | Address geocoding and autocomplete (client-side) | None |
|
|
| [OSRM](https://project-osrm.org) | Driving route calculation (client-side) | None |
|
|
|
|
The BrandMeister talk group registry is fetched once at Docker build time and bundled as `frontend/static/talkgroups.json`. It is used for talk group name resolution and autocomplete in CPS Studio.
|
|
|
|
## Running with Docker
|
|
|
|
```sh
|
|
docker compose up --build
|
|
```
|
|
|
|
Open http://localhost:8080. PostgreSQL data is persisted in a named volume.
|
|
|
|
## Development
|
|
|
|
Hot-reload with [air](https://github.com/air-verse/air) (Go) and esbuild watch (TypeScript):
|
|
|
|
```sh
|
|
docker compose -f compose.dev.yml up --build
|
|
```
|
|
|
|
The dev container mounts the project directory, so changes to Go and frontend files are picked up automatically.
|
|
|
|
### Running Tests
|
|
|
|
```sh
|
|
docker compose -f compose.test.yml run --rm test
|
|
```
|
|
|
|
## Environment Variables
|
|
|
|
| Variable | Default | Description |
|
|
|----------|---------|-------------|
|
|
| `DATABASE_URL` | `postgres://dmrmap:dmrmap@localhost:5432/dmrmap?sslmode=disable` | PostgreSQL connection string |
|
|
| `JSON_PATH` | `rptrs.json` | Path to RadioID repeater dump |
|
|
| `BMRPTRS_PATH` | `bmrptrs.json` | Path to BrandMeister repeater dump |
|
|
| `LISTEN_ADDR` | `:8080` | HTTP listen address |
|
|
| `STATIC_DIR` | `static` | Path to static frontend assets |
|
|
| `MIGRATIONS_DIR` | `migrations` | Path to SQL migration files |
|
|
| `BM_SYNC` | *(disabled)* | Set to `true` to enable periodic BrandMeister device sync |
|
|
| `ADMIN_TOKEN` | *(disabled)* | Set to enable the admin interface at `/admin/` |
|
|
|
|
## API Endpoints
|
|
|
|
| Method | Path | Description |
|
|
|--------|------|-------------|
|
|
| GET | `/api/repeaters` | Repeaters within map bounding box (query: `minLat`, `maxLat`, `minLng`, `maxLng`, `band`, `network`, `hotspots`, `inactive`) |
|
|
| GET | `/api/repeaters/radius` | Repeaters within radius of a point (query: `lat`, `lng`, `radius`) |
|
|
| POST | `/api/repeaters/route` | Repeaters along a route corridor (body: GeoJSON coordinates + `corridor` width) |
|
|
| GET | `/api/repeater` | Single repeater by ID (query: `id`) |
|
|
| GET | `/api/repeaters/search` | Free-text search (query: `q`) |
|
|
|
|
## Project Structure
|
|
|
|
```
|
|
├── backend/
|
|
│ ├── main.go # Route registration, env config
|
|
│ ├── db.go # DB queries, Repeater struct, geo helpers
|
|
│ ├── handlers.go # Public API handlers
|
|
│ ├── admin.go # Admin auth middleware + admin API
|
|
│ ├── bmdevice.go # BrandMeister device sync
|
|
│ ├── seed.go # Database seeding from JSON dumps
|
|
│ ├── migrate.go # Goose migration runner
|
|
│ ├── go.mod / go.sum
|
|
│ ├── migrations/ # SQL migrations (goose)
|
|
│ └── data/ # RadioID + BrandMeister JSON dumps
|
|
├── frontend/
|
|
│ ├── src/ # TypeScript source + tests
|
|
│ ├── static/
|
|
│ │ ├── index.html # Single-page HTML shell
|
|
│ │ ├── admin.html # Admin interface
|
|
│ │ ├── style.css # Styles with dark mode support
|
|
│ │ ├── i18n.js # i18next initialization
|
|
│ │ ├── locales/ # Translation files (en, de, es, fr, it, pl)
|
|
│ │ └── lib/ # Vendored JS libraries (Leaflet, i18next, socket.io)
|
|
│ ├── package.json
|
|
│ ├── tsconfig.json
|
|
│ └── vitest.config.ts
|
|
├── Dockerfile # Production multi-stage build
|
|
├── Dockerfile.dev # Development image with air + esbuild
|
|
├── compose.yml # Production Docker Compose
|
|
├── compose.dev.yml # Development Docker Compose
|
|
└── compose.test.yml # Test runner Docker Compose
|
|
```
|
|
|
|
## Data
|
|
|
|
Repeater data provided by [RadioID](https://radioid.net/database/dumps). Availability and talk group data by [BrandMeister](https://brandmeister.network). This project is not affiliated with or endorsed by RadioID or BrandMeister.
|
|
|
|
## License
|
|
|
|
[MIT](LICENSE)
|