# Fluid Synoptic

Der Abschnitt Fluid Synoptic verwaltet die Energiemessinfrastruktur des Gebäudes und erfasst Verwaltungsbesuche vor Ort. Er bietet ein strukturiertes Verzeichnis aller Versorgungszähler (Wasser, Strom, Gas, Wärme und Kälte), die mit ihren jeweiligen Mietern und versorgten Bereichen verknüpft sind, sowie ein vollständiges Identitätsprofil, das festhält, wer das Gebäude verwaltet und besucht.

***

## Überblick

Der Abschnitt Fluid Synoptic ist in zwei verschiedene Bereiche unterteilt:

| Abschnitt                  | Beschreibung                                                                                      |
| -------------------------- | ------------------------------------------------------------------------------------------------- |
| **Identitätsprofil**       | Erfasst die Besuchshistorie vor Ort und die wichtigsten Verwaltungskontakte für das Gebäude.      |
| **Fluid Synoptic-Tabelle** | Verzeichnis aller Energie- und Versorgungszähler, ihrer Standorte, Mieter und Validierungsstatus. |

***

## Identitätsprofil

Die Identitätsprofil-Tabelle bietet eine konsolidierte Ansicht, wer das Gebäude verwaltet und wann es besucht wurde. Dies ist besonders wichtig für das Facility Management, Audits und die Einhaltung gesetzlicher Vorschriften.

### Tabellenspalten

| Spalte               | Beschreibung                                                      |
| -------------------- | ----------------------------------------------------------------- |
| **Hausverwalter**    | Name des für das Gebäude verantwortlichen Hausverwalters.         |
| **Energiemanager**   | Name des für den Verbrauchsüberblick zuständigen Energiemanagers. |
| **Facility Manager** | Name des für den täglichen Betrieb zuständigen Facility Managers. |
| **Mieter**           | Liste der beim Besuch anwesenden oder vertretenen Mieter.         |
| **Nutzfläche**       | Die beim Besuch erfasste Gesamtnutzfläche.                        |
| **Besuchsdatum**     | Das Datum, an dem der Vor-Ort-Besuch durchgeführt wurde.          |
| **Adressen**         | Die bei der Vor-Ort-Inspektion besuchte(n) Adresse(n).            |

### Einen Besuch hinzufügen

Klicken Sie auf **Besuch hinzufügen**, um einen neuen Vor-Ort-Besuch zu erfassen. Das Formular enthält folgende Felder:

| Feld                 | Typ             | Erforderlich | Hinweise                                                                   |
| -------------------- | --------------- | ------------ | -------------------------------------------------------------------------- |
| **Besuchsdatum**     | Datumsauswahl   | Ja           | Das Datum des Besuchs.                                                     |
| **Mieter**           | Mehrfachauswahl | Nein         | Wählen Sie alle Mieter aus, die beim Besuch anwesend oder vertreten waren. |
| **Hausverwalter**    | Auswahl / Text  | Ja           | Der für die Durchführung des Besuchs verantwortliche Hausverwalter.        |
| **Energiemanager**   | Auswahl / Text  | Nein         | Der beim Besuch anwesende Energiemanager.                                  |
| **Facility Manager** | Auswahl / Text  | Nein         | Der beim Besuch anwesende Facility Manager.                                |

Jeder Besuchsdatensatz wird der Identitätsprofil-Tabelle hinzugefügt und ist nach dem Speichern unveränderlich — die vollständige Besuchshistorie wird aufbewahrt.

***

## Fluid Synoptic-Tabelle

Die Fluid Synoptic-Tabelle ist ein umfassendes Verzeichnis aller Versorgungszähler im Gebäude. Sie verfolgt, welchen Mieter jeder Zähler versorgt, den physischen Standort des Zählers, zugehörige Unterzähler und den Validierungsstatus.

### Unterstützte Energietypen

| Energietyp | Beschreibung                           |
| ---------- | -------------------------------------- |
| **Wasser** | Kalt- und Warmwasserversorgungszähler. |
| **Strom**  | Stromverbrauchszähler.                 |
| **Gas**    | Erdgasversorgungszähler.               |
| **Wärme**  | Fernwärme- oder Zentralheizungszähler. |
| **Kälte**  | Fernkälte- oder Zentralkühlungszähler. |

