Observer

Demo-Einrichtung

Probieren Sie Observer mit einer vollständig befüllten Datenbank in unter 5 Minuten aus. Der seed-Befehl füllt die Datenbank mit realistischen Testdaten — Personen, Projekte, Unterstützungseinträge, Migrationsverläufe, Haushalte und mehr — so können Sie alle Funktionen erkunden, ohne Daten manuell eingeben zu müssen.

Schnellstart

git clone https://github.com/lbrty/observer.git
cd observer
just build
./observer setup
docker compose up -d
./observer migrate up
./observer seed
./observer serve

Öffnen Sie http://localhost:9000/health — Sie sollten {"status":"healthy"} sehen.

Starten Sie die Weboberfläche:

cd packages/observer-web
bun install
bun run dev

Öffnen Sie http://localhost:5173 und melden Sie sich mit admin@example.com / password an.

Was der seed-Befehl erstellt

WasDetails
ReferenzdatenLänder, Bundesländer, Orte, Büros, Kategorien
BenutzerAdmin- + Mitarbeiterkonten, alle mit Passwort password
Projekte2 Projekte (konfigurierbar mit --projects)
Personen50 pro Projekt (konfigurierbar mit --people)
UnterstützungseinträgeBeratungsdatensätze, verknüpft mit Personen
MigrationseinträgeBewegungsverlauf mit Herkunfts-/Zielorten
HaushalteFamiliengruppen mit Mitgliedern
NotizenFallnotizen zu Personen
HaustiereHaustiereinträge mit Tags
TagsProjektbezogene Labels zur Kategorisierung

Standard-Anmeldedaten

EmailPasswordRolle
admin@example.compasswordAdmin

Benutzerdefinierte Seed-Optionen

# Mehr Projekte und Personen
./observer seed --projects 5 --people 200

# Reproduzierbare Daten (gleicher Seed = gleiche Ausgabe)
./observer seed --seed 42
Der seed-Befehl löscht ALLE Tabellen, bevor Daten eingefügt werden. Führen Sie ihn niemals gegen eine Produktionsdatenbank aus.

Schritt-für-Schritt-Anleitung

1. Build

just build

Kompiliert die observer-Binary.

2. Setup

./observer setup

Erstellt .env mit sinnvollen Standardwerten, die Verzeichnisse keys/ und data/uploads/ sowie ein 4096-Bit RSA-Schlüsselpaar für die JWT-Signierung. Falls .env bereits existiert, wird vor dem Überschreiben nachgefragt.

3. Dienste starten

docker compose up -d

Startet PostgreSQL und Redis im Hintergrund.

4. Migrieren

./observer migrate up

Wendet alle Datenbankmigrationen an.

5. Seed

./observer seed

Füllt die Datenbank mit Demodaten. Dieser Schritt macht den Unterschied zwischen einer leeren Instanz und einer funktionierenden Demo, die Sie Stakeholdern zeigen können.

6. Starten

./observer serve

Startet den API-Server unter http://localhost:9000.

7. Frontend (optional)

cd packages/observer-web
bun install
bun run dev

Startet die Weboberfläche unter http://localhost:5173.

Zurücksetzen

Um alles zu löschen und neu zu beginnen:

docker compose down -v

Dann ab Schritt 3 erneut ausführen.

Davor
Architektur
Danach
Frontend