Repository und Entwicklungsumgebung

Die Entwicklungsumgebung enthält zwei FROST‑Instanzen, weil die Integrationstests die Mandantentrennung prüfen und dafür zwei Mandanten brauchen. frost_server_b ist bewusst dauerhaft und nicht optional: Ohne CI‑Job ist ein Teststapel, den man erst einschalten muss, ein Teststapel, den nichts jemals startet. Die Mehrkosten sind ein Container — er teilt sich den Datenbankserver (als zweite Datenbank) und den Keycloak‑Realm mit frost_server und braucht dort nur einen eigenen Client.

Beide Instanzen laufen auf demselben festgeschriebenen Image‑Tag (FROST_SERVER_TAG), damit sie nicht unbemerkt auf verschiedene FROST‑Versionen auseinanderlaufen (Image‑Tag).

Der Stapel enthält eine eigene ThingsBoard‑Installation (thingsboard, Port 9090) — die Community Edition, weil es die Professional Edition nicht als frei beziehbares Image gibt. Genau das ist auch der Grund, aus dem es THINGSBOARD_EDITION überhaupt gibt: Die Community Edition kennt keine API‑Key‑Authentifizierung, der lokale Stapel läuft deshalb mit ce und Benutzername/Passwort.

Der Image‑Tag (THINGSBOARD_CE_TAG) ist aus einem härteren Grund festgeschrieben als bei FROST: ThingsBoard legt sein Schema einmal an, nämlich auf einem leeren Volume, und migriert beim Start nicht. Ein wandernder Tag lässt deshalb früher oder später ein neueres Image auf ein älteres Schema treffen — ein Fehler, der sich nicht von selbst meldet. Das Volume thingsboard_data bleibt erhalten, weil der erste Start die Schema‑Installation mitmacht und gut eine Minute dauert, während jeder weitere in Sekunden bereit ist.

docker compose up hinterlässt eine leere ThingsBoard‑Installation; die beiden Testmandanten legt die Testsuite an. Das Fixture thingsboard_provisioned in tests/integration/conftest.py ruft dazu einmal je Lauf provision() aus tests/integration/thingsboard_data.py auf. Ein eigener Bereitstellungs‑Container dafür wäre eine zweite Stelle, die dasselbe entscheidet: Die Bereitstellung ist ohnehin aus jedem Zustand heraus wiederholbar — Vorhandenes bleibt unangetastet, Fehlendes entsteht neu, und ein Mandantenadmin, dessen Passwort nicht mehr das aus .env ist, wird samt Mandant neu aufgebaut, weil ThingsBoard keinen Weg bietet, ein Passwort von der Sysadmin‑Seite aus zu setzen. Die Zugangsdaten in .env sind damit verbindlich und nicht bloß erhofft.

Zwei Tests, beide reiner Gutfall: Ein Gerät entsteht in FROST aus seinem ThingsBoard‑Datensatz, und Telemetrie landet als Observation an ihrem Datastream. Mehr nicht — alles andere ist lokal bewiesen, und es hier zu wiederholen kostete nur Schreibzugriffe auf ein System, das andere gerade benutzen.

Es ist die einzige Deckung, die der pe‑Zweig noch hat: Die Community Edition kennt keine API‑Key‑Authentifizierung, also sind Anmeldeverfahren, Client‑Klasse und Credential‑Form dort von der ersten bis zur letzten Zeile ein anderer Weg — und das Deployment, gegen das dieser Adapter tatsächlich läuft, ist PE.

Vorlage ist .env.staging.example; die ausgefüllte .env.staging steht in .gitignore.

set -a exportiert, was die Datei setzt, und eine exportierte Variable gewinnt gegen .env: Der Adapter lädt diese mit load_dotenv(), das Vorhandenes nie überschreibt. Die lokalen Vorgaben in .env bleiben also unangetastet. Der Compose‑Stapel muss trotzdem laufen — die FROST‑Server, die diese Tests lesen, sind die lokalen; geprüft wird die ThingsBoard‑Hälfte.

Welcher Test wohin gehört, regelt die Spiegelregel in Architektur im Detail; ihr verbindlicher Wortlaut steht im Docstring von tests/unit/init.py.

Wird ausschließlich für pytest -m staging in die Shell geladen und sonst von nichts gelesen (Der Staging‑Lauf). Sie nennt THINGSBOARD_URL und THINGSBOARD_EDITION="pe" für das gemeinsame System sowie THINGSBOARD_TEST_API_KEY_A und THINGSBOARD_TEST_API_KEY_B — je einen schreibberechtigten Schlüssel aus zwei verschiedenen ThingsBoard‑Mandanten. Landen beide im selben Mandanten, verweigert die Suite den Dienst: Jede Isolationseigenschaft, die sie prüft, wäre dann nicht mehr widerlegbar. Der Adapter selbst liest die Schlüssel nie.

Einen neuen Schlüssel erzeugt:

Das Frontend liest seine eigene Datei, nicht .env. Entscheidend ist frost_adapter_backend_base_url — lokal http://localhost:8000, im Container http://thingsboard_frost_adapter:8000 — sowie der [auth]‑Block für die Keycloak‑Anmeldung. Vorlage ist .streamlit/secrets-example.toml; die Details stehen in Frontend (Streamlit).