Zum Hauptinhalt springen

Willkommen beim FWV Raura Wiki

Diese Dokumentation erklärt alle Funktionen der Feuerwehrverein Raura Website und Apps.

Schnellstart​

Für Mitglieder​

Für Vorstand​

Für Administratoren​

Für Anlässe​

Buchhaltung​

  • Buchhaltung - Kontenplan, Buchungen, Rechnungen und Berichte

Mobile Apps​

API-Dokumentation​


System-Architektur​

Das System besteht aus mehreren Microservices, die alle unter api.fwv-raura.ch erreichbar sind und via Traefik anhand des URL-Pfads zum richtigen Container geroutet werden:

┌───────────────────────────────────────────────────────────────────────┐
│ Traefik │
│ (Reverse Proxy) │
└──────────────────────────────┬────────────────────────────────────────┘
│
┌────────┬────────┬──────────┼──────────┬────────┬────────┬────────┐
│ │ │ │ │ │ │ │
┌─┴──┐ ┌──┴──┐ ┌──┴──┐ ┌───┴──┐ ┌────┴──┐ ┌─┴──┐ ┌─┴──┐ ┌─┴──┐
│Web │ │Memb.│ │Event│ │Disp. │ │Accnt. │ │Ord.│ │Inv.│ │PDF │
│site│ │ API │ │ API │ │ API │ │ API │ │Sys.│ │Sys.│ │Des.│
└────┘ └──┬──┘ └──┬──┘ └──┬───┘ └───┬───┘ └─┬──┘ └─┬──┘ └────┘
│ │ │ │ │ │
└────────┴────────┴───────────┴────────┴────────┘
│
┌────────┴────────┐
│ PostgreSQL 16 │
└─────────────────┘

Services​

ServiceBeschreibungURL
FrontendHauptwebsite mit Mitgliederbereichfwv-raura.ch
Vorstand-PortalVerwaltungs-Dashboardfwv-raura.ch/vorstand.html
API MembersMitgliederverwaltung, Auth, Rollen, Fotosapi.fwv-raura.ch/members
API EventsEvents, Schichten, Kalender, Anmeldungenapi.fwv-raura.ch/events
API DispatchE-Mail, Brief-Versand, Newsletter, PDF-Vorlagenapi.fwv-raura.ch/email
API AccountingKontenplan, Buchungen, Rechnungen, Berichteapi.fwv-raura.ch/accounts
KassensystemBestellungen bei Anlässenorder.fwv-raura.ch
Kitchen DisplayBestellanzeige Küche/Barkitchen.fwv-raura.ch
InventarLagerverwaltung mit Rezepteninventar.fwv-raura.ch
PDF-DesignerVisueller Editor für PDF-Vorlagenpdf.fwv-raura.ch
WikiDiese Dokumentationwiki.fwv-raura.ch

Technologie-Stack​

KomponenteTechnologie
BackendNode.js 18+, Express.js
DatenbankPostgreSQL 16
FrontendHTML/CSS/JS, Tailwind, React
AuthentifizierungAuthentik (OIDC/RS256), IMAP (HS256)
ContainerDocker, Docker Compose
Reverse ProxyTraefik (Let's Encrypt SSL)
CI/CDGitHub Actions, Semantic Release, Watchtower
AndroidKotlin, Material 3, minSdk 26

Authentifizierung​

Für Mitglieder (Authentik OIDC)​

  • Login über zentrales Authentik-Portal (auth.fwv-raura.ch)
  • OAuth2 Authorization Code Flow mit RS256-signierten JWTs
  • Single Sign-On für Website, Kassensystem und Inventar
  • Passwort-Reset via E-Mail

Für Vorstand (IMAP Login)​

  • Login mit Vereins-E-Mail-Konto (z.B. praesident@fwv-raura.ch)
  • JWT mit HS256-Signatur, 8 Stunden gültig
  • Zugang zum Vorstand-Portal und Android-App
  • Cookie-Domain .fwv-raura.ch für Cross-Subdomain-Zugriff

Versionierung​

Die aktuelle Version kann über den Health-Endpoint abgefragt werden:

curl https://api.fwv-raura.ch/health
# {"status":"ok","service":"api-members","version":"1.145.0"}

Jeder Backend-Service hat einen eigenen /health Endpoint.


Hilfe & Support​

Bei Problemen:

  1. Prüfe diese Dokumentation
  2. Kontaktiere den Webmaster: webmaster@fwv-raura.ch
  3. Bei technischen Problemen: Beschreibe genau was passiert ist

Häufige Fragen​

Ich kann mich nicht einloggen → Prüfe ob dein Authentik-Konto aktiviert ist. Kontaktiere den Vorstand falls nötig.

Die Website lädt nicht → Prüfe deine Internetverbindung. Bei anhaltendem Problem: status.fwv-raura.ch

Ich sehe keine Events → Events werden nur angezeigt wenn sie veröffentlicht sind. Vorstand kann alle Events sehen.

Die Vorstand-App funktioniert nicht → Prüfe ob du die neueste Version installiert hast (Auto-Update prüft bei jedem Start). Stelle sicher, dass du dich mit einer erlaubten Vorstand-E-Mail anmeldest.