Systemarchitektur
Die Architektur trennt Eingabe, Conversation, Planner oder Resolver, Action Registry, Risiko und ACL, Pending, Executor und Readback.
KB-Kategorie
Entwickler und Integratoren
Architektur, Verträge und Regeln für die Weiterentwicklung.
13 Artikel
Befehlsregister
Die ActionRegistryService definiert die öffentlich verfügbaren und risikoklassifizierten SayAdmin-Aktionen.
Befehlsvertrag
Der öffentliche Action-Vertrag lautet 368 insgesamt, 160 Green, 166 Yellow und 42 Red.
Fernzugriffs-API
Remote API v1 stellt Status, Chat, Voice, Pending-Abfrage, Confirm und Cancel bereit.
Anfrage- und Antwortschemata
Chat, Confirm und Cancel akzeptieren ausschließlich passende JSON-Content-Types; Voice akzeptiert multipart/form-data.
Lebenszyklus ausstehender Befehle
Der Pending Lifecycle bindet einen validierten Plan an Benutzer, ID, Risiko, Ablauf und Bestätigungstyp.
Risiko- und Bestätigungslogik
Green, Yellow und Red sind serverseitige Eigenschaften der registrierten Action und keine freie Entscheidung der PWA oder des Modells.
Eigene Befehle entwickeln
Eine allgemein freigegebene Schnittstelle zur Installation beliebiger Drittanbieter-Actions ist im Stable-Vertrag von SayAdmin 1.1.1 nicht dokumentiert.
Adapter für KI-Anbieter entwickeln
Provider-Adapter für Claude, Gemini, Mistral und OpenRouter sind in SayAdmin 1.1.1 nicht enthalten.
Sicherheitsverträge
SayAdmin 1.1.1 dokumentiert unter anderem remote-security-v1, remote-security-test-v1, webcrypto-aes-gcm-indexeddb-v1 und iso8601-utc-ttl-v1.
Testanforderungen
Jede zukünftige Remote-Version benötigt Core-, Remote-, Voice-, Storage-, Installer- und Live-Regression.
Veröffentlichungs- und Prüfprozess
Eine Stable-Version gilt erst nach dokumentierten Verträgen, grünen statischen Prüfungen, Live-Gates, Installationsprüfungen und aktualisierter Dokumentation als freigabefähig.