Eine App klinkt sich über kleine, gleich benannte Dateien in die Plattform ein. Die Kern-Apps finden sie automatisch.
| Datei | Zweck |
|---|---|
schema_init.py |
Tabellen im Mandantenschema anlegen bzw. erweitern, dazu RLS_POLICIES – siehe Architektur und Mandantentrennung. |
menu.py |
MENU_ITEMS: Einträge im Seitenmenü mit Schlüssel, Symbol, deutschem/englischem Namen, url_name, benötigter App und Recht, Sortierung. |
permissions.py |
Grundrechte, die jedes aktive Firmenmitglied ohne Gruppe bekommt (bei Notizen notes.access, notes.share). |
dashboard_kacheln.py |
Kacheln für das Dashboard mit Auswahl und Anzahl. |
link_registry.py / links.py |
Welche Datensätze die App verknüpfen kann und wie sie dargestellt werden (Aufgabe ↔ Kontakt, Notiz ↔ Projekt …). |
i18n.py |
Texte für das JavaScript der App, je Anfrage in der Sprache des Benutzers. |
urls.py, views.py, templates/, static/ |
die eigentliche Oberfläche. |
Dazu die Einstellungs-App (tasks_settings) mit Benutzer- und Firmeneinstellungen sowie Kategorien und Status.
Beispiel: Menüeintrag
# notes/menu.py
MENU_ITEMS = [{
"key": "notizen", "parent_key": None, "level": 0,
"icon": "journal-text",
"name_de": "Notizen", "name_en": "Notes",
"url_name": "notes:index",
"required_app": "notes", "required_permission": "",
"is_system": False, "is_enabled": True, "sort_order": 7.85,
}]
required_app blendet den Eintrag aus, solange die Firma das Modul nicht gebucht hat. Administratoren können Einträge nur ein- und ausblenden und umsortieren, nicht verschieben – siehe Menü anpassen.
Rechte einer App
Die Schlüssel stehen zentral im Katalog customers/permissions_config.py (z. B. tasks.access, tasks.view_all, tasks.manage_settings). Unbekannte Schlüssel sind nie erlaubt. Wie sie aufgelöst werden: Das Berechtigungsmodell.