Sprache: Deutsch · English
Architektur und API
Wie die App funktioniert: generischer REST-Interpreter, verwendete Endpunkte, Technologie-Stack und Roadmap.
REFERENZ ENTWICKLER STAND: JUL 2026 GILT FUER NUCLOS APP 1.0
Auf dieser Seite
Die App ist im Kern ein Interpreter der generischen Nuclos-REST-API. Sie enthält keinen Nuclet-spezifischen Code; Struktur, Layout und Daten kommen zur Laufzeit vom Server.
Verwendete Endpunkte
POST /rest Login (Cookie-Session, JSESSIONID)
POST /rest (anonymous/anonymous) Anonymer Login
GET /rest/ssoAuthEndpoints konfigurierte SSO-Dienste (Label, Icon, Farbe)
PUT /rest/ssoAuthEndpoints/{id} SSO-Flow starten -> Authorize-URL (PKCE)
POST /rest (loginUri, serverUri) SSO-Login abschliessen (Token-Tausch serverseitig)
GET /rest/datalanguages verfuegbare Datensprachen
PUT /rest/datalanguage aktive Datensprache setzen
POST /rest/user/register Selbstregistrierung
POST /rest/user/activate/{code} Konto aktivieren
PUT /rest/user/{user}/password Passwort aendern
POST /rest/user/{user}/forgotPassword Reset-E-Mail anfordern
POST /rest/user/{user}/passwordReset Passwort per Code zuruecksetzen
GET /rest/bos Entitaeten (Business Objects)
GET /rest/boMetas/{id} Metadaten (Attribute, Typen, titlePattern)
GET /rest/bos/{id}?offset=&chunkSize= Datensaetze (mit Paging)
POST /rest/bos/{id}/query Suche/Filter
boGenerations Neuanlage (Objektgeneratoren)
Technologie
- Flutter (native Rendering-Engine), Material 3.
- dio + persistenter Cookie-Jar (cookie_jar) – REST mit Cookie-Session (entspricht
withCredentialsdes Web Clients); die Session wird auf der Platte gehalten und überlebt einen App-Neustart. - flutter_riverpod – State-Management.
- local_auth + flutter_secure_storage – Biometrie & sichere Ablage der Zugangsdaten.
- webview_flutter – In-App-Anmeldeseite für SSO; flutter_html – HTML-Meldungen aus Server-Kommandos.
- fl_chart (Diagramme), file_picker/image_picker (Anhänge/Kamera).
Sitzung & Kommandos
Die Sitzung wird persistiert; läuft sie ab, versucht die App ein stilles erneutes Anmelden und wechselt nur bei Misserfolg zum Anmeldebildschirm. Server-Kommandos (Meldung, Navigation, Sitzungsende) werden nach Speichern/Regel/Statuswechsel ausgeführt.
Web & CORS
Für den Web-Build ist wegen der Cookie-Session CORS auf dem Server nötig. Auf iOS/Android entfällt das.
Roadmap
- Native Features: Barcode-Scan, Push-Benachrichtigungen.
- Erweiterte Suche/Filter über
query(Filter-Editor). - Weitere Offline-Fähigkeiten.
Verwandte Seiten
Überblick
Inhalte