2026-11-01 13:47:16 +01:00
|
|
|
|
# Hinweise für Agenten
|
|
|
|
|
|
|
2026-11-11 13:14:26 +01:00
|
|
|
|
## 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.
|
feat: Website und Hub zweisprachig (Deutsch/Englisch)
Website (rinkplanner.programmschmiede.de) liegt jetzt im Repo unter web/:
Sprachweiche nach Accept-Language (der User-Agent enthält keine Sprache),
/de/ und /en/ als eigene URLs mit hreflang, Cookie für die manuelle Wahl,
Texte in web/i18n.php, Markup in web/template.php. Deployment über
tools/deploy_web.sh (--sync, --check, --all); /index.html leitet weiter.
Hub: optionale englische Oberfläche über den DE/EN-Umschalter, Cookie
RHUB_LANG, Route /language. Alle Texte (Views, Meldungen, Validierung,
API-messages) stehen in hub/app/i18n_strings.php und laufen über t();
Datum und Zahlen folgen der Sprache. Die API behält ihre code-Felder und
antwortet ohne Cookie weiter deutsch.
deploy_hub.sh --check prüft jetzt Schlüsselparität und fehlende t()-Schlüssel.
Doku: docs/website.md neu, docs/hub.md und AGENTS.md ergänzt.
2026-11-12 22:38:32 +01:00
|
|
|
|
- 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.
|
2026-11-11 13:45:25 +01:00
|
|
|
|
- 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.
|
2026-11-11 13:14:26 +01:00
|
|
|
|
|
2026-11-10 17:09:11 +01:00
|
|
|
|
## Website und Downloads
|
2026-11-01 13:47:16 +01:00
|
|
|
|
|
feat: Website und Hub zweisprachig (Deutsch/Englisch)
Website (rinkplanner.programmschmiede.de) liegt jetzt im Repo unter web/:
Sprachweiche nach Accept-Language (der User-Agent enthält keine Sprache),
/de/ und /en/ als eigene URLs mit hreflang, Cookie für die manuelle Wahl,
Texte in web/i18n.php, Markup in web/template.php. Deployment über
tools/deploy_web.sh (--sync, --check, --all); /index.html leitet weiter.
Hub: optionale englische Oberfläche über den DE/EN-Umschalter, Cookie
RHUB_LANG, Route /language. Alle Texte (Views, Meldungen, Validierung,
API-messages) stehen in hub/app/i18n_strings.php und laufen über t();
Datum und Zahlen folgen der Sprache. Die API behält ihre code-Felder und
antwortet ohne Cookie weiter deutsch.
deploy_hub.sh --check prüft jetzt Schlüsselparität und fehlende t()-Schlüssel.
Doku: docs/website.md neu, docs/hub.md und AGENTS.md ergänzt.
2026-11-12 22:38:32 +01:00
|
|
|
|
- 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`.
|
2026-11-10 17:09:11 +01:00
|
|
|
|
- Builds liegen unter `programmschmiede.de/rinkplanner/download/`.
|
|
|
|
|
|
Die Download-Links in der Subdomain-Seite sind absolut
|
|
|
|
|
|
(`https://programmschmiede.de/rinkplanner/download/...`).
|
2026-11-10 22:58:09 +01:00
|
|
|
|
- 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.
|
2026-11-10 23:08:07 +01:00
|
|
|
|
- Beim Windows-Build ausschließlich `rinkplanner-setup.exe` (Installer)
|
|
|
|
|
|
hochladen. Die lokale `rinkplanner.exe` ist nur Zwischenartefakt und wird
|
|
|
|
|
|
nicht verteilt.
|
2026-11-11 18:26:11 +01:00
|
|
|
|
- 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`.
|
2026-11-01 13:47:16 +01:00
|
|
|
|
|
2026-11-10 17:09:11 +01:00
|
|
|
|
## 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).
|
2026-11-01 14:15:16 +01:00
|
|
|
|
|
2026-11-12 22:54:14 +01:00
|
|
|
|
## 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`).
|
|
|
|
|
|
|
2026-11-03 23:48:01 +01:00
|
|
|
|
## 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.
|
|
|
|
|
|
|
2026-11-01 14:15:16 +01:00
|
|
|
|
## 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).
|
feat: Ultra-Skater im Kürkleid und Rig-Werkzeug
Zweiter Durchlauf für Geometrie und Outfit: Referenzbild per Tripo-Image-Edit
auf ein petrolfarbenes Kürkleid umgestellt (20 Credits), daraus ein
Ultra-Image→3D (geometry_quality=detailed, 50 Credits).
- v008: 59.488 Dreiecke, 1,7 m, 222 Control-/30 Deform-Bones, Glide
unverändert per Rotations-Retargeting
- Lider, Ohren und Haaransatz deutlich besser als v007; Finger bleiben
verschmolzen
- Manifest-Eintrag auf Version 2 (v008), Skater3D-Fallback und
check_export.sh nachgezogen
- tools/blender/build_skater.py: Rig, Retarget und Export in einem Befehl,
reproduziert die manuelle GLB byte-identisch
- Lizenz-Log um Bild-Edit und Ultra-Lauf ergänzt, Doku und AGENTS.md aktualisiert
2026-11-12 06:04:47 +01:00
|
|
|
|
- **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`.
|
feat: Tripo-Skater riggen und Glide anbinden
Neues Mesh über die Tripo-Pay-as-you-go-API erzeugt (v3.1, 60k Faces,
Textur v3.5, 30 Credits), lokal mit AutoRigPro geriggt und mit einem
Rotations-Retargeting an den bestehenden Glide-Clip angeschlossen.
- neues Manifest-Asset character.skater.figure_tripo_glide (v007,
59.350 Dreiecke, 30 Deform-Bones, 4 Einflüsse, Glide 2-s-Loop)
- Skater3D lädt das neue Asset; Klingenabstand auf ±0,154 m gesetzt
- check_export.sh prüft GLB und Textur der v007
- Ablauf und Stolpersteine in docs/findings-2026-11-12-tripo-skater-rig.md
- assets.md: Bestand, Export-Presets und Lizenzlage aktualisiert
- Lizenz-Log um den Tripo-Task ergänzt
- AGENTS.md: Tripo ist die 3D-Quelle, fal nur noch für Bilder
Der unrigged 30k-Eintrag bleibt als Zwischenstand dokumentiert.
2026-11-12 05:51:09 +01:00
|
|
|
|
- **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
|
2026-11-01 15:47:55 +01:00
|
|
|
|
`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.
|