# 🚀 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`).
   ```bash
   cp -r _template mein-projekt
   ```

2. **Metadaten in `module.json` anpassen:**
   Öffne `mein-projekt/module.json` und passe Name, Badge und Beschreibung an:
   ```json
   {
     "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.