Philipp Urbschat
3de05f542c
- Alle Module nach /modules/ verschoben (dinos, plants, storymachine, test, _template) - .htaccess transparentes Routing fuer /modules/ eingerichtet - ModuleService Auto-Discovery auf /modules/ Verzeichnis angepasst - Original Web Audio Synthese (playOrganicFart) und Furzkissen-UI in modules/test/index.php wiederhergestellt - AGENTS.md Dokumentation aktualisiert
41 lines
1.5 KiB
Markdown
41 lines
1.5 KiB
Markdown
# 🚀 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.
|