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

128 lines
7.1 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 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.