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.
7.1 KiB
7.1 KiB
Hinweise für Agenten
Kür-Hub
- Website:
https://rinkplanner-hub.programmschmiede.de, Code unterhub/, Dokudocs/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.phpwird beim Deployment erzeugt und nie eingecheckt. - Schema
hub/sql/schema.sql; der Installer legt es an und erzeugt den ersten Benutzer als Admin.storage/.installedverhindert einen zweiten Lauf. - Uploads liegen in
storage/uploads/(gesperrt); nurweb/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 übert('schlüssel'), Sprache im CookieRHUB_LANGüber den DE/EN-Umschalter (/language). Keine Texte direkt in Views oder Meldungen –./tools/deploy_hub.sh --checkmeldet fehlende Schlüssel. - App-Anbindung:
src/core/hub/(HubSettings,HubClient,HubJob); Token liegt getrennt vonsync.cfgunteruser://hub.cfg. Der MenüpunktDatei → Kür-Hub…erscheint nur bei geprüfter Verbindung.
Website und Downloads
- Die Rinkplanner-Seite liegt unter
rinkplanner.programmschmiede.de/, Quelle im Repo unterweb/.programmschmiede.de/rinkplanner.htmlleitet 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. Nurweb/wird hochgeladen;media/,fonts/undversion.jsonliegen weiterhin nur auf dem Server. - Zweisprachig:
/de/und/en/,/leitet anhand vonAccept-Languageweiter (der User-Agent enthält keine Sprache). Die Wahl aus dem DE/EN- Umschalter merkt sich das Cookielang. 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 lokalerinkplanner.zipist nur Zwischenartefakt für den Installer und wird nicht verteilt. Gebaut wird der Installer mittools/export_macos_installer.shauf macOS. - Beim Windows-Build ausschließlich
rinkplanner-setup.exe(Installer) hochladen. Die lokalerinkplanner.exeist 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 inrinkplanner/project.godot(config/version) und gespiegelt inrinkplanner/export_presets.cfg. Details, Installationsabläufe und Release-Checkliste:docs/updates.md.
Windows-Installer
./tools/setup_windows_installer.shrichtet NSIS lokal unter~/.local/share/rinkplanner-toolchainein (kein Root)../tools/export_windows_installer.shbautbuild/windows/rinkplanner-setup.exe;--no-exportnutzt die vorhandenerinkplanner.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 darausstrings.en.translation(registriert inproject.godotunter[internationalization]). - Reine
text-Eigenschaften übersetzen sich selbst. Für zusammengesetzte TexteI18n.t()/I18n.f()/I18n.join_lines()verwenden – nichttr()in statischen Funktionen. - Neue Texte gehören in beide Spalten;
tests/run_i18n_tests.gdprü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)..tresist 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.shlaufen lassen. Es baut den Linux-Export, startet ihn headless und prüft Autoload, Testausschluss und die Skater-Texturen. Die GLB muss vorher pertools/sync_assets.sh --syncvorliegen.
MCP-Werkzeuge
- Godot:
godot-mcpsteuert das Projekt über--project rinkplanner/rinkplanner. Die Live-Editor-Werkzeuge brauchen das Addonrinkplanner/addons/godot_ai_bridge(Port 6550, startet mit dem Editor). godot_ai_bridgeist eine Kopie aus/opt/godot-mcpmit lokalem Patch. Beim Neukopieren den Patch ausdocs/findings-2026-11-01-godot-ai-bridge.mderneut anwenden, sonst meldet jeder--import-Lauf „6 ObjectDB instances leaked at exit".- Blender:
mcp-for-blenderüberuvx, Addon in~/.config/blender/5.2/scripts/addons/blender_mcp.py(Port 9876). - Skater bauen:
tools/blender/build_skater.pyriggt ein Tripo-GLB mit AutoRigPro, übernimmtGlideund exportiert. Aufruf ohne-b(ARP braucht eine GUI), Details im Modulkopf und indocs/findings-2026-11-12-tripo-skater-rig.md. - Tripo:
tripo-MCP (Toolsetfull) und CLI/home/torsten/.local/bin/triposind die Quelle für 3D-Meshes. Der MCP-Wrapper in~/.config/opencode/opencode.jsoncsourct selbst~/.config/environment.d/91-tripo.conf; ohne das bekommt der DienstTRIPO_API_KEYnicht, weil OpenCode aus einem Terminal ohne die Variable startet. Jeder generierende Aufruf kostet Credits – vorhertripo_planbzw.dry_runzeigen lassen, Kosten nennen, Zustimmung abwarten; danachtripo_usageundassets/license-log.csvpflegen. - 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-Serverhttps://mcp.fal.ai/mcp-relay(Streamable HTTP) mitAuthorization: Bearer {env:FAL_KEY}inopencode.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;~/.bashrcsourct dieselbe Datei vor dem Interaktiv-Guard. Meldet falneeds 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_modelundsubmit_joblösen kostenpflichtige Generierungen aus – vorher Modell und Preis nennen und die Zustimmung abwarten.