# Hinweise für Agenten ## Kür-Hub - Website: `https://rinkplanner-hub.programmschmiede.de`, Code unter `hub/`, Doku `docs/hub.md`. - Deployment nur über `./tools/deploy_hub.sh` (`--sync`, `--install`, `--check`, `--all`). Keine zweite Kopie auf dem Webserver anlegen. - Zugänge stehen in `docs/credentials.txt` (`DB_*`, `HUB_ADMIN_*`, `FTP_*`). `app/config.local.php` wird beim Deployment erzeugt und nie eingecheckt. - Schema `hub/sql/schema.sql`; der Installer legt es an und erzeugt den ersten Benutzer als Admin. `storage/.installed` verhindert einen zweiten Lauf. - Uploads liegen in `storage/uploads/` (gesperrt); nur `web/` ist öffentlich. - API v1 mit Bearer-Tokens für die App; Web-UI nutzt Session + CSRF. - App-Anbindung: `src/core/hub/` (`HubSettings`, `HubClient`, `HubJob`); Token liegt getrennt von `sync.cfg` unter `user://hub.cfg`. Der Menüpunkt `Datei → Kür-Hub…` erscheint nur bei geprüfter Verbindung. ## Website und Downloads - Die Rinkplanner-Seite liegt nur noch unter `rinkplanner.programmschmiede.de/index.html`. `programmschmiede.de/rinkplanner.html` leitet per Root-`.htaccess` (301) dorthin um; keine zweite Kopie anlegen. - Builds liegen unter `programmschmiede.de/rinkplanner/download/`. Die Download-Links in der Subdomain-Seite sind absolut (`https://programmschmiede.de/rinkplanner/download/...`). - Beim macOS-Build ausschließlich `rinkplanner-setup.dmg` (Installer) hochladen. Die lokale `rinkplanner.zip` ist nur Zwischenartefakt für den Installer und wird nicht verteilt. Gebaut wird der Installer mit `tools/export_macos_installer.sh` auf macOS. - Beim Windows-Build ausschließlich `rinkplanner-setup.exe` (Installer) hochladen. Die lokale `rinkplanner.exe` ist nur Zwischenartefakt und wird nicht verteilt. - Update-Endpunkt: `https://rinkplanner.programmschmiede.de/version.json` (statisches JSON), erzeugt und hochgeladen mit `./tools/publish_version.sh` (`--windows`, `--notes`, `--no-upload`, `--check`). Die Version steht in `rinkplanner/project.godot` (`config/version`) und gespiegelt in `rinkplanner/export_presets.cfg`. Details, Installationsabläufe und Release-Checkliste: `docs/updates.md`. ## Windows-Installer - `./tools/setup_windows_installer.sh` richtet NSIS lokal unter `~/.local/share/rinkplanner-toolchain` ein (kein Root). - `./tools/export_windows_installer.sh` baut `build/windows/rinkplanner-setup.exe`; `--no-export` nutzt die vorhandene `rinkplanner.exe`. - Der Installer ist per-user (kein Admin) und unsigniert (SmartScreen). ## Dateiformat und Release-Check - Neue Kürdateien werden als JSON gespeichert (`RoutineFile`). `.tres` ist nur noch Legacy-Import und wird vor dem Laden per Whitelist geprüft; nicht wieder als neues Speicherformat einführen. - Vor einem Release `./tools/check_export.sh` laufen lassen. Es baut den Linux-Export, startet ihn headless und prüft Autoload, Testausschluss und die Skater-Texturen. Die GLB muss vorher per `tools/sync_assets.sh --sync` vorliegen. ## MCP-Werkzeuge - **Godot:** `godot-mcp` steuert das Projekt über `--project rinkplanner/rinkplanner`. Die Live-Editor-Werkzeuge brauchen das Addon `rinkplanner/addons/godot_ai_bridge` (Port 6550, startet mit dem Editor). - `godot_ai_bridge` ist eine Kopie aus `/opt/godot-mcp` **mit lokalem Patch**. Beim Neukopieren den Patch aus `docs/findings-2026-11-01-godot-ai-bridge.md` erneut anwenden, sonst meldet jeder `--import`-Lauf „6 ObjectDB instances leaked at exit". - **Blender:** `mcp-for-blender` über `uvx`, Addon in `~/.config/blender/5.2/scripts/addons/blender_mcp.py` (Port 9876). - **Skater bauen:** `tools/blender/build_skater.py` riggt ein Tripo-GLB mit AutoRigPro, übernimmt `Glide` und exportiert. Aufruf ohne `-b` (ARP braucht eine GUI), Details im Modulkopf und in `docs/findings-2026-11-12-tripo-skater-rig.md`. - **Tripo:** `tripo`-MCP (Toolset `full`) und CLI `/home/torsten/.local/bin/tripo` sind die Quelle für 3D-Meshes. Der MCP-Wrapper in `~/.config/opencode/opencode.jsonc` sourct selbst `~/.config/environment.d/91-tripo.conf`; ohne das bekommt der Dienst `TRIPO_API_KEY` nicht, weil OpenCode aus einem Terminal ohne die Variable startet. Jeder generierende Aufruf kostet Credits – vorher `tripo_plan` bzw. `dry_run` zeigen lassen, Kosten nennen, Zustimmung abwarten; danach `tripo_usage` und `assets/license-log.csv` pflegen. - **fal:** wird für 3D **nicht mehr** verwendet (Kosten), die Rechteklärung vom 2026-11-12 bleibt dokumentiert in `docs/findings-2026-11-11-ai-skater-model-comparison.md`. Die unten beschriebene Anbindung bleibt nur für bestehende Bild-Endpunkte bestehen: Remote-Server `https://mcp.fal.ai/mcp-relay` (Streamable HTTP) mit `Authorization: Bearer {env:FAL_KEY}` in `opencode.jsonc`. Kein OAuth nötig – der Relay akzeptiert den API-Key als Bearer, der Browser-Login scheitert dagegen oft am lokalen Callback-Port. Der Key liegt in `~/.config/environment.d/90-fal.conf` (Modus 600), im systemd-Format; `~/.bashrc` sourct dieselbe Datei vor dem Interaktiv-Guard. Meldet fal `needs authentication`, fehlt dem OpenCode-Dienst die Variable: `systemctl --user import-environment FAL_KEY && opencode service restart`. Nach einer Key-Rotation ebenso: Datei anpassen, import-environment, Neustart. `run_model` und `submit_job` lösen kostenpflichtige Generierungen aus – vorher Modell und Preis nennen und die Zustimmung abwarten.