> For the complete documentation index, see [llms.txt](https://bienenstock.gitbook.io/bienenstock/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://bienenstock.gitbook.io/bienenstock/sonstiges/haufige-probleme-and-losungen.md).

# Häufige Probleme & Lösungen

Diese Seite hilft Ihnen bei der Lösung der häufigsten Probleme mit Bienenstock.

***

### Kamera & QR-Code Scanner

#### Die Kamera startet nicht

{% hint style="danger" %}
**Bitte nutzen Sie NICHT Safari.** Unsere App funktioniert auf dem Tablet am besten mit **Firefox** oder **Chrome**.\
\
Nutzen Sie unsere offizielle App im IPAD-App store 'Bienenstock Terminal Kiosk'
{% endhint %}

| Problem                           | Ursache                                         | Lösung                                                                                                            |
| --------------------------------- | ----------------------------------------------- | ----------------------------------------------------------------------------------------------------------------- |
| "Kamera-Zugriff wurde verweigert" | Browser-Berechtigung fehlt                      | Öffnen Sie die Browser-Einstellungen → Datenschutz/Berechtigungen → Kamera → Erlauben für app.bienenstock-kita.de |
| "Kamera wird bereits verwendet"   | Andere App nutzt die Kamera (Zoom, Teams, etc.) | Schließen Sie alle anderen Apps, die die Kamera verwenden, und klicken Sie "NEU LADEN"                            |
| "Keine Kamera gefunden"           | Gerät hat keine Kamera oder sie ist deaktiviert | Prüfen Sie, ob eine Frontkamera vorhanden ist. Bei externen USB-Kameras: Kabel prüfen                             |
| "Kamera-Zugriff erfordert HTTPS"  | Seite wird über HTTP geladen                    | Stellen Sie sicher, dass die URL mit `https://` beginnt                                                           |
| Kamera zeigt schwarzes Bild       | Kamera-Linse verdeckt oder Kiosk-Modus-Problem  | Prüfen Sie die Linse. Klicken Sie auf "NEU LADEN" um die Seite neu zu laden                                       |

**Wenn nichts hilft:**

1. Klicken Sie auf **"NEU LADEN"** auf der Check-in-Seite
2. Falls das nicht hilft: Wechseln Sie zur **manuellen PIN-Eingabe** (Button unter dem Scanner)
3. Die Einstellung wird gespeichert — beim nächsten Mal öffnet sich direkt die PIN-Eingabe

{% hint style="info" %}
Die Kamera versucht automatisch verschiedene Qualitätsstufen (hoch → mittel → niedrig → minimal). Bei älteren Tablets kann dies einige Sekunden dauern.
{% endhint %}

#### QR-Code wird nicht erkannt

| Problem                               | Lösung                                                                                                    |
| ------------------------------------- | --------------------------------------------------------------------------------------------------------- |
| QR-Code ist zu klein oder zu weit weg | Halten Sie den Code näher an die Kamera (ca. 15-20 cm)                                                    |
| Schlechte Beleuchtung                 | Verbessern Sie die Lichtverhältnisse im Eingangsbereich                                                   |
| QR-Code ist beschädigt oder verwischt | Drucken Sie einen neuen QR-Code aus der Datenbank (Admin → Datenbank → Kind auswählen → QR herunterladen) |
| "Kind nicht gefunden" nach Scan       | Der QR-Code gehört möglicherweise zu einer anderen KiTa, oder das Kind wurde aus der Datenbank entfernt   |

***

### Check-in / Check-out

#### Kind kann nicht eingecheckt werden

| Problem                                       | Ursache                            | Lösung                                                                                                    |
| --------------------------------------------- | ---------------------------------- | --------------------------------------------------------------------------------------------------------- |
| "Kind nicht gefunden in Datenbank"            | PIN existiert nicht in dieser KiTa | Prüfen Sie die PIN in der Datenbank (Admin → Datenbank → Kinder). Stimmt die PIN mit dem QR-Code überein? |
| "KiTa nicht gefunden"                         | Keine KiTa ausgewählt              | Wählen Sie oben in der Seitenleiste Ihre KiTa aus dem Dropdown                                            |
| Kind wird als "bereits eingecheckt" angezeigt | Doppelter Check-in versuch         | Das Kind ist schon da. Zum Auschecken erneut den QR-Code scannen oder PIN eingeben                        |
| Ampel ist rot, Check-in blockiert             | Kapazitätsgrenze erreicht          | Entweder: Roten Schwellenwert im Dashboard anpassen, oder warten bis Personal eincheckt                   |

#### Betreuungsmodell-Warnung beim Check-in

Wenn beim Einchecken die Meldung erscheint: **"Es sind derzeit keine weiteren Vollzeitplätze verfügbar"**

Das bedeutet: Die maximale Anzahl für dieses Betreuungsmodell (z.B. "U3-Kinder") ist erreicht.

**Optionen:**

1. **"Einverstanden, für halben Tag einchecken"** — Das Kind wird eingecheckt, erscheint aber in der Dashboard-Liste "Kinder, die heute früher gehen müssen"
2. **"Abbrechen"** — Check-in wird nicht durchgeführt

{% hint style="warning" %}
Sie können die maximale Anzahl pro Betreuungsmodell direkt im Dashboard ändern: Klicken Sie auf das Stift-Symbol neben dem Betreuungsmodell in der Kinder-Karte.
{% endhint %}

#### Automatisches Auschecken funktioniert nicht

Das automatische Auschecken wird ausgelöst, wenn die aktuelle Uhrzeit die **Schließzeit** der KiTa erreicht.

**Checkliste:**

1. Ist eine **Schließzeit** in den Einstellungen eingetragen? (Admin → Einstellungen → Schließzeit)
2. Ist die Schließzeit im Format **HH:MM** (z.B. "17:00")?
3. Ist die Check-in-Seite (`/kinder`) im Browser geöffnet? Das Auto-Checkout läuft nur auf dieser Seite
4. Hat der Browser Cookies aktiviert? (Auto-Checkout wird per Cookie nachverfolgt, um doppeltes Auschecken zu verhindern)

**Wenn es trotzdem nicht funktioniert:**

* Checken Sie die Personen **manuell** aus (Dashboard → Kinder/Personal → "Check Out" Button)
* Eine Fehlermeldung wie "Fehler beim automatischen Auschecken. Bitte checken Sie die Personen manuell aus." erscheint, wenn ein technisches Problem vorliegt

***

### Personal-Check-in

#### PIN wird nicht akzeptiert

| Problem                                   | Lösung                                                                                                           |
| ----------------------------------------- | ---------------------------------------------------------------------------------------------------------------- |
| Falsches Passwort auf der Erzieher-Seite  | Es wird das **Personal-Passwort** benötigt (nicht das Admin-Passwort). Prüfen Sie es unter Admin → Einstellungen |
| "Kein Faktor für den Erzieher festgelegt" | Der Mitarbeiter hat keinen Standard-Faktor. Admin → Datenbank → Personal → Faktor eintragen                      |

#### Personal erscheint nicht in der Liste

* Prüfen Sie, ob der Mitarbeiter in der richtigen **KiTa** angelegt ist
* Prüfen Sie, ob der Mitarbeiter einer **Gruppe** zugeordnet ist
* Nach dem Anlegen eines neuen Mitarbeiters: Seite neu laden oder kurz warten (Echtzeit-Synchronisation)

***

### Passwörter

#### Internes Passwort vergessen

{% hint style="info" %}
Wenn Sie eines der internen Passwörter (Personal oder Admin) vergessen haben: Loggen Sie sich aus und melden Sie sich mit dem **Master-Passwort** (E-Mail + Passwort) wieder an. Nach dem Login ist das Menü für die Passwort-Einstellungen für einige Sekunden geöffnet.
{% endhint %}

#### Master-Passwort vergessen

1. Gehen Sie auf die Login-Seite
2. Klicken Sie auf **"Passwort vergessen"**
3. Geben Sie Ihre registrierte E-Mail-Adresse ein
4. Sie erhalten einen Link zum Zurücksetzen per E-Mail
5. Prüfen Sie auch Ihren Spam-Ordner

#### "Falsches Passwort" bei Admin-Seiten

* **Admin-Seiten** (Dashboard, Berichte, Einstellungen, Meldungen) benötigen das **Admin-Passwort**
* **Erzieher-Seite** und **Nachrichten** benötigen das **Personal-Passwort**
* Das Admin-Passwort wird für **5 Minuten** zwischengespeichert
* Das Personal-Passwort wird für **24 Stunden** zwischengespeichert

***

### Daten & Synchronisation

#### Daten werden nicht in Echtzeit aktualisiert

Bienenstock nutzt Echtzeit-Synchronisation über Supabase Realtime. Bei Verbindungsproblemen:

1. **Automatische Wiederverbindung:** Das System versucht automatisch bis zu 5 Mal, die Verbindung wiederherzustellen (mit steigenden Wartezeiten: 1s → 2s → 4s → 8s → 16s, max. 30s)
2. **Inaktivitäts-Refresh:** Nach 10 Minuten Inaktivität werden alle Daten automatisch neu geladen
3. **Auto-Reload:** Nach 30 Sekunden kompletter Inaktivität wird die Seite automatisch neu geladen
4. **Manuell:** Laden Sie die Seite im Browser neu (F5 oder Cmd+R)

#### "Keine Internetverbindung"

Wenn diese Meldung als Vollbild-Overlay erscheint:

* Prüfen Sie die WLAN-Verbindung des Tablets
* Prüfen Sie, ob der Router funktioniert
* Testen Sie die Verbindung in einem anderen Browser-Tab
* Die App funktioniert **nicht offline** — eine stabile Internetverbindung ist erforderlich

***

### Berichte & Export

#### "Keine Logs gefunden"

| Meldung                                           | Bedeutung                              | Lösung                                                            |
| ------------------------------------------------- | -------------------------------------- | ----------------------------------------------------------------- |
| "Keine Logs gefunden für den {Datum}"             | Kein Check-in/out an diesem Tag        | Wählen Sie ein Datum, an dem Check-ins stattgefunden haben        |
| "Keine Logs für diese Arbeitswoche gefunden"      | Keine Aktivität in der laufenden Woche | Der Wochenbericht benötigt mindestens einen Check-in in der Woche |
| "Keine Logs für die letzte Arbeitswoche gefunden" | Keine Aktivität in der Vorwoche        | Die Vorwoche hatte keine Check-in-Aktivität                       |

#### Wochenbericht fragt nach Tagesbericht

**Das ist gewollt.** Bevor ein Wochenbericht erstellt werden kann, muss der heutige Tagesbericht existieren.

**Ablauf:**

1. Sie klicken auf "Wochenbericht erstellen"
2. Das System prüft, ob der heutige Tagesbericht vorhanden ist
3. Falls nicht: Der Metadaten-Dialog öffnet sich mit dem Hinweis "Um den Wochenbericht zu erstellen, muss zuerst der heutige Tagesbericht erstellt werden."
4. Nach dem Speichern wird automatisch erst der Tagesbericht, dann der Wochenbericht erstellt

#### Excel-Datei lässt sich nicht herunterladen

* Prüfen Sie, ob Ihr Browser Downloads erlaubt (Pop-up-Blocker deaktivieren)
* Versuchen Sie es mit einem anderen Browser
* Erstellen Sie den Bericht neu, falls die Datei beschädigt sein sollte

***

### Eltern-App & Meldungen

#### Eltern können sich nicht in der App anmelden

**Checkliste für die Einrichtung:**

1. Ist das **Eltern-Passwort** in den Einstellungen gesetzt? (Admin → Einstellungen)
2. Haben die Eltern die richtige **KiTa-Kennung** (Slug)? Zu finden auf der Meldungen-Seite
3. Ist der korrekte **API-Key** konfiguriert?

**Fehlercodes der Eltern-App:**

| Fehler               | Bedeutung                             | Lösung                                                                      |
| -------------------- | ------------------------------------- | --------------------------------------------------------------------------- |
| INVALID\_CREDENTIALS | Kennung oder Passwort falsch          | Korrekte Kennung und Eltern-Passwort weitergeben                            |
| INVALID\_KIND\_CODE  | Kind-Code existiert nicht             | PIN des Kindes in der Datenbank prüfen                                      |
| TOO\_LATE            | Frist für Essensabsage überschritten  | Frist in Einstellungen prüfen (Essensabsage-Frist)                          |
| ALREADY\_EXISTS      | Doppelte Meldung                      | Meldung wurde bereits eingereicht (z.B. doppelte Abwesenheit am selben Tag) |
| KITA\_CLOSED         | Einrichtung an diesem Tag geschlossen | Tag ist als Schließtag eingetragen                                          |

#### Meldungen erscheinen nicht auf der Meldungen-Seite

* Prüfen Sie das **ausgewählte Datum** — verwenden Sie die Pfeile, um zum richtigen Tag zu navigieren
* Meldungen erscheinen am **Datum der Abwesenheit**, nicht am Eingabedatum
* Echtzeit-Synchronisation: Meldungen sollten innerhalb weniger Sekunden erscheinen

***

### Ampel & Kapazität

#### Ampel zeigt falschen Status

Die Ampel berechnet: `(Summe Kinder-Faktoren / Summe Personal-Faktoren) × 100`

**Häufige Ursachen für falsche Anzeige:**

1. **Falscher Faktor** bei einem Kind oder Mitarbeiter → Prüfen Sie die Faktoren in der Datenbank
2. **Personal vergessen einzuchecken** → Kapazität wird zu hoch angezeigt
3. **Schwellenwerte falsch eingestellt** → Prüfen Sie die Werte im Dashboard (Ampel Rot/Gelb)

#### Kapazität zeigt "NaN%" oder "0%"

* Kein Personal eingecheckt → Es gibt keinen Nenner für die Berechnung
* Checken Sie mindestens eine Fachkraft ein, damit die Berechnung funktioniert

***

### Nachrichten

#### Nachrichten werden nicht auf der Eltern-Ampel angezeigt

1. Prüfen Sie, ob die Nachricht der richtigen **Gruppe** zugeordnet ist
2. Nachrichten erscheinen nur für die Gruppe, an die sie gesendet wurden
3. Prüfen Sie, ob die Nachricht noch **aktiv** ist (nicht gelöscht)

#### Nachricht kann nicht bearbeitet werden

* Klicken Sie auf das **Stift-Symbol** (nicht auf den Text)
* Im Bearbeitungsmodus: **Cmd+Enter** (Mac) oder **Ctrl+Enter** (Windows) zum Speichern
* **Esc** zum Abbrechen

***

### Browser-Kompatibilität

#### Empfohlene Browser

| Browser               | Status                | Hinweis                                              |
| --------------------- | --------------------- | ---------------------------------------------------- |
| **Chrome**            | Teilweise unterstützt | Empfohlen für Tablets                                |
| **Firefox**           | Teilweise unterstützt | Empfohlen für Tablets                                |
| **Edge**              | Teilweise unterstützt |                                                      |
| **Safari**            | Eingeschränkt         | Kamera-Probleme möglich, nicht empfohlen für Tablets |
| **Internet Explorer** | Nicht unterstützt     | Kein Kamera-Zugriff, veraltet                        |

#### Kiosk-Modus Probleme

* Wenn die App im Kiosk-Modus einfriert: Kiosk-Modus kurz beenden und neu starten
* Bei Kamera-Problemen im Kiosk-Modus: Den "NEU LADEN" Button auf der Check-in-Seite verwenden
* Stellen Sie sicher, dass das Tablet eine **stabile Stromversorgung** und **WLAN-Verbindung** hat

***

### Notfallkontakt

Sollte ein schwerwiegender Fehler die Funktion der App einschränken:

**E-Mail:** <bugs@bienenstock-kita.de> **WhatsApp (Notfall):** +49 1577 4993702 (Anna-Maria von Lauppert)

{% hint style="warning" %}
Bitte teilen Sie über den WhatsApp-Kanal **keine sensitiven Daten** (Passwörter, persönliche Daten von Kindern oder Eltern).
{% endhint %}