philippurbschat.de/_template/README.md
Philipp Urbschat f393beb7ff
feat: inkubator-standard & modul-autodiscovery
- Dynamische Modulerkennung via module.json in ModuleService.php
- Kaskadierender Env-Loader fuer zentrale API-Keys (GEMINI_API_KEY)
- Graceful Auth fuer alle Subprojekte (dinos, plants, storymachine, test)
- Wiederverwendbares Starter-Template in _template/
- test-Modul auf philippurbschat.de Dark-Design modernisiert
2026-09-13 00:23:16 +02:00

1.5 KiB

🚀 Modul-Starter-Template für philippurbschat.de

Dieses Verzeichnis dient als Kopiervorlage für neue Mini-Projekte und Experimente.

In 30 Sekunden startklar:

  1. Ordner duplizieren: Kopiere diesen _template-Ordner und gib ihm den Namen deines neuen Projekts (z.B. synth, todo, scanner).

    cp -r _template mein-projekt
    
  2. Metadaten in module.json anpassen: Öffne mein-projekt/module.json und passe Name, Badge und Beschreibung an:

    {
      "name": "Mein Tolles Tool",
      "badge": "AI Lab",
      "description": "Was das Tool macht",
      "adminOnly": false,
      "order": 10
    }
    
  3. Fertig!

    • Das Modul erscheint sofort automatisch in der Benutzerverwaltung unter philippurbschat.de/admin/users.
    • Es erbt automatisch das Dark-Theme, Tailwind v4 und Typografie von philippurbschat.de.
    • Es hat sofortigen Zugriff auf GEMINI_API_KEY aus der zentralen Konfiguration.

Features & Architektur

  • Graceful Auth (bootstrap.php):
    • Auf philippurbschat.de: Vollständig geschützt durch Session & Rechteverwaltung.
    • Standalone-Betrieb: Wenn du den Ordner als eigene Website auslagerst, läuft er ohne Änderungen direkt weiter.
  • Hierarchische API-Keys:
    • Rufe in PHP module_env('GEMINI_API_KEY') auf.
    • Wenn im Modulordner eine eigene .env liegt, hat diese Vorrang. Andernfalls greift automatisch der globale Key aus /home/.env.
  • Sicherer API-Proxy (api.php):
    • Verhindert das Offenlegen deiner API-Schlüssel im Frontend.