UniOS / Entwickler
UniOS Handbuch
Für Entwickler
Entwicklungsumgebung, Architektur, Schnittstellen und Betrieb mit konkreten Verträgen aus dem Repository.
01Thema wählenSchritt für Schritt
02Details lesenMit Quellen aus dem Repo
03WeitergehenVerwandte Themen
Loslegen
EntwicklungsumgebungUniOS besteht aus FastAPI, SQLite und einer React/Vite-PWA. Arbeite für Entwicklung und Tests ausschließlich mit erfundenen Daten und lokalen Fake-Servern.Weiterlesen →Tests und Fake-DatenDie Testumgebung darf sich nicht bei echten Hochschulsystemen anmelden. Für Portal- und Sync-Abläufe dienen lokale Fake-Server und erfundene Fixtures.Weiterlesen →
Architektur
Backend-SchichtenNeue Backend-Domänen folgen dem Pfad HTTP/API → Service → Repository → SQLite und Dateien. Diese Trennung hält Validierung, Fachregeln und Datenzugriff prüfbar.Weiterlesen →Frontend und PWADie UniOS-Oberfläche ist eine React/TypeScript-App mit Vite. Die PWA spricht die lokale FastAPI-Schnittstelle des Hosts.Weiterlesen →Dateien und SucheSQLite hält lokale Metadaten; Dateiversionen bleiben als Originale erhalten. Der Suchindex kann aus dem lokalen Bestand neu aufgebaut werden.Weiterlesen →
Schnittstellen
REST APIFastAPI stellt die lokale Schnittstelle für Web-App und CLI bereit. Ein laufender Host liefert sein Schema unter /openapi.json; im Repository liegt ein exportierter Stand unter frontend/openapi.json.Weiterlesen →CLIDie CLI heißt unios und spricht viele der lokalen Funktionen des Hosts an. Zeige die vollständigen Optionen mit uv run unios --help oder für einen Unterbefehl mit --help an.Weiterlesen →Entitäten und BeziehungenSchemaversion: 1. Quelle:
app/entities/schema.py.Weiterlesen →API-ReferenzDie folgenden Themenseiten werden beim Dokumentations-Build aus frontend/openapi.json erzeugt. Sie spiegeln die vorhandenen Pfade und Methoden wider.Weiterlesen →API-Referenz
Kurse und Material14 Endpunkte aus dem aktuellen OpenAPI-Schema.Weiterlesen →Notizen und Links14 Endpunkte aus dem aktuellen OpenAPI-Schema.Weiterlesen →Eingang10 Endpunkte aus dem aktuellen OpenAPI-Schema.Weiterlesen →Lernen18 Endpunkte aus dem aktuellen OpenAPI-Schema.Weiterlesen →Karteikarten und Anki22 Endpunkte aus dem aktuellen OpenAPI-Schema.Weiterlesen →KI32 Endpunkte aus dem aktuellen OpenAPI-Schema.Weiterlesen →Organisation17 Endpunkte aus dem aktuellen OpenAPI-Schema.Weiterlesen →Hochschulportale11 Endpunkte aus dem aktuellen OpenAPI-Schema.Weiterlesen →Connectoren7 Endpunkte aus dem aktuellen OpenAPI-Schema.Weiterlesen →Host und Einrichtung20 Endpunkte aus dem aktuellen OpenAPI-Schema.Weiterlesen →Weitere Endpunkte78 Endpunkte aus dem aktuellen OpenAPI-Schema.Weiterlesen →
Erweiterungen
Connector API v1Connectoren holen Daten aus externen Quellen in UniOS. Ein Hochschulprofil bindet die freigegebenen Connectoren an die jeweilige Einrichtung.Weiterlesen →HochschulprofileEin Profil kombiniert Connectoren und Konfiguration für eine Hochschule. Eine neue Einrichtung braucht keinen Fork des Core.Weiterlesen →Feature- und UI-AddonsUniOS hat eine lokale, deklarative Addon API v1. Connectoren bleiben ein eigener Vertrag für externe Datenquellen. Ein Addon-Manifest beschreibt einen Core-Ansichtstyp, einen festen Platz und die benötigten Datenrechte. Unter Mehr → Erweiterungen lässt es sich importieren, installieren, freigeben und aktivieren. Eigener React-, JavaScript- oder Python-Code wird nicht geladen.Weiterlesen →
Betrieb & Beiträge
Self-HostingUniOS ist für selbst betriebene Einzelinstallationen gedacht. Der persönliche Host bleibt die einzige schreibende Instanz.Weiterlesen →BeitragenBeiträge sollen nachvollziehbar, testbar und frei von persönlichen Hochschuldaten sein. UI-Texte und Dokumentation sind deutsch; Code-Bezeichner sind englisch.Weiterlesen →