commit 8e755154609f177528ddc04ae4cb1d8179e45f5b Author: Konrad Neitzel Date: Sat Oct 3 15:23:37 2026 +0200 Record the station glossary and the window and config decisions. Co-authored-by: Cursor diff --git a/CONTEXT.md b/CONTEXT.md new file mode 100644 index 0000000..1dc484a --- /dev/null +++ b/CONTEXT.md @@ -0,0 +1,37 @@ +# funknetz + +A headset station for the FM-Funknetz. It joins one reflector talk group and lets the operator listen and speak. + +## Language + +**FM-Funknetz**: +The German amateur network of linked analog FM stations that this application joins. +_Avoid_: using that name for this application + +**Station**: +This application’s presence on a reflector, named by a callsign. It has no radio of its own. +_Avoid_: node, client, channel, hotspot + +**Reflector**: +The conference that forwards audio among stations that have joined the same talk group. One talk group has at most one talker. +_Avoid_: server, bridge + +**Talk group**: +A numbered audio room on the reflector. The station joins one talk group for the whole run. +_Avoid_: channel, room + +**Talker**: +The station currently sending audio on a talk group. +_Avoid_: transmitter + +**Callsign**: +The uppercase amateur call sign that names this station on the reflector. +_Avoid_: a lowercase spelling, username, node id + +**Auth key**: +The secret the network issues for this station’s callsign, used to prove identity to the reflector. +_Avoid_: certificate, a password sent in the clear + +**Push-to-talk**: +The operator holding the control that makes this station the talker. Releasing it returns the station to listening. +_Avoid_: voice-operated transmit, a mute toggle diff --git a/docs/adr/0001-wails-station-window.md b/docs/adr/0001-wails-station-window.md new file mode 100644 index 0000000..3c66ac9 --- /dev/null +++ b/docs/adr/0001-wails-station-window.md @@ -0,0 +1,3 @@ +# Wails for the station window + +funknetz must ship as a Mac app package and stay a small Go program. The window is Wails v2 with plain HTML, CSS, and JavaScript. A native Go toolkit would avoid the webview; we gave that up so `wails build` produces `funknetz.app` from this tree. Version 1 is an unsigned local package. Notarization is a later decision. diff --git a/docs/adr/0002-home-directory-config.md b/docs/adr/0002-home-directory-config.md new file mode 100644 index 0000000..64acd8c --- /dev/null +++ b/docs/adr/0002-home-directory-config.md @@ -0,0 +1,3 @@ +# Hand-edited config in the home directory + +The operator edits connection settings by hand. There is no settings window in version 1. The file is `~/.funknetz.json`, created mode 0600 when missing. Application Support would match other Mac apps and would be a worse place to open in an editor. That path is part of the station's contract; moving it later strands existing files.