> 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/admin/markdown.md).

# Das Dashboard (Aktuelles)

Das Dashboard unter **Admin > Aktuelles** (`/admin/aktuell`) ist die zentrale Echtzeit-Ubersichtsseite Ihrer KiTa. Es zeigt die `Live-`Komponenten mit Kapazitatsauslastung, eingecheckten Kindern und Personal, Prognosen und manuellen Check-in-/Check-out-Funktionen.

***

### Obere Kartenreihe (StatusMonitor)

Im oberen Bereich des Dashboards werden vier Karten in einer Reihe angezeigt (auf dem Desktop vierspaltig, auf dem Handy untereinander gestapelt). Jede Karte hat oben eine **LiveBar** -- einen pulsierenden grunen Punkt, der die aktive Echtzeit-Verbindung zum Server signalisiert.

#### Karte 1: KiTa-Status

Diese Karte hat einen **blauen Farbverlauf** als Hintergrund und ist das Herzstuck des Dashboards.

* **Mitte links:** Grosse Prozentzahl der aktuellen Auslastung (z.B. **75%**)&#x20;
* **Darunter:** Der korrespondierende Kapazitats-Rohwert als Dezimalzahl (z.B. **12,50**)&#x20;
* **Mitte rechts:** Eine vertikale **Ampel-Komponente** (TrafficLight), die den aktuellen Zustand farblich anzeigt (Grun, Gelb oder Rot)
* **Unter der Ampel:** Die konfigurierten Schwellenwerte für die Ampel

\[Screenshot: KiTa-Status-Karte mit Auslastung, Kapazitat und Ampel]

#### Karte 2: Personal

Weisse Karte mit Informationen zum eingecheckten Personal.

* **Grosse Zahl:** Anzahl der aktuell eingecheckten Fachkrafte
* **Aufschluesselung:** Pro **Arbeitsmodell** eine Zeile&#x20;
* &#x20;**Lupen-Symbol** -- ein Klick darauf offnet den StatsDialog im Modus Tabellen

\[Screenshot: Personal-Karte mit Aufschluesselung nach Arbeitsmodell]

#### Karte 3: Kinder

Weisse Karte mit Informationen zu den eingecheckten Kindern.

* **Grosse Zahl:** Anzahl der aktuell eingecheckten Kinder
* **Aufschluesselung:** Pro **Betreuungsart** eine Zeile&#x20;
* **Bearbeitungssymbol:** Neben jeder Betreuungsart befindet sich ein Stift-Symbol. Ein Klick darauf offnet einen Inline-Dialog, in dem Sie den `max_children`-Wert direkt anpassen konnen.
* &#x20;**Lupen-Symbol** -- ein Klick darauf offnet den StatsDialog im Modus Tabellen

\[Screenshot: Kinder-Karte mit Betreuungsart-Aufschluesselung und Bearbeitungssymbolen]

{% hint style="info" %}
Durch die direkte Bearbeitung der Maximalgrenzen pro Betreuungsart konnen Sie tagesaktuelle Anpassungen vornehmen, ohne in die Einstellungen wechseln zu muessen.
{% endhint %}

#### Karte 4: Schwellenwerte bearbeiten (nur Admin-Seite)

Zwei separate Karten zum Anpassen der Ampel-Schwellenwerte:

**Karte "Ampel Rot":**

* Anzeige: "Aktuell: {Wert}"
* Eingabefeld "Neuer Wert" (Schrittweite 0,05)
* Bestatigen mit "OK"-Button

**Karte "Ampel Gelb":**

* Anzeige: "Aktuell: {Wert}"
* Eingabefeld "Neuer Wert" (Schrittweite 0,05)
* Bestatigen mit "OK"-Button

{% hint style="warning" %}
Anderungen an den Schwellenwerten wirken sich sofort auf den Ampelstatus aus -- auch auf der Eltern-Ampel und dem Kinder-Check-in-Terminal.
{% endhint %}

***

### Bedingte Anzeige: Kinder mit eingeschrankter Betreuung

Dieser Bereich erscheint **nur**, wenn Kinder eingecheckt sind, die keinen Vollzeitplatz mehr bekommen haben (bedingte Check-ins).

* **Uberschrift:** "Kinder, die heute frueher gehen muessen"
* **Tabelle:** Name | Gruppe | PIN | Betreuungsmodell
* **Erklarungstext:** "Diese Kinder haben keinen Vollzeitplatz mehr bekommen und muessen heute frueher abgeholt werden."

{% hint style="warning" %}
Wenn diese Anzeige erscheint, informieren Sie die betroffenen Eltern umgehend ueber die fruehere Abholzeit.
{% endhint %}

***

### Akkordeon-Bereiche

Unterhalb der Kartenreihe befinden sich aufklappbare Akkordeon-Bereiche.

#### Akkordeon 1: Prognosen

* **Inhalt:**
  * **Kapazitats-Prognosediagramm**  Ein Liniendiagramm  das die voraussichtliche Kapazitatsauslastung in Prozent uber den Tagesverlauf zeigt.

\[Screenshot: Prognosen-Akkordeon mit Kapazitats- und Gruppendiagramm]

