Kontrolle der Live-Streams aus den Aufzeichnungsräumen der Universität
Osnabrück: Django-Backend (backend/) + React/Vite-SPA (frontend/). Gemeinsame Basis der virtUOS
"-bar"-Tools aus dem basicbar-Repo: basicbar-auth (OIDC), basicbar-integrations
(LibreTranslate/LiteLLM) und @basicbar/ui
(Tailwind-Preset, base.css, Theme, i18n, TranslatableField, Preferences). Paketcode
nie lokal patchen — Änderungen gehören ins basicbar-Repo, Upgrade per
Versions-Bump (Changelog dort = Migrationsanleitung).
Frontend 5179, Backend 8007, Keycloak 8086, Postgres 5438.
- Backend-Apps:
config(Settings/URLs),accounts(User, Zugangsprüfung über IdP-Gruppe/Bootstrap/Einladungen, Einladungs- und Benutzersuche-API),recorders(Rekorder, Status, Monitor-Einstellungen, API, Monitor-Zyklus;audio_monitor.pyführt den Ton-Durchlauf aus;AudioSample= ein Pegelwert je Messung;history.py= Kalender-/Vorfallsdaten, geteilt mit „Letzte Aufzeichnung“;retention.py= Aufbewahrung,prune_history, stündlich im Monitor),opencast(read-only-Client der External API, Sync von Agents und Terminen,ScheduledEvent,OpencastSyncState),alarms(Alarmempfänger,SentNotification-Protokoll, E-Mail-Zustellung im Monitor-Zyklus; Alarmregeln liegen inrecorders/alarm_rules.py,/metricsincommon/views.py),recorders/tickets.py(GitLab-Client und Ticket-Text; EndpunktPOST /api/recorders/<id>/ticket/; Token verschlüsselt übercommon/encryption.py, Einstellungen inMonitorSettings),streams(HLS-Probe: Master-/Chunklist, Frische der Media-Sequence;audio.py: Pegelmessung mit ffmpeg),common(Basis). - Monitor: eigener Compose-Dienst
monitor,python manage.py run_monitor(--oncefür einen Lauf); IntervallMONITOR_INTERVAL_SECONDS. Der Monitor misst den Ton in einem eigenen Thread (AUDIO_*, Stufe 3b). - Frontend (
frontend/src/):media/(hls.js-Player, Web-Audio, Pegel),pages/(Übersicht, Raumansicht, RaumkalenderRoomCalendar, Landing/NoAccess,admin/; Zeitleiste/Pegelkurve:timeline.ts,EventTimeline,LevelCurve),components/(Kachel, Raumliste, StatusBadge, Formularteile, Dialog),api.ts(Client),locales/(Übersetzungen). - Website (GitHub Pages, DE/EN):
website/(MkDocs Material, siehewebsite/README.md); Screenshots perfrontend/e2e/docs-screenshots.spec.tsmit erfundenen API-Antworten (frontend/e2e/docs-data.ts). - Spec:
docs/superpowers/specs/2026-10-30-ansehbar-design.md, Plan:docs/superpowers/plans/2026-10-30-ansehbar-stufe-1.md.
docker compose exec backend python manage.py test # Backend-Tests
docker compose exec frontend npx tsc -b # Frontend-Typecheck
docker compose exec frontend npm test # Frontend-Tests (vitest)
docker compose exec frontend npm run check:i18n # jeder t("…")-Key hat eine deutsche Übersetzung
docker compose exec backend python manage.py run_monitor --once # ein Prüflauf
docker compose exec backend python manage.py measure_audio <stream> # Pegel eines Streams messen (Kalibrierung der Stille-Schwelle)
docker compose exec backend python manage.py load_site_config # Rekorder/Stream-URL aus backend/site.local.json laden
docker compose exec backend sh -c "pip install -q ruff && ruff check ." # Lint (wie CI, Config in backend/pyproject.toml)
cd frontend && npm run docs:shots # Website-Screenshots (DE; DOCS_SHOTS_LANG=en für EN), braucht Chrome + ffmpeg- Repo:
github.com/virtUOS/ansehbar(öffentlich). Keine Infrastruktur-Details einer Einrichtung committen (Hostnamen, Rekorder-/Raumnamen) — die gehören in die ungetrackte Standortkonfiguration (*.local.json, siehe docs/KONFIGURATION.md). - Vereinfachter Gitflow:
mainist geschützt (kein direkter Push, kein Force-Push); Arbeit auffeature/<slug>,fix/<slug>,chore/<slug>,docs/<slug>; PR mit grüner CI (.github/workflows/ci.yml); der Mensch merged. - Release = Git-Tag
vX.Y.Z→.github/workflows/release.ymlbaut das Image nachghcr.io/virtuos/ansehbar; Deployment überdocker-compose.prod.yml(Server-Anleitung: docs/deployment.md, App-Konfiguration: docs/KONFIGURATION.md).Caddyfileohne lokale Änderungen, gesteuert über.env. - Gerüst-Updates:
pipx run copier update --vcs-ref HEAD(Identitäts- und Inhaltsdateien sind davon ausgenommen, siehe README).
- Apache-2.0, SPDX-Header in jeder Quelldatei.
- Jede App hält mindestens Basis-Tests in ihrer
tests.py. - UI-Texte: Englisch als i18n-Key, Deutsch in
src/locales/de/translation.json. - Design: Ramps in
tailwind.config.jssind die Identität dieses Tools; Struktur kommt aus dem @basicbar/ui-Preset. - Backend-Texte: englische msgids mit gettext (
gettext/gettext_lazy), Deutsch inbackend/locale/de/LC_MESSAGES/django.po;.pound.moeinchecken (makemessages -l de,compilemessages). Die SPA sendetAccept-Language(aus<html lang>),LocaleMiddlewarewählt die Sprache. - Kein Django-Admin für Fachdaten; jede Pflegemaske gehört ins Frontend.
- Nie Browser-Dialoge (
window.confirm/alert/prompt), stattdessenConfirmDialog. - Status immer mit Text und Symbol, nie nur Farbe; Akzentfarbe (brand) ist nie
Statusfarbe. Dark-Mode-Text mindestens
slate-300(slate-400verfehlt 4,5:1). - Stream-Namen sind case-sensitiv (
cap-90-R12), nie kleinschreiben. - „Live“ = Chunklist existiert und ihre Media-Sequence hat sich innerhalb von
3 × TARGETDURATIONgeändert; HTTP 200 auf die Master-Playlist allein reicht nicht. - Keine Infrastrukturdetails der Einrichtung (Stream-Hostnamen, Rekorder-/Raumnamen)
im Repo: sie stehen in der git-ignorierten
backend/site.local.json(Vorlagebackend/site.example.json, Befehlload_site_config, siehe README „Standortkonfiguration“). Migrationen und Tests nur mit fiktiven Werten. - ansehBAR schreibt nie nach Keycloak und nie nach Opencast (Client kennt nur GET).