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.

App-Einstellungen

Eine installierte App kann Einstellungen pro Installation tragen - kleine Konfiguration, die ein Hive-Admin setzt (eine verknüpfte Ressource, ein Integrationsschlüssel, ein Modus). Sie werden mit der Installation gespeichert und im Launch-Payload geliefert; die App liest sie beim Start und erneut, wenn der Admin sie ändert - ohne Redeploy. Nutze das für Konfiguration. Die Domänendaten der App (ihre Datensätze) gehören in deinen eigenen Speicher, nach Installation oder Kontext geschlüsselt - SweetHive liefert Identität, Scope und Personen/Gruppen; die App besitzt ihre Daten.

Rollen und Berechtigungen

Eine Rolle ist ein benannter Satz der Funktionen deiner App, zugewiesen an Gruppen - nie an einzelne Personen: Mitglieder erben sie über ihre Gruppe. Gruppen und Personen kommen von SweetHive, gelistet für den Kontext, in dem die App installiert ist (die App liest sie). Rollen sind die Daten deiner App - erstelle sie in deinem Speicher und weise jede den richtigen Gruppen zu (mit Suche über die Gruppen des Kontexts bei großen Hives). Zwei Schritte in Reihenfolge: Rolle erstellen (Name + Funktionen), dann Gruppen zuweisen.

Apps miteinander verbinden

Apps rufen sich nicht direkt gegenseitig auf, sondern verbinden sich über die Konnektoren-Schicht von SweetHive. Eine App löst ein Ereignis aus (zum Beispiel "ein Lead wurde erfasst"), und ein Konnektor pro Hive leitet es an die Aktion einer anderen App weiter (zum Beispiel "Marketing-Attribution erfassen"). Eine Integration ein- oder auszuschalten ist eine Einstellung, kein Code in einer der beiden Apps, so bleiben die beiden Apps unabhängig.

• Registriere einmal, was deine App auslöst und was sie akzeptiert (ihre Aktionen).
• Richte einen Konnektor für einen Hive ein: Quell-App + Ereignis zu Ziel-App + Aktion. Ein Administrator verwaltet sie auf der Seite Konnektoren; aktiviere, deaktiviere oder entferne sie jederzeit.
• Die Zustellung erfolgt best-effort: Wenn die andere App nicht erreichbar ist, wird der Ablauf deiner App nicht beeinträchtigt, und jede Zustellung wird protokolliert, damit ein Administrator sehen kann, was passiert ist.

Eine optionale Feldzuordnung erlaubt es, dass jedes Ereignis jede Aktion speist, auch wenn die Feldnamen unterschiedlich sind, so sind neue Integrationen reine Konfiguration. Der SDK-Leitfaden enthält den Ereignis/Aktion-Vertrag und die genauen Endpunkte.