NetDiag — Netzwerk-Diagnose App (SvelteKit + Capacitor)

Find a file

Eduard Wisch 9eef6177ba WLAN-Diagramme: Y-Achse gespreizt statt Namen zusammenzuquetschen Eddy hatte vorgeschlagen, die Netze "weiter auseinander zu ziehen". Das wurde mit dem Argument abgelehnt, die Blockhoehe SEI der Messwert und duerfe nicht verschoben werden. Das war ein Denkfehler: ein Netz von seinem Messwert wegzuschieben waere falsch, den Massstab der Achse zu dehnen dagegen voellig unbedenklich - die Achsenbeschriftung wandert mit, jeder Wert bleibt exakt ablesbar. Genau so loest es auch WiFiAnalyzer (Einstellung "Maximum Y-axis Value" plus Pinch-Zoom). - DB_SCALE 2 -> 5 Einheiten je dB. Der dichte Bereich (-65...-85 dBm) waechst von 40 auf 100 Einheiten: Platz fuer neun Namenszeilen statt dreieinhalb. - Achse zeigt nur den belegten Bereich (rssiBereich), auf 10 dB gerastert mit 5 dB Luft nach oben. Ohne das waere 5 GHz mit vier Bloecken ueberwiegend leere Flaeche zum Scrollen. Gerastert, damit die Achse nicht bei jedem RSSI-Zucken springt und zwei Momentaufnahmen vergleichbar bleiben. Ergebnis: trotz 2,5-facher Spreizung 30 % kuerzer als vorher. - Alle Bloecke EINES Bandes teilen sich den Bereich - sonst laese man zwei gleich hohe Balken als "gleich stark", obwohl 20 dB dazwischen liegen. Gleiches gilt im Zeitverlauf ueber alle Momentaufnahmen. - Jede 10-dB-Linie beschriftet (vorher nur jede zweite, da war kein Platz). - dBm-Wert am Netznamen ("FRITZ!Box 7590 AX -48"). Beantwortet Eddys erste Meldung ("ich sehe nicht die Sendestaerke in dB") ohne Blickwechsel zur Achse - und bleibt richtig, wenn ein Name verschoben werden musste. Passt der Text nicht, wird der Wert geopfert, nicht der Name: den Wert kann man an der Achse ablesen, den Namen nirgends. Geprueft mit tools/render-chart.mjs (dicht24: 15/15 Netze beschriftet, voll5: 25/25) und im Emulator auf der echten Kanalanalyse-Seite.		2026-08-16 17:48:43 +02:00
.forgejo/workflows	android/ fest ins Repo aufgenommen — Build wie beim Adressmanager [apk]	2026-05-19 18:09:23 +02:00
android	Phase 6: Lesbarkeit und Bedienung — Ampel mit Form, Klartext-Werte, Toasts	2026-08-16 11:21:59 +02:00
native-plugin	Phase 0: doppelte Plugin-Quelle aufgeloest, falsche Doku-Zusagen korrigiert	2026-08-14 18:39:40 +02:00
src	WLAN-Diagramme: Y-Achse gespreizt statt Namen zusammenzuquetschen	2026-08-16 17:48:43 +02:00
tools	Kanalgraph bei vielen Netzen lesbar: Namen entzerrt, Netzauswahl	2026-08-16 17:29:18 +02:00
.gitignore	WLAN-Diagramme lesbar gemacht: dBm-Achse, 5-GHz-Aufteilung, Farben je Netz	2026-08-15 17:24:59 +02:00
capacitor.config.ts	Initiales Commit — NetDiag App vollständig implementiert [apk]	2026-05-19 12:01:56 +02:00
package.json	Initiales Commit — NetDiag App vollständig implementiert [apk]	2026-05-19 12:01:56 +02:00
README.md	Phase 0: doppelte Plugin-Quelle aufgeloest, falsche Doku-Zusagen korrigiert	2026-08-14 18:39:40 +02:00
svelte.config.js	Initiales Commit — NetDiag App vollständig implementiert [apk]	2026-05-19 12:01:56 +02:00
tsconfig.json	Initiales Commit — NetDiag App vollständig implementiert [apk]	2026-05-19 12:01:56 +02:00
vite.config.ts	Initiales Commit — NetDiag App vollständig implementiert [apk]	2026-05-19 12:01:56 +02:00

README.md

NetDiag — Diagnose-App (Android)

Mobile Netzwerk-Diagnose-App. Erfasst vor Ort beim Kunden (Handy am WLAN oder USB-C→RJ45-Adapter) Geräte, Ports und Messungen und hängt die Protokolle ans Dolibarr-Modul netdiag an Kunde und Auftrag.

Stack

SvelteKit 2 · Svelte 5 · Tailwind 4 · Vite 7 · Capacitor 6 · SQLite-Offline

Entwicklung (Browser)

npm install
npm run dev          # http://localhost:5175

Im Browser liefert ein Mock (src/lib/scanner.ts) Beispiel-Scandaten — die Oberfläche lässt sich ohne Gerät entwickeln. API-Aufrufe gehen über den Vite-Proxy an den Dolibarr-Testserver (192.168.155.11, siehe vite.config.ts).

Android-Build

npm run build
npx cap add android        # einmalig
# android/ liegt komplett im Repo — cap sync kopiert nur die Web-Assets
npx cap sync android
npx cap open android

Release-APK über CI: Commit mit [apk] in der Message → Forgejo baut und lädt die APK in die Package Registry (netdiag-apk). Siehe .forgejo/workflows/build.yml.

Architektur

src/lib/
  api.ts            JSON-API-Client (JWT, 401-Refresh, Timeout)
  auth.svelte.ts    Anmelde-Status
  db.ts             Offline-Speicher (SQLite nativ / localStorage Browser)
  sync.svelte.ts    Sync-Queue -> Dolibarr (idempotent über clientUuid)
  scanner.ts        Brücke zum nativen Plugin (+ Browser-Mock)
  backButton.svelte.ts  Hardware-Back (Single-Instance, KB #480/#549)
  updater.ts        APK-Auto-Update-Prüfung (KB #363)
  tools/            erweiterbare Tool-Plattform
    index.ts        Registry — neues Tool hier eintragen
    netzwerk/       IP-Scan, Port, Ping, IP-Konflikt, SNMP, Traceroute, Stress
    internet/       Durchsatz-Test
    telefonie/      (folgt: SIP, FreePBX, RTP)
src/routes/
  login/ auftraege/ kunden/ protokoll/[id]/ einstellungen/
android/            natives Android-Projekt inkl. Kotlin-Plugin (einzige Quelle)
native-plugin/      nur noch Anleitung/Hinweise zum Plugin

Neues Tool hinzufügen

Datei unter src/lib/tools/<kategorie>/<id>.ts anlegen, Tool implementieren.
In src/lib/tools/index.ts importieren und in TOOLS eintragen.

Kein Eingriff in App-Logik, Sync oder Datenbank — das Ergebnis ist generisches JSON. Braucht das Tool eine neue native Messroutine, eine Methode im Kotlin-Plugin ergänzen.

Bedienung

Anmelden (Dolibarr-Zugang; auf dem Gerät zusätzlich Server-URL).
Aufträge — aktive direkt sichtbar, abgeschlossene per Checkbox, Suche. Alternativ über Kunden suchen.
Auftrag/Kunde antippen → Diagnose-Protokoll öffnet sich.
Werkzeuge ausführen (IP-Scan füllt die Geräteliste, je Gerät weitere Tools).
Abschließen & synchronisieren — Protokoll geht ans Dolibarr, PDF landet im ECM. Offline bleibt es lokal und synct automatisch bei Verbindung.