26.1.1 Mitgliedschaft (MVP)

Diese Version bringt die Mitgliedschaft ins Studio, die Verwaltungsanwendung von appsolut ONE. Eine Organisation beschreibt, woher ihre Menschen kommen und wer von ihnen Mitglied ist, und das Studio entscheidet für jede Person, welche ihrer Websites und Apps sie nutzen darf.

Register

• Interne Register werden im Studio geführt. Studio-Benutzer legen Einträge von Hand an, bearbeiten, deaktivieren und reaktivieren sie oder laden eine Excel-Datei (.xlsx) oder CSV-Datei hoch: Sie ordnen deren Spalten zu, lesen den „Prüfbericht“ und eine Vorschau und bestätigen. Ein Upload führt nach Mitgliedsnummer zusammen und entfernt nie jemanden. 50.000 Zeilen sind in unter zwei Minuten geschrieben.
• Ein internes Register lässt sich als Excel-Arbeitsmappe herunterladen, die Sie bearbeiten und unverändert wieder hochladen können.
• Ein Eintrag enthält die Mitgliedsnummer und, soweit bekannt, Namen, Geburtsdatum, Telefonnummer, Postanschrift, Status, Gruppen und Mitgliedschaftsbeginn. Jedes Register legt fest, welche Status als Mitglied zählen.
• Prüfcodes ergänzen das Onboarding um einen zweiten Nachweis. Die Einträge zeigen „Prüfcode erforderlich“ und „Prüfcode gesetzt“, und ob ein Prüfcode erforderlich ist, lässt sich für einen Eintrag von Hand umschalten oder für viele Einträge mit einem Upload festlegen. „Prüfcodes erzeugen“ legt sie für jeden Eintrag an, der einen braucht, als Excel-Datei, die sich einmal herunterladen lässt, bereit für einen Serienbrief. Für ausgewählte Einträge lassen sich die Codes ersetzen, oder sie kommen mit einem Upload. Das Studio speichert von jedem Code nur einen Hash.
• Externe Register bleiben im eigenen System der Organisation, und das Studio fragt sie live über die appsolut Register-API ab. Der API-Schlüssel wird verschlüsselt gespeichert. „Verbindung testen“ zeigt, ob das Register antwortet und wie schnell, und nennt die Ursache, wenn nicht.
• Für ein externes Register lassen sich Gruppen einmal festlegen, für alle, die darin gefunden werden.
• Die Registeraktivität führt jede Änderung an einem Register und seinen Einträgen auf, mit den Werten davor und danach.
• Ein „Eigentümer“ kann ein Register löschen, das weder in der Mitgliedschaftsdefinition noch in einer Community verwendet wird.

Mitgliedschaftsdefinition

• Die „Mitgliedschaftsdefinition“ ist die eine geordnete Liste von Registerzuordnungen einer Organisation. Eine Person wird von oben nach unten gesucht, und das erste Register, das entscheidet, gilt, mit dem Ergebnis „Lässt zu“ oder „Lehnt ab“.
• Filter grenzen ein, über wen eine Zuordnung entscheidet: Status, Gruppen, Mitgliedschaftsbeginn und Mindestdauer der Mitgliedschaft bei einem internen Register, Status und Claims bei einem externen.
• Während Sie bearbeiten, zählt „Berechtigte Personen“ je internem Register die Personen, die die ungespeicherten Änderungen zulassen. Externe Register werden live gefragt und zeigen daher „Nicht zählbar“.
• Eine Mitgliedsnummer lässt sich gegen die ungespeicherte Definition testen, wobei externe Register live gefragt werden.
• „Speichern und veröffentlichen“ veröffentlicht die Definition sofort als neue Version. Der „Versionsverlauf“ bewahrt jede gespeicherte Version, schreibgeschützt.

Mitgliedschaftsprüfung