### Tabellenspalten

| Spalte                      | Beschreibung                                                                             |
| --------------------------- | ---------------------------------------------------------------------------------------- |
| **Energietyp**              | Die Art der gemessenen Energie (Wasser, Strom, Gas, Wärme, Kälte).                       |
| **Zähler-ID-Nummer**        | Der eindeutige Bezeichner des physischen Zählers (wie auf dem Gerät angegeben).          |
| **Zählerstandort**          | Der physische Standort des Zählers im Gebäude im Standardformat.                         |
| **Mieterunternehmen**       | Das für den von diesem Zähler gemessenen Verbrauch in Rechnung gestellte Unternehmen.    |
| **Mieter**                  | Der mit diesem Zähler verbundene individuelle Mieterkontakt.                             |
| **Rechnungsempfänger**      | Die für die Zahlung verantwortliche juristische Person (kann vom Mieter abweichen).      |
| **Versorgter Bereich**      | Die Loscodes aller von diesem Zähler versorgten Bereiche.                                |
| **Zugehöriger Unterzähler** | Eine verknüpfte Unterzähler-ID, wenn dieser Zähler einen nachgelagerten Unterzähler hat. |
| **Validator**               | Der für die Validierung dieses Zählerdatensatzes zuständige Beteiligte.                  |
| **Status**                  | Aktueller Validierungsstatus (PENDING\_VALIDATION / VALIDATED / REJECTED).               |

***

## Zählerstandort-Format

Zählerstandorte müssen einer standardisierten Namenskonvention folgen, um Konsistenz und Rückverfolgbarkeit im gesamten Gebäude sicherzustellen:

```
STADT.STOCKWERK.LOS
```

**Beispiel:** `RNS.2.12`

Dies bedeutet: Stadtcode **RNS**, Stockwerk **2**, Los **12**.

Dieses Format verknüpft den physischen Standort des Zählers mit dem Los- und Stockwerksystem des Gebäudes und ermöglicht eine einfache Querverweisierung mit den Losteilungsdatensätzen.

***

## Einen Zähler hinzufügen

Klicken Sie auf **+ Zähler hinzufügen**, um das Zähler-Erstellungsformular zu öffnen.

### Formularfelder

| Feld                        | Typ             | Erforderlich | Hinweise                                                                                                                                                             |
| --------------------------- | --------------- | ------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Energietyp**              | Auswahl         | Ja           | Wasser, Strom, Gas, Wärme oder Kälte.                                                                                                                                |
| **Zähler-ID-Nummer**        | Text            | Ja           | Die auf dem Gerät aufgedruckte physische ID des Zählers.                                                                                                             |
| **Zählerstandort**          | Text            | Ja           | Format: `STADT.STOCKWERK.LOS` (z. B. `RNS.2.12`).                                                                                                                    |
| **Leerstandszähler**        | Umschalter      | Nein         | Wenn EIN geschaltet, ist der Zähler einem leerstehenden Raum zugeordnet und wird **automatisch validiert**, ohne dass eine Validierungsgenehmigung erforderlich ist. |
| **Mieterunternehmen**       | Text            | Bedingt      | Erforderlich, wenn Leerstandszähler AUS ist.                                                                                                                         |
| **Mieter**                  | Auswahl         | Bedingt      | Erforderlich, wenn Leerstandszähler AUS ist. Aus den registrierten Beteiligten des Gebäudes auswählen.                                                               |
| **Rechnungsempfänger**      | Text            | Bedingt      | Erforderlich, wenn der Rechnungsempfänger vom Mieterunternehmen abweicht.                                                                                            |
| **Versorgter Bereich**      | Mehrfachauswahl | Nein         | Einen oder mehrere von diesem Zähler versorgte Loscodes auswählen.                                                                                                   |
| **Zugehöriger Unterzähler** | Text            | Nein         | Die ID eines nachgelagerten Unterzählers für diesen Zähler eingeben.                                                                                                 |
| **Validator**               | Auswahl         | Nein         | Einen einzelnen Validator für diesen Zählerdatensatz auswählen.                                                                                                      |

### Leerstandszähler-Umschalter

