Co-authored-by: Timotheus Pokorra <timotheus.pokorra@solidcharity.com> Co-authored-by: Dev und Test fuer hsadminng <hsh03-hsngdev@h50.hostsharing.net> Reviewed-on: #115 Reviewed-by: Michael Hoennig <michael.hoennig@hostsharing.net> Co-authored-by: Timotheus Pokorra <timotheus.pokorra@hostsharing.net> Co-committed-by: Timotheus Pokorra <timotheus.pokorra@hostsharing.net>
5.0 KiB
hsadminNg fachliches Glossar
Dieses ist eine Sammlung von Fachbegriffen, die in diesem Projekt benutzt werden. Ebenfalls aufgenommen sind technische Begriffe, die für Benutzer für das Verständnis der Schnittstellen nötig sind.
Falls etwas fehlt, bitte Bescheid geben.
Partner
In diesem System ist ein Partner grundsätzlich jeglicher Geschäftspartner der Hostsharing eG. Dies können grundsätzlich Kunden, siehe Debitor, wie Lieferanten sein. Derzeit sind aber nur Debitoren implementiert.
Des Weiteren gibt es für jeden Partner eine fünfstellige Partnernummer mit dem Prefix 'P-' (z.B. P-123454
)
sowie Zusatzinformationen (z.B. Registergerichtnummer oder Geburtsdatum), die zur genauen Identifikation benötigt werden.
Für einen Partner kann es gleichzeitig mehrere Debitoren und zeitlich nacheinander mehrere Mitgliedschaften geben.
Partner sind grundsätzlich als ist Relation der Vertragsperson mit der Person Hostsharing eG implementiert.
Debitor
Ein Debitor
ist quasi ein Rechnungsempfänger für einen Partner.
Für einen Partner kann es gleichzeitig mehrere Debitoren geben, z.B. für spezielle Projekte des Kunden oder verbundene Organisationen.
Des Weiteren gibt es für jeden Partner eine fünfstellige Partnernummer mit dem Prefix 'P-' (z.B. P-123454
)
sowie Zusatzinformationen (z.B. Registergerichtsnummer oder Geburtsdatum), die zur genauen Identifikation benötigt werden.
Debitoren sind grundsätzlich als ist Relation der Vertragsperson mit der Person des Vertragspartners implementiert.
Relation
Eine Relation ist eine typisierte und mit Kontaktdaten versehene Beziehung einer (Holder)-Person zu einer Anchor-Person.
Eine Relation ist eine Art Geschäftsrolle, wir haben hier aber keinen Begriff mit 'Rolle' verwendet, weil 'Role' (engl.) zu leicht mit der RBAC-Rolle verwechselt werden könnte.
Die Relation ist auch ein technisches Konzept und gehört nicht zur Domänensprache. Dieses Konzept ist jedoch für das Verständnis der (API) notwendig.
Ex-Partner
Ex-Partner bilden Personen ab, die vormals Partner waren. Diese bleiben dadurch informationshalber im System verfügbar.
Implementiert ist der Ex-Partner als eine besondere Form der Relation der Person des Ex-Partner (Holder) zum neuen Partner (Anchor) dargestellt. Dieses kann zu einer Kettenbildung führen.
Representative-Contact (ehemals contractual)
Ein Representative ist eine natürliche Person, die für eine nicht-natürliche Person vertretungsberechtigt ist.
Implementiert ist der Representative als eine besondere Form der Relation der Person des Repräsentanten (Holder) zur repräsentierten Person (Anchor) dargestellt.
VIP-Contact
Ein VIP-Contact ist eine natürliche Person, die für einen Geschäftspartner eine wichtige Funktion übernimmt, nicht aber deren offizieller Repräsentant ist.
Implementiert ist der VIP-Contact als eine besondere Form der Relation der Person des VIP-Contact (Holder) zur repräsentierten Person (Anchor) dargestellt.
Operations-Contact
Ein Operations-Contact ist eine natürliche Person, die für einen Geschäftspartner technischer Ansprechpartner ist.
Ein Seiteneffekt ist, dass diese Person im Ticketsystem Znuny direkt dem Geschäftspartner zugeordnet werden kann.
Im Legacy System waren das die Kontakte mit der Rolle operation
und silent
.
Implementiert ist der Operations-Contact als eine besondere Form der Relation der Person des Operations-Contact (Holder) zur repräsentierten Person (Anchor) dargestellt.
OperationsAlert-Contact
Ein OperationsAlert-Contact ist eine natürliche Person, die für einen Geschäftspartner bei technischen Probleme kontaktiert werden soll.
Im Legacy System waren das die Kontakte mit der Rolle operation
.
Implementiert ist der OperationsAlert-Contact als eine besondere Form der Relation der Person des OperationsAlert-Contact (Holder) zur repräsentierten Person (Anchor) dargestellt.
Subscriber-Contact
Ein Subscriber-Contact ist eine natürliche Person, die für einen Geschäftspartner eine bestimmte Mailingliste abonniert.
Implementiert ist der Subscriber-Contact als eine besondere Form der Relation der Person des Subscriber-Contact (Holder) zur repräsentierten Person (Anchor) dargestellt. Zusätzlich wird diese Relation mit dem Kurznamen der abonnierten Mailingliste markiert.
Anchor / Relation-Anchor
siehe Relation
Holder / Relation-Holder
siehe Relation
API
Und API (Application-Programming-Interface) verstehen wir eine über HTTPS angesprochene programmatisch bedienbare Schnittstell zur Funktionalität des hsAdmin-NG-Systems.