Zum Inhalt springen

Aufbau eines Moduls

Welche Dateien eine App mitbringt – am Beispiel Aufgaben und Notizen.

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.

Hilfe & Support

Nicht gefunden, was Sie suchen? Die Plattform und das Hilfe-Center sind einen Klick entfernt.