Ähnlich wie der Leerstand-Umschalter in der Losteilung: Wenn **Leerstandszähler** aktiviert ist, ist der Zählerdatensatz einem nicht belegten Raum zugeordnet. Der Datensatz wird **automatisch validiert**, ohne dass eine Validator-Überprüfung erforderlich ist, was die Dateneingabe für leerstehende Einheiten rationalisiert.

***

## Validierungs-Workflow

### Status-Lebenszyklus

Zählerdatensätze durchlaufen folgende Statuswerte:

```
(Erstellt) → PENDING_VALIDATION → VALIDATED
                               → REJECTED
```

| Status                  | Beschreibung                                                                    |
| ----------------------- | ------------------------------------------------------------------------------- |
| **PENDING\_VALIDATION** | Der Zählerdatensatz wurde eingereicht und wartet auf die Validator-Überprüfung. |
| **VALIDATED**           | Der zugewiesene Validator hat den Datensatz genehmigt.                          |
| **REJECTED**            | Der Validator hat den Datensatz mit einem Grund abgelehnt.                      |

### Ablehnung

Wenn ein Validator einen Zählerdatensatz ablehnt, ist ein **Ablehnungsgrund** erforderlich. Dieser Grund wird im Prüfpfad gespeichert und ist für den Einreicher sichtbar. Nach der Korrektur der Informationen kann der Einreicher erneut einreichen, was eine neue Version erstellt und den Status auf PENDING\_VALIDATION zurücksetzt.

***

## Versionshistorie

Jede Aktualisierung eines Zählerdatensatzes erstellt eine **neue Version**. Die vorherige Version wird archiviert (ersetzt) und aufbewahrt. Jede Version erfasst:

* Die Feldwerte bei dieser Version.
* Wer die Änderung vorgenommen hat und wann.
* Den Validierungsstatus zum damaligen Zeitpunkt.

Dies gewährleistet eine vollständige, manipulationssichere Historie aller Zählerdatenänderungen.

***

## Aufgabenintegration

Die Fluid Synoptic-Funktion erzeugt automatisch folgende Aufgabentypen:

| Aufgabentyp                         | Auslöser                                                                                       |
| ----------------------------------- | ---------------------------------------------------------------------------------------------- |
| **VALIDATE\_ENERGY\_METER**         | Ein Zählerdatensatz wird zur Validierung eingereicht. Für den zugewiesenen Validator erstellt. |
| **UPDATE\_REJECTED\_ENERGY\_METER** | Ein Zählerdatensatz wird abgelehnt. Für den Einreicher des Zählerdatensatzes erstellt.         |

Diese Aufgaben erscheinen im [Aufgaben](/magma-documentation/de/funktionen/tasks.md)-Panel und im [Aktivitätsfeed](/magma-documentation/de/funktionen/activity-feed.md).

***

## Tipps und Best Practices

* Pflegen Sie das **Identitätsprofil** konsequent nach jedem Vor-Ort-Besuch — dies erstellt einen dauerhaften Nachweis der Gebäudeverwaltungsaktivität, der für Audits, Due Diligence und regulatorische Berichterstattung wertvoll ist.
* Verwenden Sie den **Leerstandszähler-Umschalter** sofort, wenn eine Einheit leersteht, um zu vermeiden, dass ein veralteter Mieterzuordnung auf einem aktiven Zähler verbleibt — dies hält Ihre Energiedaten sauber und reduziert den Validierungsaufwand.
* Weisen Sie **Unterzähler** genau über das Feld „Zugehöriger Unterzähler" zu — dies ermöglicht eine genaue Abrechnungsabstimmung zwischen Hauptzählern und individuellen Einheiten-Unterzählern.
* Halten Sie die Loscodes des **versorgten Bereichs** aktuell, wenn Mieter wechseln oder Loszuweisungen geändert werden. Veraltete Daten zum versorgten Bereich können Diskrepanzen in den Energiekostenverteilungsberichten verursachen.
* Gleichen Sie Zählerstandorte mit den Losteilungsdatensätzen ab, um sicherzustellen, dass die in Fluid Synoptic verwendeten `STADT.STOCKWERK.LOS`-Codes mit den in der Losteilung registrierten übereinstimmen.


---

# Agent Instructions: 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:

```
GET https://docs.mymagma.com/magma-documentation/de/funktionen/fluid-synoptic.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
