rinkplanner/AGENTS.md
torsten fa1c989372 feat: App-Oberfläche auf Englisch umschaltbar
Die Oberfläche lässt sich über Datei → Sprache zwischen Deutsch und
Englisch umschalten; die Wahl liegt in user://app.cfg (AppSettings) und
gilt bis zur nächsten Änderung. Ohne gespeicherte Wahl startet die App
weiterhin auf Deutsch.

Alle sichtbaren Texte stehen als deutsche Schlüssel in
assets/i18n/strings.csv (rund 750 Einträge, inkl. Menüs, Dialoge,
Statuszeile, Kürprüfung, Cloud-/Update-Meldungen und PDF-/SVG-Blätter).
Godot importiert daraus strings.en.translation und registriert sie in
project.godot. Reine text-Eigenschaften übersetzen sich selbst; für
zusammengesetzte Texte gibt es I18n.t()/f()/join_lines().

Nutzdaten bleiben deutsch: Kürdateien, eigene Abschnittsnamen und
Dateinamen werden nicht übersetzt, nur die Anzeige der automatischen
Standardschnitte ("Abschnitt 3" → "Section 3").

Neuer Test tests/run_i18n_tests.gd prüft Katalog, Sprachwechsel und
gespeicherte Einstellung; in tools/test.sh eingehängt.
2026-11-12 22:54:21 +01:00

7.1 KiB
Raw Permalink Blame History

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.
  • Web-UI ist zweisprachig (Deutsch Standard, Englisch optional): Texte in hub/app/i18n_strings.php, Zugriff über t('schlüssel'), Sprache im Cookie RHUB_LANG über den DE/EN-Umschalter (/language). Keine Texte direkt in Views oder Meldungen – ./tools/deploy_hub.sh --check meldet fehlende Schlüssel.
  • 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 unter rinkplanner.programmschmiede.de/, Quelle im Repo unter web/. programmschmiede.de/rinkplanner.html leitet per Root-.htaccess (301) dorthin um; keine zweite Kopie anlegen.
  • Deployment mit ./tools/deploy_web.sh (--sync, --check, --all). Nicht direkt per FTP editieren – der nächste Sync überschreibt es. Nur web/ wird hochgeladen; media/, fonts/ und version.json liegen weiterhin nur auf dem Server.
  • Zweisprachig: /de/ und /en/, / leitet anhand von Accept-Language weiter (der User-Agent enthält keine Sprache). Die Wahl aus dem DE/EN- Umschalter merkt sich das Cookie lang. Texte: web/i18n.php, Markup: web/template.php, Stile: web/assets/site.css.
  • Details und Host-Eigenheiten: docs/website.md.
  • 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).

Sprache der App

  • Die App ist zweisprachig (Deutsch/Englisch). Umgeschaltet wird über Datei → Sprache; die Wahl liegt in user://app.cfg (AppSettings). Ohne gespeicherte Wahl startet sie auf Deutsch.
  • Alle sichtbaren Texte stehen als deutsche Schlüssel in rinkplanner/assets/i18n/strings.csv; Godot importiert daraus strings.en.translation (registriert in project.godot unter [internationalization]).
  • Reine text-Eigenschaften übersetzen sich selbst. Für zusammengesetzte Texte I18n.t() / I18n.f() / I18n.join_lines() verwenden – nicht tr() in statischen Funktionen.
  • Neue Texte gehören in beide Spalten; tests/run_i18n_tests.gd prüft den Katalog und den Umschalter. Nutzdaten (Kür-, Abschnittstitel, Dateinamen) bleiben deutsch und werden nur zur Anzeige übersetzt (I18n.section_title).

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.