Eine App entwickeln

Entwickler können eigene Apps für SweetHive erstellen — eine kleine Datenansicht, eingebettet in einen Kontext, oder ein vollständiges Produkt unter eigener URL. Sie registrieren die App einmal, erhalten Client-Zugangsdaten und entwickeln gegen das App SDK.

Zwei Arten von Apps

Beide authentifizieren sich auf dieselbe Weise: mit einem kurzlebigen, bereichsgebundenen Token, serverseitig begrenzt durch den Geltungsbereich der Installation und die aktuelle Sichtbarkeit des Betrachters. Ihre App sieht nie mehr, als die Person, die sie nutzt, sehen kann — und der Zugriff erlischt in dem Moment, in dem diese Person ihn verliert.

Registrieren und entwickeln

1. Öffnen Sie Entwickler → Apps über das Benutzermenü.
2. Wählen Sie App registrieren: Vergeben Sie einen Namen, wählen Sie Eingebettet oder Extern und legen Sie URL, Icon und Berechtigungsstufe fest.
3. Speichern Sie Client-ID und Secret (werden nur einmal angezeigt).
4. Laden Sie den SDK-Entwicklerleitfaden (.md) herunter — der vollständige Vertrag: der iframe-Handshake, die Authentifizierung, die bereichsgebundene Daten-API, Testen und Veröffentlichen. Legen Sie ihn in Ihr Repository und entwickeln Sie mit Ihrem KI-Coding-Assistenten. Auch hier verfügbar: SWEETHIVE_APP_SDK.md.
5. Setzen Sie die App auf Aktiv, damit Hive-Administratoren sie über Kontext → Apps → App hinzufügen installieren können.

So funktioniert der Standard

• Eingebettete Apps laufen in einem sandboxed iframe und erhalten ein kurzlebiges, bereichsgebundenes Token über einen postMessage-Handshake — niemals ein Cookie, daher funktioniert dies auch in den mobilen Apps. Ihre App muss zulassen, dass SweetHive sie einbettet (eine frame-ancestors-CSP, die die Origins der mobilen Apps einschließt — der SDK-Leitfaden nennt den genauen Header).
• Externe Apps öffnen sich unter ihrer eigenen URL mit einem signierten Start; auf Mobilgeräten öffnen sie sich im nativen In-App-Browser.
• Jeder Datenzugriff wird serverseitig durch den Geltungsbereich der Installation im Schnitt mit der aktuellen Sichtbarkeit des Betrachters begrenzt — dasselbe Gesetz, dieselbe Prüfung wie bei jedem anderen SweetHive-Akteur.

Externe Apps und Hubs

Eine externe App ist ein vollständiges Produkt unter eigener URL. SweetHive zeigt eine Start-Kachel; beim Klick öffnet sich die App mit einem signierten Start und beginnt ihre eigene Sitzung — auf Mobilgeräten im nativen In-App-Browser.

Externe Apps auf einer freigegebenen Origin können Nutzer auch direkt mit ihrem SweetHive-Konto anmelden (SSO): Bei einer aktiven SweetHive-Sitzung wird kein Passwort abgefragt; andernfalls meldet sich der Nutzer auf der SweetHive-Anmeldeseite an und wird direkt in die App zurückgeleitet. Beantragen Sie die Freigabe der Origin bei der Registrierung der App.

Multi-Hive-Hubs: eine Shell, viele Apps

Ein Produkt, das mehrere Hives aus einer Oberfläche verwaltet, folgt dem Hub-Shell-Standard — eine wiederverwendbare Shell, geformt durch ein Manifest:

• Die Shell stellt einmalig für jede App bereit: SSO-Anmeldung, den Hive-Selektor oben rechts, Team- und Einladungsverwaltung, helles/dunkles Design und die einklappbare Seitenleiste.
• Das Manifest (mit der App-Registrierung gespeichert) deklariert die Marke und die Einträge des linken Panels. Jeder Eintrag öffnet eine in die Shell integrierte Ansicht oder — der entscheidende Teil — eine beliebige eingebettete SweetHive-App, unverändert in einem Frame dargestellt: ein Build bedient die Kontext-Oberfläche und den Hub.
• Der Hive-Wechsel setzt den Geltungsbereich neu: Die Shell löst die Installation der App im gewählten Hive auf und lädt die aktive Ansicht neu, sodass jeder Bildschirm dem Hive folgt — einschließlich leerer Zustände für Hives, in denen die App nicht installiert ist.

Der SDK-Leitfaden enthält den vollständigen Vertrag: das Manifest-Schema, den Ansichten-Handshake und die Fallstricke.

Testen und veröffentlichen

Registrieren Sie Ihre App mit einer localhost-URL und installieren Sie sie in einem Testkontext — der Handshake liefert dann ein echtes bereichsgebundenes Token gegen Ihre Daten. Wenn die App fertig ist, setzen Sie sie auf Aktiv — und deaktivieren Sie sie jederzeit wieder; Installationen stoppen sofort.