{% hint style="info" %}
Die Prognose hilft Ihnen, Engpasse fruehzeitig zu erkennen -- z.B. wenn uber die Mittagszeit weniger Personal eingeplant ist.
{% endhint %}

#### Akkordeon 2: Kinder in der Einrichtung

* **Button im Header:** "Kind Manuell Einchecken" -- offnet einen Dialog mit einer Autocomplete-Suche (siehe Workflow unten)

**Tab-Leiste:** "Alle Kinder" + ein Tab pro Gruppe

**Tabelle "Alle Kinder":**

| PIN  | Name        | Gruppe       | Faktor | Betreuungsmodell | Status                     | Aktionen                 |
| ---- | ----------- | ------------ | ------ | ---------------- | -------------------------- | ------------------------ |
| 1234 | Max Mueller | Sonnenschein | 1.0    | Ganztagsplatz    | Eingecheckt (gruener Chip) | Check Out (roter Button) |

**Tabelle pro Gruppe:**

| PIN  | Faktor | Betreuungsmodell | Status                     | Aktionen                 |
| ---- | ------ | ---------------- | -------------------------- | ------------------------ |
| 1234 | 1.0    | Ganztagsplatz    | Eingecheckt (gruener Chip) | Check Out (roter Button) |

* **Check-Out:** Ein Klick auf "Check Out" zeigt einen Bestatigungsdialog: "Moechten Sie das Kind wirklich auschecken?"
* **Leerer Zustand:** "Momentan sind keine Kinder eingecheckt."

\[Screenshot: Kinder-Akkordeon mit Tabelle und Gruppen-Tabs]

#### Akkordeon 3: Erzieher:innen in der Einrichtung

**Tab-Leiste:** "Alle Erzieher" + ein Tab pro Gruppe

**Tabelle "Alle Erzieher":**

| Name          | PIN  | Gruppe       | Faktor | Arbeitsmodell | Status                     | Aktionen                 |
| ------------- | ---- | ------------ | ------ | ------------- | -------------------------- | ------------------------ |
| Sarah Schmidt | 5678 | Sonnenschein | 1.0    | Vollzeit      | Eingecheckt (gruener Chip) | Check Out (roter Button) |

**Tabelle pro Gruppe:**

| Name          | PIN  | Faktor | Arbeitsmodell | Status                     | Aktionen                 |
| ------------- | ---- | ------ | ------------- | -------------------------- | ------------------------ |
| Sarah Schmidt | 5678 | 1.0    | Vollzeit      | Eingecheckt (gruener Chip) | Check Out (roter Button) |

* **Check-Out:** Erfordert ebenfalls einen Bestatigungsdialog

\[Screenshot: Erzieher-Akkordeon mit Tabelle und Gruppen-Tabs]

***

### Schwebender Aktionsbutton (FAB)

In der unteren rechten Ecke befindet sich ein **blauer, schwebender Aktionsbutton** (Floating Action Button) mit einem **Plus-Symbol**. Ein Klick darauf offnet den StatsDialog im Modus "child".

***

### Workflow: Kind manuell vom Dashboard einchecken

1. Klicken Sie auf den Button **"Kind Manuell Einchecken"** im Header des Kinder-Akkordeons.
2. Ein Dialog offnet sich mit einem **Autocomplete-Suchfeld**. Es werden nur Kinder angezeigt, die aktuell **nicht** eingecheckt sind.
3. Geben Sie die **PIN** des Kindes ein, um es zu finden, und wahlen Sie es aus.
4. Klicken Sie auf **"Kind {PIN} einchecken"**.
5. Ein Bestatigungsdialog erscheint: **"Moechten Sie das Kind wirklich einchecken?"**
6. Falls die **Betreuungsart bereits ausgelastet** ist (z.B. alle Ganztagsplatze belegt), erscheint ein zweiter Dialog mit der Option, das Kind fuer einen **halben Tag** einzuchecken.
7. Bei Erfolg ertont ein **Sound-Effekt** und eine Erfolgsmeldung wird angezeigt.
8. Das Kind erscheint sofort in der eingecheckten Kinderliste.

{% hint style="info" %}
Der manuelle Check-in vom Dashboard ist vor allem fuer Sonderfalle gedacht -- z.B. wenn das Check-in-Terminal nicht verfuegbar ist oder ein Kind nachtraeglich erfasst werden muss.
{% endhint %}

### Workflow: Kind oder Fachkraft vom Dashboard auschecken

1. Suchen Sie die Person im entsprechenden Akkordeon (Kinder oder Erzieher:innen).
2. Nutzen Sie die **Gruppen-Tabs**, um schneller zur richtigen Gruppe zu navigieren.
3. Klicken Sie auf den roten **"Check Out"**-Button in der Aktionen-Spalte.
4. Bestatigen Sie im Dialog: **"Moechten Sie das Kind/die Fachkraft wirklich auschecken?"**
5. Das Check-out wird sofort durchgefuehrt und die Kapazitatsanzeige aktualisiert sich in Echtzeit.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://bienenstock.gitbook.io/bienenstock/admin/markdown.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