• Die Mitgliedschaftsprüfung beantwortet, ob eine Mitgliedsnummer und die Angaben zur Person dazu zu einem berechtigten Mitglied gehören: gültig, nicht gültig oder nicht verfügbar. Sie läuft, wenn eine Person Mitglied wird (Onboarding), bei jeder Anmeldung eines Mitglieds (Anmeldung) und wenn das Backend eines Frontends nach jemandem fragt (Berechtigung).
• Den Grund einer Antwort „Nicht gültig“ zeigt nur das Studio, nie die Person oder das Frontend.
• Ist ein externes Register nicht erreichbar, melden sich Mitglieder, deren letzte gültige Prüfung weniger als 7 Tage zurückliegt, nach der Kulanzregel mit diesem Ergebnis weiter an.
• Fehlgeschlagene Prüfungen sind je Mitgliedsnummer, je IP-Adresse des Antragstellers und je Frontend begrenzt, damit sich Mitgliedsnummern und Angaben zur Person nicht erraten lassen. Die Schreibweisen einer Mitgliedsnummer, etwa in Kleinbuchstaben oder mit einem Leerzeichen am Ende, zählen als eine Nummer, und Prüfungen, die im selben Moment kommen, können eine Grenze nicht gemeinsam unterlaufen.
• Findet ein externes Register eine Mitgliedsnummer ohne Namen und Geburtsdatum, mit einem Status, den es nicht zählt, gibt es die Person an das nächste Register weiter, statt die Prüfung als nicht verfügbar zu beenden.

Communities und Frontends

• Communities sind benannte Filter über das Mitgliederverzeichnis, nach Register, Status, Gruppen und Claims. Sie lassen sich anlegen, umbenennen und löschen, und die Communities eines Mitglieds ergeben sich aus seiner letzten Prüfung.
• Frontends sind die Websites und Apps, die die Menschen einer Organisation nutzen. Jedes hat genau eine Community, und mit „Mitgliedschaft verpflichtend“ dürfen es nur gültige Mitglieder dieser Community nutzen.
• Mit Frontend-Schlüsseln ruft das eigene Backend eines Frontends das Studio auf. Ein Schlüssel wird beim Ausstellen einmal angezeigt, und Widerrufen stoppt ihn sofort.

Mitgliederverzeichnis

• Das „Mitgliederverzeichnis“ listet alle Organisationsmitgliedschaften mit Suche, Filtern, Status und Communities.
• „Prüfungen suchen“ listet die protokollierten Prüfungen einer Mitgliedsnummer, mit Prüfmodus, Ergebnis und Grund.
• Die Seite eines Mitglieds zeigt seine Mitgliedschaft mit den Namen aus dem Register, den Frontend-Benutzer, der sie hält, die genutzten Frontends und den Verlauf.
• Eine Mitgliedschaft lässt sich mit Begründung deaktivieren. Bittet eine Person um die Löschung ihrer Daten, entfernt „Jetzt anonymisieren“ alles, was sie erkennen lässt.
• Entscheidet bei einer Anmeldeprüfung ein anderer Registereintrag, wird die Mitgliedschaft von selbst neu verknüpft, und der Verlauf zeigt es.

Mitglieder-API

• POST /api/v1/members/eligibility beantwortet mit dem Frontend-Schlüssel, ob eine Person für die Community des anfragenden Frontends berechtigt ist, ohne dass sie sich anmeldet.
• GET /api/v1/members/me liefert die eigene Organisationsmitgliedschaft und die Mitgliedsdaten des angemeldeten Mitglieds, live aus seinem Register gelesen.

Community Portal

• Ein mit Frontend-Schlüssel angebundenes Community Portal prüft Mitgliedsnummern in seinen Assistenten für Buchung und Einlösung über die Mitgliedschaftsprüfung des Studios. Kann ein Register oder das Studio nicht antworten, bittet der Assistent das Mitglied, es später noch einmal zu versuchen, und behält alle Eingaben, statt es abzulehnen.

Studio-Benutzer und Organisationen

• Studio-Rollen legen fest, was jeder Studio-Benutzer in einer Organisation tun darf, von „Eigentümer“ und „Administrator“ bis zu Rollen für einen einzelnen Bereich.
• Eine öffentliche Roadmap, auf der Studio-Benutzer Funktionen vorschlagen, Fehler melden und darüber abstimmen, was als Nächstes kommt.
• Die Links in den E-Mails des Studios zum Bestätigen einer Registrierung, Annehmen einer Einladung und Ändern der E-Mail-Adresse warten auf einen Klick auf der Seite, die sie öffnen. Ein Mailscanner, der sie zuerst öffnet, verbraucht sie daher nicht mehr. Eine Registrierung lässt sich auch mit dem Code aus derselben E-Mail bestätigen.
• Jedem eingeladenen Studio-Benutzer ohne Passwort wird beim Beitreten angeboten, eine Anmeldemöglichkeit einzurichten.
• Nur Studio-Benutzer, die die Einstellungen einer Organisation ändern dürfen, ändern ihren Namen und ihr Logo. Ein neues Logo erscheint sofort, und ein fehlgeschlagener Upload behält das alte.
• Datum und Uhrzeit erscheinen in der Zeitzone der Person, die sie liest, und in der Sprache, in der sie das Studio nutzt.