behebes.ai – Open-Source Mängelmelder

Behebes.ai ist eine vollständig offene, kostenlose und mandantenfähige Plattform, die Kommunen dabei unterstützt, Bürgeranliegen effizient entgegenzunehmen, mit KI-Unterstützung zu bearbeiten und operativ umzusetzen. Die Kernbestandteile sind:

  • ein Bürger‑Frontend für Meldungen und Statusverfolgung
  • ein Admin‑Kontrollzentrum für Vorgänge, Workflows, Governance und KI‑Einstellungen
  • eine mobile Einsatzoberfläche (OPS) für Bauhof, Außendienst und operative Teams

Die Plattform wurde von der Verbandsgemeinde Otterbach-Otterberg durch AI Assistent Coding speziell für den kommunalen Alltag entwickelt: zuverlässig, datenschutzkonform, nachvollziehbar und praxistauglich.

Was behebes.ai für Kommunen besonders wertvoll macht

Mandantenfähigkeit

Mehrere Gemeinden können parallel mit einer Instanz arbeiten – sauber getrennt, aber zentral administrierbar. Ein Landkreis könnte behebes.ai beispielsweise auf einem eigenen Serverbetreiben und den Kommunen des Landkreises zur Verfügung stellen.

Strukturierte Workflows

Tickets, Aufgaben, Eskalationen und interne Prozesse lassen sich klar steuern, automatisieren und überwachen.

KI‑Unterstützung

Die Plattform unterstützt mehrere OpenAI‑kompatible KI‑Provider und kann Modelle je nach Aufgabe automatisch auswählen. Persönliche Daten werden pseudonymisiert. Behebes.ai kann auch mit einer lokal betriebenen KI verwendet werden.

Realtime‑Funktionen / Messenger

Live‑Aktualisierungen über SSE und WebSockets sowie ein integrierter XMPP‑Messenger sorgen für schnelle Kommunikation zwischen Verwaltung und Außendienst.

Mobile Einsatzoberfläche

Die OPS‑App ist für Smartphones optimiert und unterstützt Messenger, Tickets, Fotos, Standortdaten und Feldprozesse.

Technische Architektur im Überblick

Die Architektur ist bewusst robust und modular aufgebaut:

  • Backend: Node.js + Express + TypeScript
  • Datenbank: MySQL
  • Frontends: React + Vite (Bürger, Admin, OPS)
  • Realtime: SSE + WebSocket/XMPP
  • Proxy: Nginx
  • Container: docker‑compose (dev & prod)

Damit ist die Plattform vollständig on‑premise oder in einer DSGVO‑konformen Cloud betreibbar.

Hosting‑Empfehlungen für Kommunen

Voraussetzungen

  • Server oder VM
  • Ubuntu LTS (22.04 oder 24.04)
  • Domain oder Subdomain (optional, aber empfohlen)
  • Grundkenntnisse im Umgang mit Terminal/ SSH

Docker installieren

  • System aktualisieren: sudo apt update && sudo apt upgrade -y
  • Docker installieren: sudo apt install docker.io -y
  • Docker Compose installieren: sudo apt install docker-compose -y
  • Docker‑Dienst aktivieren: sudo systemctl enable --now docker

behebes.AI herunterladen

  • Repository klonen: git clone https://github.com/derdigitalaffine/behebes-ai
  • In das Projekt wechseln: cd behebes-ai

Konfiguration vorbereiten

  • Beispiel‑Umgebung kopieren: cp .env.example .env.local
  • In .env.local anpassen:
    • Domain / URLs
    • SMTP‑Daten
    • KI‑Provider (optional)
    • Ports (Standard: 8384 intern)

Datenbank & Dienste starten (Produktion)

  • Produktions‑Stack starten: docker compose -f docker-compose.prod.yml up -d --build
  • Docker startet automatisch:
    • Backend
    • Bürger‑Frontend
    • Admin‑Frontend
    • OPS‑Frontend
    • MySQL
    • Nginx‑Reverse‑Proxy
    • XMPP‑Server

Externe Erreichbarkeit einrichten

  • Domain auf Server‑IP zeigen lassen (A‑Record)
  • Ports 80/443 in Firewall öffnen
  • HTTPS‑Zertifikat via Let’s Encrypt oder Traefik einrichten
  • Nginx‑Konfiguration im Repo anpassen (Servername, Weiterleitungen)

Erstzugang & Einrichtung

  • Admin‑Frontend öffnen: https://deine-domain.de/admin
  • Ersten Admin‑Benutzer anlegen
  • Mandanten einrichten
  • Rollen & Berechtigungen konfigurieren
  • Workflows definieren
  • Bürger‑Frontend veröffentlichen
  • Details zur Konfiguration sind in behebs.ai enthalten