Stand: 31.10.2026 · Richtlinienversion 11
Diese Hinweise erleichtern Stefan den AI-Einstieg bei den Kammersolisten, später auch bei Caruso und «Einfach bewegen». Sie helfen, Fehlwege zu vermeiden und die Zusammenarbeit mit Reto durch Rückmeldungen laufend zu verbessern.
Es gibt zwei Arbeitsweisen: über die Benutzeroberfläche im Browser, sodass Stefan zuschauen und die Schritte nachvollziehen kann, oder über die API. Zum Einstieg die Benutzeroberfläche verwenden. Sobald Stefan damit vertraut ist, die schnellere API anbieten; ihre einzelnen Schritte sind für ihn weniger sichtbar. Voraussetzung sind jeweils passende Browser- bzw. HTTP-Werkzeuge. Diese Hinweise sind ohne Zugriff auf Projektdateien verwendbar.
Quellen: Kammermusik/Souvenir: kammersolisten.ch. Caruso/Mini-Mozart: ab Saison 2022/23 katercaruso.ch, davor kammersolisten.ch. Die Grenze ist die Saison, kein Kalenderdatum.
Externe Konzerte: Lokale Seiten, Konzertdaten und Poster für Startseite, Kalender und Archiv erhalten.
box_url_extern verweist auf die genaue Konzertseite (externes Symbol); lokaler Inhalt ab der Übergabe:
kurzer deutscher Hinweis mit diesem Link. Archivkopie-PDFs erhalten; alte Downloads nur bei beauftragter Bereinigung entfernen.
adresse, nicht in ort: «Theater Casino», «Artherstr. 2–4, 6300 Zug».
In Strassennamen «strasse» durch «str.» ersetzen.fk_poster: Galerie-Bild derselben Seite, kein Download. Beim Wechsel altes Poster aus der Galerie nehmen,
andere Zuordnungen erhalten. Flyer, Programme und Archivkopien: Anhänge mit «Als Download anzeigen»;
Beschreibung, sonst Dateiname als Beschriftung.Token erhalten: Stefan meldet sich mit seinem Admin-Konto an, öffnet «Benutzer» und seinen eigenen AI-Benutzer und klickt «API-Token erstellen». Falls dieser Benutzer noch fehlt, Reto fragen. Den angezeigten Token sofort kopieren; nach Verlassen der Seite ist er nicht erneut lesbar. Er gilt 24 Stunden. Bei Ablauf neu erstellen; ein neuer Token ersetzt den bisherigen. Vertraulich behandeln.
POST https://www.kammersolisten.ch/api/<Name> · JSON · Content-Type: application/json ·
X-Api-Token (Benutzerseite, 24 Stunden gültig; vertraulich).
Erfolg: HTTP 200 + status:"OK"; Fehler: HTTP 500 + status:"ERROR", Details in error.
| Endpunkte | Aktionen |
|---|---|
Seite_*, Anhang_* | get, set, delete, rename |
Konzert_* | get, set, delete |
db_backup | Online-H2-Backup |
Lesen: Seite_get (ebenso Konzert/Anhang) mit {"id":123}
liefert id, revision, fields.
Optional "fields":["name","titel","inhalt"]. Keine Liste/Suche; IDs aus der Website.
Ändern: Seite_set mit frisch gelesener Revision:
{"id":123,"revision":"<Revision>","fields":{"titel":"Neuer Titel"}}"" leert Strings.
id:0 erstellt ohne Revision. Pflichtfelder: Seite name;
Konzert datum,uhrzeit,ort,fk_seite; Anhang name,fk_seite und Dateidaten. Neue Seiten sind inaktiv.null; Datum YYYY-MM-DD,
Zeit HH:mm; Konzertreihe: 1 Kammermusik, 2 Caruso, 3 Souvenir, 4 Mini-Mozart/null.
Auditfelder schreibgeschützt; Seite/Anhang name nur bei Erstellung, Anhang fk_seite unveränderlich.
Seiteninhalt wird bereinigt und versioniert.Anhang_set mit Base64-Originalbytes in data neben fields;
bestehende Datei wird ersetzt. Anhang_get mit include_data:true liest sie. JSON-Limit: 32 MiB.{"id":123,"revision":"<Revision>","new_name":"Neuer-Name","preview":true}.
affected_links/invalid_links prüfen, dann preview:false.
Interne Links werden angepasst; Query/Fragment nur eingeschränkt.{"id":123,"revision":"<Revision>"}.
Seitenlöschung umfasst Konzerte, Anhänge und Historie; Unterstrich-Seiten sind geschützt.db_backup mit {} liefert Base64-ZIP in data.
Nur bei Bedarf und Auftrag; enthält Benutzer-/Reservationsdaten.Schritte bei Bedarf Stefan erklären. Fehlen Werkzeuge oder Angaben für einen Auftrag, die konkrete Lücke nennen.
Bei Inhalts-/API-Änderungen diese Hinweise samt Stand/Version aktualisieren, Wiederholungen entfernen, Entscheidungen und offene Fragen erhalten. Keine Zugangsdaten oder privaten Entwicklerhinweise.