From 92e675b642a54de1cc945809998592471c034877 Mon Sep 17 00:00:00 2001 From: Michael Hoennig Date: Fri, 15 Nov 2024 09:51:04 +0100 Subject: [PATCH] improves the Business-Glossary --- doc/business-glossary-de.md | 84 ++++++++++++++++++++++++++----------- 1 file changed, 59 insertions(+), 25 deletions(-) diff --git a/doc/business-glossary-de.md b/doc/business-glossary-de.md index 4ab2d60a..65d316a1 100644 --- a/doc/business-glossary-de.md +++ b/doc/business-glossary-de.md @@ -26,12 +26,6 @@ und zeitlich nacheinander mehrere [Mitgliedschaften](#Mitgliedschaft) geben. Partner sind grundsätzlich als ist [Relation](#Relation) der Vertragsperson mit der Person _Hostsharing eG_ implementiert. -#### Ex-Partner - -Ex-Partner bilden [Personen](#Person) ab, die vormals [Partner](#Partner) waren. -Diese bleiben dadurch dem System - - ### Debitor Ein `Debitor` ist quasi ein Rechnungsempfänger für einen [Partner](#Partner). @@ -42,35 +36,75 @@ 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](#Relation) der Vertragsperson mit der Person des Vertragspartners implementiert. -#### Representative (ehemals _contractual_) +#### Relation -Ein _Representative_ ist eine natürliche Person, die für eine nicht-natürliche Person vertretungsberechtigt ist. +Eine _Relation_ ist eine typisierte und mit Kontaktdaten versehene Beziehung einer (_Holder_)-Person zu einer _Anchor_-Person. -Implementiert ist der _Representative_ als eine besondere Form der [Relation](#Relation) des - - - 'VIP_CONTACT', - 'OPERATIONS', - 'SUBSCRIBER'); - - -#### Relation (so eine Art Geschäftsrolle) - -Eine _Relation_ ist eine Beziehung - -Wir haben hier keinen Begriff mit 'Rolle' verwendet, +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](#RBAC-Role) 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](#API)) notwendig. -#### Anker + +#### Ex-Partner + +Ex-Partner bilden [Personen](#Person) ab, die vormals [Partner](#Partner) waren. +Diese bleiben dadurch informationshalber im System verfügbar. + +Implementiert ist der _Ex-Partner_ als eine besondere Form der [Relation](#Relation) +der Person des Ex-Partner (_Holder_) zum neuen Partner (_Anchor_) dargestellt. +Dieses kann zu einer Kettenbildung führen. -#### API (Application-Programming-Interface) +#### 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](#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](#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 + +Implementiert ist der _Operations-Contact_ als eine besondere Form der [Relation](#Relation) +der Person des _Operations-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](#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](#Relation) + + +#### Holder / Relation-Holder + +siehe [Relation](#Relation) + + +#### API + +Und API (Application-Programming-Interface) verstehen wir eine über HTTPS angesprochene programmatisch bedienbare Schnittstell +zur Funktionalität des hsAdmin-NG-Systems.