MOSAIC Administration: Handbuch und Bedienung
Dieses Handbuch beschreibt die allgemeine Bedienung der MOSAIC-Administration aus Sicht eines Projektverantwortlichen. Die Texte sind bewusst in deutscher Sprache verfasst, damit sie im Forum automatisch in die Zielsprache des angemeldeten Benutzers uebersetzt werden koennen. Die Screenshots wurden fuer diese Dokumentation browserseitig in eine englische Beschriftung ueberfuehrt, damit Schaltflaechen, Menuepunkte und Eingabefelder fuer internationale Leser leichter nachvollziehbar bleiben.
Hinweis: Die Administration ist die technische Steuerzentrale von MOSAIC. Hier werden Projekte angelegt, Verbindungen gepflegt, Generatoren gestartet und zentrale Konfigurationen bearbeitet.
1. Allgemeine Bedienlogik
Die MOSAIC-Administration folgt einem klaren Grundprinzip: Zuerst wird ein Projekt ausgewaehlt, danach wird die passende Aktion fuer dieses Projekt gestartet. Viele Werkzeuge greifen direkt auf Dateien im Projektverzeichnis zu und schreiben dort Konfigurationen oder Generatorergebnisse.
- Die Sprachauswahl oben beeinflusst die Bedienoberflaeche der Administration.
- Im Projektbereich wird festgelegt, fuer welche Anwendung die folgenden Aktionen gelten.
- Die Aktionsleiste gruppiert technische Aufgaben wie Datenbank, Konfiguration, Generatoren und Versionspruefung.
- Generatoren arbeiten gefuehrt: Sie sammeln Einstellungen ein und erzeugen daraus MOSAIC-Bausteine im Projekt.
- Einige Werkzeuge sind nur dann sinnvoll, wenn fuer das Projekt bereits eine gueltige Datenbankverbindung und eine passende Lizenz hinterlegt sind.
2. Die Startseite der Administration
Die Startseite ist der zentrale Einstiegspunkt fuer alle administrativen Aufgaben. Im oberen Bereich koennen neue Projekte angelegt werden. Darunter folgt eine Statuszeile mit Informationen ueber den aktiven Admin-Schutz, die Passwortdatei, die Anzahl erkannter Projekte und die verwendete PHP-Version.
Der wichtigste Arbeitsbereich ist die Projektliste. Hier wird sichtbar, welche Anwendungen im MOSAIC-Verzeichnis vorhanden sind und ob bereits eine Datenbankverbindung definiert wurde. Nach der Auswahl eines Projekts werden die Schaltflaechen der Aktionsleiste auf dieses Projekt bezogen.
Wichtige Elemente auf der Startseite
| Bereich | Bedeutung | Typischer Einsatz |
|---|---|---|
| Language / Sprache | Stellt die Sprache der Admin-Oberflaeche um. | Hilfreich fuer internationale Teams oder fuer Dokumentationsscreenshots. |
| Neues Projekt anlegen | Erzeugt ein neues Projektverzeichnis als Grundlage einer Anwendung. | Beim Start eines neuen MOSAIC-Projekts. |
| Projektliste | Zeigt vorhandene Anwendungen und den Status ihrer Datenbankanbindung. | Zur Auswahl des Zielprojekts vor einer Aktion. |
| Aktuelle Anwendung / Aktuelle DB | Zeigt, welches Projekt und welche Datenbank im Moment technisch im Fokus stehen. | Zur schnellen Kontrolle vor Generator- oder Konfigurationsschritten. |
3. Aktionsleiste und technische Werkzeuge
Die Aktionsleiste ist in Funktionsgruppen gegliedert. Einige Schaltflaechen oeffnen direkte Editor- oder Service-Seiten, andere starten Generatoren, die neue Bausteine erzeugen. Die folgende Uebersicht erklaert den Inhalt der einzelnen Funktionen.
3.1 Datenbank und Projektkonfiguration
| Funktion | Inhalt | Praxisnutzen |
|---|---|---|
| DB | Bearbeitet die Datenbankverbindung des Projekts. | Wird benoetigt, um ein Projekt an MySQL, SQLite oder je nach Lizenz weitere Datenbanken anzubinden. |
| CO | Oeffnet die allgemeine Projektkonfiguration. | Hier werden zentrale Optionen wie Security, Logging, SMTP, PayPal, DeepL oder OpenAI gepflegt. |
| MySQL | Startet einen visuellen Query-Maker fuer MySQL. | Hilfreich fuer Analyse, Strukturverstaendnis und SQL-Erstellung. |
| DBE | Oeffnet den MySQL-Datenbank-Editor. | Dient zur Arbeit mit Tabellen, Feldern und Daten direkt aus der Admin-Oberflaeche. |
| FTP | Verwaltet technische Transfer- und Deployment-Aufgaben. | Hilfreich fuer den Dateiabgleich und fuer verteilte Installationen. |
| Versionscheck | Prueft Dateiversionen im zentralen `_pgm`-Bereich. | Unterstuetzt bei Wartung, Updatekontrolle und Plausibilisierung von Deployments. |
Die Konfigurationsseite ist besonders wichtig, weil hier globale Schalter fuer das Verhalten des Projekts gesetzt werden. Wer SMTP, Logging oder DeepL/OpenAI aktivieren moechte, arbeitet typischerweise in dieser Maske. In der aktuellen lokalen Testinstallation liessen sich nicht alle Unterwerkzeuge fehlerfrei oeffnen; die Funktionalitaet ist deshalb im Text vollstaendig beschrieben, auch wenn nicht fuer jeden Punkt ein eigener Screenshot vorliegt.
3.2 Generatoren
Generatoren erzeugen produktive MOSAIC-Bausteine. Typischerweise waehlt man zuerst ein Projekt und danach den passenden Generator. Die Administration springt dann in eine gefuehrte Bearbeitungsseite mit technischen Optionen, Dateipfaden und fachlichen Einstellungen.
| Generator | Erzeugt | Wofuer er gedacht ist |
|---|---|---|
| form | Formular-Bausteine | Zum Erstellen und Bearbeiten einzelner Datensaetze mit Eingabemasken. |
| grid | Tabellenanzeigen | Fuer Listen, Uebersichten, Filter und tabellarische Recherche. |
| menu | Menuestrukturen | Zur Navigation innerhalb eines Projekts inklusive Gruppen, Items und Zielmodulen. |
| login | Login-Bausteine | Fuer Anmeldung, Projektzugang und nutzerspezifische Einstiegspunkte. |
| dashboard | Dashboards | Fuer verdichtete Kennzahlen, Uebersichten und Management-Sichten. |
| calendar | Kalender-Bausteine | Fuer zeitbezogene Uebersichten, Termine und Planungsansichten. |
| chart | Diagramm-Bausteine | Zur visuellen Aufbereitung von Kennzahlen und Trends. |
| api | API-Bausteine | Fuer technische Schnittstellen und systematische Datenbereitstellung. |
| connector | Externe Schnittstellen | Zur Anbindung von Fremdsystemen oder technischen Import-/Export-Strecken. |
| paypal | PayPal-Bausteine | Fuer Zahlungsprozesse und Checkout-nahe Integrationen. |
| report | Reports | Fuer layoutorientierte Ausgaben, Listen, Druck- oder Exportstrecken. |
| create_log | Logging-Strukturen | Zur Einrichtung von Aenderungsprotokollen auf Basis von `iss_log`. |
| show_log | Protokollansicht | Zum Nachvollziehen technischer oder fachlicher Aenderungen. |
| rights_apps | Applikationsrechte | Zur Pflege freigegebener Anwendungen in der Rechteverwaltung. |
| rights_groups | Gruppenrechte | Zur Strukturierung von Rollen, Gruppen und administrativen Zustaendigkeiten. |
| rights_group_apps | Gruppen-zu-Anwendung | Zur konkreten Zuordnung, welche Gruppe auf welche Anwendung zugreifen darf. |
Der Login-Generator steht hier stellvertretend fuer die Generatorlogik in MOSAIC: links die Navigation durch thematische Bereiche, rechts die eigentlichen Einstellungen, unten die Speicheraktion und die direkte Rueckkehr in die Anwendung. Andere Generatoren wie Menu, Form, Grid oder Report folgen demselben Grundprinzip, auch wenn ihre Eingabefelder fachlich unterschiedlich sind.
4. Typischer Arbeitsablauf in der Administration
- Projekt auswaehlen und pruefen, ob eine Datenbankverbindung hinterlegt ist.
- Grundkonfiguration in der Konfigurationsmaske kontrollieren oder erweitern.
- Danach den passenden Generator starten, etwa fuer Formular, Menue oder Login.
- Erzeugte Bausteine in der Anwendung pruefen und bei Bedarf in weiteren Generatoren ergaenzen.
- Vor Updates oder groesseren Eingriffen Logging, Protokollierung und technische Prueffunktionen nutzen.
5. Einordnung der einzelnen Funktionen
Die MOSAIC-Administration kombiniert drei Ebenen: technische Basisarbeit, Projektkonfiguration und Generatorlogik. Genau diese Kombination macht die Oberflaeche so leistungsfaehig. Datenbank und Konfiguration schaffen die Grundlage, Generatoren erzeugen produktive Module, und Zusatzwerkzeuge wie Logging oder Versionskontrolle sichern den Betrieb ab.
Wer die Administration effizient nutzen moechte, sollte nicht jede Funktion isoliert betrachten, sondern als Teil eines Workflows: Projekt vorbereiten, Konfiguration setzen, Bausteine generieren, Navigation verbinden und Ergebnisse kontrollieren.
6. Zusammenfassung
Die MOSAIC-Administration ist keine einzelne Maske, sondern eine Werkzeugsammlung fuer den gesamten Lebenszyklus eines Projekts. Sie deckt Anlage, Konfiguration, Strukturaufbau, Rechte, Generatoren und technische Kontrolle ab. Die Startseite dient als Schaltzentrale, waehrend die Unterseiten jeweils auf eine spezialisierte Aufgabe fokussieren.
Dieses Handbuch bietet dafuer einen stabilen Einstieg. Fuer weitere Dokumentationen koennen in dieser Rubrik zusaetzliche Themen angelegt werden, zum Beispiel fuer einzelne Generatoren, Integrationen oder Lizenz- und Deploymentprozesse.