doc/hs-office-data-structure.md

@@ -10,7 +10,7 @@ classDiagram
 
     namespace Partner {
         class partner-MeierGmbH
-        class rel-MeierGmbH
+        class role-MeierGmbH
         class personDetails-MeierGmbH
         class contactData-MeierGmbH
         class person-MeierGmbH
@@ -19,29 +19,28 @@ classDiagram
     namespace Representatives {
         class person-FrankMeier
         class contactData-FrankMeier
-        class rel-MeierGmbH-FrankMeier
+        class role-MeierGmbH-FrankMeier
     }
     
     namespace Debitors {
         class debitor-MeierGmbH
         class contactData-MeierGmbH-Buha
-        class rel-MeierGmbH-Buha
+        class role-MeierGmbH-Buha
     }
 
     namespace Operations {
         class person-SabineMeier
         class contactData-SabineMeier
-        class rel-MeierGmbH-SabineMeier
+        class role-MeierGmbH-SabineMeier
     }
     
     namespace Enums {
 
-        class RelationType {
+        class RoleType {
             <<enumeration>>
             UNKNOWN
-            PARTNER
-            DEBITOR
             REPRESENTATIVE
+            ACCOUNTING
             OPERATIONS
         }
 
@@ -65,9 +64,9 @@ classDiagram
 
     class partner-MeierGmbH {
         +Numeric partnerNumber: 12345
-        +Relation partnerRel
+        +Role partnerRole
     }
-    partner-MeierGmbH *-- rel-MeierGmbH
+    partner-MeierGmbH *-- role-MeierGmbH
 
     class person-MeierGmbH {
         +personType: LEGAL
@@ -91,22 +90,22 @@ classDiagram
         +emailAddresses:    office@meier-gmbh.de
     }
 
-    class rel-MeierGmbH {
-        +RelationType type PARTNER
+    class role-MeierGmbH {
+        +RoleType RoleType PARTNER
         +Person anchor
         +Person holder
-        +Contact contact
+        +Contact roleContact
     }
-    rel-MeierGmbH o-- person-HostsharingEG : anchor
-    rel-MeierGmbH o-- person-MeierGmbH : holder
-    rel-MeierGmbH o-- contactData-MeierGmbH
+    role-MeierGmbH o-- person-HostsharingEG : anchor
+    role-MeierGmbH o-- person-MeierGmbH : holder
+    role-MeierGmbH o-- contactData-MeierGmbH
 
     %% --- Debitors ---
 
     class debitor-MeierGmbH {
         +Partner    partner
         +Numeric[2] debitorNumberSuffix:    00
-        +Relation    debitorRel
+        +Role       billingRole
         +boolean    billable:               true
         +String     vatId:                  ID123456789
         +String     vatCountryCode:         DE
@@ -116,7 +115,7 @@ classDiagram
         +String     defaultPrefix:          mei
     }
     debitor-MeierGmbH o-- partner-MeierGmbH
-    debitor-MeierGmbH *-- rel-MeierGmbH-Buha
+    debitor-MeierGmbH *-- role-MeierGmbH-Buha
 
     class contactData-MeierGmbH-Buha {
         +postalAddress:     Hauptstraße 5, 22345 Hamburg
@@ -124,15 +123,15 @@ classDiagram
         +emailAddresses:    buha@meier-gmbh.de
     }
 
-    class rel-MeierGmbH-Buha {
-        +RelationType type DEBITOR
+    class role-MeierGmbH-Buha {
+        +RoleType RoleType ACCOUNTING
         +Person anchor
         +Person holder
-        +Contact contact
+        +Contact roleContact
     }
-    rel-MeierGmbH-Buha o-- person-MeierGmbH : anchor
-    rel-MeierGmbH-Buha o-- person-MeierGmbH : holder
-    rel-MeierGmbH-Buha o-- contactData-MeierGmbH-Buha
+    role-MeierGmbH-Buha o-- person-MeierGmbH : anchor
+    role-MeierGmbH-Buha o-- person-MeierGmbH : holder
+    role-MeierGmbH-Buha o-- contactData-MeierGmbH-Buha
 
     %% --- Representatives ---
 
@@ -149,15 +148,15 @@ classDiagram
         +emailAddresses: frank.meier@meier-gmbh.de
     }
 
-    class rel-MeierGmbH-FrankMeier {
-        +RelationType type REPRESENTATIVE
+    class role-MeierGmbH-FrankMeier {
+        +RoleType RoleType REPRESENTATIVE
         +Person anchor
         +Person holder
-        +Contact contact
+        +Contact roleContact
     }
-    rel-MeierGmbH-FrankMeier o-- person-MeierGmbH : anchor
-    rel-MeierGmbH-FrankMeier o-- person-FrankMeier : holder
-    rel-MeierGmbH-FrankMeier o-- contactData-FrankMeier
+    role-MeierGmbH-FrankMeier o-- person-MeierGmbH : anchor
+    role-MeierGmbH-FrankMeier o-- person-FrankMeier : holder
+    role-MeierGmbH-FrankMeier o-- contactData-FrankMeier
 
     %% --- Operations ---
 
@@ -174,14 +173,14 @@ classDiagram
         +emailAddresses: sabine.meier@meier-gmbh.de
     }
 
-    class rel-MeierGmbH-SabineMeier {
-        +RelationType type OPERATIONAL
+    class role-MeierGmbH-SabineMeier {
+        +RoleType RoleType OPERATIONAL
         +Person anchor
         +Person holder
-        +Contact contact
+        +Contact roleContact
     }
-    rel-MeierGmbH-SabineMeier o-- person-MeierGmbH : anchor
-    rel-MeierGmbH-SabineMeier o-- person-SabineMeier : holder
-    rel-MeierGmbH-SabineMeier o-- contactData-SabineMeier
+    role-MeierGmbH-SabineMeier o-- person-MeierGmbH : anchor
+    role-MeierGmbH-SabineMeier o-- person-SabineMeier : holder
+    role-MeierGmbH-SabineMeier o-- contactData-SabineMeier
 
 ```

doc/ideas/simplified-grant-structure.md

@@ -8,7 +8,7 @@ Vor einigen Wochen hatten wir schon einmal darüber geredet, ob wir dieses Gefle
 
 Und nun gehe ich noch einen Schritt weiter: Könnte es nicht auch andersherum sein? Also wenn jemand z.B. SELECT-Recht am Partner hat, dass wir davon ausgehen können, dass derjenige auch die Partner-Personen- und Kontaktdaten sehen darf, und zwar implizit durch seine Partner-SELECT-Permission und ohne dass er explizit Rollen für diese Partner-Personen oder Kontaktdaten inne hat?
 
-Im Halbschlaf kam mir nur die Idee, warum wir nicht einfach die komplexen JPA-Entitäten zwar auf die restricted View setzen, wie bisher, aber für die verknüpften Entitäten auf die direkten (bisher "Raw..." genannt) Entitäten gehen. Dann könnte jemand mit einer Rolle, welche die SELECT-Permission auf die komplexe JPA-Entität (z.B.) Partner inne hat, auch die dazugehörige Relation(ship) ["Relation" wurde vor kurzem auf kurz "Relation" umbenannt] und die wiederum dazu gehörigen Personen- und Kontaktdaten lesen, ohne dass in einem INSERT- und UPDATE-Trigger der Partner-Entität die ganzen Grants mit den verknüpften Entäten aufgebaut und aktualisiert werden müssen.
+Im Halbschlaf kam mir nur die Idee, warum wir nicht einfach die komplexen JPA-Entitäten zwar auf die restricted View setzen, wie bisher, aber für die verknüpften Entitäten auf die direkten (bisher "Raw..." genannt) Entitäten gehen. Dann könnte jemand mit einer Rolle, welche die SELECT-Permission auf die komplexe JPA-Entität (z.B.) Partner inne hat, auch die dazugehörige Relation(ship) ["Relationship" wurde vor kurzem auf kurz "Relation" umbenannt] und die wiederum dazu gehörigen Personen- und Kontaktdaten lesen, ohne dass in einem INSERT- und UPDATE-Trigger der Partner-Entität die ganzen Grants mit den verknüpften Entäten aufgebaut und aktualisiert werden müssen.
 
 Beim Debitor ist das nämlich selbst mit Generator die Hölle, zumal eben auch Querverbindungen gegranted werden müssen, z.B. von der Debitor-Person zum Sema-Mandat - jedenfalls wenn man nicht Gefahr laufen wollte, dass jemand mit Admin-Rechten an der Partner-Person (also z.B. ein Repräsentant des Partners) die Sepa-Mandate der Debitoren gar nicht mehr sehen kann. Natürlich bräuchte man immer noch die Agent-Rolle am Partner und Debitor (evtl. repräsentiert durch die jeweils zugehörigen Relation - falls dieser Trick überhaupt noch nötig wäre), sowie ein Grant vom Partner-Agent auf den Debitor-Agent und vom Debitor-Agent auf die Sepa-Mandate-Admins, aber eben ohne filigran die ganzen Neben-Entäten (Personen- und Kontaktdaten von Partner und Debitor sowie Bank-Account) in jedem Trigger berücksichtigen zu müssen. Beim Refund-Bank-Account sogar besonders ätzend, weil der optional ist und dadurch zig "if ...refundBankAccountUuid is not null then ..." im Code enstehen (wenn der auch generiert ist).
 

doc/rbac-schema-f.md

@@ -8,11 +8,11 @@ Das folgende Schema soll dabei unterstützen, die richtigen Permissions, Rollen
 
 An einigen Stellen ist vom *Initiator* die Rede. Als *Initiator* gilt derjenige User, der die Operation (INSERT oder UPDATE) durchführt bzw. dessen primary assumed Rol. (TODO: bisher gibt es nur assumed roles, das Konzept einer primary assumed Role müsste noch eingeführt werden, derzeit nehmen wir dafür immer den `globalAdmin()`. Bevor Kunden aber selbst Objekte anlegen können, muss das geklärt sein.)
 
-#### Typ Root: Objekte, welche nur eine Spezialisierung bzw. Zusatzdaten für andere Objekte bereitstellen (z.B. Partner für Relations vom Typ Partner oder Partner Details für Partner)
+#### Typ Root: Objekte, welche nur eine Spezialisierung bzw. Zusatzdaten für andere Objekte bereitstellen (z.B. Partner für Relationships vom Typ Partner oder Partner Details für Partner)
 
-Objektorientiert gedacht, enthalten solche Objekte die Zusatzdaten einer Subklasse; die Daten im Partner erweitern also eine Relation vom Typ `partner`.
+Objektorientiert gedacht, enthalten solche Objekte die Zusatzdaten einer Subklasse; die Daten im Partner erweitern also eine Relationship vom Typ `partner`.
 
-- Dann muss dieses Objekt zeitlich nach dem Objekt erzeugt werden, auf dass es sich bezieht, also z.B. zeitlich nach der Relation.
+- Dann muss dieses Objekt zeitlich nach dem Objekt erzeugt werden, auf dass es sich bezieht, also z.B. zeitlich nach der Relationship.
 - Es werden Delete (\*), Edit und View Permissions für dieses Objekt erzeugt.
 - Es werden **keine** Rollen für dieses Objekt erzeugt.
 - Statt eigener Rollen werden die o.g. Permissions passenden Rollen des Hauptobjekts zugewiesen (granted) bzw. aus denen entfernt (revoked).
@@ -33,7 +33,7 @@ Objektorientiert gedacht, enthalten solche Objekte die Zusatzdaten einer Subklas
 Anmerkung: Der Typ-Begriff *Root* bezieht sich auf die Rolle im fachlichen Datenmodell. Im Bezug auf den Teilgraphen eines fachlichen Kontexts ist dies auch eine Wurzel im Sinne der Graphentheorie. Aber in anderen fachlichen Kontexten können auch diese Objekte von anderen Teilgraphen referenziert werden und werden dann zum inneren Knoten.
 
 
-#### Typ Aggregator: Objekte, welche weitere Objekte zusammenfassen (z.B. Relation fasst zwei Persons und einen Contact zusammen)
+#### Typ Aggregator: Objekte, welche weitere Objekte zusammenfassen (z.B. Relationship fasst zwei Persons und einen Contact zusammen)
 
 Solche Objekte verweisen üblicherweise auf Objekte vom Typ Leaf und werden oft von Objekten des Typs Root referenziert.
 

src/main/java/net/hostsharing/hsadminng/hs/office/debitor/HsOfficeDebitorController.java

@@ -5,8 +5,8 @@ import net.hostsharing.hsadminng.hs.office.generated.api.v1.api.HsOfficeDebitors
 import net.hostsharing.hsadminng.hs.office.generated.api.v1.model.HsOfficeDebitorInsertResource;
 import net.hostsharing.hsadminng.hs.office.generated.api.v1.model.HsOfficeDebitorPatchResource;
 import net.hostsharing.hsadminng.hs.office.generated.api.v1.model.HsOfficeDebitorResource;
-import net.hostsharing.hsadminng.hs.office.relation.HsOfficeRelationEntity;
-import net.hostsharing.hsadminng.hs.office.relation.HsOfficeRelationRepository;
+import net.hostsharing.hsadminng.hs.office.relationship.HsOfficeRelationshipEntity;
+import net.hostsharing.hsadminng.hs.office.relationship.HsOfficeRelationshipRepository;
 import net.hostsharing.hsadminng.mapper.Mapper;
 import org.apache.commons.lang3.Validate;
 import org.springframework.beans.factory.annotation.Autowired;
@@ -21,7 +21,7 @@ import jakarta.persistence.PersistenceContext;
 import java.util.List;
 import java.util.UUID;
 
-import static net.hostsharing.hsadminng.hs.office.relation.HsOfficeRelationType.DEBITOR;
+import static net.hostsharing.hsadminng.hs.office.relationship.HsOfficeRelationshipType.ACCOUNTING;
 
 @RestController
 
@@ -37,7 +37,7 @@ public class HsOfficeDebitorController implements HsOfficeDebitorsApi {
     private HsOfficeDebitorRepository debitorRepo;
 
     @Autowired
-    private HsOfficeRelationRepository relRepo;
+    private HsOfficeRelationshipRepository relRepo;
 
     @PersistenceContext
     private EntityManager em;
@@ -73,15 +73,15 @@ public class HsOfficeDebitorController implements HsOfficeDebitorsApi {
         Validate.isTrue(body.getDebitorRel() != null || body.getDebitorRelUuid() != null,
                 "ERROR: [400] exactly one of debitorRel and debitorRelUuid must be supplied, but found none");
         Validate.isTrue(body.getDebitorRel() == null ||
-                    body.getDebitorRel().getType() == null || DEBITOR.name().equals(body.getDebitorRel().getType()),
-                "ERROR: [400] debitorRel.type must be '"+DEBITOR.name()+"' or null for default");
-        Validate.isTrue(body.getDebitorRel() == null || body.getDebitorRel().getMark() == null,
-                "ERROR: [400] debitorRel.mark must be null");
+                    body.getDebitorRel().getRelType() == null || ACCOUNTING.name().equals(body.getDebitorRel().getRelType()),
+                "ERROR: [400] debitorRel.relType must be '"+ACCOUNTING.name()+"' or null for default");
+        Validate.isTrue(body.getDebitorRel() == null || body.getDebitorRel().getRelMark() == null,
+                "ERROR: [400] debitorRel.relMark must be null");
 
         final var entityToSave = mapper.map(body, HsOfficeDebitorEntity.class);
         if ( body.getDebitorRel() != null ) {
-            body.getDebitorRel().setType(DEBITOR.name());
-            final var debitorRel = mapper.map(body.getDebitorRel(), HsOfficeRelationEntity.class);
+            body.getDebitorRel().setRelType(ACCOUNTING.name());
+            final var debitorRel = mapper.map(body.getDebitorRel(), HsOfficeRelationshipEntity.class);
             entityToSave.setDebitorRel(relRepo.save(debitorRel));
             // FIXME em.flush();
         } else {

src/main/java/net/hostsharing/hsadminng/hs/office/debitor/HsOfficeDebitorEntity.java

@@ -3,8 +3,8 @@ package net.hostsharing.hsadminng.hs.office.debitor;
 import lombok.*;
 import net.hostsharing.hsadminng.errors.DisplayName;
 import net.hostsharing.hsadminng.hs.office.bankaccount.HsOfficeBankAccountEntity;
+import net.hostsharing.hsadminng.hs.office.relationship.HsOfficeRelationshipEntity;
 import net.hostsharing.hsadminng.hs.office.partner.HsOfficePartnerEntity;
-import net.hostsharing.hsadminng.hs.office.relation.HsOfficeRelationEntity;
 import net.hostsharing.hsadminng.persistence.HasUuid;
 import net.hostsharing.hsadminng.rbac.rbacdef.RbacView;
 import net.hostsharing.hsadminng.rbac.rbacdef.RbacView.SQL;
@@ -43,7 +43,7 @@ public class HsOfficeDebitorEntity implements HasUuid, Stringifyable {
     private static Stringify<HsOfficeDebitorEntity> stringify =
             stringify(HsOfficeDebitorEntity.class, "debitor")
                     .withIdProp(HsOfficeDebitorEntity::toShortString)
-                    .withProp(e -> ofNullable(e.getDebitorRel()).map(HsOfficeRelationEntity::toShortString).orElse(null))
+                    .withProp(e -> ofNullable(e.getDebitorRel()).map(HsOfficeRelationshipEntity::toShortString).orElse(null))
                     .withProp(HsOfficeDebitorEntity::getDefaultPrefix)
                     .quotedValues(false);
 
@@ -60,11 +60,11 @@ public class HsOfficeDebitorEntity implements HasUuid, Stringifyable {
             (
                 SELECT DISTINCT partner.uuid
                 FROM hs_office_partner partner
-                JOIN hs_office_relation dRel
-                    ON dRel.uuid = debitorreluuid AND dRel.type = 'DEBITOR'
-                JOIN hs_office_relation pRel
-                    ON pRel.uuid = partner.partnerRelUuid AND pRel.type = 'PARTNER'
-                WHERE pRel.holderUuid = dRel.anchorUuid
+                JOIN hs_office_relationship dRel
+                    ON dRel.uuid = debitorreluuid AND dRel.relType = 'ACCOUNTING'
+                JOIN hs_office_relationship pRel
+                    ON pRel.uuid = partner.partnerRoleUuid AND pRel.relType = 'PARTNER'
+                WHERE pRel.relHolderUuid = dRel.relAnchorUuid
             )
             """)
     @NotFound(action = NotFoundAction.IGNORE)
@@ -75,7 +75,7 @@ public class HsOfficeDebitorEntity implements HasUuid, Stringifyable {
 
     @ManyToOne(cascade = CascadeType.ALL)
     @JoinColumn(name = "debitorreluuid", nullable = false)
-    private HsOfficeRelationEntity debitorRel;
+    private HsOfficeRelationshipEntity debitorRel;
 
     @Column(name = "billable", nullable = false)
     private Boolean billable; // not a primitive because otherwise the default would be false
@@ -128,10 +128,10 @@ public class HsOfficeDebitorEntity implements HasUuid, Stringifyable {
                         SELECT debitor.uuid AS uuid,
                                     'D-' || (SELECT partner.partnerNumber
                                             FROM hs_office_partner partner
-                                            JOIN hs_office_relation partnerRel
-                                                ON partnerRel.uuid = partner.partnerRelUUid AND partnerRel.type = 'PARTNER'
-                                            JOIN hs_office_relation debitorRel
-                                                ON debitorRel.anchorUuid = partnerRel.holderUuid AND debitorRel.type = 'DEBITOR'
+                                            JOIN hs_office_relationship partnerRel
+                                                ON partnerRel.uuid = partner.partnerRoleUUid AND partnerRel.relType = 'PARTNER'
+                                            JOIN hs_office_relationship debitorRel
+                                                ON debitorRel.relAnchorUuid = partnerRel.relHolderUuid AND debitorRel.relType = 'ACCOUNTING'
                                             WHERE debitorRel.uuid = debitor.debitorRelUuid)
                                          || to_char(debitorNumberSuffix, 'fm00') as idName
                         FROM hs_office_debitor AS debitor
@@ -148,11 +148,11 @@ public class HsOfficeDebitorEntity implements HasUuid, Stringifyable {
                         "defaultPrefix" /* TODO: do we want that updatable? */)
                 .toRole("global", ADMIN).grantPermission(INSERT)
 
-                .importRootEntityAliasProxy("debitorRel", HsOfficeRelationEntity.class,
+                .importRootEntityAliasProxy("debitorRel", HsOfficeRelationshipEntity.class,
                         fetchedBySql("""
                                 SELECT *
-                                    FROM hs_office_relation AS r
-                                    WHERE r.type = 'DEBITOR' AND r.uuid = ${REF}.debitorRelUuid
+                                    FROM hs_office_relationship AS r
+                                    WHERE r.relType = 'ACCOUNTING' AND r.uuid = ${REF}.debitorRelUuid
                                 """),
                         dependsOnColumn("debitorRelUuid"))
                 .createPermission(DELETE).grantedTo("debitorRel", OWNER)
@@ -171,14 +171,14 @@ public class HsOfficeDebitorEntity implements HasUuid, Stringifyable {
                 .toRole("refundBankAccount", ADMIN).grantRole("debitorRel", AGENT)
                 .toRole("debitorRel", AGENT).grantRole("refundBankAccount", REFERRER)
 
-                .importEntityAlias("partnerRel", HsOfficeRelationEntity.class,
+                .importEntityAlias("partnerRel", HsOfficeRelationshipEntity.class,
                         dependsOnColumn("debitorRelUuid"),
                         fetchedBySql("""
                                 SELECT partnerRel.*
-                                    FROM hs_office_relation AS partnerRel
-                                    JOIN hs_office_relation AS debitorRel
-                                        ON debitorRel.type = 'DEBITOR' AND debitorRel.anchorUuid = partnerRel.holderUuid
-                                    WHERE partnerRel.type = 'PARTNER'
+                                    FROM hs_office_relationship AS partnerRel
+                                    JOIN hs_office_relationship AS debitorRel
+                                        ON debitorRel.relType = 'ACCOUNTING' AND debitorRel.relAnchorUuid = partnerRel.relHolderUuid
+                                    WHERE partnerRel.relType = 'PARTNER'
                                         AND ${REF}.debitorRelUuid = debitorRel.uuid
                                 """)
                 )

src/main/java/net/hostsharing/hsadminng/hs/office/debitor/HsOfficeDebitorEntityPatcher.java

@@ -2,7 +2,7 @@ package net.hostsharing.hsadminng.hs.office.debitor;
 
 import net.hostsharing.hsadminng.hs.office.bankaccount.HsOfficeBankAccountEntity;
 import net.hostsharing.hsadminng.hs.office.generated.api.v1.model.HsOfficeDebitorPatchResource;
-import net.hostsharing.hsadminng.hs.office.relation.HsOfficeRelationEntity;
+import net.hostsharing.hsadminng.hs.office.relationship.HsOfficeRelationshipEntity;
 import net.hostsharing.hsadminng.mapper.EntityPatcher;
 import net.hostsharing.hsadminng.mapper.OptionalFromJson;
 
@@ -25,7 +25,7 @@ class HsOfficeDebitorEntityPatcher implements EntityPatcher<HsOfficeDebitorPatch
     public void apply(final HsOfficeDebitorPatchResource resource) {
         OptionalFromJson.of(resource.getDebitorRelUuid()).ifPresent(newValue -> {
             verifyNotNull(newValue, "debitorRel");
-            entity.setDebitorRel(em.getReference(HsOfficeRelationEntity.class, newValue));
+            entity.setDebitorRel(em.getReference(HsOfficeRelationshipEntity.class, newValue));
         });
         Optional.ofNullable(resource.getBillable()).ifPresent(entity::setBillable);
         OptionalFromJson.of(resource.getVatId()).ifPresent(entity::setVatId);

src/main/java/net/hostsharing/hsadminng/hs/office/debitor/HsOfficeDebitorRepository.java

@@ -14,8 +14,8 @@ public interface HsOfficeDebitorRepository extends Repository<HsOfficeDebitorEnt
     @Query("""
             SELECT debitor FROM HsOfficeDebitorEntity debitor
             JOIN HsOfficePartnerEntity partner
-                    ON partner.partnerRel.holder = debitor.debitorRel.anchor
-                        AND partner.partnerRel.type = 'PARTNER' AND debitor.debitorRel.type = 'DEBITOR'
+                    ON partner.partnerRole.relHolder = debitor.debitorRel.relAnchor
+                        AND partner.partnerRole.relType = 'PARTNER' AND debitor.debitorRel.relType = 'ACCOUNTING'
                 WHERE cast(partner.partnerNumber as integer) = :partnerNumber
                   AND cast(debitor.debitorNumberSuffix as integer) = :debitorNumberSuffix
                """)
@@ -28,14 +28,14 @@ public interface HsOfficeDebitorRepository extends Repository<HsOfficeDebitorEnt
     @Query("""
             SELECT debitor FROM HsOfficeDebitorEntity debitor
                 JOIN HsOfficePartnerEntity partner
-                    ON partner.partnerRel.holder = debitor.debitorRel.anchor
-                        AND partner.partnerRel.type = 'PARTNER' AND debitor.debitorRel.type = 'DEBITOR'
+                    ON partner.partnerRole.relHolder = debitor.debitorRel.relAnchor
+                        AND partner.partnerRole.relType = 'PARTNER' AND debitor.debitorRel.relType = 'ACCOUNTING'
                 JOIN HsOfficePersonEntity person
-                    ON person.uuid = partner.partnerRel.holder.uuid
-                        OR person.uuid = debitor.debitorRel.holder.uuid
+                    ON person.uuid = partner.partnerRole.relHolder.uuid
+                        OR person.uuid = debitor.debitorRel.relHolder.uuid
                 JOIN HsOfficeContactEntity contact
                     ON contact.uuid = debitor.debitorRel.contact.uuid 
-                        OR contact.uuid = partner.partnerRel.contact.uuid
+                        OR contact.uuid = partner.partnerRole.contact.uuid
                 WHERE :name is null
                     OR partner.details.birthName like concat(cast(:name as text), '%')
                     OR person.tradeName like concat(cast(:name as text), '%')

src/main/java/net/hostsharing/hsadminng/hs/office/membership/HsOfficeMembershipEntity.java

@@ -4,7 +4,7 @@ import com.vladmihalcea.hibernate.type.range.PostgreSQLRangeType;
 import com.vladmihalcea.hibernate.type.range.Range;
 import lombok.*;
 import net.hostsharing.hsadminng.errors.DisplayName;
-import net.hostsharing.hsadminng.hs.office.relation.HsOfficeRelationEntity;
+import net.hostsharing.hsadminng.hs.office.relationship.HsOfficeRelationshipEntity;
 import net.hostsharing.hsadminng.persistence.HasUuid;
 import net.hostsharing.hsadminng.hs.office.partner.HsOfficePartnerEntity;
 import net.hostsharing.hsadminng.rbac.rbacdef.RbacView;
@@ -128,12 +128,12 @@ public class HsOfficeMembershipEntity implements HasUuid, Stringifyable {
                 .withRestrictedViewOrderBy(SQL.projection("validity"))
                 .withUpdatableColumns("validity", "membershipFeeBillable", "reasonForTermination")
 
-                .importEntityAlias("partnerRel", HsOfficeRelationEntity.class,
+                .importEntityAlias("partnerRel", HsOfficeRelationshipEntity.class,
                         dependsOnColumn("partnerUuid"),
                         fetchedBySql("""
                                 SELECT r.*
                                     FROM hs_office_partner AS p
-                                    JOIN hs_office_relation AS r ON r.uuid = p.partnerRelUuid
+                                    JOIN hs_office_relationship AS r ON r.uuid = p.partnerRoleUuid
                                     WHERE p.uuid = ${REF}.partnerUuid
                                 """))
                 .toRole("partnerRel", ADMIN).grantPermission(INSERT)

src/main/java/net/hostsharing/hsadminng/hs/office/partner/HsOfficePartnerController.java

@@ -7,11 +7,11 @@ import net.hostsharing.hsadminng.hs.office.generated.api.v1.api.HsOfficePartners
 import net.hostsharing.hsadminng.hs.office.generated.api.v1.model.HsOfficePartnerInsertResource;
 import net.hostsharing.hsadminng.hs.office.generated.api.v1.model.HsOfficePartnerPatchResource;
 import net.hostsharing.hsadminng.hs.office.generated.api.v1.model.HsOfficePartnerResource;
-import net.hostsharing.hsadminng.hs.office.generated.api.v1.model.HsOfficePartnerRelInsertResource;
+import net.hostsharing.hsadminng.hs.office.generated.api.v1.model.HsOfficePartnerRoleInsertResource;
 import net.hostsharing.hsadminng.hs.office.person.HsOfficePersonEntity;
-import net.hostsharing.hsadminng.hs.office.relation.HsOfficeRelationEntity;
-import net.hostsharing.hsadminng.hs.office.relation.HsOfficeRelationRepository;
-import net.hostsharing.hsadminng.hs.office.relation.HsOfficeRelationType;
+import net.hostsharing.hsadminng.hs.office.relationship.HsOfficeRelationshipEntity;
+import net.hostsharing.hsadminng.hs.office.relationship.HsOfficeRelationshipRepository;
+import net.hostsharing.hsadminng.hs.office.relationship.HsOfficeRelationshipType;
 import net.hostsharing.hsadminng.mapper.Mapper;
 import net.hostsharing.hsadminng.rbac.rbacobject.RbacObject;
 import org.springframework.beans.factory.annotation.Autowired;
@@ -40,7 +40,7 @@ public class HsOfficePartnerController implements HsOfficePartnersApi {
     private HsOfficePartnerRepository partnerRepo;
 
     @Autowired
-    private HsOfficeRelationRepository relationRepo;
+    private HsOfficeRelationshipRepository relationshipRepo;
 
     @PersistenceContext
     private EntityManager em;
@@ -139,16 +139,16 @@ public class HsOfficePartnerController implements HsOfficePartnersApi {
     private HsOfficePartnerEntity createPartnerEntity(final HsOfficePartnerInsertResource body) {
         final var entityToSave = new HsOfficePartnerEntity();
         entityToSave.setPartnerNumber(body.getPartnerNumber());
-        entityToSave.setPartnerRel(persistPartnerRel(body.getPartnerRel()));
+        entityToSave.setPartnerRole(persistPartnerRole(body.getPartnerRole()));
         entityToSave.setDetails(mapper.map(body.getDetails(), HsOfficePartnerDetailsEntity.class));
         return entityToSave;
     }
 
-    private HsOfficeRelationEntity persistPartnerRel(final HsOfficePartnerRelInsertResource resource) {
-        final var entity = new HsOfficeRelationEntity();
-        entity.setType(HsOfficeRelationType.PARTNER);
-        entity.setAnchor(ref(HsOfficePersonEntity.class, resource.getAnchorUuid()));
-        entity.setHolder(ref(HsOfficePersonEntity.class, resource.getHolderUuid()));
+    private HsOfficeRelationshipEntity persistPartnerRole(final HsOfficePartnerRoleInsertResource resource) {
+        final var entity = new HsOfficeRelationshipEntity();
+        entity.setRelType(HsOfficeRelationshipType.PARTNER);
+        entity.setRelAnchor(ref(HsOfficePersonEntity.class, resource.getRelAnchorUuid()));
+        entity.setRelHolder(ref(HsOfficePersonEntity.class, resource.getRelHolderUuid()));
         entity.setContact(ref(HsOfficeContactEntity.class, resource.getContactUuid()));
         em.persist(entity);
         return entity;

src/main/java/net/hostsharing/hsadminng/hs/office/partner/HsOfficePartnerEntity.java

@@ -9,7 +9,7 @@ import net.hostsharing.hsadminng.errors.DisplayName;
 import net.hostsharing.hsadminng.hs.office.contact.HsOfficeContactEntity;
 import net.hostsharing.hsadminng.hs.office.person.HsOfficePersonEntity;
 import net.hostsharing.hsadminng.persistence.HasUuid;
-import net.hostsharing.hsadminng.hs.office.relation.HsOfficeRelationEntity;
+import net.hostsharing.hsadminng.hs.office.relationship.HsOfficeRelationshipEntity;
 import net.hostsharing.hsadminng.rbac.rbacdef.RbacView;
 import net.hostsharing.hsadminng.rbac.rbacdef.RbacView.SQL;
 import net.hostsharing.hsadminng.stringify.Stringify;
@@ -51,12 +51,12 @@ public class HsOfficePartnerEntity implements Stringifyable, HasUuid {
 
     private static Stringify<HsOfficePartnerEntity> stringify = stringify(HsOfficePartnerEntity.class, "partner")
             .withIdProp(HsOfficePartnerEntity::toShortString)
-            .withProp(p -> ofNullable(p.getPartnerRel())
-                    .map(HsOfficeRelationEntity::getHolder)
+            .withProp(p -> ofNullable(p.getPartnerRole())
+                    .map(HsOfficeRelationshipEntity::getRelHolder)
                     .map(HsOfficePersonEntity::toShortString)
                     .orElse(null))
-            .withProp(p -> ofNullable(p.getPartnerRel())
-                    .map(HsOfficeRelationEntity::getContact)
+            .withProp(p -> ofNullable(p.getPartnerRole())
+                    .map(HsOfficeRelationshipEntity::getContact)
                     .map(HsOfficeContactEntity::toShortString)
                     .orElse(null))
             .quotedValues(false);
@@ -69,8 +69,8 @@ public class HsOfficePartnerEntity implements Stringifyable, HasUuid {
     private Integer partnerNumber;
 
     @ManyToOne(cascade = CascadeType.ALL)
-    @JoinColumn(name = "partnerReluuid", nullable = false)
-    private HsOfficeRelationEntity partnerRel;
+    @JoinColumn(name = "partnerroleuuid", nullable = false)
+    private HsOfficeRelationshipEntity partnerRole;
 
     @ManyToOne(cascade = { CascadeType.PERSIST, CascadeType.MERGE, CascadeType.DETACH }, optional = true)
     @JoinColumn(name = "detailsuuid")
@@ -94,12 +94,12 @@ public class HsOfficePartnerEntity implements Stringifyable, HasUuid {
     public static RbacView rbac() {
         return rbacViewFor("partner", HsOfficePartnerEntity.class)
                 .withIdentityView(SQL.projection("'P-' || partnerNumber"))
-                .withUpdatableColumns("partnerRelUuid")
-                .toRole("global", ADMIN).grantPermission(INSERT) // FIXME: global -> partnerRel.anchor?
+                .withUpdatableColumns("partnerRoleUuid")
+                .toRole("global", ADMIN).grantPermission(INSERT) // FIXME: global -> partnerRel.relAnchor?
 
-                .importRootEntityAliasProxy("partnerRel", HsOfficeRelationEntity.class,
-                        fetchedBySql("SELECT * FROM hs_office_relation AS r WHERE r.uuid = ${ref}.partnerRelUuid"),
-                        dependsOnColumn("partnerRelUuid"))
+                .importRootEntityAliasProxy("partnerRel", HsOfficeRelationshipEntity.class,
+                        fetchedBySql("SELECT * FROM hs_office_relationship AS r WHERE r.uuid = ${ref}.partnerRoleUuid"),
+                        dependsOnColumn("partnerRoleUuid"))
                 .createPermission(DELETE).grantedTo("partnerRel", ADMIN)
                 .createPermission(UPDATE).grantedTo("partnerRel", AGENT)
                 .createPermission(SELECT).grantedTo("partnerRel", TENANT)

src/main/java/net/hostsharing/hsadminng/hs/office/partner/HsOfficePartnerEntityPatcher.java

@@ -1,7 +1,7 @@
 package net.hostsharing.hsadminng.hs.office.partner;
 
 import net.hostsharing.hsadminng.hs.office.generated.api.v1.model.HsOfficePartnerPatchResource;
-import net.hostsharing.hsadminng.hs.office.relation.HsOfficeRelationEntity;
+import net.hostsharing.hsadminng.hs.office.relationship.HsOfficeRelationshipEntity;
 import net.hostsharing.hsadminng.mapper.EntityPatcher;
 import net.hostsharing.hsadminng.mapper.OptionalFromJson;
 
@@ -19,9 +19,9 @@ class HsOfficePartnerEntityPatcher implements EntityPatcher<HsOfficePartnerPatch
 
     @Override
     public void apply(final HsOfficePartnerPatchResource resource) {
-        OptionalFromJson.of(resource.getPartnerRelUuid()).ifPresent(newValue -> {
-            verifyNotNull(newValue, "partnerRel");
-            entity.setPartnerRel(em.getReference(HsOfficeRelationEntity.class, newValue));
+        OptionalFromJson.of(resource.getPartnerRoleUuid()).ifPresent(newValue -> {
+            verifyNotNull(newValue, "partnerRole");
+            entity.setPartnerRole(em.getReference(HsOfficeRelationshipEntity.class, newValue));
         });
 
         new HsOfficePartnerDetailsEntityPatcher(em, entity.getDetails()).apply(resource.getDetails());

src/main/java/net/hostsharing/hsadminng/hs/office/partner/HsOfficePartnerRepository.java

@@ -15,9 +15,9 @@ public interface HsOfficePartnerRepository extends Repository<HsOfficePartnerEnt
 
     @Query("""
             SELECT partner FROM HsOfficePartnerEntity partner
-                JOIN HsOfficeRelationEntity rel ON rel.uuid = partner.partnerRel.uuid
+                JOIN HsOfficeRelationshipEntity rel ON rel.uuid = partner.partnerRole.uuid
                 JOIN HsOfficeContactEntity contact ON contact.uuid = rel.contact.uuid
-                JOIN HsOfficePersonEntity person ON person.uuid = rel.holder.uuid
+                JOIN HsOfficePersonEntity person ON person.uuid = rel.relHolder.uuid
                 WHERE :name is null
                     OR partner.details.birthName like concat(cast(:name as text), '%')
                     OR contact.label like concat(cast(:name as text), '%')

src/main/java/net/hostsharing/hsadminng/hs/office/relation/HsOfficeRelationRepository.java

@@ -1,37 +0,0 @@
-package net.hostsharing.hsadminng.hs.office.relation;
-
-import org.springframework.data.jpa.repository.Query;
-import org.springframework.data.repository.Repository;
-
-import jakarta.validation.constraints.NotNull;
-import java.util.List;
-import java.util.Optional;
-import java.util.UUID;
-
-public interface HsOfficeRelationRepository extends Repository<HsOfficeRelationEntity, UUID> {
-
-    Optional<HsOfficeRelationEntity> findByUuid(UUID id);
-
-    default List<HsOfficeRelationEntity> findRelationRelatedToPersonUuidAndRelationType(@NotNull UUID personUuid, HsOfficeRelationType relationType) {
-        return findRelationRelatedToPersonUuidAndRelationTypeString(personUuid, relationType.toString());
-    }
-
-    @Query(value = """
-            SELECT p.* FROM hs_office_relation_rv AS p
-                WHERE p.anchorUuid = :personUuid OR p.holderUuid = :personUuid
-               """, nativeQuery = true)
-    List<HsOfficeRelationEntity> findRelationRelatedToPersonUuid(@NotNull UUID personUuid);
-
-    @Query(value = """
-            SELECT p.* FROM hs_office_relation_rv AS p
-                WHERE (:relationType IS NULL OR p.type = cast(:relationType AS HsOfficeRelationType))
-                    AND ( p.anchorUuid = :personUuid OR p.holderUuid = :personUuid)
-               """, nativeQuery = true)
-    List<HsOfficeRelationEntity> findRelationRelatedToPersonUuidAndRelationTypeString(@NotNull UUID personUuid, String relationType);
-
-    HsOfficeRelationEntity save(final HsOfficeRelationEntity entity);
-
-    long count();
-
-    int deleteByUuid(UUID uuid);
-}

src/main/java/net/hostsharing/hsadminng/hs/office/relationship/HsOfficeRelationshipController.java

@@ -1,8 +1,8 @@
-package net.hostsharing.hsadminng.hs.office.relation;
+package net.hostsharing.hsadminng.hs.office.relationship;
 
 import net.hostsharing.hsadminng.context.Context;
 import net.hostsharing.hsadminng.hs.office.contact.HsOfficeContactRepository;
-import net.hostsharing.hsadminng.hs.office.generated.api.v1.api.HsOfficeRelationsApi;
+import net.hostsharing.hsadminng.hs.office.generated.api.v1.api.HsOfficeRelationshipsApi;
 import net.hostsharing.hsadminng.hs.office.generated.api.v1.model.*;
 import net.hostsharing.hsadminng.hs.office.person.HsOfficePersonRepository;
 import net.hostsharing.hsadminng.mapper.Mapper;
@@ -22,7 +22,7 @@ import java.util.function.BiConsumer;
 
 @RestController
 
-public class HsOfficeRelationController implements HsOfficeRelationsApi {
+public class HsOfficeRelationshipController implements HsOfficeRelationshipsApi {
 
     @Autowired
     private Context context;
@@ -31,10 +31,10 @@ public class HsOfficeRelationController implements HsOfficeRelationsApi {
     private Mapper mapper;
 
     @Autowired
-    private HsOfficeRelationRepository relationRepo;
+    private HsOfficeRelationshipRepository relationshipRepo;
 
     @Autowired
-    private HsOfficePersonRepository holderRepo;
+    private HsOfficePersonRepository relHolderRepo;
 
     @Autowired
     private HsOfficeContactRepository contactRepo;
@@ -44,79 +44,79 @@ public class HsOfficeRelationController implements HsOfficeRelationsApi {
 
     @Override
     @Transactional(readOnly = true)
-    public ResponseEntity<List<HsOfficeRelationResource>> listRelations(
+    public ResponseEntity<List<HsOfficeRelationshipResource>> listRelationships(
             final String currentUser,
             final String assumedRoles,
             final UUID personUuid,
-            final HsOfficeRelationTypeResource relationType) {
+            final HsOfficeRelationshipTypeResource relationshipType) {
         context.define(currentUser, assumedRoles);
 
-        final var entities = relationRepo.findRelationRelatedToPersonUuidAndRelationType(personUuid,
-                mapper.map(relationType, HsOfficeRelationType.class));
+        final var entities = relationshipRepo.findRelationshipRelatedToPersonUuidAndRelationshipType(personUuid,
+                mapper.map(relationshipType, HsOfficeRelationshipType.class));
 
-        final var resources = mapper.mapList(entities, HsOfficeRelationResource.class,
-                RELATION_ENTITY_TO_RESOURCE_POSTMAPPER);
+        final var resources = mapper.mapList(entities, HsOfficeRelationshipResource.class,
+                RELATIONSHIP_ENTITY_TO_RESOURCE_POSTMAPPER);
         return ResponseEntity.ok(resources);
     }
 
     @Override
     @Transactional
-    public ResponseEntity<HsOfficeRelationResource> addRelation(
+    public ResponseEntity<HsOfficeRelationshipResource> addRelationship(
             final String currentUser,
             final String assumedRoles,
-            final HsOfficeRelationInsertResource body) {
+            final HsOfficeRelationshipInsertResource body) {
 
         context.define(currentUser, assumedRoles);
 
-        final var entityToSave = new HsOfficeRelationEntity();
-        entityToSave.setType(HsOfficeRelationType.valueOf(body.getType()));
-        entityToSave.setAnchor(holderRepo.findByUuid(body.getAnchorUuid()).orElseThrow(
-                () -> new NoSuchElementException("cannot find anchorUuid " + body.getAnchorUuid())
+        final var entityToSave = new HsOfficeRelationshipEntity();
+        entityToSave.setRelType(HsOfficeRelationshipType.valueOf(body.getRelType()));
+        entityToSave.setRelAnchor(relHolderRepo.findByUuid(body.getRelAnchorUuid()).orElseThrow(
+                () -> new NoSuchElementException("cannot find relAnchorUuid " + body.getRelAnchorUuid())
         ));
-        entityToSave.setHolder(holderRepo.findByUuid(body.getHolderUuid()).orElseThrow(
-                () -> new NoSuchElementException("cannot find holderUuid " + body.getHolderUuid())
+        entityToSave.setRelHolder(relHolderRepo.findByUuid(body.getRelHolderUuid()).orElseThrow(
+                () -> new NoSuchElementException("cannot find relHolderUuid " + body.getRelHolderUuid())
         ));
         entityToSave.setContact(contactRepo.findByUuid(body.getContactUuid()).orElseThrow(
                 () -> new NoSuchElementException("cannot find contactUuid " + body.getContactUuid())
         ));
 
-        final var saved = relationRepo.save(entityToSave);
+        final var saved = relationshipRepo.save(entityToSave);
 
         final var uri =
                 MvcUriComponentsBuilder.fromController(getClass())
-                        .path("/api/hs/office/relations/{id}")
+                        .path("/api/hs/office/relationships/{id}")
                         .buildAndExpand(saved.getUuid())
                         .toUri();
-        final var mapped = mapper.map(saved, HsOfficeRelationResource.class,
-                RELATION_ENTITY_TO_RESOURCE_POSTMAPPER);
+        final var mapped = mapper.map(saved, HsOfficeRelationshipResource.class,
+                RELATIONSHIP_ENTITY_TO_RESOURCE_POSTMAPPER);
         return ResponseEntity.created(uri).body(mapped);
     }
 
     @Override
     @Transactional(readOnly = true)
-    public ResponseEntity<HsOfficeRelationResource> getRelationByUuid(
+    public ResponseEntity<HsOfficeRelationshipResource> getRelationshipByUuid(
             final String currentUser,
             final String assumedRoles,
-            final UUID relationUuid) {
+            final UUID relationshipUuid) {
 
         context.define(currentUser, assumedRoles);
 
-        final var result = relationRepo.findByUuid(relationUuid);
+        final var result = relationshipRepo.findByUuid(relationshipUuid);
         if (result.isEmpty()) {
             return ResponseEntity.notFound().build();
         }
-        return ResponseEntity.ok(mapper.map(result.get(), HsOfficeRelationResource.class, RELATION_ENTITY_TO_RESOURCE_POSTMAPPER));
+        return ResponseEntity.ok(mapper.map(result.get(), HsOfficeRelationshipResource.class, RELATIONSHIP_ENTITY_TO_RESOURCE_POSTMAPPER));
     }
 
     @Override
     @Transactional
-    public ResponseEntity<Void> deleteRelationByUuid(
+    public ResponseEntity<Void> deleteRelationshipByUuid(
             final String currentUser,
             final String assumedRoles,
-            final UUID relationUuid) {
+            final UUID relationshipUuid) {
         context.define(currentUser, assumedRoles);
 
-        final var result = relationRepo.deleteByUuid(relationUuid);
+        final var result = relationshipRepo.deleteByUuid(relationshipUuid);
         if (result == 0) {
             return ResponseEntity.notFound().build();
         }
@@ -126,27 +126,27 @@ public class HsOfficeRelationController implements HsOfficeRelationsApi {
 
     @Override
     @Transactional
-    public ResponseEntity<HsOfficeRelationResource> patchRelation(
+    public ResponseEntity<HsOfficeRelationshipResource> patchRelationship(
             final String currentUser,
             final String assumedRoles,
-            final UUID relationUuid,
-            final HsOfficeRelationPatchResource body) {
+            final UUID relationshipUuid,
+            final HsOfficeRelationshipPatchResource body) {
 
         context.define(currentUser, assumedRoles);
 
-        final var current = relationRepo.findByUuid(relationUuid).orElseThrow();
+        final var current = relationshipRepo.findByUuid(relationshipUuid).orElseThrow();
 
-        new HsOfficeRelationEntityPatcher(em, current).apply(body);
+        new HsOfficeRelationshipEntityPatcher(em, current).apply(body);
 
-        final var saved = relationRepo.save(current);
-        final var mapped = mapper.map(saved, HsOfficeRelationResource.class);
+        final var saved = relationshipRepo.save(current);
+        final var mapped = mapper.map(saved, HsOfficeRelationshipResource.class);
         return ResponseEntity.ok(mapped);
     }
 
 
-    final BiConsumer<HsOfficeRelationEntity, HsOfficeRelationResource> RELATION_ENTITY_TO_RESOURCE_POSTMAPPER = (entity, resource) -> {
-        resource.setAnchor(mapper.map(entity.getAnchor(), HsOfficePersonResource.class));
-        resource.setHolder(mapper.map(entity.getHolder(), HsOfficePersonResource.class));
+    final BiConsumer<HsOfficeRelationshipEntity, HsOfficeRelationshipResource> RELATIONSHIP_ENTITY_TO_RESOURCE_POSTMAPPER = (entity, resource) -> {
+        resource.setRelAnchor(mapper.map(entity.getRelAnchor(), HsOfficePersonResource.class));
+        resource.setRelHolder(mapper.map(entity.getRelHolder(), HsOfficePersonResource.class));
         resource.setContact(mapper.map(entity.getContact(), HsOfficeContactResource.class));
     };
 }

src/main/java/net/hostsharing/hsadminng/hs/office/relationship/HsOfficeRelationshipEntity.java

@@ -1,4 +1,4 @@
-package net.hostsharing.hsadminng.hs.office.relation;
+package net.hostsharing.hsadminng.hs.office.relationship;
 
 import lombok.*;
 import lombok.experimental.FieldNameConstants;
@@ -24,49 +24,49 @@ import static net.hostsharing.hsadminng.rbac.rbacdef.RbacView.rbacViewFor;
 import static net.hostsharing.hsadminng.stringify.Stringify.stringify;
 
 @Entity
-@Table(name = "hs_office_relation_rv")
+@Table(name = "hs_office_relationship_rv")
 @Getter
 @Setter
 @Builder
 @NoArgsConstructor
 @AllArgsConstructor
 @FieldNameConstants
-public class HsOfficeRelationEntity implements HasUuid, Stringifyable {
+public class HsOfficeRelationshipEntity implements HasUuid, Stringifyable {
 
-    private static Stringify<HsOfficeRelationEntity> toString = stringify(HsOfficeRelationEntity.class, "rel")
-            .withProp(Fields.anchor, HsOfficeRelationEntity::getAnchor)
-            .withProp(Fields.type, HsOfficeRelationEntity::getType)
-            .withProp(Fields.mark, HsOfficeRelationEntity::getMark)
-            .withProp(Fields.holder, HsOfficeRelationEntity::getHolder)
-            .withProp(Fields.contact, HsOfficeRelationEntity::getContact);
+    private static Stringify<HsOfficeRelationshipEntity> toString = stringify(HsOfficeRelationshipEntity.class, "rel")
+            .withProp(Fields.relAnchor, HsOfficeRelationshipEntity::getRelAnchor)
+            .withProp(Fields.relType, HsOfficeRelationshipEntity::getRelType)
+            .withProp(Fields.relMark, HsOfficeRelationshipEntity::getRelMark)
+            .withProp(Fields.relHolder, HsOfficeRelationshipEntity::getRelHolder)
+            .withProp(Fields.contact, HsOfficeRelationshipEntity::getContact);
 
-    private static Stringify<HsOfficeRelationEntity> toShortString = stringify(HsOfficeRelationEntity.class, "rel")
-            .withProp(Fields.anchor, HsOfficeRelationEntity::getAnchor)
-            .withProp(Fields.type, HsOfficeRelationEntity::getType)
-            .withProp(Fields.holder, HsOfficeRelationEntity::getHolder);
+    private static Stringify<HsOfficeRelationshipEntity> toShortString = stringify(HsOfficeRelationshipEntity.class, "rel")
+            .withProp(Fields.relAnchor, HsOfficeRelationshipEntity::getRelAnchor)
+            .withProp(Fields.relType, HsOfficeRelationshipEntity::getRelType)
+            .withProp(Fields.relHolder, HsOfficeRelationshipEntity::getRelHolder);
 
     @Id
     @GeneratedValue
     private UUID uuid;
 
     @ManyToOne
-    @JoinColumn(name = "anchoruuid")
-    private HsOfficePersonEntity anchor;
+    @JoinColumn(name = "relanchoruuid")
+    private HsOfficePersonEntity relAnchor;
 
     @ManyToOne
-    @JoinColumn(name = "holderuuid")
-    private HsOfficePersonEntity holder;
+    @JoinColumn(name = "relholderuuid")
+    private HsOfficePersonEntity relHolder;
 
     @ManyToOne
     @JoinColumn(name = "contactuuid")
     private HsOfficeContactEntity contact;
 
-    @Column(name = "type")
+    @Column(name = "reltype")
     @Enumerated(EnumType.STRING)
-    private HsOfficeRelationType type;
+    private HsOfficeRelationshipType relType;
 
-    @Column(name = "mark")
-    private String mark;
+    @Column(name = "relmark")
+    private String relMark;
 
     @Override
     public String toString() {
@@ -79,22 +79,22 @@ public class HsOfficeRelationEntity implements HasUuid, Stringifyable {
     }
 
     public static RbacView rbac() {
-        return rbacViewFor("relation", HsOfficeRelationEntity.class)
+        return rbacViewFor("relationship", HsOfficeRelationshipEntity.class)
                 .withIdentityView(SQL.projection("""
-                             (select idName from hs_office_person_iv p where p.uuid = anchorUuid)
-                             || '-with-' || target.type || '-'
-                             || (select idName from hs_office_person_iv p where p.uuid = holderUuid)
+                             (select idName from hs_office_person_iv p where p.uuid = relAnchorUuid)
+                             || '-with-' || target.relType || '-'
+                             || (select idName from hs_office_person_iv p where p.uuid = relHolderUuid)
                         """))
                 .withRestrictedViewOrderBy(SQL.expression(
-                        "(select idName from hs_office_person_iv p where p.uuid = target.holderUuid)"))
+                        "(select idName from hs_office_person_iv p where p.uuid = target.relHolderUuid)"))
                 .withUpdatableColumns("contactUuid")
                 .importEntityAlias("anchorPerson", HsOfficePersonEntity.class,
-                        dependsOnColumn("anchorUuid"),
-                        fetchedBySql("select * from hs_office_person as p where p.uuid = ${REF}.anchorUuid")
+                        dependsOnColumn("relAnchorUuid"),
+                        fetchedBySql("select * from hs_office_person as p where p.uuid = ${REF}.relAnchorUuid")
                 )
                 .importEntityAlias("holderPerson", HsOfficePersonEntity.class,
-                        dependsOnColumn("holderUuid"),
-                        fetchedBySql("select * from hs_office_person as p where p.uuid = ${REF}.holderUuid")
+                        dependsOnColumn("relHolderUuid"),
+                        fetchedBySql("select * from hs_office_person as p where p.uuid = ${REF}.relHolderUuid")
                 )
                 .importEntityAlias("contact", HsOfficeContactEntity.class,
                         dependsOnColumn("contactUuid"),
@@ -129,6 +129,6 @@ public class HsOfficeRelationEntity implements HasUuid, Stringifyable {
     }
 
     public static void main(String[] args) throws IOException {
-        rbac().generateWithBaseFileName("223-hs-office-relation-rbac");
+        rbac().generateWithBaseFileName("223-hs-office-relationship-rbac");
     }
 }

src/main/java/net/hostsharing/hsadminng/hs/office/relationship/HsOfficeRelationshipEntityPatcher.java

@@ -1,25 +1,25 @@
-package net.hostsharing.hsadminng.hs.office.relation;
+package net.hostsharing.hsadminng.hs.office.relationship;
 
 import net.hostsharing.hsadminng.hs.office.contact.HsOfficeContactEntity;
-import net.hostsharing.hsadminng.hs.office.generated.api.v1.model.HsOfficeRelationPatchResource;
+import net.hostsharing.hsadminng.hs.office.generated.api.v1.model.HsOfficeRelationshipPatchResource;
 import net.hostsharing.hsadminng.mapper.EntityPatcher;
 import net.hostsharing.hsadminng.mapper.OptionalFromJson;
 
 import jakarta.persistence.EntityManager;
 import java.util.UUID;
 
-class HsOfficeRelationEntityPatcher implements EntityPatcher<HsOfficeRelationPatchResource> {
+class HsOfficeRelationshipEntityPatcher implements EntityPatcher<HsOfficeRelationshipPatchResource> {
 
     private final EntityManager em;
-    private final HsOfficeRelationEntity entity;
+    private final HsOfficeRelationshipEntity entity;
 
-    HsOfficeRelationEntityPatcher(final EntityManager em, final HsOfficeRelationEntity entity) {
+    HsOfficeRelationshipEntityPatcher(final EntityManager em, final HsOfficeRelationshipEntity entity) {
         this.em = em;
         this.entity = entity;
     }
 
     @Override
-    public void apply(final HsOfficeRelationPatchResource resource) {
+    public void apply(final HsOfficeRelationshipPatchResource resource) {
         OptionalFromJson.of(resource.getContactUuid()).ifPresent(newValue -> {
             verifyNotNull(newValue, "contact");
             entity.setContact(em.getReference(HsOfficeContactEntity.class, newValue));

src/main/java/net/hostsharing/hsadminng/hs/office/relationship/HsOfficeRelationshipRepository.java

@@ -0,0 +1,37 @@
+package net.hostsharing.hsadminng.hs.office.relationship;
+
+import org.springframework.data.jpa.repository.Query;
+import org.springframework.data.repository.Repository;
+
+import jakarta.validation.constraints.NotNull;
+import java.util.List;
+import java.util.Optional;
+import java.util.UUID;
+
+public interface HsOfficeRelationshipRepository extends Repository<HsOfficeRelationshipEntity, UUID> {
+
+    Optional<HsOfficeRelationshipEntity> findByUuid(UUID id);
+
+    default List<HsOfficeRelationshipEntity> findRelationshipRelatedToPersonUuidAndRelationshipType(@NotNull UUID personUuid, HsOfficeRelationshipType relationshipType) {
+        return findRelationshipRelatedToPersonUuidAndRelationshipTypeString(personUuid, relationshipType.toString());
+    }
+
+    @Query(value = """
+            SELECT p.* FROM hs_office_relationship_rv AS p
+                WHERE p.relAnchorUuid = :personUuid OR p.relHolderUuid = :personUuid
+               """, nativeQuery = true)
+    List<HsOfficeRelationshipEntity> findRelationshipRelatedToPersonUuid(@NotNull UUID personUuid);
+
+    @Query(value = """
+            SELECT p.* FROM hs_office_relationship_rv AS p
+                WHERE (:relationshipType IS NULL OR p.relType = cast(:relationshipType AS HsOfficeRelationshipType))
+                    AND ( p.relAnchorUuid = :personUuid OR p.relHolderUuid = :personUuid)
+               """, nativeQuery = true)
+    List<HsOfficeRelationshipEntity> findRelationshipRelatedToPersonUuidAndRelationshipTypeString(@NotNull UUID personUuid, String relationshipType);
+
+    HsOfficeRelationshipEntity save(final HsOfficeRelationshipEntity entity);
+
+    long count();
+
+    int deleteByUuid(UUID uuid);
+}

src/main/java/net/hostsharing/hsadminng/hs/office/relationship/HsOfficeRelationshipType.java

@@ -1,12 +1,12 @@
-package net.hostsharing.hsadminng.hs.office.relation;
+package net.hostsharing.hsadminng.hs.office.relationship;
 
-public enum HsOfficeRelationType {
+public enum HsOfficeRelationshipType {
     UNKNOWN,
     PARTNER,
     EX_PARTNER,
     REPRESENTATIVE,
     VIP_CONTACT,
-    DEBITOR,
+    ACCOUNTING,
     OPERATIONS,
     SUBSCRIBER
 }

src/main/java/net/hostsharing/hsadminng/hs/office/sepamandate/HsOfficeSepaMandateEntity.java

@@ -6,7 +6,7 @@ import lombok.*;
 import net.hostsharing.hsadminng.errors.DisplayName;
 import net.hostsharing.hsadminng.hs.office.bankaccount.HsOfficeBankAccountEntity;
 import net.hostsharing.hsadminng.hs.office.debitor.HsOfficeDebitorEntity;
-import net.hostsharing.hsadminng.hs.office.relation.HsOfficeRelationEntity;
+import net.hostsharing.hsadminng.hs.office.relationship.HsOfficeRelationshipEntity;
 import net.hostsharing.hsadminng.persistence.HasUuid;
 import net.hostsharing.hsadminng.rbac.rbacdef.RbacView;
 import net.hostsharing.hsadminng.stringify.Stringify;
@@ -103,11 +103,11 @@ public class HsOfficeSepaMandateEntity implements Stringifyable, HasUuid {
                 .withRestrictedViewOrderBy(expression("validity"))
                 .withUpdatableColumns("reference", "agreement", "validity")
 
-                .importEntityAlias("debitorRel", HsOfficeRelationEntity.class,
+                .importEntityAlias("debitorRel", HsOfficeRelationshipEntity.class,
                         dependsOnColumn("debitorUuid"),
                         fetchedBySql("""
                                 SELECT debitorRel.*
-                                    FROM hs_office_relation debitorRel
+                                    FROM hs_office_relationship debitorRel
                                     JOIN hs_office_debitor debitor ON debitor.debitorRelUuid = debitorRel.uuid
                                     WHERE debitor.uuid = ${REF}.debitorUuid
                                 """)

src/main/java/net/hostsharing/hsadminng/rbac/rbacdef/InsertTriggerGenerator.java

@@ -23,7 +23,7 @@ public class InsertTriggerGenerator {
 
     void generateTo(final StringWriter plPgSql) {
         generateLiquibaseChangesetHeader(plPgSql);
-        generateGrantInsertRoleToExistingObjects(plPgSql);
+        generateGrantInsertRoleToExistingCustomers(plPgSql);
         generateInsertPermissionGrantTrigger(plPgSql);
         generateInsertCheckTrigger(plPgSql);
         plPgSql.writeLn("--//");
@@ -38,7 +38,7 @@ public class InsertTriggerGenerator {
                 with("liquibaseTagPrefix", liquibaseTagPrefix));
     }
 
-    private void generateGrantInsertRoleToExistingObjects(final StringWriter plPgSql) {
+    private void generateGrantInsertRoleToExistingCustomers(final StringWriter plPgSql) {
         getOptionalInsertSuperRole().ifPresent( superRoleDef -> {
             plPgSql.writeLn("""
                 /*
@@ -100,7 +100,13 @@ public class InsertTriggerGenerator {
 
     private void generateInsertCheckTrigger(final StringWriter plPgSql) {
         getOptionalInsertGrant().ifPresentOrElse(g -> {
-            if (g.getSuperRoleDef().getEntityAlias().isGlobal()) {
+            if (!g.getSuperRoleDef().getEntityAlias().isGlobal()) {
+                if (rbacDef.isRootEntityAlias(g.getSuperRoleDef().getEntityAlias())) {
+                    generateInsertPermissionTriggerAllowByDirectRole(plPgSql, g);
+                } else {
+                    generateInsertPermissionTriggerAllowByIndirectRole(plPgSql, g);
+                }
+            } else {
                 switch (g.getSuperRoleDef().getRole()) {
                     case ADMIN -> {
                         generateInsertPermissionTriggerAllowOnlyGlobalAdmin(plPgSql);
@@ -113,23 +119,27 @@ public class InsertTriggerGenerator {
                                 "invalid global role for INSERT permission: " + g.getSuperRoleDef().getRole());
                     }
                 }
-            } else {
-                generateInsertPermissionTriggerAllowByRoleOfDirectForeignKey(plPgSql, g);
             }
         },
         () -> {
-            System.err.println("WARNING: no explicit INSERT grant for " + rbacDef.getRootEntityAlias().simpleName() + " => implicitly grant INSERT to global.admin");
-            generateInsertPermissionTriggerAllowOnlyGlobalAdmin(plPgSql);
+            plPgSql.writeLn("""
+                -- FIXME: Where is this case necessary?
+                create trigger ${rawSubTable}_insert_permission_check_tg
+                    before insert on ${rawSubTable}
+                    for each row
+                    -- As there is no explicit INSERT grant specified for this table,
+                    -- only global admins are allowed to insert any rows.
+                    when ( not isGlobalAdmin() )
+                        execute procedure ${rawSubTable}_insert_permission_missing_tf();
+                """,
+                with("rawSubTable", rbacDef.getRootEntityAlias().getRawTableName()));
         });
     }
 
-    private void generateInsertPermissionTriggerAllowByRoleOfDirectForeignKey(final StringWriter plPgSql, final RbacView.RbacGrantDefinition g) {
+    private void generateInsertPermissionTriggerAllowByDirectRole(final StringWriter plPgSql, final RbacView.RbacGrantDefinition g) {
         plPgSql.writeLn("""
                 /**
-                    Checks if the user or assumed roles are allowed to insert a row to ${rawSubTable},
-                    where the check is performed by a direct role.
-                    
-                    A direct role is a role depending on a foreign key directly available in the NEW row.
+                    Checks if the user or assumed roles are allowed to insert a row to ${rawSubTable}.
                 */
                 create or replace function ${rawSubTable}_insert_permission_missing_tf()
                     returns trigger
@@ -149,11 +159,51 @@ public class InsertTriggerGenerator {
                 with("referenceColumn", g.getSuperRoleDef().getEntityAlias().dependsOnColumName()));
     }
 
+    private void generateInsertPermissionTriggerAllowByIndirectRole(
+            final StringWriter plPgSql,
+            final RbacView.RbacGrantDefinition g) {
+        plPgSql.writeLn("""
+                /**
+                    Checks if the user or assumed roles are allowed to insert a row to ${rawSubTable}.
+                */
+                create or replace function ${rawSubTable}_insert_permission_missing_tf()
+                    returns trigger
+                    language plpgsql as $$
+                begin
+                    if ( not hasInsertPermission(
+                        ( SELECT ${varName}.uuid FROM
+                """,
+                with("rawSubTable", rbacDef.getRootEntityAlias().getRawTableName()),
+                with("varName", g.getSuperRoleDef().getEntityAlias().aliasName()));
+        plPgSql.indented(3, () ->  {
+            plPgSql.writeLn(
+                    "(" + g.getSuperRoleDef().getEntityAlias().fetchSql().sql + ") AS ${varName}",
+                    with("varName", g.getSuperRoleDef().getEntityAlias().aliasName()),
+                    with("ref", NEW.name()));
+        });
+        plPgSql.writeLn("""
+
+                        ), 'INSERT', '${rawSubTable}') ) then
+                            raise exception
+                                '[403] insert into ${rawSubTable} not allowed for current subjects % (%)',
+                                currentSubjects(), currentSubjectsUuids();
+                    end if;
+                    return NEW;
+                end; $$;
+
+                create trigger ${rawSubTable}_insert_permission_check_tg
+                    before insert on ${rawSubTable}
+                    for each row
+                        execute procedure ${rawSubTable}_insert_permission_missing_tf();
+                    
+                """,
+                with("rawSubTable", rbacDef.getRootEntityAlias().getRawTableName()));
+    }
+
     private void generateInsertPermissionTriggerAllowOnlyGlobalAdmin(final StringWriter plPgSql) {
         plPgSql.writeLn("""
             /**
-                Checks if the user or assumed roles are allowed to insert a row to ${rawSubTable},
-                where only global-admin has that permission.
+                Checks if the user or assumed roles are allowed to insert a row to ${rawSubTable}.
             */
             create or replace function ${rawSubTable}_insert_permission_missing_tf()
                 returns trigger

src/main/java/net/hostsharing/hsadminng/rbac/rbacdef/RbacRestrictedViewGenerator.java

@@ -8,11 +8,13 @@ import static net.hostsharing.hsadminng.rbac.rbacdef.StringWriter.with;
 public class RbacRestrictedViewGenerator {
     private final RbacView rbacDef;
     private final String liquibaseTagPrefix;
+    private final String simpleEntityVarName;
     private final String rawTableName;
 
     public RbacRestrictedViewGenerator(final RbacView rbacDef, final String liquibaseTagPrefix) {
         this.rbacDef = rbacDef;
         this.liquibaseTagPrefix = liquibaseTagPrefix;
+        this.simpleEntityVarName = rbacDef.getRootEntityAlias().simpleName();
         this.rawTableName = rbacDef.getRootEntityAlias().getRawTableName();
     }
 
@@ -32,7 +34,7 @@ public class RbacRestrictedViewGenerator {
 
                 """,
                 with("liquibaseTagPrefix", liquibaseTagPrefix),
-                with("orderBy", indented(rbacDef.getOrderBySqlExpression().sql, 2)),
+                with("orderBy", rbacDef.getOrderBySqlExpression().sql),
                 with("updates", indented(rbacDef.getUpdatableColumns().stream()
                         .map(c -> c + " = new." + c)
                         .collect(joining(",\n")), 2)),

src/main/java/net/hostsharing/hsadminng/rbac/rbacdef/RbacView.java

@@ -11,7 +11,7 @@ import net.hostsharing.hsadminng.hs.office.membership.HsOfficeMembershipEntity;
 import net.hostsharing.hsadminng.hs.office.partner.HsOfficePartnerDetailsEntity;
 import net.hostsharing.hsadminng.hs.office.partner.HsOfficePartnerEntity;
 import net.hostsharing.hsadminng.hs.office.person.HsOfficePersonEntity;
-import net.hostsharing.hsadminng.hs.office.relation.HsOfficeRelationEntity;
+import net.hostsharing.hsadminng.hs.office.relationship.HsOfficeRelationshipEntity;
 import net.hostsharing.hsadminng.hs.office.sepamandate.HsOfficeSepaMandateEntity;
 import net.hostsharing.hsadminng.persistence.HasUuid;
 import net.hostsharing.hsadminng.rbac.rbacobject.RbacObject;
@@ -812,7 +812,7 @@ public class RbacView {
                 HsOfficePartnerDetailsEntity.class,
                 HsOfficeBankAccountEntity.class,
                 HsOfficeDebitorEntity.class,
-                HsOfficeRelationEntity.class,
+                HsOfficeRelationshipEntity.class,
                 HsOfficeCoopAssetsTransactionEntity.class,
                 HsOfficeContactEntity.class,
                 HsOfficeSepaMandateEntity.class,
@@ -831,7 +831,7 @@ public class RbacView {
                     throw new RuntimeException(e);
                 }
             } else {
-                System.err.println("WARNING: no main method in: " + c.getName() + " => no RBAC rules generated");
+                System.err.println("no main method in: " + c.getName());
             }
         });
     }

src/main/resources/api-definition/hs-office/api-mappings.yaml

@@ -23,7 +23,7 @@ map:
             null: org.openapitools.jackson.nullable.JsonNullable
         /api/hs/office/persons/{personUUID}:
             null: org.openapitools.jackson.nullable.JsonNullable
-        /api/hs/office/relations/{relationUUID}:
+        /api/hs/office/relationships/{relationshipUUID}:
             null: org.openapitools.jackson.nullable.JsonNullable
         /api/hs/office/bankaccounts/{bankAccountUUID}:
             null: org.openapitools.jackson.nullable.JsonNullable

src/main/resources/api-definition/hs-office/hs-office-debitor-schemas.yaml

@@ -10,7 +10,7 @@ components:
                     type: string
                     format: uuid
                 debitorRel:
-                    $ref: './hs-office-relation-schemas.yaml#/components/schemas/HsOfficeRelation'
+                    $ref: './hs-office-relationship-schemas.yaml#/components/schemas/HsOfficeRelationship'
                 debitorNumber:
                     type: integer
                     format: int32
@@ -76,7 +76,7 @@ components:
             type: object
             properties:
                 debitorRel:
-                    $ref: './hs-office-relation-schemas.yaml#/components/schemas/HsOfficeRelationInsert'
+                    $ref: './hs-office-relationship-schemas.yaml#/components/schemas/HsOfficeRelationshipInsert'
                 debitorRelUuid:
                     type: string
                     format: uuid

src/main/resources/api-definition/hs-office/hs-office-partner-schemas.yaml

@@ -14,8 +14,8 @@ components:
                     format: int8
                     minimum: 10000
                     maximum: 99999
-                partnerRel:
-                    $ref: './hs-office-relation-schemas.yaml#/components/schemas/HsOfficeRelation'
+                partnerRole:
+                    $ref: './hs-office-relationship-schemas.yaml#/components/schemas/HsOfficeRelationship'
                 details:
                     $ref: '#/components/schemas/HsOfficePartnerDetails'
 
@@ -50,7 +50,7 @@ components:
         HsOfficePartnerPatch:
             type: object
             properties:
-                partnerRelUuid:
+                partnerRoleUuid:
                     type: string
                     format: uuid
                     nullable: true
@@ -90,31 +90,31 @@ components:
                     format: int8
                     minimum: 10000
                     maximum: 99999
-                partnerRel:
-                    $ref: '#/components/schemas/HsOfficePartnerRelInsert'
+                partnerRole:
+                    $ref: '#/components/schemas/HsOfficePartnerRoleInsert'
                 details:
                     $ref: '#/components/schemas/HsOfficePartnerDetailsInsert'
             required:
                 - partnerNumber
-                - partnerRel
+                - partnerRole
                 - details
 
-        HsOfficePartnerRelInsert:
+        HsOfficePartnerRoleInsert:
             type: object
             nullable: false
             properties:
-                anchorUuid:
+                relAnchorUuid:
                     type: string
                     format: uuid
-                holderUuid:
+                relHolderUuid:
                     type: string
                     format: uuid
                 contactUuid:
                     type: string
                     format: uuid
             required:
-                - anchorUuid
-                - holderUuid
+                - relAnchorUuid
+                - relHolderUuid
                 - relContactUuid
 
         HsOfficePartnerDetailsInsert:

src/main/resources/api-definition/hs-office/hs-office-relationship-schemas.yaml

@@ -3,37 +3,37 @@ components:
 
     schemas:
 
-        HsOfficeRelationType:
+        HsOfficeRelationshipType:
             type: string
             enum:
                 - UNKNOWN
                 - PARTNER
                 - EX_PARTNER
-                - DEBITOR
-                - REPRESENTATIVE
+                - REPRESENTATIVE,
                 - VIP_CONTACT
+                - ACCOUNTING,
                 - OPERATIONS
                 - SUBSCRIBER
 
-        HsOfficeRelation:
+        HsOfficeRelationship:
             type: object
             properties:
                 uuid:
                     type: string
                     format: uuid
-                anchor:
+                relAnchor:
                     $ref: './hs-office-person-schemas.yaml#/components/schemas/HsOfficePerson'
-                holder:
+                relHolder:
                     $ref: './hs-office-person-schemas.yaml#/components/schemas/HsOfficePerson'
-                type:
+                relType:
                     type: string
-                mark:
+                relMark:
                     type: string
                     nullable: true
                 contact:
                     $ref: './hs-office-contact-schemas.yaml#/components/schemas/HsOfficeContact'
 
-        HsOfficeRelationPatch:
+        HsOfficeRelationshipPatch:
             type: object
             properties:
                 contactUuid:
@@ -41,25 +41,25 @@ components:
                     format: uuid
                     nullable: true
 
-        HsOfficeRelationInsert:
+        HsOfficeRelationshipInsert:
             type: object
             properties:
-                anchorUuid:
+                relAnchorUuid:
                     type: string
                     format: uuid
-                holderUuid:
+                relHolderUuid:
                     type: string
                     format: uuid
-                type:
+                relType:
                     type: string
                     nullable: true
-                mark:
+                relMark:
                     type: string
                 contactUuid:
                     type: string
                     format: uuid
             required:
-              - anchorUuid
-              - holderUuid
-              - type
+              - relAnchorUuid
+              - relHolderUuid
+              - relType
               - relContactUuid

src/main/resources/api-definition/hs-office/hs-office-relationships-with-uuid.yaml

@@ -1,25 +1,25 @@
 get:
     tags:
-        - hs-office-relations
-    description: 'Fetch a single person relation by its uuid, if visible for the current subject.'
-    operationId: getRelationByUuid
+        - hs-office-relationships
+    description: 'Fetch a single person relationship by its uuid, if visible for the current subject.'
+    operationId: getRelationshipByUuid
     parameters:
         - $ref: './auth.yaml#/components/parameters/currentUser'
         - $ref: './auth.yaml#/components/parameters/assumedRoles'
-        - name: relationUUID
+        - name: relationshipUUID
           in: path
           required: true
           schema:
               type: string
               format: uuid
-          description: UUID of the relation to fetch.
+          description: UUID of the relationship to fetch.
     responses:
         "200":
             description: OK
             content:
                 'application/json':
                     schema:
-                        $ref: './hs-office-relations-schemas.yaml#/components/schemas/HsOfficeRelation'
+                        $ref: './hs-office-relationship-schemas.yaml#/components/schemas/HsOfficeRelationship'
 
         "401":
             $ref: './error-responses.yaml#/components/responses/Unauthorized'
@@ -28,13 +28,13 @@ get:
 
 patch:
     tags:
-        - hs-office-relations
-    description: 'Updates a single person relation by its uuid, if permitted for the current subject.'
-    operationId: patchRelation
+        - hs-office-relationships
+    description: 'Updates a single person relationship by its uuid, if permitted for the current subject.'
+    operationId: patchRelationship
     parameters:
         -   $ref: './auth.yaml#/components/parameters/currentUser'
         -   $ref: './auth.yaml#/components/parameters/assumedRoles'
-        -   name: relationUUID
+        -   name: relationshipUUID
             in: path
             required: true
             schema:
@@ -44,14 +44,14 @@ patch:
         content:
             'application/json':
                 schema:
-                    $ref: './hs-office-relations-schemas.yaml#/components/schemas/HsOfficeRelationPatch'
+                    $ref: './hs-office-relationship-schemas.yaml#/components/schemas/HsOfficeRelationshipPatch'
     responses:
         "200":
             description: OK
             content:
                 'application/json':
                     schema:
-                        $ref: './hs-office-relations-schemas.yaml#/components/schemas/HsOfficeRelation'
+                        $ref: './hs-office-relationship-schemas.yaml#/components/schemas/HsOfficeRelationship'
         "401":
             $ref: './error-responses.yaml#/components/responses/Unauthorized'
         "403":
@@ -59,19 +59,19 @@ patch:
 
 delete:
     tags:
-        - hs-office-relations
-    description: 'Delete a single person relation by its uuid, if permitted for the current subject.'
-    operationId: deleteRelationByUuid
+        - hs-office-relationships
+    description: 'Delete a single person relationship by its uuid, if permitted for the current subject.'
+    operationId: deleteRelationshipByUuid
     parameters:
         - $ref: './auth.yaml#/components/parameters/currentUser'
         - $ref: './auth.yaml#/components/parameters/assumedRoles'
-        - name: relationUUID
+        - name: relationshipUUID
           in: path
           required: true
           schema:
               type: string
               format: uuid
-          description: UUID of the relation to delete.
+          description: UUID of the relationship to delete.
     responses:
         "204":
             description: No Content

src/main/resources/api-definition/hs-office/hs-office-relationships.yaml

@@ -1,9 +1,9 @@
 get:
-    summary: Returns a list of (optionally filtered) person relations for a given person.
-    description: Returns the list of (optionally filtered) person relations of a given person and which are visible to the current user or any of it's assumed roles.
+    summary: Returns a list of (optionally filtered) person relationships for a given person.
+    description: Returns the list of (optionally filtered) person relationships of a given person and which are visible to the current user or any of it's assumed roles.
     tags:
-        - hs-office-relations
-    operationId: listRelations
+        - hs-office-relationships
+    operationId: listRelationships
     parameters:
         - $ref: './auth.yaml#/components/parameters/currentUser'
         - $ref: './auth.yaml#/components/parameters/assumedRoles'
@@ -13,13 +13,13 @@ get:
           schema:
               type: string
               format: uuid
-          description: Prefix of name properties from holder or contact to filter the results.
-        - name: relationType
+          description: Prefix of name properties from relHolder or contact to filter the results.
+        - name: relationshipType
           in: query
           required: false
           schema:
-              $ref: './hs-office-relations-schemas.yaml#/components/schemas/HsOfficeRelationType'
-          description: Prefix of name properties from holder or contact to filter the results.
+              $ref: './hs-office-relationship-schemas.yaml#/components/schemas/HsOfficeRelationshipType'
+          description: Prefix of name properties from relHolder or contact to filter the results.
     responses:
         "200":
             description: OK
@@ -28,17 +28,17 @@ get:
                     schema:
                         type: array
                         items:
-                            $ref: './hs-office-relations-schemas.yaml#/components/schemas/HsOfficeRelation'
+                            $ref: './hs-office-relationship-schemas.yaml#/components/schemas/HsOfficeRelationship'
         "401":
             $ref: './error-responses.yaml#/components/responses/Unauthorized'
         "403":
             $ref: './error-responses.yaml#/components/responses/Forbidden'
 
 post:
-    summary: Adds a new person relation.
+    summary: Adds a new person relationship.
     tags:
-        - hs-office-relations
-    operationId: addRelation
+        - hs-office-relationships
+    operationId: addRelationship
     parameters:
         - $ref: './auth.yaml#/components/parameters/currentUser'
         - $ref: './auth.yaml#/components/parameters/assumedRoles'
@@ -46,7 +46,7 @@ post:
         content:
             'application/json':
                 schema:
-                    $ref: './hs-office-relations-schemas.yaml#/components/schemas/HsOfficeRelationInsert'
+                    $ref: './hs-office-relationship-schemas.yaml#/components/schemas/HsOfficeRelationshipInsert'
         required: true
     responses:
         "201":
@@ -54,7 +54,7 @@ post:
             content:
                 'application/json':
                     schema:
-                        $ref: './hs-office-relations-schemas.yaml#/components/schemas/HsOfficeRelation'
+                        $ref: './hs-office-relationship-schemas.yaml#/components/schemas/HsOfficeRelationship'
         "401":
             $ref: './error-responses.yaml#/components/responses/Unauthorized'
         "403":

src/main/resources/api-definition/hs-office/hs-office.yaml

@@ -35,13 +35,13 @@ paths:
     $ref: "./hs-office-persons-with-uuid.yaml"
 
 
-  # Relations
+  # Relationships
 
-  /api/hs/office/relations:
-    $ref: "./hs-office-relations.yaml"
+  /api/hs/office/relationships:
+    $ref: "./hs-office-relationships.yaml"
 
-  /api/hs/office/relations/{relationUUID}:
-    $ref: "./hs-office-relations-with-uuid.yaml"
+  /api/hs/office/relationships/{relationshipUUID}:
+    $ref: "./hs-office-relationships-with-uuid.yaml"
 
 
   # BankAccounts

src/main/resources/db/changelog/113-test-customer-rbac.md

@@ -1,6 +1,6 @@
 ### rbac customer
 
-This code generated was by RbacViewMermaidFlowchartGenerator at  2024-03-22T14:44:19.425403022.
+This code generated was by RbacViewMermaidFlowchartGenerator at  2024-03-11T11:29:11.571772062.
 
 ```mermaid
 %%{init:{'flowchart':{'htmlLabels':false}}}%%

src/main/resources/db/changelog/113-test-customer-rbac.sql

@@ -1,6 +1,5 @@
 --liquibase formatted sql
--- This code generated was by RbacViewPostgresGenerator at 2024-03-22T14:44:19.441879428.
-
+-- This code generated was by RbacViewPostgresGenerator at 2024-03-11T11:29:11.584886824.
 
 -- ============================================================================
 --changeset test-customer-rbac-OBJECT:1 endDelimiter:--//
@@ -37,8 +36,8 @@ begin
     perform createRoleWithGrants(
         testCustomerOwner(NEW),
             permissions => array['DELETE'],
-            incomingSuperRoles => array[globalAdmin(unassumed())],
-            userUuids => array[currentUserUuid()]
+            userUuids => array[currentUserUuid()],
+            incomingSuperRoles => array[globalAdmin(unassumed())]
     );
 
     perform createRoleWithGrants(
@@ -73,16 +72,15 @@ create trigger insertTriggerForTestCustomer_tg
     after insert on test_customer
     for each row
 execute procedure insertTriggerForTestCustomer_tf();
---//
 
+--//
 
 -- ============================================================================
 --changeset test-customer-rbac-INSERT:1 endDelimiter:--//
 -- ----------------------------------------------------------------------------
 
 /**
-    Checks if the user or assumed roles are allowed to insert a row to test_customer,
-    where only global-admin has that permission.
+    Checks if the user or assumed roles are allowed to insert a row to test_customer.
 */
 create or replace function test_customer_insert_permission_missing_tf()
     returns trigger
@@ -95,10 +93,12 @@ end; $$;
 create trigger test_customer_insert_permission_check_tg
     before insert on test_customer
     for each row
+    -- As there is no explicit INSERT grant specified for this table,
+    -- only global admins are allowed to insert any rows.
     when ( not isGlobalAdmin() )
         execute procedure test_customer_insert_permission_missing_tf();
---//
 
+--//
 -- ============================================================================
 --changeset test-customer-rbac-IDENTITY-VIEW:1 endDelimiter:--//
 -- ----------------------------------------------------------------------------
@@ -106,15 +106,13 @@ create trigger test_customer_insert_permission_check_tg
 call generateRbacIdentityViewFromProjection('test_customer', $idName$
     prefix
     $idName$);
---//
 
+--//
 -- ============================================================================
 --changeset test-customer-rbac-RESTRICTED-VIEW:1 endDelimiter:--//
 -- ----------------------------------------------------------------------------
 call generateRbacRestrictedView('test_customer',
-    $orderBy$
-        reference
-    $orderBy$,
+    'reference',
     $updates$
         reference = new.reference,
         prefix = new.prefix,
@@ -122,3 +120,4 @@ call generateRbacRestrictedView('test_customer',
     $updates$);
 --//
 
+

src/main/resources/db/changelog/123-test-package-rbac.md

@@ -1,6 +1,6 @@
 ### rbac package
 
-This code generated was by RbacViewMermaidFlowchartGenerator at  2024-03-22T14:44:19.484173294.
+This code generated was by RbacViewMermaidFlowchartGenerator at  2024-03-11T11:29:11.624847792.
 
 ```mermaid
 %%{init:{'flowchart':{'htmlLabels':false}}}%%

src/main/resources/db/changelog/123-test-package-rbac.sql

@@ -1,6 +1,5 @@
 --liquibase formatted sql
--- This code generated was by RbacViewPostgresGenerator at 2024-03-22T12:01:44.554331877.
-
+-- This code generated was by RbacViewPostgresGenerator at 2024-03-11T11:29:11.625353859.
 
 -- ============================================================================
 --changeset test-package-rbac-OBJECT:1 endDelimiter:--//
@@ -34,12 +33,9 @@ declare
 
 begin
     call enterTriggerForObjectUuid(NEW.uuid);
-
     SELECT * FROM test_customer c
         WHERE c.uuid= NEW.customerUuid
-        INTO newCustomer;
-    assert newCustomer.uuid is not null, format('newCustomer must not be null for NEW.customerUuid = %s', NEW.customerUuid);
-
+     into newCustomer;
 
     perform createRoleWithGrants(
         testPackageOwner(NEW),
@@ -79,8 +75,8 @@ create trigger insertTriggerForTestPackage_tg
     after insert on test_package
     for each row
 execute procedure insertTriggerForTestPackage_tf();
---//
 
+--//
 
 -- ============================================================================
 --changeset test-package-rbac-update-trigger:1 endDelimiter:--//
@@ -105,18 +101,14 @@ begin
 
     SELECT * FROM test_customer c
         WHERE c.uuid= OLD.customerUuid
-        INTO oldCustomer;
-    assert oldCustomer.uuid is not null, format('oldCustomer must not be null for OLD.customerUuid = %s', OLD.customerUuid);
-
+     into oldCustomer;
     SELECT * FROM test_customer c
         WHERE c.uuid= NEW.customerUuid
-        INTO newCustomer;
-    assert newCustomer.uuid is not null, format('newCustomer must not be null for NEW.customerUuid = %s', NEW.customerUuid);
-
+     into newCustomer;
 
     if NEW.customerUuid <> OLD.customerUuid then
 
-        call revokePermissionFromRole(getPermissionId(OLD.uuid, 'INSERT'), testCustomerAdmin(oldCustomer));
+        call revokePermissionFromRole(findPermissionId(OLD.uuid, 'INSERT'), testCustomerAdmin(oldCustomer));
 
         call revokeRoleFromRole(testPackageOwner(OLD), testCustomerAdmin(oldCustomer));
         call grantRoleToRole(testPackageOwner(NEW), testCustomerAdmin(newCustomer));
@@ -146,8 +138,8 @@ create trigger updateTriggerForTestPackage_tg
     after update on test_package
     for each row
 execute procedure updateTriggerForTestPackage_tf();
---//
 
+--//
 
 -- ============================================================================
 --changeset test-package-rbac-INSERT:1 endDelimiter:--//
@@ -187,43 +179,29 @@ begin
     return NEW;
 end; $$;
 
--- z_... is to put it at the end of after insert triggers, to make sure the roles exist
 create trigger z_test_package_test_customer_insert_tg
     after insert on test_customer
     for each row
 execute procedure test_package_test_customer_insert_tf();
 
 /**
-    Checks if the user or assumed roles are allowed to insert a row to test_package,
-    where the check is performed by an indirect role.
-
-    An indirect role is a role FIXME.
+    Checks if the user or assumed roles are allowed to insert a row to test_package.
 */
 create or replace function test_package_insert_permission_missing_tf()
     returns trigger
     language plpgsql as $$
 begin
-    if ( not hasInsertPermission(
-        ( SELECT customer.uuid FROM
-
-            (SELECT * FROM test_customer c
-                WHERE c.uuid= NEW.customerUuid
-            ) AS customer
-
-        ), 'INSERT', 'test_package') ) then
-            raise exception
-                '[403] insert into test_package not allowed for current subjects % (%)',
+    raise exception '[403] insert into test_package not allowed for current subjects % (%)',
         currentSubjects(), currentSubjectsUuids();
-    end if;
-    return NEW;
 end; $$;
 
 create trigger test_package_insert_permission_check_tg
     before insert on test_package
     for each row
+    when ( not hasInsertPermission(NEW.customerUuid, 'INSERT', 'test_package') )
         execute procedure test_package_insert_permission_missing_tf();
---//
 
+--//
 -- ============================================================================
 --changeset test-package-rbac-IDENTITY-VIEW:1 endDelimiter:--//
 -- ----------------------------------------------------------------------------
@@ -231,15 +209,13 @@ create trigger test_package_insert_permission_check_tg
 call generateRbacIdentityViewFromProjection('test_package', $idName$
     name
     $idName$);
---//
 
+--//
 -- ============================================================================
 --changeset test-package-rbac-RESTRICTED-VIEW:1 endDelimiter:--//
 -- ----------------------------------------------------------------------------
 call generateRbacRestrictedView('test_package',
-    $orderBy$
-        name
-    $orderBy$,
+    'name',
     $updates$
         version = new.version,
         customerUuid = new.customerUuid,
@@ -247,3 +223,4 @@ call generateRbacRestrictedView('test_package',
     $updates$);
 --//
 
+

src/main/resources/db/changelog/133-test-domain-rbac.md

@@ -1,6 +1,6 @@
 ### rbac domain
 
-This code generated was by RbacViewMermaidFlowchartGenerator at  2024-03-22T14:44:19.510830235.
+This code generated was by RbacViewMermaidFlowchartGenerator at  2024-03-11T11:29:11.644658132.
 
 ```mermaid
 %%{init:{'flowchart':{'htmlLabels':false}}}%%

src/main/resources/db/changelog/220-hs-office-relation.sql

@@ -1,36 +0,0 @@
---liquibase formatted sql
-
--- ============================================================================
---changeset hs-office-relation-MAIN-TABLE:1 endDelimiter:--//
--- ----------------------------------------------------------------------------
-
-CREATE TYPE HsOfficeRelationType AS ENUM (
-    'UNKNOWN',
-    'PARTNER',
-    'EX_PARTNER',
-    'REPRESENTATIVE',
-    'DEBITOR',
-    'VIP_CONTACT',
-    'OPERATIONS',
-    'SUBSCRIBER');
-
-CREATE CAST (character varying as HsOfficeRelationType) WITH INOUT AS IMPLICIT;
-
-create table if not exists hs_office_relation
-(
-    uuid             uuid unique references RbacObject (uuid) initially deferred, -- on delete cascade
-    anchorUuid       uuid not null references hs_office_person(uuid),
-    holderUuid       uuid not null references hs_office_person(uuid),
-    contactUuid      uuid references hs_office_contact(uuid),
-    type             HsOfficeRelationType not null,
-    mark             varchar(24)
-);
---//
-
-
--- ============================================================================
---changeset hs-office-relation-MAIN-TABLE-JOURNAL:1 endDelimiter:--//
--- ----------------------------------------------------------------------------
-
-call create_journal('hs_office_relation');
---//

src/main/resources/db/changelog/220-hs-office-relationship.sql

@@ -0,0 +1,36 @@
+--liquibase formatted sql
+
+-- ============================================================================
+--changeset hs-office-relationship-MAIN-TABLE:1 endDelimiter:--//
+-- ----------------------------------------------------------------------------
+
+CREATE TYPE HsOfficeRelationshipType AS ENUM (
+    'UNKNOWN',
+    'PARTNER',
+    'EX_PARTNER',
+    'REPRESENTATIVE',
+    'VIP_CONTACT',
+    'ACCOUNTING',
+    'OPERATIONS',
+    'SUBSCRIBER');
+
+CREATE CAST (character varying as HsOfficeRelationshipType) WITH INOUT AS IMPLICIT;
+
+create table if not exists hs_office_relationship
+(
+    uuid                uuid unique references RbacObject (uuid) initially deferred, -- on delete cascade
+    relAnchorUuid       uuid not null references hs_office_person(uuid),
+    relHolderUuid       uuid not null references hs_office_person(uuid),
+    contactUuid         uuid references hs_office_contact(uuid),
+    relType             HsOfficeRelationshipType not null,
+    relMark             varchar(24)
+);
+--//
+
+
+-- ============================================================================
+--changeset hs-office-relationship-MAIN-TABLE-JOURNAL:1 endDelimiter:--//
+-- ----------------------------------------------------------------------------
+
+call create_journal('hs_office_relationship');
+--//

src/main/resources/db/changelog/223-hs-office-relationship-rbac.md

@@ -1,4 +1,4 @@
-### rbac relation
+### rbac relationship
 
 This code generated was by RbacViewMermaidFlowchartGenerator at  2024-03-15T17:17:00.854621634.
 
@@ -45,31 +45,31 @@ subgraph contact["`**contact**`"]
     end
 end
 
-subgraph relation["`**relation**`"]
+subgraph relationship["`**relationship**`"]
     direction TB
-    style relation fill:#dd4901,stroke:#274d6e,stroke-width:8px
+    style relationship fill:#dd4901,stroke:#274d6e,stroke-width:8px
 
-    subgraph relation:roles[ ]
-        style relation:roles fill:#dd4901,stroke:white
+    subgraph relationship:roles[ ]
+        style relationship:roles fill:#dd4901,stroke:white
 
-        role:relation:owner[[relation:owner]]
-        role:relation:admin[[relation:admin]]
-        role:relation:agent[[relation:agent]]
-        role:relation:tenant[[relation:tenant]]
+        role:relationship:owner[[relationship:owner]]
+        role:relationship:admin[[relationship:admin]]
+        role:relationship:agent[[relationship:agent]]
+        role:relationship:tenant[[relationship:tenant]]
     end
 
-    subgraph relation:permissions[ ]
-        style relation:permissions fill:#dd4901,stroke:white
+    subgraph relationship:permissions[ ]
+        style relationship:permissions fill:#dd4901,stroke:white
 
-        perm:relation:DELETE{{relation:DELETE}}
-        perm:relation:UPDATE{{relation:UPDATE}}
-        perm:relation:SELECT{{relation:SELECT}}
-        perm:relation:INSERT{{relation:INSERT}}
+        perm:relationship:DELETE{{relationship:DELETE}}
+        perm:relationship:UPDATE{{relationship:UPDATE}}
+        perm:relationship:SELECT{{relationship:SELECT}}
+        perm:relationship:INSERT{{relationship:INSERT}}
     end
 end
 
 %% granting roles to users
-user:creator ==> role:relation:owner
+user:creator ==> role:relationship:owner
 
 %% granting roles to roles
 role:global:admin -.-> role:anchorPerson:owner
@@ -81,22 +81,22 @@ role:holderPerson:admin -.-> role:holderPerson:referrer
 role:global:admin -.-> role:contact:owner
 role:contact:owner -.-> role:contact:admin
 role:contact:admin -.-> role:contact:referrer
-role:global:admin ==> role:relation:owner
-role:relation:owner ==> role:relation:admin
-role:anchorPerson:admin ==> role:relation:admin
-role:relation:admin ==> role:relation:agent
-role:holderPerson:admin ==> role:relation:agent
-role:relation:agent ==> role:relation:tenant
-role:holderPerson:admin ==> role:relation:tenant
-role:contact:admin ==> role:relation:tenant
-role:relation:tenant ==> role:anchorPerson:referrer
-role:relation:tenant ==> role:holderPerson:referrer
-role:relation:tenant ==> role:contact:referrer
+role:global:admin ==> role:relationship:owner
+role:relationship:owner ==> role:relationship:admin
+role:anchorPerson:admin ==> role:relationship:admin
+role:relationship:admin ==> role:relationship:agent
+role:holderPerson:admin ==> role:relationship:agent
+role:relationship:agent ==> role:relationship:tenant
+role:holderPerson:admin ==> role:relationship:tenant
+role:contact:admin ==> role:relationship:tenant
+role:relationship:tenant ==> role:anchorPerson:referrer
+role:relationship:tenant ==> role:holderPerson:referrer
+role:relationship:tenant ==> role:contact:referrer
 
 %% granting permissions to roles
-role:relation:owner ==> perm:relation:DELETE
-role:relation:admin ==> perm:relation:UPDATE
-role:relation:tenant ==> perm:relation:SELECT
-role:anchorPerson:admin ==> perm:relation:INSERT
+role:relationship:owner ==> perm:relationship:DELETE
+role:relationship:admin ==> perm:relationship:UPDATE
+role:relationship:tenant ==> perm:relationship:SELECT
+role:anchorPerson:admin ==> perm:relationship:INSERT
 
 ```

src/main/resources/db/changelog/223-hs-office-relationship-rbac.sql

@@ -3,29 +3,29 @@
 
 
 -- ============================================================================
---changeset hs-office-relation-rbac-OBJECT:1 endDelimiter:--//
+--changeset hs-office-relationship-rbac-OBJECT:1 endDelimiter:--//
 -- ----------------------------------------------------------------------------
-call generateRelatedRbacObject('hs_office_relation');
+call generateRelatedRbacObject('hs_office_relationship');
 --//
 
 
 -- ============================================================================
---changeset hs-office-relation-rbac-ROLE-DESCRIPTORS:1 endDelimiter:--//
+--changeset hs-office-relationship-rbac-ROLE-DESCRIPTORS:1 endDelimiter:--//
 -- ----------------------------------------------------------------------------
-call generateRbacRoleDescriptors('hsOfficeRelation', 'hs_office_relation');
+call generateRbacRoleDescriptors('hsOfficeRelationship', 'hs_office_relationship');
 --//
 
 
 -- ============================================================================
---changeset hs-office-relation-rbac-insert-trigger:1 endDelimiter:--//
+--changeset hs-office-relationship-rbac-insert-trigger:1 endDelimiter:--//
 -- ----------------------------------------------------------------------------
 
 /*
     Creates the roles, grants and permission for the AFTER INSERT TRIGGER.
  */
 
-create or replace procedure buildRbacSystemForHsOfficeRelation(
-    NEW hs_office_relation
+create or replace procedure buildRbacSystemForHsOfficeRelationship(
+    NEW hs_office_relationship
 )
     language plpgsql as $$
 
@@ -37,43 +37,43 @@ declare
 begin
     call enterTriggerForObjectUuid(NEW.uuid);
 
-    select * from hs_office_person as p where p.uuid = NEW.holderUuid    INTO newHolderPerson;
-    assert newHolderPerson.uuid is not null, format('newHolderPerson must not be null for NEW.holderUuid = %s', NEW.holderUuid);
+    select * from hs_office_person as p where p.uuid = NEW.relHolderUuid    INTO newHolderPerson;
+    assert newHolderPerson.uuid is not null, format('newHolderPerson must not be null for NEW.relHolderUuid = %s', NEW.relHolderUuid);
 
-    select * from hs_office_person as p where p.uuid = NEW.anchorUuid    INTO newAnchorPerson;
-    assert newAnchorPerson.uuid is not null, format('newAnchorPerson must not be null for NEW.anchorUuid = %s', NEW.anchorUuid);
+    select * from hs_office_person as p where p.uuid = NEW.relAnchorUuid    INTO newAnchorPerson;
+    assert newAnchorPerson.uuid is not null, format('newAnchorPerson must not be null for NEW.relAnchorUuid = %s', NEW.relAnchorUuid);
 
     select * from hs_office_contact as c where c.uuid = NEW.contactUuid    INTO newContact;
     assert newContact.uuid is not null, format('newContact must not be null for NEW.contactUuid = %s', NEW.contactUuid);
 
 
     perform createRoleWithGrants(
-        hsOfficeRelationOwner(NEW),
+        hsOfficeRelationshipOwner(NEW),
             permissions => array['DELETE'],
             incomingSuperRoles => array[globalAdmin()],
             userUuids => array[currentUserUuid()]
     );
 
     perform createRoleWithGrants(
-        hsOfficeRelationAdmin(NEW),
+        hsOfficeRelationshipAdmin(NEW),
             permissions => array['UPDATE'],
             incomingSuperRoles => array[
-            	hsOfficeRelationOwner(NEW),
+            	hsOfficeRelationshipOwner(NEW),
             	hsOfficePersonAdmin(newAnchorPerson)]
     );
 
     perform createRoleWithGrants(
-        hsOfficeRelationAgent(NEW),
+        hsOfficeRelationshipAgent(NEW),
             incomingSuperRoles => array[
             	hsOfficePersonAdmin(newHolderPerson),
-            	hsOfficeRelationAdmin(NEW)]
+            	hsOfficeRelationshipAdmin(NEW)]
     );
 
     perform createRoleWithGrants(
-        hsOfficeRelationTenant(NEW),
+        hsOfficeRelationshipTenant(NEW),
             permissions => array['SELECT'],
             incomingSuperRoles => array[
-            	hsOfficeRelationAgent(NEW),
+            	hsOfficeRelationshipAgent(NEW),
             	hsOfficeContactAdmin(newContact),
             	hsOfficePersonAdmin(newHolderPerson)],
             outgoingSubRoles => array[
@@ -86,36 +86,36 @@ begin
 end; $$;
 
 /*
-    AFTER INSERT TRIGGER to create the role+grant structure for a new hs_office_relation row.
+    AFTER INSERT TRIGGER to create the role+grant structure for a new hs_office_relationship row.
  */
 
-create or replace function insertTriggerForHsOfficeRelation_tf()
+create or replace function insertTriggerForHsOfficeRelationship_tf()
     returns trigger
     language plpgsql
     strict as $$
 begin
-    call buildRbacSystemForHsOfficeRelation(NEW);
+    call buildRbacSystemForHsOfficeRelationship(NEW);
     return NEW;
 end; $$;
 
-create trigger insertTriggerForHsOfficeRelation_tg
-    after insert on hs_office_relation
+create trigger insertTriggerForHsOfficeRelationship_tg
+    after insert on hs_office_relationship
     for each row
-execute procedure insertTriggerForHsOfficeRelation_tf();
+execute procedure insertTriggerForHsOfficeRelationship_tf();
 --//
 
 
 -- ============================================================================
---changeset hs-office-relation-rbac-update-trigger:1 endDelimiter:--//
+--changeset hs-office-relationship-rbac-update-trigger:1 endDelimiter:--//
 -- ----------------------------------------------------------------------------
 
 /*
     Called from the AFTER UPDATE TRIGGER to re-wire the grants.
  */
 
-create or replace procedure updateRbacRulesForHsOfficeRelation(
-    OLD hs_office_relation,
-    NEW hs_office_relation
+create or replace procedure updateRbacRulesForHsOfficeRelationship(
+    OLD hs_office_relationship,
+    NEW hs_office_relationship
 )
     language plpgsql as $$
 
@@ -130,17 +130,17 @@ declare
 begin
     call enterTriggerForObjectUuid(NEW.uuid);
 
-    select * from hs_office_person as p where p.uuid = OLD.holderUuid    INTO oldHolderPerson;
-    assert oldHolderPerson.uuid is not null, format('oldHolderPerson must not be null for OLD.holderUuid = %s', OLD.holderUuid);
+    select * from hs_office_person as p where p.uuid = OLD.relHolderUuid    INTO oldHolderPerson;
+    assert oldHolderPerson.uuid is not null, format('oldHolderPerson must not be null for OLD.relHolderUuid = %s', OLD.relHolderUuid);
 
-    select * from hs_office_person as p where p.uuid = NEW.holderUuid    INTO newHolderPerson;
-    assert newHolderPerson.uuid is not null, format('newHolderPerson must not be null for NEW.holderUuid = %s', NEW.holderUuid);
+    select * from hs_office_person as p where p.uuid = NEW.relHolderUuid    INTO newHolderPerson;
+    assert newHolderPerson.uuid is not null, format('newHolderPerson must not be null for NEW.relHolderUuid = %s', NEW.relHolderUuid);
 
-    select * from hs_office_person as p where p.uuid = OLD.anchorUuid    INTO oldAnchorPerson;
-    assert oldAnchorPerson.uuid is not null, format('oldAnchorPerson must not be null for OLD.anchorUuid = %s', OLD.anchorUuid);
+    select * from hs_office_person as p where p.uuid = OLD.relAnchorUuid    INTO oldAnchorPerson;
+    assert oldAnchorPerson.uuid is not null, format('oldAnchorPerson must not be null for OLD.relAnchorUuid = %s', OLD.relAnchorUuid);
 
-    select * from hs_office_person as p where p.uuid = NEW.anchorUuid    INTO newAnchorPerson;
-    assert newAnchorPerson.uuid is not null, format('newAnchorPerson must not be null for NEW.anchorUuid = %s', NEW.anchorUuid);
+    select * from hs_office_person as p where p.uuid = NEW.relAnchorUuid    INTO newAnchorPerson;
+    assert newAnchorPerson.uuid is not null, format('newAnchorPerson must not be null for NEW.relAnchorUuid = %s', NEW.relAnchorUuid);
 
     select * from hs_office_contact as c where c.uuid = OLD.contactUuid    INTO oldContact;
     assert oldContact.uuid is not null, format('oldContact must not be null for OLD.contactUuid = %s', OLD.contactUuid);
@@ -151,11 +151,11 @@ begin
 
     if NEW.contactUuid <> OLD.contactUuid then
 
-        call revokeRoleFromRole(hsOfficeRelationTenant(OLD), hsOfficeContactAdmin(oldContact));
-        call grantRoleToRole(hsOfficeRelationTenant(NEW), hsOfficeContactAdmin(newContact));
+        call revokeRoleFromRole(hsOfficeRelationshipTenant(OLD), hsOfficeContactAdmin(oldContact));
+        call grantRoleToRole(hsOfficeRelationshipTenant(NEW), hsOfficeContactAdmin(newContact));
 
-        call revokeRoleFromRole(hsOfficeContactReferrer(oldContact), hsOfficeRelationTenant(OLD));
-        call grantRoleToRole(hsOfficeContactReferrer(newContact), hsOfficeRelationTenant(NEW));
+        call revokeRoleFromRole(hsOfficeContactReferrer(oldContact), hsOfficeRelationshipTenant(OLD));
+        call grantRoleToRole(hsOfficeContactReferrer(newContact), hsOfficeRelationshipTenant(NEW));
 
     end if;
 
@@ -163,31 +163,31 @@ begin
 end; $$;
 
 /*
-    AFTER INSERT TRIGGER to re-wire the grant structure for a new hs_office_relation row.
+    AFTER INSERT TRIGGER to re-wire the grant structure for a new hs_office_relationship row.
  */
 
-create or replace function updateTriggerForHsOfficeRelation_tf()
+create or replace function updateTriggerForHsOfficeRelationship_tf()
     returns trigger
     language plpgsql
     strict as $$
 begin
-    call updateRbacRulesForHsOfficeRelation(OLD, NEW);
+    call updateRbacRulesForHsOfficeRelationship(OLD, NEW);
     return NEW;
 end; $$;
 
-create trigger updateTriggerForHsOfficeRelation_tg
-    after update on hs_office_relation
+create trigger updateTriggerForHsOfficeRelationship_tg
+    after update on hs_office_relationship
     for each row
-execute procedure updateTriggerForHsOfficeRelation_tf();
+execute procedure updateTriggerForHsOfficeRelationship_tf();
 --//
 
 
 -- ============================================================================
---changeset hs-office-relation-rbac-INSERT:1 endDelimiter:--//
+--changeset hs-office-relationship-rbac-INSERT:1 endDelimiter:--//
 -- ----------------------------------------------------------------------------
 
 /*
-    Creates INSERT INTO hs_office_relation permissions for the related hs_office_person rows.
+    Creates INSERT INTO hs_office_relationship permissions for the related hs_office_person rows.
  */
 do language plpgsql $$
     declare
@@ -195,80 +195,80 @@ do language plpgsql $$
         permissionUuid uuid;
         roleUuid uuid;
     begin
-        call defineContext('create INSERT INTO hs_office_relation permissions for the related hs_office_person rows');
+        call defineContext('create INSERT INTO hs_office_relationship permissions for the related hs_office_person rows');
 
         FOR row IN SELECT * FROM hs_office_person
             LOOP
                 roleUuid := findRoleId(hsOfficePersonAdmin(row));
-                permissionUuid := createPermission(row.uuid, 'INSERT', 'hs_office_relation');
+                permissionUuid := createPermission(row.uuid, 'INSERT', 'hs_office_relationship');
                 call grantPermissionToRole(permissionUuid, roleUuid);
             END LOOP;
     END;
 $$;
 
 /**
-    Adds hs_office_relation INSERT permission to specified role of new hs_office_person rows.
+    Adds hs_office_relationship INSERT permission to specified role of new hs_office_person rows.
 */
-create or replace function hs_office_relation_hs_office_person_insert_tf()
+create or replace function hs_office_relationship_hs_office_person_insert_tf()
     returns trigger
     language plpgsql
     strict as $$
 begin
     call grantPermissionToRole(
-            createPermission(NEW.uuid, 'INSERT', 'hs_office_relation'),
+            createPermission(NEW.uuid, 'INSERT', 'hs_office_relationship'),
             hsOfficePersonAdmin(NEW));
     return NEW;
 end; $$;
 
-create trigger z_hs_office_relation_hs_office_person_insert_tg
+create trigger z_hs_office_relationship_hs_office_person_insert_tg
     after insert on hs_office_person
     for each row
-execute procedure hs_office_relation_hs_office_person_insert_tf();
+execute procedure hs_office_relationship_hs_office_person_insert_tf();
 
 /**
-    Checks if the user or assumed roles are allowed to insert a row to hs_office_relation.
+    Checks if the user or assumed roles are allowed to insert a row to hs_office_relationship.
 */
-create or replace function hs_office_relation_insert_permission_missing_tf()
+create or replace function hs_office_relationship_insert_permission_missing_tf()
     returns trigger
     language plpgsql as $$
 begin
     if ( not hasInsertPermission(
         ( SELECT anchorPerson.uuid FROM
 
-            (select * from hs_office_person as p where p.uuid = NEW.anchorUuid) AS anchorPerson
+            (select * from hs_office_person as p where p.uuid = NEW.relAnchorUuid) AS anchorPerson
 
-        ), 'INSERT', 'hs_office_relation') ) then
+        ), 'INSERT', 'hs_office_relationship') ) then
             raise exception
-                '[403] insert into hs_office_relation not allowed for current subjects % (%)',
+                '[403] insert into hs_office_relationship not allowed for current subjects % (%)',
                 currentSubjects(), currentSubjectsUuids();
     end if;
     return NEW;
 end; $$;
 
-create trigger hs_office_relation_insert_permission_check_tg
-    before insert on hs_office_relation
+create trigger hs_office_relationship_insert_permission_check_tg
+    before insert on hs_office_relationship
     for each row
-        execute procedure hs_office_relation_insert_permission_missing_tf();
+        execute procedure hs_office_relationship_insert_permission_missing_tf();
 --//
 
 -- ============================================================================
---changeset hs-office-relation-rbac-IDENTITY-VIEW:1 endDelimiter:--//
+--changeset hs-office-relationship-rbac-IDENTITY-VIEW:1 endDelimiter:--//
 -- ----------------------------------------------------------------------------
 
-call generateRbacIdentityViewFromProjection('hs_office_relation', $idName$
-         (select idName from hs_office_person_iv p where p.uuid = anchorUuid)
-     || '-with-' || target.type || '-'
-     || (select idName from hs_office_person_iv p where p.uuid = holderUuid)
+call generateRbacIdentityViewFromProjection('hs_office_relationship', $idName$
+         (select idName from hs_office_person_iv p where p.uuid = relAnchorUuid)
+     || '-with-' || target.relType || '-'
+     || (select idName from hs_office_person_iv p where p.uuid = relHolderUuid)
 
     $idName$);
 --//
 
 -- ============================================================================
---changeset hs-office-relation-rbac-RESTRICTED-VIEW:1 endDelimiter:--//
+--changeset hs-office-relationship-rbac-RESTRICTED-VIEW:1 endDelimiter:--//
 -- ----------------------------------------------------------------------------
-call generateRbacRestrictedView('hs_office_relation',
+call generateRbacRestrictedView('hs_office_relationship',
     $orderBy$
-        (select idName from hs_office_person_iv p where p.uuid = target.holderUuid)
+        (select idName from hs_office_person_iv p where p.uuid = target.relHolderUuid)
     $orderBy$,
     $updates$
                 contactUuid = new.contactUuid

src/main/resources/db/changelog/228-hs-office-relationship-test-data.sql

@@ -2,15 +2,15 @@
 
 
 -- ============================================================================
---changeset hs-office-relation-TEST-DATA-GENERATOR:1 endDelimiter:--//
+--changeset hs-office-relationship-TEST-DATA-GENERATOR:1 endDelimiter:--//
 -- ----------------------------------------------------------------------------
 
 /*
-    Creates a single relation test record.
+    Creates a single relationship test record.
  */
-create or replace procedure createHsOfficeRelationTestData(
+create or replace procedure createHsOfficeRelationshipTestData(
         holderPersonName varchar,
-        relationType HsOfficeRelationType,
+        relationshipType HsOfficeRelationshipType,
         anchorPersonName varchar,
         contactLabel varchar,
         mark varchar default null)
@@ -24,7 +24,7 @@ declare
 
 begin
     idName := cleanIdentifier( anchorPersonName || '-' || holderPersonName);
-    currentTask := 'creating relation test-data ' || idName;
+    currentTask := 'creating relationship test-data ' || idName;
     call defineContext(currentTask, null, 'superuser-alex@hostsharing.net', 'global#global.admin');
     execute format('set local hsadminng.currentTask to %L', currentTask);
 
@@ -49,20 +49,20 @@ begin
         raise exception 'contact "%" not found', contactLabel;
     end if;
 
-    raise notice 'creating test relation: %', idName;
+    raise notice 'creating test relationship: %', idName;
     raise notice '- using anchor person (%): %', anchorPerson.uuid, anchorPerson;
     raise notice '- using holder person (%): %', holderPerson.uuid, holderPerson;
     raise notice '- using contact (%): %', contact.uuid, contact;
     insert
-        into hs_office_relation (uuid, anchoruuid, holderuuid, type, mark, contactUuid)
-        values (uuid_generate_v4(), anchorPerson.uuid, holderPerson.uuid, relationType, mark, contact.uuid);
+        into hs_office_relationship (uuid, relanchoruuid, relholderuuid, reltype, relmark, contactUuid)
+        values (uuid_generate_v4(), anchorPerson.uuid, holderPerson.uuid, relationshipType, mark, contact.uuid);
 end; $$;
 --//
 
 /*
-    Creates a range of test relation for mass data generation.
+    Creates a range of test relationship for mass data generation.
  */
-create or replace procedure createHsOfficeRelationTestData(
+create or replace procedure createHsOfficeRelationshipTestData(
     startCount integer,  -- count of auto generated rows before the run
     endCount integer     -- count of auto generated rows after the run
 )
@@ -76,7 +76,7 @@ begin
             select p.* from hs_office_person p where tradeName = intToVarChar(t, 4) into person;
             select c.* from hs_office_contact c where c.label = intToVarChar(t, 4) || '#' || t into contact;
 
-            call createHsOfficeRelationTestData(person.uuid, contact.uuid, 'REPRESENTATIVE');
+            call createHsOfficeRelationshipTestData(person.uuid, contact.uuid, 'REPRESENTATIVE');
             commit;
         end loop;
 end; $$;
@@ -84,30 +84,30 @@ end; $$;
 
 
 -- ============================================================================
---changeset hs-office-relation-TEST-DATA-GENERATION:1 –context=dev,tc endDelimiter:--//
+--changeset hs-office-relationship-TEST-DATA-GENERATION:1 –context=dev,tc endDelimiter:--//
 -- ----------------------------------------------------------------------------
 
 do language plpgsql $$
     begin
-        call createHsOfficeRelationTestData('First GmbH', 'PARTNER', 'Hostsharing eG', 'first contact');
-        call createHsOfficeRelationTestData('Firby', 'REPRESENTATIVE', 'First GmbH', 'first contact');
-        call createHsOfficeRelationTestData('First GmbH', 'DEBITOR', 'First GmbH', 'first contact');
+        call createHsOfficeRelationshipTestData('First GmbH', 'PARTNER', 'Hostsharing eG', 'first contact');
+        call createHsOfficeRelationshipTestData('Firby', 'REPRESENTATIVE', 'First GmbH', 'first contact');
+        call createHsOfficeRelationshipTestData('First GmbH', 'ACCOUNTING', 'First GmbH', 'first contact');
 
-        call createHsOfficeRelationTestData('Second e.K.', 'PARTNER', 'Hostsharing eG', 'second contact');
-        call createHsOfficeRelationTestData('Smith', 'REPRESENTATIVE', 'Second e.K.', 'second contact');
-        call createHsOfficeRelationTestData('Second e.K.', 'DEBITOR', 'Second e.K.', 'second contact');
+        call createHsOfficeRelationshipTestData('Second e.K.', 'PARTNER', 'Hostsharing eG', 'second contact');
+        call createHsOfficeRelationshipTestData('Smith', 'REPRESENTATIVE', 'Second e.K.', 'second contact');
+        call createHsOfficeRelationshipTestData('Second e.K.', 'ACCOUNTING', 'Second e.K.', 'second contact');
 
-        call createHsOfficeRelationTestData('Third OHG', 'PARTNER', 'Hostsharing eG', 'third contact');
-        call createHsOfficeRelationTestData('Tucker', 'REPRESENTATIVE', 'Third OHG', 'third contact');
-        call createHsOfficeRelationTestData('Third OHG', 'DEBITOR', 'Third OHG', 'third contact');
+        call createHsOfficeRelationshipTestData('Third OHG', 'PARTNER', 'Hostsharing eG', 'third contact');
+        call createHsOfficeRelationshipTestData('Tucker', 'REPRESENTATIVE', 'Third OHG', 'third contact');
+        call createHsOfficeRelationshipTestData('Third OHG', 'ACCOUNTING', 'Third OHG', 'third contact');
 
-        call createHsOfficeRelationTestData('Fourth eG', 'PARTNER', 'Hostsharing eG', 'fourth contact');
-        call createHsOfficeRelationTestData('Fouler', 'REPRESENTATIVE', 'Third OHG', 'third contact');
-        call createHsOfficeRelationTestData('Third OHG', 'DEBITOR', 'Third OHG', 'third contact');
+        call createHsOfficeRelationshipTestData('Fourth eG', 'PARTNER', 'Hostsharing eG', 'fourth contact');
+        call createHsOfficeRelationshipTestData('Fouler', 'REPRESENTATIVE', 'Third OHG', 'third contact');
+        call createHsOfficeRelationshipTestData('Third OHG', 'ACCOUNTING', 'Third OHG', 'third contact');
 
-        call createHsOfficeRelationTestData('Smith', 'PARTNER', 'Hostsharing eG', 'sixth contact');
-        call createHsOfficeRelationTestData('Smith', 'DEBITOR', 'Smith', 'third contact');
-        call createHsOfficeRelationTestData('Smith', 'SUBSCRIBER', 'Third OHG', 'third contact', 'members-announce');
+        call createHsOfficeRelationshipTestData('Smith', 'PARTNER', 'Hostsharing eG', 'sixth contact');
+        call createHsOfficeRelationshipTestData('Smith', 'ACCOUNTING', 'Smith', 'third contact');
+        call createHsOfficeRelationshipTestData('Smith', 'SUBSCRIBER', 'Third OHG', 'third contact', 'members-announce');
     end;
 $$;
 --//

src/main/resources/db/changelog/230-hs-office-partner.sql

@@ -33,7 +33,7 @@ create table hs_office_partner
 (
     uuid                uuid unique references RbacObject (uuid) initially deferred,
     partnerNumber       numeric(5) unique not null,
-    partnerRelUuid     uuid not null references hs_office_relation(uuid), -- TODO: delete in after delete trigger
+    partnerRoleUuid     uuid not null references hs_office_relationship(uuid), -- TODO: delete in after delete trigger
     detailsUuid         uuid not null references hs_office_partner_details(uuid) -- deleted in after delete trigger
 );
 --//

src/main/resources/db/changelog/233-hs-office-partner-rbac.sql

@@ -30,24 +30,24 @@ create or replace procedure buildRbacSystemForHsOfficePartner(
     language plpgsql as $$
 
 declare
-    newPartnerRel hs_office_relation;
+    newPartnerRel hs_office_relationship;
     newPartnerDetails hs_office_partner_details;
 
 begin
     call enterTriggerForObjectUuid(NEW.uuid);
 
-    SELECT * FROM hs_office_relation AS r WHERE r.uuid = NEW.partnerRelUuid    INTO newPartnerRel;
-    assert newPartnerRel.uuid is not null, format('newPartnerRel must not be null for NEW.partnerRelUuid = %s', NEW.partnerRelUuid);
+    SELECT * FROM hs_office_relationship AS r WHERE r.uuid = NEW.partnerRoleUuid    INTO newPartnerRel;
+    assert newPartnerRel.uuid is not null, format('newPartnerRel must not be null for NEW.partnerRoleUuid = %s', NEW.partnerRoleUuid);
 
     SELECT * FROM hs_office_partner_details AS d WHERE d.uuid = NEW.detailsUuid    INTO newPartnerDetails;
     assert newPartnerDetails.uuid is not null, format('newPartnerDetails must not be null for NEW.detailsUuid = %s', NEW.detailsUuid);
 
-    call grantPermissionToRole(createPermission(NEW.uuid, 'DELETE'), hsOfficeRelationAdmin(newPartnerRel));
-    call grantPermissionToRole(createPermission(NEW.uuid, 'SELECT'), hsOfficeRelationTenant(newPartnerRel));
-    call grantPermissionToRole(createPermission(NEW.uuid, 'UPDATE'), hsOfficeRelationAgent(newPartnerRel));
-    call grantPermissionToRole(createPermission(newPartnerDetails.uuid, 'DELETE'), hsOfficeRelationAdmin(newPartnerRel));
-    call grantPermissionToRole(createPermission(newPartnerDetails.uuid, 'SELECT'), hsOfficeRelationAgent(newPartnerRel));
-    call grantPermissionToRole(createPermission(newPartnerDetails.uuid, 'UPDATE'), hsOfficeRelationAgent(newPartnerRel));
+    call grantPermissionToRole(createPermission(NEW.uuid, 'DELETE'), hsOfficeRelationshipAdmin(newPartnerRel));
+    call grantPermissionToRole(createPermission(NEW.uuid, 'SELECT'), hsOfficeRelationshipTenant(newPartnerRel));
+    call grantPermissionToRole(createPermission(NEW.uuid, 'UPDATE'), hsOfficeRelationshipAgent(newPartnerRel));
+    call grantPermissionToRole(createPermission(newPartnerDetails.uuid, 'DELETE'), hsOfficeRelationshipAdmin(newPartnerRel));
+    call grantPermissionToRole(createPermission(newPartnerDetails.uuid, 'SELECT'), hsOfficeRelationshipAgent(newPartnerRel));
+    call grantPermissionToRole(createPermission(newPartnerDetails.uuid, 'UPDATE'), hsOfficeRelationshipAgent(newPartnerRel));
 
     call leaveTriggerForObjectUuid(NEW.uuid);
 end; $$;
@@ -87,19 +87,19 @@ create or replace procedure updateRbacRulesForHsOfficePartner(
     language plpgsql as $$
 
 declare
-    oldPartnerRel hs_office_relation;
-    newPartnerRel hs_office_relation;
+    oldPartnerRel hs_office_relationship;
+    newPartnerRel hs_office_relationship;
     oldPartnerDetails hs_office_partner_details;
     newPartnerDetails hs_office_partner_details;
 
 begin
     call enterTriggerForObjectUuid(NEW.uuid);
 
-    SELECT * FROM hs_office_relation AS r WHERE r.uuid = OLD.partnerRelUuid    INTO oldPartnerRel;
-    assert oldPartnerRel.uuid is not null, format('oldPartnerRel must not be null for OLD.partnerRelUuid = %s', OLD.partnerRelUuid);
+    SELECT * FROM hs_office_relationship AS r WHERE r.uuid = OLD.partnerRoleUuid    INTO oldPartnerRel;
+    assert oldPartnerRel.uuid is not null, format('oldPartnerRel must not be null for OLD.partnerRoleUuid = %s', OLD.partnerRoleUuid);
 
-    SELECT * FROM hs_office_relation AS r WHERE r.uuid = NEW.partnerRelUuid    INTO newPartnerRel;
-    assert newPartnerRel.uuid is not null, format('newPartnerRel must not be null for NEW.partnerRelUuid = %s', NEW.partnerRelUuid);
+    SELECT * FROM hs_office_relationship AS r WHERE r.uuid = NEW.partnerRoleUuid    INTO newPartnerRel;
+    assert newPartnerRel.uuid is not null, format('newPartnerRel must not be null for NEW.partnerRoleUuid = %s', NEW.partnerRoleUuid);
 
     SELECT * FROM hs_office_partner_details AS d WHERE d.uuid = OLD.detailsUuid    INTO oldPartnerDetails;
     assert oldPartnerDetails.uuid is not null, format('oldPartnerDetails must not be null for OLD.detailsUuid = %s', OLD.detailsUuid);
@@ -108,31 +108,31 @@ begin
     assert newPartnerDetails.uuid is not null, format('newPartnerDetails must not be null for NEW.detailsUuid = %s', NEW.detailsUuid);
 
 
-    if NEW.partnerRelUuid <> OLD.partnerRelUuid then
+    if NEW.partnerRoleUuid <> OLD.partnerRoleUuid then
 
-        call revokePermissionFromRole(getPermissionId(OLD.uuid, 'DELETE'), hsOfficeRelationAdmin(oldPartnerRel));
-        call grantPermissionToRole(createPermission(NEW.uuid, 'DELETE'), hsOfficeRelationAdmin(newPartnerRel));
+        call revokePermissionFromRole(getPermissionId(OLD.uuid, 'DELETE'), hsOfficeRelationshipAdmin(oldPartnerRel));
+        call grantPermissionToRole(createPermission(NEW.uuid, 'DELETE'), hsOfficeRelationshipAdmin(newPartnerRel));
 
-        call revokePermissionFromRole(getPermissionId(OLD.uuid, 'UPDATE'), hsOfficeRelationAgent(oldPartnerRel));
-        call grantPermissionToRole(createPermission(NEW.uuid, 'UPDATE'), hsOfficeRelationAgent(newPartnerRel));
+        call revokePermissionFromRole(getPermissionId(OLD.uuid, 'UPDATE'), hsOfficeRelationshipAgent(oldPartnerRel));
+        call grantPermissionToRole(createPermission(NEW.uuid, 'UPDATE'), hsOfficeRelationshipAgent(newPartnerRel));
 
-        call revokePermissionFromRole(getPermissionId(OLD.uuid, 'SELECT'), hsOfficeRelationTenant(oldPartnerRel));
-        call grantPermissionToRole(createPermission(NEW.uuid, 'SELECT'), hsOfficeRelationTenant(newPartnerRel));
+        call revokePermissionFromRole(getPermissionId(OLD.uuid, 'SELECT'), hsOfficeRelationshipTenant(oldPartnerRel));
+        call grantPermissionToRole(createPermission(NEW.uuid, 'SELECT'), hsOfficeRelationshipTenant(newPartnerRel));
 
-        call revokePermissionFromRole(getPermissionId(oldPartnerDetails.uuid, 'DELETE'), hsOfficeRelationAdmin(oldPartnerRel));
-        call grantPermissionToRole(createPermission(newPartnerDetails.uuid, 'DELETE'), hsOfficeRelationAdmin(newPartnerRel));
+        call revokePermissionFromRole(getPermissionId(oldPartnerDetails.uuid, 'DELETE'), hsOfficeRelationshipAdmin(oldPartnerRel));
+        call grantPermissionToRole(createPermission(newPartnerDetails.uuid, 'DELETE'), hsOfficeRelationshipAdmin(newPartnerRel));
 
-        call revokePermissionFromRole(getPermissionId(oldPartnerDetails.uuid, 'UPDATE'), hsOfficeRelationAgent(oldPartnerRel));
-        call grantPermissionToRole(createPermission(newPartnerDetails.uuid, 'UPDATE'), hsOfficeRelationAgent(newPartnerRel));
+        call revokePermissionFromRole(getPermissionId(oldPartnerDetails.uuid, 'UPDATE'), hsOfficeRelationshipAgent(oldPartnerRel));
+        call grantPermissionToRole(createPermission(newPartnerDetails.uuid, 'UPDATE'), hsOfficeRelationshipAgent(newPartnerRel));
 
-        call revokePermissionFromRole(getPermissionId(oldPartnerDetails.uuid, 'SELECT'), hsOfficeRelationAgent(oldPartnerRel));
-        call grantPermissionToRole(createPermission(newPartnerDetails.uuid, 'SELECT'), hsOfficeRelationAgent(newPartnerRel));
+        call revokePermissionFromRole(getPermissionId(oldPartnerDetails.uuid, 'SELECT'), hsOfficeRelationshipAgent(oldPartnerRel));
+        call grantPermissionToRole(createPermission(newPartnerDetails.uuid, 'SELECT'), hsOfficeRelationshipAgent(newPartnerRel));
 
     end if;
 
     call leaveTriggerForObjectUuid(NEW.uuid);
 
-    -- raise exception 'RBAC updated from rel % to %', OLD.partnerReluuid, NEW.partnerReluuid;
+    -- raise exception 'RBAC updated from rel % to %', OLD.partnerroleuuid, NEW.partnerroleuuid;
 end; $$;
 
 
@@ -143,20 +143,20 @@ create or replace procedure updateRbacRulesForHsOfficePartnerX(
 )
     language plpgsql as $$
 declare
-    partnerRel hs_office_relation;
+    partnerRel hs_office_relationship;
     grantCount int;
 
 begin
     assert OLD.uuid = NEW.uuid, 'uuid did change, but should not';
-    assert OLD.partnerReluuid <> NEW.partnerReluuid, 'partnerReluuid did not change, but should have';
+    assert OLD.partnerroleuuid <> NEW.partnerroleuuid, 'partnerroleuuid did not change, but should have';
 
     delete from rbacgrants where grantedbytriggerof = OLD.uuid;
     select count(*) from rbacgrants where grantedbytriggerof=NEW.uuid into grantCount;
     assert grantCount=0, format('unexpected grantCount>0: %d', grantCount);
 
     call buildRbacSystemForHsOfficePartner(NEW);
-    select * from hs_office_relation where uuid=NEW.partnerReluuid into partnerRel;
-    call grantPermissionToRole(createPermission(NEW.uuid, 'SELECT'), hsOfficeRelationTenant(partnerRel));
+    select * from hs_office_relationship where uuid=NEW.partnerroleuuid into partnerRel;
+    call grantPermissionToRole(createPermission(NEW.uuid, 'SELECT'), hsOfficeRelationshipTenant(partnerRel));
     select count(*) from rbacgrants where grantedbytriggerof=NEW.uuid into grantCount;
     assert grantCount>0, format('unexpected grantCount=0: %d', grantCount);
     raise warning 'WARNING grantCount=%', grantCount;
@@ -262,7 +262,7 @@ call generateRbacRestrictedView('hs_office_partner',
         'P-' || partnerNumber
     $orderBy$,
     $updates$
-                partnerRelUuid = new.partnerRelUuid
+                partnerRoleUuid = new.partnerRoleUuid
     $updates$);
 --//
 

src/main/resources/db/changelog/238-hs-office-partner-test-data.sql

@@ -18,7 +18,7 @@ declare
     currentTask         varchar;
     idName              varchar;
     mandantPerson       hs_office_person;
-    partnerRel         hs_office_relation;
+    partnerRole         hs_office_relationship;
     relatedPerson       hs_office_person;
     relatedDetailsUuid  uuid;
 begin
@@ -38,16 +38,16 @@ begin
                where p.tradeName = partnerPersonName or p.familyName = partnerPersonName
                into relatedPerson;
 
-    select r.* from hs_office_relation r
-            where r.type = 'PARTNER'
-                and r.anchoruuid = mandantPerson.uuid and r.holderuuid = relatedPerson.uuid
-            into partnerRel;
-    if partnerRel is null then
-        raise exception 'partnerRel "%"-"%" not found', mandantPerson.tradename, partnerPersonName;
+    select r.* from hs_office_relationship r
+            where r.reltype = 'PARTNER'
+                and r.relanchoruuid = mandantPerson.uuid and r.relholderuuid = relatedPerson.uuid
+            into partnerRole;
+    if partnerRole is null then
+        raise exception 'partnerRole "%"-"%" not found', mandantPerson.tradename, partnerPersonName;
     end if;
 
     raise notice 'creating test partner: %', idName;
-    raise notice '- using partnerRel (%): %', partnerRel.uuid, partnerRel;
+    raise notice '- using partnerRole (%): %', partnerRole.uuid, partnerRole;
     raise notice '- using person (%): %', relatedPerson.uuid, relatedPerson;
 
     if relatedPerson.persontype = 'NP' then
@@ -63,8 +63,8 @@ begin
     end if;
 
     insert
-        into hs_office_partner (uuid, partnerNumber, partnerRelUuid, detailsUuid)
-        values (uuid_generate_v4(), newPartnerNumber, partnerRel.uuid, relatedDetailsUuid);
+        into hs_office_partner (uuid, partnerNumber, partnerRoleUuid, detailsUuid)
+        values (uuid_generate_v4(), newPartnerNumber, partnerRole.uuid, relatedDetailsUuid);
 end; $$;
 --//
 

src/main/resources/db/changelog/253-hs-office-sepamandate-rbac.sql

@@ -31,7 +31,7 @@ create or replace procedure buildRbacSystemForHsOfficeSepaMandate(
 
 declare
     newBankAccount hs_office_bankaccount;
-    newDebitorRel hs_office_relation;
+    newDebitorRel hs_office_relationship;
 
 begin
     call enterTriggerForObjectUuid(NEW.uuid);
@@ -40,7 +40,7 @@ begin
     assert newBankAccount.uuid is not null, format('newBankAccount must not be null for NEW.bankAccountUuid = %s', NEW.bankAccountUuid);
 
     SELECT debitorRel.*
-        FROM hs_office_relation debitorRel
+        FROM hs_office_relationship debitorRel
         JOIN hs_office_debitor debitor ON debitor.debitorRelUuid = debitorRel.uuid
         WHERE debitor.uuid = NEW.debitorUuid
         INTO newDebitorRel;
@@ -64,7 +64,7 @@ begin
         hsOfficeSepaMandateAgent(NEW),
             incomingSuperRoles => array[hsOfficeSepaMandateAdmin(NEW)],
             outgoingSubRoles => array[
-            	hsOfficeRelationAgent(newDebitorRel),
+            	hsOfficeRelationshipAgent(newDebitorRel),
             	hsOfficeBankAccountReferrer(newBankAccount)]
     );
 
@@ -74,8 +74,8 @@ begin
             incomingSuperRoles => array[
             	hsOfficeSepaMandateAgent(NEW),
             	hsOfficeBankAccountAdmin(newBankAccount),
-            	hsOfficeRelationAgent(newDebitorRel)],
-            outgoingSubRoles => array[hsOfficeRelationTenant(newDebitorRel)]
+            	hsOfficeRelationshipAgent(newDebitorRel)],
+            outgoingSubRoles => array[hsOfficeRelationshipTenant(newDebitorRel)]
     );
 
     call leaveTriggerForObjectUuid(NEW.uuid);
@@ -106,19 +106,19 @@ execute procedure insertTriggerForHsOfficeSepaMandate_tf();
 -- ----------------------------------------------------------------------------
 
 /*
-    Creates INSERT INTO hs_office_sepamandate permissions for the related hs_office_relation rows.
+    Creates INSERT INTO hs_office_sepamandate permissions for the related hs_office_relationship rows.
  */
 do language plpgsql $$
     declare
-        row hs_office_relation;
+        row hs_office_relationship;
         permissionUuid uuid;
         roleUuid uuid;
     begin
-        call defineContext('create INSERT INTO hs_office_sepamandate permissions for the related hs_office_relation rows');
+        call defineContext('create INSERT INTO hs_office_sepamandate permissions for the related hs_office_relationship rows');
 
-        FOR row IN SELECT * FROM hs_office_relation
+        FOR row IN SELECT * FROM hs_office_relationship
             LOOP
-                roleUuid := findRoleId(hsOfficeRelationAdmin(row));
+                roleUuid := findRoleId(hsOfficeRelationshipAdmin(row));
                 permissionUuid := createPermission(row.uuid, 'INSERT', 'hs_office_sepamandate');
                 call grantPermissionToRole(permissionUuid, roleUuid);
             END LOOP;
@@ -126,24 +126,24 @@ do language plpgsql $$
 $$;
 
 /**
-    Adds hs_office_sepamandate INSERT permission to specified role of new hs_office_relation rows.
+    Adds hs_office_sepamandate INSERT permission to specified role of new hs_office_relationship rows.
 */
-create or replace function hs_office_sepamandate_hs_office_relation_insert_tf()
+create or replace function hs_office_sepamandate_hs_office_relationship_insert_tf()
     returns trigger
     language plpgsql
     strict as $$
 begin
     call grantPermissionToRole(
             createPermission(NEW.uuid, 'INSERT', 'hs_office_sepamandate'),
-            hsOfficeRelationAdmin(NEW));
+            hsOfficeRelationshipAdmin(NEW));
     return NEW;
 end; $$;
 
 -- z_... is to put it at the end of after insert triggers, to make sure the roles exist
-create trigger z_hs_office_sepamandate_hs_office_relation_insert_tg
-    after insert on hs_office_relation
+create trigger z_hs_office_sepamandate_hs_office_relationship_insert_tg
+    after insert on hs_office_relationship
     for each row
-execute procedure hs_office_sepamandate_hs_office_relation_insert_tf();
+execute procedure hs_office_sepamandate_hs_office_relationship_insert_tf();
 
 /**
     Checks if the user or assumed roles are allowed to insert a row to hs_office_sepamandate.
@@ -156,7 +156,7 @@ begin
         ( SELECT debitorRel.uuid FROM
 
             (SELECT debitorRel.*
-                FROM hs_office_relation debitorRel
+                FROM hs_office_relationship debitorRel
                 JOIN hs_office_debitor debitor ON debitor.debitorRelUuid = debitorRel.uuid
                 WHERE debitor.uuid = NEW.debitorUuid
             ) AS debitorRel

src/main/resources/db/changelog/258-hs-office-sepamandate-test-data.sql

@@ -25,9 +25,9 @@ begin
 
     select debitor.* into relatedDebitor
         from hs_office_debitor debitor
-        join hs_office_relation debitorRel on debitorRel.uuid = debitor.debitorRelUuid
-        join hs_office_relation partnerRel on partnerRel.holderUuid = debitorRel.anchorUuid
-        join hs_office_partner partner on partner.partnerRelUuid = partnerRel.uuid
+        join hs_office_relationship debitorRel on debitorRel.uuid = debitor.debitorRelUuid
+        join hs_office_relationship partnerRel on partnerRel.relHolderUuid = debitorRel.relAnchorUuid
+        join hs_office_partner partner on partner.partnerRoleUuid = partnerRel.uuid
         where partner.partnerNumber = forPartnerNumber and debitor.debitorNumberSuffix = forDebitorSuffix;
     select b.* into relatedBankAccount
         from hs_office_bankAccount b where b.iban = forIban;

src/main/resources/db/changelog/270-hs-office-debitor.sql

@@ -8,7 +8,7 @@ create table hs_office_debitor
 (
     uuid                    uuid unique references RbacObject (uuid) initially deferred,
     debitorNumberSuffix     numeric(2) not null,
-    debitorRelUuid          uuid not null references hs_office_relation(uuid),
+    debitorRelUuid          uuid not null references hs_office_relationship(uuid),
     billable                boolean not null default true,
     vatId                   varchar(24), -- TODO.spec: here or in person?
     vatCountryCode          varchar(2),

src/main/resources/db/changelog/273-hs-office-debitor-rbac.sql

@@ -30,25 +30,25 @@ create or replace procedure buildRbacSystemForHsOfficeDebitor(
     language plpgsql as $$
 
 declare
-    newPartnerRel hs_office_relation;
-    newDebitorRel hs_office_relation;
+    newPartnerRel hs_office_relationship;
+    newDebitorRel hs_office_relationship;
     newRefundBankAccount hs_office_bankaccount;
 
 begin
     call enterTriggerForObjectUuid(NEW.uuid);
 
     SELECT partnerRel.*
-        FROM hs_office_relation AS partnerRel
-        JOIN hs_office_relation AS debitorRel
-            ON debitorRel.type = 'DEBITOR' AND debitorRel.anchorUuid = partnerRel.holderUuid
-        WHERE partnerRel.type = 'PARTNER'
+        FROM hs_office_relationship AS partnerRel
+        JOIN hs_office_relationship AS debitorRel
+            ON debitorRel.relType = 'ACCOUNTING' AND debitorRel.relAnchorUuid = partnerRel.relHolderUuid
+        WHERE partnerRel.relType = 'PARTNER'
             AND NEW.debitorRelUuid = debitorRel.uuid
         INTO newPartnerRel;
     assert newPartnerRel.uuid is not null, format('newPartnerRel must not be null for NEW.debitorRelUuid = %s', NEW.debitorRelUuid);
 
     SELECT *
-        FROM hs_office_relation AS r
-        WHERE r.type = 'DEBITOR' AND r.uuid = NEW.debitorRelUuid
+        FROM hs_office_relationship AS r
+        WHERE r.relType = 'ACCOUNTING' AND r.uuid = NEW.debitorRelUuid
         INTO newDebitorRel;
     assert newDebitorRel.uuid is not null, format('newDebitorRel must not be null for NEW.debitorRelUuid = %s', NEW.debitorRelUuid);
 
@@ -57,15 +57,15 @@ begin
         WHERE b.uuid = NEW.refundBankAccountUuid
         INTO newRefundBankAccount;
 
-    call grantRoleToRole(hsOfficeBankAccountReferrer(newRefundBankAccount), hsOfficeRelationAgent(newDebitorRel));
-    call grantRoleToRole(hsOfficeRelationAdmin(newDebitorRel), hsOfficeRelationAdmin(newPartnerRel));
-    call grantRoleToRole(hsOfficeRelationAgent(newDebitorRel), hsOfficeBankAccountAdmin(newRefundBankAccount));
-    call grantRoleToRole(hsOfficeRelationAgent(newDebitorRel), hsOfficeRelationAgent(newPartnerRel));
-    call grantRoleToRole(hsOfficeRelationTenant(newPartnerRel), hsOfficeRelationAgent(newDebitorRel));
+    call grantRoleToRole(hsOfficeBankAccountReferrer(newRefundBankAccount), hsOfficeRelationshipAgent(newDebitorRel));
+    call grantRoleToRole(hsOfficeRelationshipAdmin(newDebitorRel), hsOfficeRelationshipAdmin(newPartnerRel));
+    call grantRoleToRole(hsOfficeRelationshipAgent(newDebitorRel), hsOfficeBankAccountAdmin(newRefundBankAccount));
+    call grantRoleToRole(hsOfficeRelationshipAgent(newDebitorRel), hsOfficeRelationshipAgent(newPartnerRel));
+    call grantRoleToRole(hsOfficeRelationshipTenant(newPartnerRel), hsOfficeRelationshipAgent(newDebitorRel));
 
-    call grantPermissionToRole(createPermission(NEW.uuid, 'DELETE'), hsOfficeRelationOwner(newDebitorRel));
-    call grantPermissionToRole(createPermission(NEW.uuid, 'SELECT'), hsOfficeRelationTenant(newDebitorRel));
-    call grantPermissionToRole(createPermission(NEW.uuid, 'UPDATE'), hsOfficeRelationAdmin(newDebitorRel));
+    call grantPermissionToRole(createPermission(NEW.uuid, 'DELETE'), hsOfficeRelationshipOwner(newDebitorRel));
+    call grantPermissionToRole(createPermission(NEW.uuid, 'SELECT'), hsOfficeRelationshipTenant(newDebitorRel));
+    call grantPermissionToRole(createPermission(NEW.uuid, 'UPDATE'), hsOfficeRelationshipAdmin(newDebitorRel));
 
     call leaveTriggerForObjectUuid(NEW.uuid);
 end; $$;
@@ -202,10 +202,10 @@ create trigger hs_office_debitor_insert_permission_check_tg
         SELECT debitor.uuid AS uuid,
             'D-' || (SELECT partner.partnerNumber
                     FROM hs_office_partner partner
-                    JOIN hs_office_relation partnerRel
-                        ON partnerRel.uuid = partner.partnerRelUUid AND partnerRel.type = 'PARTNER'
-                    JOIN hs_office_relation debitorRel
-                        ON debitorRel.anchorUuid = partnerRel.holderUuid AND debitorRel.type = 'DEBITOR'
+                    JOIN hs_office_relationship partnerRel
+                        ON partnerRel.uuid = partner.partnerRoleUUid AND partnerRel.relType = 'PARTNER'
+                    JOIN hs_office_relationship debitorRel
+                        ON debitorRel.relAnchorUuid = partnerRel.relHolderUuid AND debitorRel.relType = 'ACCOUNTING'
                     WHERE debitorRel.uuid = debitor.debitorRelUuid)
                  || to_char(debitorNumberSuffix, 'fm00') as idName
 FROM hs_office_debitor AS debitor

src/main/resources/db/changelog/278-hs-office-debitor-test-data.sql

@@ -28,10 +28,10 @@ begin
 
     select debitorRel.uuid
             into relatedDebitorRelUuid
-            from hs_office_relation debitorRel
-            join hs_office_person person on person.uuid = debitorRel.holderUuid
+            from hs_office_relationship debitorRel
+            join hs_office_person person on person.uuid = debitorRel.relHolderUuid
                 and (person.tradeName = forPartnerPersonName or person.familyName = forPartnerPersonName)
-            where debitorRel.type = 'DEBITOR';
+            where debitorRel.relType = 'ACCOUNTING';
 
     select b.uuid
             into relatedBankAccountUuid

src/main/resources/db/changelog/303-hs-office-membership-rbac.sql

@@ -30,14 +30,14 @@ create or replace procedure buildRbacSystemForHsOfficeMembership(
     language plpgsql as $$
 
 declare
-    newPartnerRel hs_office_relation;
+    newPartnerRel hs_office_relationship;
 
 begin
     call enterTriggerForObjectUuid(NEW.uuid);
 
     SELECT r.*
         FROM hs_office_partner AS p
-        JOIN hs_office_relation AS r ON r.uuid = p.partnerRelUuid
+        JOIN hs_office_relationship AS r ON r.uuid = p.partnerRoleUuid
         WHERE p.uuid = NEW.partnerUuid
         INTO newPartnerRel;
     assert newPartnerRel.uuid is not null, format('newPartnerRel must not be null for NEW.partnerUuid = %s', NEW.partnerUuid);
@@ -46,7 +46,7 @@ begin
     perform createRoleWithGrants(
         hsOfficeMembershipOwner(NEW),
             permissions => array['DELETE'],
-            incomingSuperRoles => array[hsOfficeRelationAdmin(newPartnerRel)],
+            incomingSuperRoles => array[hsOfficeRelationshipAdmin(newPartnerRel)],
             userUuids => array[currentUserUuid()]
     );
 
@@ -55,14 +55,14 @@ begin
             permissions => array['UPDATE'],
             incomingSuperRoles => array[
             	hsOfficeMembershipOwner(NEW),
-            	hsOfficeRelationAgent(newPartnerRel)]
+            	hsOfficeRelationshipAgent(newPartnerRel)]
     );
 
     perform createRoleWithGrants(
         hsOfficeMembershipReferrer(NEW),
             permissions => array['SELECT'],
             incomingSuperRoles => array[hsOfficeMembershipAdmin(NEW)],
-            outgoingSubRoles => array[hsOfficeRelationTenant(newPartnerRel)]
+            outgoingSubRoles => array[hsOfficeRelationshipTenant(newPartnerRel)]
     );
 
     call leaveTriggerForObjectUuid(NEW.uuid);
@@ -93,19 +93,19 @@ execute procedure insertTriggerForHsOfficeMembership_tf();
 -- ----------------------------------------------------------------------------
 
 /*
-    Creates INSERT INTO hs_office_membership permissions for the related hs_office_relation rows.
+    Creates INSERT INTO hs_office_membership permissions for the related hs_office_relationship rows.
  */
 do language plpgsql $$
     declare
-        row hs_office_relation;
+        row hs_office_relationship;
         permissionUuid uuid;
         roleUuid uuid;
     begin
-        call defineContext('create INSERT INTO hs_office_membership permissions for the related hs_office_relation rows');
+        call defineContext('create INSERT INTO hs_office_membership permissions for the related hs_office_relationship rows');
 
-        FOR row IN SELECT * FROM hs_office_relation
+        FOR row IN SELECT * FROM hs_office_relationship
             LOOP
-                roleUuid := findRoleId(hsOfficeRelationAdmin(row));
+                roleUuid := findRoleId(hsOfficeRelationshipAdmin(row));
                 permissionUuid := createPermission(row.uuid, 'INSERT', 'hs_office_membership');
                 call grantPermissionToRole(permissionUuid, roleUuid);
             END LOOP;
@@ -113,24 +113,24 @@ do language plpgsql $$
 $$;
 
 /**
-    Adds hs_office_membership INSERT permission to specified role of new hs_office_relation rows.
+    Adds hs_office_membership INSERT permission to specified role of new hs_office_relationship rows.
 */
-create or replace function hs_office_membership_hs_office_relation_insert_tf()
+create or replace function hs_office_membership_hs_office_relationship_insert_tf()
     returns trigger
     language plpgsql
     strict as $$
 begin
     call grantPermissionToRole(
             createPermission(NEW.uuid, 'INSERT', 'hs_office_membership'),
-            hsOfficeRelationAdmin(NEW));
+            hsOfficeRelationshipAdmin(NEW));
     return NEW;
 end; $$;
 
 -- z_... is to put it at the end of after insert triggers, to make sure the roles exist
-create trigger z_hs_office_membership_hs_office_relation_insert_tg
-    after insert on hs_office_relation
+create trigger z_hs_office_membership_hs_office_relationship_insert_tg
+    after insert on hs_office_relationship
     for each row
-execute procedure hs_office_membership_hs_office_relation_insert_tf();
+execute procedure hs_office_membership_hs_office_relationship_insert_tf();
 
 /**
     Checks if the user or assumed roles are allowed to insert a row to hs_office_membership.
@@ -144,7 +144,7 @@ begin
 
             (SELECT r.*
                 FROM hs_office_partner AS p
-                JOIN hs_office_relation AS r ON r.uuid = p.partnerRelUuid
+                JOIN hs_office_relationship AS r ON r.uuid = p.partnerRoleUuid
                 WHERE p.uuid = NEW.partnerUuid
             ) AS partnerRel
 

src/main/resources/db/changelog/db.changelog-master.yaml

@@ -70,11 +70,11 @@ databaseChangeLog:
     - include:
         file: db/changelog/218-hs-office-person-test-data.sql
     - include:
-        file: db/changelog/220-hs-office-relation.sql
+        file: db/changelog/220-hs-office-relationship.sql
     - include:
-        file: db/changelog/223-hs-office-relation-rbac.sql
+        file: db/changelog/223-hs-office-relationship-rbac.sql
     - include:
-        file: db/changelog/228-hs-office-relation-test-data.sql
+        file: db/changelog/228-hs-office-relationship-test-data.sql
     - include:
         file: db/changelog/230-hs-office-partner.sql
     - include:

src/test/java/net/hostsharing/hsadminng/arch/ArchitectureTest.java

@@ -41,7 +41,7 @@ public class ArchitectureTest {
                     "..hs.office.migration",
                     "..hs.office.partner",
                     "..hs.office.person",
-                    "..hs.office.relation",
+                    "..hs.office.relationship",
                     "..hs.office.sepamandate",
                     "..errors",
                     "..mapper",
@@ -148,7 +148,7 @@ public class ArchitectureTest {
     public static final ArchRule hsOfficeContactPackageRule = classes()
             .that().resideInAPackage("..hs.office.contact..")
             .should().onlyBeAccessed().byClassesThat()
-            .resideInAnyPackage("..hs.office.contact..", "..hs.office.relation..",
+            .resideInAnyPackage("..hs.office.contact..", "..hs.office.relationship..",
                     "..hs.office.partner..",
                     "..hs.office.debitor..",
                     "..hs.office.membership..",
@@ -159,7 +159,7 @@ public class ArchitectureTest {
     public static final ArchRule hsOfficePersonPackageRule = classes()
             .that().resideInAPackage("..hs.office.person..")
             .should().onlyBeAccessed().byClassesThat()
-            .resideInAnyPackage("..hs.office.person..", "..hs.office.relation..",
+            .resideInAnyPackage("..hs.office.person..", "..hs.office.relationship..",
                     "..hs.office.partner..",
                     "..hs.office.debitor..",
                     "..hs.office.membership..",
@@ -167,10 +167,10 @@ public class ArchitectureTest {
 
     @ArchTest
     @SuppressWarnings("unused")
-    public static final ArchRule hsOfficeRelationPackageRule = classes()
-            .that().resideInAPackage("..hs.office.relation..")
+    public static final ArchRule hsOfficeRelationshipPackageRule = classes()
+            .that().resideInAPackage("..hs.office.relationship..")
             .should().onlyBeAccessed().byClassesThat()
-            .resideInAnyPackage("..hs.office.relation..",
+            .resideInAnyPackage("..hs.office.relationship..",
                     "..hs.office.partner..",
                     "..hs.office.migration..");
 

src/test/java/net/hostsharing/hsadminng/hs/office/debitor/HsOfficeDebitorControllerAcceptanceTest.java

@@ -8,8 +8,8 @@ import net.hostsharing.hsadminng.hs.office.bankaccount.HsOfficeBankAccountReposi
 import net.hostsharing.hsadminng.hs.office.contact.HsOfficeContactRepository;
 import net.hostsharing.hsadminng.hs.office.partner.HsOfficePartnerRepository;
 import net.hostsharing.hsadminng.hs.office.person.HsOfficePersonRepository;
-import net.hostsharing.hsadminng.hs.office.relation.HsOfficeRelationEntity;
-import net.hostsharing.hsadminng.hs.office.relation.HsOfficeRelationRepository;
+import net.hostsharing.hsadminng.hs.office.relationship.HsOfficeRelationshipEntity;
+import net.hostsharing.hsadminng.hs.office.relationship.HsOfficeRelationshipRepository;
 import net.hostsharing.hsadminng.hs.office.test.ContextBasedTestWithCleanup;
 import net.hostsharing.test.Accepts;
 import net.hostsharing.test.JpaAttempt;
@@ -27,7 +27,7 @@ import jakarta.persistence.EntityManager;
 import jakarta.persistence.PersistenceContext;
 import java.util.UUID;
 
-import static net.hostsharing.hsadminng.hs.office.relation.HsOfficeRelationType.DEBITOR;
+import static net.hostsharing.hsadminng.hs.office.relationship.HsOfficeRelationshipType.ACCOUNTING;
 import static net.hostsharing.test.IsValidUuidMatcher.isUuidValid;
 import static net.hostsharing.test.JsonMatcher.lenientlyEquals;
 import static org.assertj.core.api.Assertions.assertThat;
@@ -65,7 +65,7 @@ class HsOfficeDebitorControllerAcceptanceTest extends ContextBasedTestWithCleanu
     HsOfficePersonRepository personRepo;
 
     @Autowired
-    HsOfficeRelationRepository relRepo;
+    HsOfficeRelationshipRepository relRepo;
 
     @Autowired
     JpaAttempt jpaAttempt;
@@ -93,20 +93,20 @@ class HsOfficeDebitorControllerAcceptanceTest extends ContextBasedTestWithCleanu
                     [
                       {
                         "debitorRel": {
-                          "anchor": {
+                          "relAnchor": {
                             "personType": "LEGAL_PERSON",
                             "tradeName": "First GmbH",
                             "givenName": null,
                             "familyName": null
                           },
-                          "holder": {
+                          "relHolder": {
                             "personType": "LEGAL_PERSON",
                             "tradeName": "First GmbH",
                             "givenName": null,
                             "familyName": null
                           },
-                          "type": "DEBITOR",
-                          "mark": null,
+                          "relType": "ACCOUNTING",
+                          "relMark": null,
                           "contact": {
                             "label": "first contact",
                             "emailAddresses": "contact-admin@firstcontact.example.com",
@@ -117,21 +117,21 @@ class HsOfficeDebitorControllerAcceptanceTest extends ContextBasedTestWithCleanu
                         "debitorNumberSuffix": 11,
                         "partner": {
                           "partnerNumber": 10001,
-                          "partnerRel": {
-                            "anchor": {
+                          "partnerRole": {
+                            "relAnchor": {
                               "personType": "LEGAL_PERSON",
                               "tradeName": "Hostsharing eG",
                               "givenName": null,
                               "familyName": null
                             },
-                            "holder": {
+                            "relHolder": {
                               "personType": "LEGAL_PERSON",
                               "tradeName": "First GmbH",
                               "givenName": null,
                               "familyName": null
                             },
-                            "type": "PARTNER",
-                            "mark": null,
+                            "relType": "PARTNER",
+                            "relMark": null,
                             "contact": {
                               "label": "first contact",
                               "emailAddresses": "contact-admin@firstcontact.example.com",
@@ -161,19 +161,19 @@ class HsOfficeDebitorControllerAcceptanceTest extends ContextBasedTestWithCleanu
                       },
                       {
                         "debitorRel": {
-                          "anchor": {"tradeName": "Second e.K."},
-                          "holder": {"tradeName": "Second e.K."},
-                          "type": "DEBITOR",
+                          "relAnchor": {"tradeName": "Second e.K."},
+                          "relHolder": {"tradeName": "Second e.K."},
+                          "relType": "ACCOUNTING",
                           "contact": {"emailAddresses": "contact-admin@secondcontact.example.com"}
                         },
                         "debitorNumber": 1000212,
                         "debitorNumberSuffix": 12,
                         "partner": {
                           "partnerNumber": 10002,
-                          "partnerRel": {
-                            "anchor": {"tradeName": "Hostsharing eG"},
-                            "holder": {"tradeName": "Second e.K."},
-                            "type": "PARTNER",
+                          "partnerRole": {
+                            "relAnchor": {"tradeName": "Hostsharing eG"},
+                            "relHolder": {"tradeName": "Second e.K."},
+                            "relType": "PARTNER",
                             "contact": {"emailAddresses": "contact-admin@secondcontact.example.com"}
                           },
                           "details": {
@@ -191,19 +191,19 @@ class HsOfficeDebitorControllerAcceptanceTest extends ContextBasedTestWithCleanu
                       },
                       {
                         "debitorRel": {
-                          "anchor": {"tradeName": "Third OHG"},
-                          "holder": {"tradeName": "Third OHG"},
-                          "type": "DEBITOR",
+                          "relAnchor": {"tradeName": "Third OHG"},
+                          "relHolder": {"tradeName": "Third OHG"},
+                          "relType": "ACCOUNTING",
                           "contact": {"emailAddresses": "contact-admin@thirdcontact.example.com"}
                         },
                         "debitorNumber": 1000313,
                         "debitorNumberSuffix": 13,
                         "partner": {
                           "partnerNumber": 10003,
-                          "partnerRel": {
-                            "anchor": {"tradeName": "Hostsharing eG"},
-                            "holder": {"tradeName": "Third OHG"},
-                            "type": "PARTNER",
+                          "partnerRole": {
+                            "relAnchor": {"tradeName": "Hostsharing eG"},
+                            "relHolder": {"tradeName": "Third OHG"},
+                            "relType": "PARTNER",
                             "contact": {"emailAddresses": "contact-admin@thirdcontact.example.com"}
                           },
                           "details": {
@@ -268,10 +268,10 @@ class HsOfficeDebitorControllerAcceptanceTest extends ContextBasedTestWithCleanu
 
             final var givenDebitorRelUUid = jpaAttempt.transacted(() -> {
                 context.define("superuser-alex@hostsharing.net");
-                return relRepo.save(HsOfficeRelationEntity.builder()
-                        .type(DEBITOR)
-                        .anchor(givenPartner.getPartnerRel().getHolder())
-                        .holder(givenBillingPerson)
+                return relRepo.save(HsOfficeRelationshipEntity.builder()
+                        .relType(ACCOUNTING)
+                        .relAnchor(givenPartner.getPartnerRole().getRelHolder())
+                        .relHolder(givenBillingPerson)
                         .contact(givenContact)
                         .build()).getUuid();
             }).assertSuccessful().returnedValue();
@@ -303,7 +303,7 @@ class HsOfficeDebitorControllerAcceptanceTest extends ContextBasedTestWithCleanu
                         .body("vatId", is("VAT123456"))
                         .body("defaultPrefix", is("for"))
                         .body("debitorRel.contact.label", is(givenContact.getLabel()))
-                        .body("debitorRel.holder.tradeName", is(givenBillingPerson.getTradeName()))
+                        .body("debitorRel.relHolder.tradeName", is(givenBillingPerson.getTradeName()))
                         .body("refundBankAccount.holder", is(givenBankAccount.getHolder()))
                         .header("Location", startsWith("http://localhost"))
                     .extract().header("Location");  // @formatter:on
@@ -328,9 +328,9 @@ class HsOfficeDebitorControllerAcceptanceTest extends ContextBasedTestWithCleanu
                     .body("""
                             {
                                "debitorRel": {
-                                    "type": "DEBITOR",
-                                    "anchorUuid": "%s",
-                                    "holderUuid": "%s",
+                                    "relType": "ACCOUNTING",
+                                    "relAnchorUuid": "%s",
+                                    "relHolderUuid": "%s",
                                     "contactUuid": "%s"
                                 },
                                 "debitorNumberSuffix": "%s",
@@ -339,8 +339,8 @@ class HsOfficeDebitorControllerAcceptanceTest extends ContextBasedTestWithCleanu
                                 "vatReverseCharge": "false"
                             }
                             """.formatted(
-                                givenPartner.getPartnerRel().getHolder().getUuid(),
-                                givenPartner.getPartnerRel().getHolder().getUuid(),
+                                givenPartner.getPartnerRole().getRelHolder().getUuid(),
+                                givenPartner.getPartnerRole().getRelHolder().getUuid(),
                                 givenContact.getUuid(),
                                 ++nextDebitorSuffix))
                     .port(port)
@@ -351,7 +351,7 @@ class HsOfficeDebitorControllerAcceptanceTest extends ContextBasedTestWithCleanu
                     .contentType(ContentType.JSON)
                     .body("uuid", isUuidValid())
                     .body("debitorRel.contact.label", is(givenContact.getLabel()))
-                    .body("partner.partnerRel.holder.tradeName", is(givenPartner.getPartnerRel().getHolder().getTradeName()))
+                    .body("partner.partnerRole.relHolder.tradeName", is(givenPartner.getPartnerRole().getRelHolder().getTradeName()))
                     .body("vatId", equalTo(null))
                     .body("vatCountryCode", equalTo(null))
                     .body("vatBusiness", equalTo(false))
@@ -380,9 +380,9 @@ class HsOfficeDebitorControllerAcceptanceTest extends ContextBasedTestWithCleanu
                     .body("""
                             {
                                "debitorRel": {
-                                    "type": "DEBITOR",
-                                    "anchorUuid": "%s",
-                                    "holderUuid": "%s",
+                                    "relType": "ACCOUNTING",
+                                    "relAnchorUuid": "%s",
+                                    "relHolderUuid": "%s",
                                     "contactUuid": "%s"
                                 },
                                 "debitorNumberSuffix": "%s",
@@ -391,8 +391,8 @@ class HsOfficeDebitorControllerAcceptanceTest extends ContextBasedTestWithCleanu
                                 "vatReverseCharge": "false"
                             }
                             """.formatted(
-                                givenPartner.getPartnerRel().getAnchor().getUuid(),
-                                givenPartner.getPartnerRel().getAnchor().getUuid(),
+                                givenPartner.getPartnerRole().getRelAnchor().getUuid(),
+                                givenPartner.getPartnerRole().getRelAnchor().getUuid(),
                                 givenContactUuid, ++nextDebitorSuffix))
                     .port(port)
                 .when()
@@ -428,7 +428,7 @@ class HsOfficeDebitorControllerAcceptanceTest extends ContextBasedTestWithCleanu
                     .post("http://localhost/api/hs/office/debitors")
                 .then().log().all().assertThat()
                     .statusCode(400)
-                    .body("message", is("Unable to find HsOfficeRelationEntity with uuid 00000000-0000-0000-0000-000000000000"));
+                    .body("message", is("Unable to find HsOfficeRelationshipEntity with uuid 00000000-0000-0000-0000-000000000000"));
                 // @formatter:on
         }
     }
@@ -454,9 +454,9 @@ class HsOfficeDebitorControllerAcceptanceTest extends ContextBasedTestWithCleanu
                     .body("", lenientlyEquals("""
                     {
                          "debitorRel": {
-                             "anchor": { "personType": "LEGAL_PERSON", "tradeName": "First GmbH"},
-                             "holder": { "personType": "LEGAL_PERSON", "tradeName": "First GmbH"},
-                             "type": "DEBITOR",
+                             "relAnchor": { "personType": "LEGAL_PERSON", "tradeName": "First GmbH"},
+                             "relHolder": { "personType": "LEGAL_PERSON", "tradeName": "First GmbH"},
+                             "relType": "ACCOUNTING",
                              "contact": {
                                  "label": "first contact",
                                  "postalAddress": "\\nVorname Nachname\\nStraße Hnr\\nPLZ Stadt\\n",
@@ -468,11 +468,11 @@ class HsOfficeDebitorControllerAcceptanceTest extends ContextBasedTestWithCleanu
                          "debitorNumberSuffix": 11,
                          "partner": {
                              "partnerNumber": 10001,
-                             "partnerRel": {
-                                 "anchor": { "personType": "LEGAL_PERSON", "tradeName": "Hostsharing eG"},
-                                 "holder": { "personType": "LEGAL_PERSON", "tradeName": "First GmbH"},
-                                 "type": "PARTNER",
-                                 "mark": null,
+                             "partnerRole": {
+                                 "relAnchor": { "personType": "LEGAL_PERSON", "tradeName": "Hostsharing eG"},
+                                 "relHolder": { "personType": "LEGAL_PERSON", "tradeName": "First GmbH"},
+                                 "relType": "PARTNER",
+                                 "relMark": null,
                                  "contact": {
                                      "label": "first contact",
                                      "postalAddress": "\\nVorname Nachname\\nStraße Hnr\\nPLZ Stadt\\n",
@@ -576,7 +576,7 @@ class HsOfficeDebitorControllerAcceptanceTest extends ContextBasedTestWithCleanu
                     .body("vatBusiness", is(true))
                     .body("defaultPrefix", is("for"))
                     // FIXME .body("billingContact.label", is(givenContact.getLabel()))
-                    // FIXME .body("partner.partnerRel.holder.tradeName", is(givenDebitor.getPartner().getPartnerRel().getHolder().getTradeName()))
+                    // FIXME .body("partner.partnerRole.relHolder.tradeName", is(givenDebitor.getPartner().getPartnerRole().getRelHolder().getTradeName()))
                     ;
                 // @formatter:on
 
@@ -584,8 +584,8 @@ class HsOfficeDebitorControllerAcceptanceTest extends ContextBasedTestWithCleanu
             context.define("superuser-alex@hostsharing.net");
             assertThat(debitorRepo.findByUuid(givenDebitor.getUuid())).isPresent().get()
                     .matches(debitor -> {
-                        assertThat(debitor.getDebitorRel().getHolder().getTradeName())
-                                .isEqualTo(givenDebitor.getDebitorRel().getHolder().getTradeName());
+                        assertThat(debitor.getDebitorRel().getRelHolder().getTradeName())
+                                .isEqualTo(givenDebitor.getDebitorRel().getRelHolder().getTradeName());
                         assertThat(debitor.getDebitorRel().getContact().getLabel()).isEqualTo("fourth contact");
                         assertThat(debitor.getVatId()).isEqualTo("VAT222222");
                         assertThat(debitor.getVatCountryCode()).isEqualTo("AA");
@@ -627,8 +627,8 @@ class HsOfficeDebitorControllerAcceptanceTest extends ContextBasedTestWithCleanu
             // finally, the debitor is actually updated
             assertThat(debitorRepo.findByUuid(givenDebitor.getUuid())).isPresent().get()
                     .matches(partner -> {
-                        assertThat(partner.getDebitorRel().getHolder().getTradeName())
-                                .isEqualTo(givenDebitor.getDebitorRel().getHolder().getTradeName());
+                        assertThat(partner.getDebitorRel().getRelHolder().getTradeName())
+                                .isEqualTo(givenDebitor.getDebitorRel().getRelHolder().getTradeName());
                         // FIXME assertThat(partner.getDebitorRel().getContact().getLabel()).isEqualTo("sixth contact");
                         assertThat(partner.getVatId()).isEqualTo("VAT999999");
                         assertThat(partner.getVatCountryCode()).isEqualTo(givenDebitor.getVatCountryCode());
@@ -711,10 +711,10 @@ class HsOfficeDebitorControllerAcceptanceTest extends ContextBasedTestWithCleanu
                     .debitorNumberSuffix(++nextDebitorSuffix)
                     .billable(true)
                     .debitorRel(
-                            HsOfficeRelationEntity.builder()
-                                    .type(DEBITOR)
-                                    .anchor(givenPartner.getPartnerRel().getHolder())
-                                    .holder(givenPartner.getPartnerRel().getHolder())
+                            HsOfficeRelationshipEntity.builder()
+                                    .relType(ACCOUNTING)
+                                    .relAnchor(givenPartner.getPartnerRole().getRelHolder())
+                                    .relHolder(givenPartner.getPartnerRole().getRelHolder())
                                     .contact(givenContact)
                                     .build()
                     )

src/test/java/net/hostsharing/hsadminng/hs/office/debitor/HsOfficeDebitorEntityPatcherUnitTest.java

@@ -2,7 +2,7 @@ package net.hostsharing.hsadminng.hs.office.debitor;
 
 import net.hostsharing.hsadminng.hs.office.bankaccount.HsOfficeBankAccountEntity;
 import net.hostsharing.hsadminng.hs.office.generated.api.v1.model.HsOfficeDebitorPatchResource;
-import net.hostsharing.hsadminng.hs.office.relation.HsOfficeRelationEntity;
+import net.hostsharing.hsadminng.hs.office.relationship.HsOfficeRelationshipEntity;
 import net.hostsharing.test.PatchUnitTestBase;
 import org.junit.jupiter.api.BeforeEach;
 import org.junit.jupiter.api.TestInstance;
@@ -44,7 +44,7 @@ class HsOfficeDebitorEntityPatcherUnitTest extends PatchUnitTestBase<
     private static final UUID INITIAL_REFUND_BANK_ACCOUNT_UUID = UUID.randomUUID();
     private static final UUID PATCHED_REFUND_BANK_ACCOUNT_UUID = UUID.randomUUID();
 
-    private final HsOfficeRelationEntity givenInitialDebitorRel = HsOfficeRelationEntity.builder()
+    private final HsOfficeRelationshipEntity givenInitialDebitorRel = HsOfficeRelationshipEntity.builder()
             .uuid(INITIAL_DEBITOR_REL_UUID)
             .build();
 
@@ -56,8 +56,8 @@ class HsOfficeDebitorEntityPatcherUnitTest extends PatchUnitTestBase<
 
     @BeforeEach
     void initMocks() {
-        lenient().when(em.getReference(eq(HsOfficeRelationEntity.class), any())).thenAnswer(invocation ->
-                HsOfficeRelationEntity.builder().uuid(invocation.getArgument(1)).build());
+        lenient().when(em.getReference(eq(HsOfficeRelationshipEntity.class), any())).thenAnswer(invocation ->
+                HsOfficeRelationshipEntity.builder().uuid(invocation.getArgument(1)).build());
         lenient().when(em.getReference(eq(HsOfficeBankAccountEntity.class), any())).thenAnswer(invocation ->
                 HsOfficeBankAccountEntity.builder().uuid(invocation.getArgument(1)).build());
     }
@@ -141,8 +141,8 @@ class HsOfficeDebitorEntityPatcherUnitTest extends PatchUnitTestBase<
         );
     }
 
-    private HsOfficeRelationEntity newDebitorRel(final UUID uuid) {
-        return HsOfficeRelationEntity.builder()
+    private HsOfficeRelationshipEntity newDebitorRel(final UUID uuid) {
+        return HsOfficeRelationshipEntity.builder()
                 .uuid(uuid)
                 .build();
     }

src/test/java/net/hostsharing/hsadminng/hs/office/debitor/HsOfficeDebitorEntityUnitTest.java

@@ -4,19 +4,19 @@ import net.hostsharing.hsadminng.hs.office.contact.HsOfficeContactEntity;
 import net.hostsharing.hsadminng.hs.office.partner.HsOfficePartnerEntity;
 import net.hostsharing.hsadminng.hs.office.person.HsOfficePersonEntity;
 import net.hostsharing.hsadminng.hs.office.person.HsOfficePersonType;
-import net.hostsharing.hsadminng.hs.office.relation.HsOfficeRelationEntity;
+import net.hostsharing.hsadminng.hs.office.relationship.HsOfficeRelationshipEntity;
 import org.junit.jupiter.api.Test;
 
 import static org.assertj.core.api.Assertions.assertThat;
 
 class HsOfficeDebitorEntityUnitTest {
 
-    private HsOfficeRelationEntity givenDebitorRel = HsOfficeRelationEntity.builder()
-            .anchor(HsOfficePersonEntity.builder()
+    private HsOfficeRelationshipEntity givenDebitorRel = HsOfficeRelationshipEntity.builder()
+            .relAnchor(HsOfficePersonEntity.builder()
                     .personType(HsOfficePersonType.LEGAL_PERSON)
                     .tradeName("some partner trade name")
                     .build())
-            .holder(HsOfficePersonEntity.builder()
+            .relHolder(HsOfficePersonEntity.builder()
                     .personType(HsOfficePersonType.LEGAL_PERSON)
                     .tradeName("some billing trade name")
                     .build())
@@ -36,7 +36,7 @@ class HsOfficeDebitorEntityUnitTest {
 
         final var result = given.toString();
 
-        assertThat(result).isEqualTo("debitor(D-1234567: rel(anchor='LP some partner trade name', holder='LP some billing trade name'), som)");
+        assertThat(result).isEqualTo("debitor(D-1234567: rel(relAnchor='LP some partner trade name', relHolder='LP some billing trade name'), som)");
     }
 
     @Test

src/test/java/net/hostsharing/hsadminng/hs/office/debitor/HsOfficeDebitorRepositoryIntegrationTest.java

@@ -5,8 +5,8 @@ import net.hostsharing.hsadminng.hs.office.bankaccount.HsOfficeBankAccountReposi
 import net.hostsharing.hsadminng.hs.office.contact.HsOfficeContactRepository;
 import net.hostsharing.hsadminng.hs.office.partner.HsOfficePartnerRepository;
 import net.hostsharing.hsadminng.hs.office.person.HsOfficePersonRepository;
-import net.hostsharing.hsadminng.hs.office.relation.HsOfficeRelationEntity;
-import net.hostsharing.hsadminng.hs.office.relation.HsOfficeRelationType;
+import net.hostsharing.hsadminng.hs.office.relationship.HsOfficeRelationshipEntity;
+import net.hostsharing.hsadminng.hs.office.relationship.HsOfficeRelationshipType;
 import net.hostsharing.hsadminng.hs.office.test.ContextBasedTestWithCleanup;
 import net.hostsharing.hsadminng.rbac.rbacgrant.RawRbacGrantRepository;
 import net.hostsharing.hsadminng.rbac.rbacgrant.RbacGrantsDiagramService;
@@ -89,10 +89,10 @@ class HsOfficeDebitorRepositoryIntegrationTest extends ContextBasedTestWithClean
             final var result = attempt(em, () -> {
                 final var newDebitor = HsOfficeDebitorEntity.builder()
                         .debitorNumberSuffix((byte)21)
-                        .debitorRel(HsOfficeRelationEntity.builder()
-                                .type(HsOfficeRelationType.DEBITOR)
-                                .anchor(givenPartnerPerson)
-                                .holder(givenPartnerPerson)
+                        .debitorRel(HsOfficeRelationshipEntity.builder()
+                                .relType(HsOfficeRelationshipType.ACCOUNTING)
+                                .relAnchor(givenPartnerPerson)
+                                .relHolder(givenPartnerPerson)
                                 .contact(givenContact)
                                 .build())
                         .defaultPrefix("abc")
@@ -121,10 +121,10 @@ class HsOfficeDebitorRepositoryIntegrationTest extends ContextBasedTestWithClean
             final var result = attempt(em, () -> {
                 final var newDebitor = HsOfficeDebitorEntity.builder()
                         .debitorNumberSuffix((byte)21)
-                        .debitorRel(HsOfficeRelationEntity.builder()
-                                .type(HsOfficeRelationType.DEBITOR)
-                                .anchor(givenPartnerPerson)
-                                .holder(givenPartnerPerson)
+                        .debitorRel(HsOfficeRelationshipEntity.builder()
+                                .relType(HsOfficeRelationshipType.ACCOUNTING)
+                                .relAnchor(givenPartnerPerson)
+                                .relHolder(givenPartnerPerson)
                                 .contact(givenContact)
                                 .build())
                         .billable(true)
@@ -156,10 +156,10 @@ class HsOfficeDebitorRepositoryIntegrationTest extends ContextBasedTestWithClean
                 final var givenContact = one(contactRepo.findContactByOptionalLabelLike("fourth contact"));
                 final var newDebitor = HsOfficeDebitorEntity.builder()
                         .debitorNumberSuffix((byte)22)
-                        .debitorRel(HsOfficeRelationEntity.builder()
-                                .type(HsOfficeRelationType.DEBITOR)
-                                .anchor(givenPartnerPerson)
-                                .holder(givenDebitorPerson)
+                        .debitorRel(HsOfficeRelationshipEntity.builder()
+                                .relType(HsOfficeRelationshipType.ACCOUNTING)
+                                .relAnchor(givenPartnerPerson)
+                                .relHolder(givenDebitorPerson)
                                 .contact(givenContact)
                                 .build())
                         .defaultPrefix("abc")
@@ -171,45 +171,45 @@ class HsOfficeDebitorRepositoryIntegrationTest extends ContextBasedTestWithClean
             // then
             assertThat(distinctRoleNamesOf(rawRoleRepo.findAll())).containsExactlyInAnyOrder(Array.from(
                     initialRoleNames,
-                    "hs_office_relation#FirstGmbH-with-DEBITOR-FourtheG.owner",
-                    "hs_office_relation#FirstGmbH-with-DEBITOR-FourtheG.admin",
-                    "hs_office_relation#FirstGmbH-with-DEBITOR-FourtheG.agent",
-                    "hs_office_relation#FirstGmbH-with-DEBITOR-FourtheG.tenant"));
+                    "hs_office_relationship#FirstGmbH-with-ACCOUNTING-FourtheG.owner",
+                    "hs_office_relationship#FirstGmbH-with-ACCOUNTING-FourtheG.admin",
+                    "hs_office_relationship#FirstGmbH-with-ACCOUNTING-FourtheG.agent",
+                    "hs_office_relationship#FirstGmbH-with-ACCOUNTING-FourtheG.tenant"));
             assertThat(distinctGrantDisplaysOf(rawGrantRepo.findAll()))
                 .map(s -> s.replace("hs_office_", ""))
                 .containsExactlyInAnyOrder(Array.fromFormatted(
                     initialGrantNames,
                     // FIXME: the next line is completely wrong, the format as well that it exists
-                    "{ grant perm INSERT on relation#FirstGmbH-with-DEBITOR-FourtheG to role relation#FirstGmbH-with-DEBITOR-FourtheG.admin by system and assume }",
+                    "{ grant perm INSERT on relationship#FirstGmbH-with-ACCOUNTING-FourtheG to role relationship#FirstGmbH-with-ACCOUNTING-FourtheG.admin by system and assume }",
 
                     // owner
-                    "{ grant perm DELETE on debitor#D-1000122 to role relation#FirstGmbH-with-DEBITOR-FourtheG.owner by system and assume }",
-                    "{ grant perm DELETE on relation#FirstGmbH-with-DEBITOR-FourtheG to role relation#FirstGmbH-with-DEBITOR-FourtheG.owner by system and assume }",
-                    "{ grant role relation#FirstGmbH-with-DEBITOR-FourtheG.owner to role global#global.admin by system and assume }",
-                    "{ grant role relation#FirstGmbH-with-DEBITOR-FourtheG.owner to user superuser-alex@hostsharing.net by relation#FirstGmbH-with-DEBITOR-FourtheG.owner and assume }",
+                    "{ grant perm DELETE on debitor#D-1000122 to role relationship#FirstGmbH-with-ACCOUNTING-FourtheG.owner by system and assume }",
+                    "{ grant perm DELETE on relationship#FirstGmbH-with-ACCOUNTING-FourtheG to role relationship#FirstGmbH-with-ACCOUNTING-FourtheG.owner by system and assume }",
+                    "{ grant role relationship#FirstGmbH-with-ACCOUNTING-FourtheG.owner to role global#global.admin by system and assume }",
+                    "{ grant role relationship#FirstGmbH-with-ACCOUNTING-FourtheG.owner to user superuser-alex@hostsharing.net by relationship#FirstGmbH-with-ACCOUNTING-FourtheG.owner and assume }",
 
                     // admin
-                    "{ grant perm UPDATE on debitor#D-1000122 to role relation#FirstGmbH-with-DEBITOR-FourtheG.admin by system and assume }",
-                    "{ grant perm UPDATE on relation#FirstGmbH-with-DEBITOR-FourtheG to role relation#FirstGmbH-with-DEBITOR-FourtheG.admin by system and assume }",
-                    "{ grant role relation#FirstGmbH-with-DEBITOR-FourtheG.admin to role relation#FirstGmbH-with-DEBITOR-FourtheG.owner by system and assume }",
-                    "{ grant role relation#FirstGmbH-with-DEBITOR-FourtheG.admin to role person#FirstGmbH.admin by system and assume }",
-                    "{ grant role relation#FirstGmbH-with-DEBITOR-FourtheG.admin to role relation#HostsharingeG-with-PARTNER-FirstGmbH.admin by system and assume }",
+                    "{ grant perm UPDATE on debitor#D-1000122 to role relationship#FirstGmbH-with-ACCOUNTING-FourtheG.admin by system and assume }",
+                    "{ grant perm UPDATE on relationship#FirstGmbH-with-ACCOUNTING-FourtheG to role relationship#FirstGmbH-with-ACCOUNTING-FourtheG.admin by system and assume }",
+                    "{ grant role relationship#FirstGmbH-with-ACCOUNTING-FourtheG.admin to role relationship#FirstGmbH-with-ACCOUNTING-FourtheG.owner by system and assume }",
+                    "{ grant role relationship#FirstGmbH-with-ACCOUNTING-FourtheG.admin to role person#FirstGmbH.admin by system and assume }",
+                    "{ grant role relationship#FirstGmbH-with-ACCOUNTING-FourtheG.admin to role relationship#HostsharingeG-with-PARTNER-FirstGmbH.admin by system and assume }",
 
                     // agent
-                    "{ grant role relation#FirstGmbH-with-DEBITOR-FourtheG.agent to role person#FourtheG.admin by system and assume }",
-                    "{ grant role relation#FirstGmbH-with-DEBITOR-FourtheG.agent to role relation#FirstGmbH-with-DEBITOR-FourtheG.admin by system and assume }",
-                    "{ grant role relation#FirstGmbH-with-DEBITOR-FourtheG.agent to role relation#HostsharingeG-with-PARTNER-FirstGmbH.agent by system and assume }",
+                    "{ grant role relationship#FirstGmbH-with-ACCOUNTING-FourtheG.agent to role person#FourtheG.admin by system and assume }",
+                    "{ grant role relationship#FirstGmbH-with-ACCOUNTING-FourtheG.agent to role relationship#FirstGmbH-with-ACCOUNTING-FourtheG.admin by system and assume }",
+                    "{ grant role relationship#FirstGmbH-with-ACCOUNTING-FourtheG.agent to role relationship#HostsharingeG-with-PARTNER-FirstGmbH.agent by system and assume }",
 
                     // tenant
-                    "{ grant perm SELECT on debitor#D-1000122 to role relation#FirstGmbH-with-DEBITOR-FourtheG.tenant by system and assume }",
-                    "{ grant perm SELECT on relation#FirstGmbH-with-DEBITOR-FourtheG to role relation#FirstGmbH-with-DEBITOR-FourtheG.tenant by system and assume }",
-                    "{ grant role relation#HostsharingeG-with-PARTNER-FirstGmbH.tenant to role relation#FirstGmbH-with-DEBITOR-FourtheG.agent by system and assume }",
-                    "{ grant role contact#fourthcontact.referrer to role relation#FirstGmbH-with-DEBITOR-FourtheG.tenant by system and assume }",
-                    "{ grant role person#FirstGmbH.referrer to role relation#FirstGmbH-with-DEBITOR-FourtheG.tenant by system and assume }",
-                    "{ grant role person#FourtheG.referrer to role relation#FirstGmbH-with-DEBITOR-FourtheG.tenant by system and assume }",
-                    "{ grant role relation#FirstGmbH-with-DEBITOR-FourtheG.tenant to role contact#fourthcontact.admin by system and assume }",
-                    "{ grant role relation#FirstGmbH-with-DEBITOR-FourtheG.tenant to role person#FourtheG.admin by system and assume }",
-                    "{ grant role relation#FirstGmbH-with-DEBITOR-FourtheG.tenant to role relation#FirstGmbH-with-DEBITOR-FourtheG.agent by system and assume }",
+                    "{ grant perm SELECT on debitor#D-1000122 to role relationship#FirstGmbH-with-ACCOUNTING-FourtheG.tenant by system and assume }",
+                    "{ grant perm SELECT on relationship#FirstGmbH-with-ACCOUNTING-FourtheG to role relationship#FirstGmbH-with-ACCOUNTING-FourtheG.tenant by system and assume }",
+                    "{ grant role relationship#HostsharingeG-with-PARTNER-FirstGmbH.tenant to role relationship#FirstGmbH-with-ACCOUNTING-FourtheG.agent by system and assume }",
+                    "{ grant role contact#fourthcontact.referrer to role relationship#FirstGmbH-with-ACCOUNTING-FourtheG.tenant by system and assume }",
+                    "{ grant role person#FirstGmbH.referrer to role relationship#FirstGmbH-with-ACCOUNTING-FourtheG.tenant by system and assume }",
+                    "{ grant role person#FourtheG.referrer to role relationship#FirstGmbH-with-ACCOUNTING-FourtheG.tenant by system and assume }",
+                    "{ grant role relationship#FirstGmbH-with-ACCOUNTING-FourtheG.tenant to role contact#fourthcontact.admin by system and assume }",
+                    "{ grant role relationship#FirstGmbH-with-ACCOUNTING-FourtheG.tenant to role person#FourtheG.admin by system and assume }",
+                    "{ grant role relationship#FirstGmbH-with-ACCOUNTING-FourtheG.tenant to role relationship#FirstGmbH-with-ACCOUNTING-FourtheG.agent by system and assume }",
 
                     null));
         }
@@ -235,9 +235,9 @@ class HsOfficeDebitorRepositoryIntegrationTest extends ContextBasedTestWithClean
             // then
             allTheseDebitorsAreReturned(
                     result,
-                    "debitor(D-1000111: rel(anchor='LP First GmbH', type='DEBITOR', holder='LP First GmbH'), fir)",
-                    "debitor(D-1000212: rel(anchor='LP Second e.K.', type='DEBITOR', holder='LP Second e.K.'), sec)",
-                    "debitor(D-1000313: rel(anchor='IF Third OHG', type='DEBITOR', holder='IF Third OHG'), thi)");
+                    "debitor(D-1000111: rel(relAnchor='LP First GmbH', relType='ACCOUNTING', relHolder='LP First GmbH'), fir)",
+                    "debitor(D-1000212: rel(relAnchor='LP Second e.K.', relType='ACCOUNTING', relHolder='LP Second e.K.'), sec)",
+                    "debitor(D-1000313: rel(relAnchor='IF Third OHG', relType='ACCOUNTING', relHolder='IF Third OHG'), thi)");
         }
 
         @ParameterizedTest
@@ -286,7 +286,7 @@ class HsOfficeDebitorRepositoryIntegrationTest extends ContextBasedTestWithClean
 
             // then
             exactlyTheseDebitorsAreReturned(result,
-                    "debitor(D-1000313: rel(anchor='IF Third OHG', type='DEBITOR', holder='IF Third OHG'), thi)");
+                    "debitor(D-1000313: rel(relAnchor='IF Third OHG', relType='ACCOUNTING', relHolder='IF Third OHG'), thi)");
         }
     }
 
@@ -302,7 +302,7 @@ class HsOfficeDebitorRepositoryIntegrationTest extends ContextBasedTestWithClean
             final var result = debitorRepo.findDebitorByOptionalNameLike("third contact");
 
             // then
-            exactlyTheseDebitorsAreReturned(result, "debitor(D-1000313: rel(anchor='IF Third OHG', type='DEBITOR', holder='IF Third OHG'), thi)");
+            exactlyTheseDebitorsAreReturned(result, "debitor(D-1000313: rel(relAnchor='IF Third OHG', relType='ACCOUNTING', relHolder='IF Third OHG'), thi)");
         }
     }
 
@@ -317,7 +317,7 @@ class HsOfficeDebitorRepositoryIntegrationTest extends ContextBasedTestWithClean
 
             assertThatDebitorIsVisibleForUserWithRole(
                     givenDebitor,
-                    "hs_office_relation#FourtheG-with-DEBITOR-FourtheG.admin");
+                    "hs_office_relationship#FourtheG-with-ACCOUNTING-FourtheG.admin");
             final var givenNewPartnerPerson = one(personRepo.findPersonByOptionalNameLike("First"));
             final var givenNewBillingPerson = one(personRepo.findPersonByOptionalNameLike("Firby"));
             final var givenNewContact = one(contactRepo.findContactByOptionalLabelLike("sixth contact"));
@@ -329,10 +329,10 @@ class HsOfficeDebitorRepositoryIntegrationTest extends ContextBasedTestWithClean
             // when
             final var result = jpaAttempt.transacted(() -> {
                 context("superuser-alex@hostsharing.net");
-                givenDebitor.setDebitorRel(HsOfficeRelationEntity.builder()
-                        .type(HsOfficeRelationType.DEBITOR)
-                        .anchor(givenNewPartnerPerson)
-                        .holder(givenNewBillingPerson)
+                givenDebitor.setDebitorRel(HsOfficeRelationshipEntity.builder()
+                        .relType(HsOfficeRelationshipType.ACCOUNTING)
+                        .relAnchor(givenNewPartnerPerson)
+                        .relHolder(givenNewBillingPerson)
                         .contact(givenNewContact)
                         .build());
                 givenDebitor.setRefundBankAccount(givenNewBankAccount);
@@ -351,10 +351,10 @@ class HsOfficeDebitorRepositoryIntegrationTest extends ContextBasedTestWithClean
             // ... partner role was reassigned:
             assertThatDebitorIsNotVisibleForUserWithRole(
                     result.returnedValue(),
-                    "hs_office_relation#FourtheG-with-DEBITOR-FourtheG.admin");
+                    "hs_office_relationship#FourtheG-with-ACCOUNTING-FourtheG.admin");
             assertThatDebitorIsVisibleForUserWithRole(
                     result.returnedValue(),
-                    "hs_office_relation#FirstGmbH-with-DEBITOR-FirbySusan.agent");
+                    "hs_office_relationship#FirstGmbH-with-ACCOUNTING-FirbySusan.agent");
 
             // ... contact role was reassigned:
             assertThatDebitorIsNotVisibleForUserWithRole(
@@ -380,7 +380,7 @@ class HsOfficeDebitorRepositoryIntegrationTest extends ContextBasedTestWithClean
             final var givenDebitor = givenSomeTemporaryDebitor("Fourth", "fifth contact", null, "fig");
             assertThatDebitorIsVisibleForUserWithRole(
                     givenDebitor,
-                    "hs_office_relation#FourtheG-with-DEBITOR-FourtheG.admin");
+                    "hs_office_relationship#FourtheG-with-ACCOUNTING-FourtheG.admin");
             assertThatDebitorActuallyInDatabase(givenDebitor);
             final var givenNewBankAccount = one(bankAccountRepo.findByOptionalHolderLike("first"));
 
@@ -410,7 +410,7 @@ class HsOfficeDebitorRepositoryIntegrationTest extends ContextBasedTestWithClean
             final var givenDebitor = givenSomeTemporaryDebitor("Fourth", "fifth contact", "Fourth", "fih");
             assertThatDebitorIsVisibleForUserWithRole(
                     givenDebitor,
-                    "hs_office_relation#HostsharingeG-with-PARTNER-FourtheG.agent");
+                    "hs_office_relationship#HostsharingeG-with-PARTNER-FourtheG.agent");
             assertThatDebitorActuallyInDatabase(givenDebitor);
 
             // when
@@ -439,12 +439,12 @@ class HsOfficeDebitorRepositoryIntegrationTest extends ContextBasedTestWithClean
             final var givenDebitor = givenSomeTemporaryDebitor("Fourth", "eighth", "Fourth", "eig");
             assertThatDebitorIsVisibleForUserWithRole(
                     givenDebitor,
-                    "hs_office_relation#HostsharingeG-with-PARTNER-FourtheG.agent");
+                    "hs_office_relationship#HostsharingeG-with-PARTNER-FourtheG.agent");
             assertThatDebitorActuallyInDatabase(givenDebitor);
 
             // when
             final var result = jpaAttempt.transacted(() -> {
-                context("superuser-alex@hostsharing.net", "hs_office_relation#HostsharingeG-with-PARTNER-FourtheG.agent");
+                context("superuser-alex@hostsharing.net", "hs_office_relationship#HostsharingeG-with-PARTNER-FourtheG.agent");
                 givenDebitor.setVatId("NEW-VAT-ID");
                 return toCleanup(debitorRepo.save(givenDebitor));
             });
@@ -489,7 +489,7 @@ class HsOfficeDebitorRepositoryIntegrationTest extends ContextBasedTestWithClean
                 if ( saved.getPartner() != null) { // FIXME: check, why there is no partner for the updated contact
                     assertThat(foundEntity.getPartner()).isNotNull();
                 }
-                assertThat(foundEntity.getDebitorRel()).extracting(HsOfficeRelationEntity::toString)
+                assertThat(foundEntity.getDebitorRel()).extracting(HsOfficeRelationshipEntity::toString)
                         .isEqualTo(saved.getDebitorRel().toString());
             });
         }
@@ -545,7 +545,7 @@ class HsOfficeDebitorRepositoryIntegrationTest extends ContextBasedTestWithClean
 
             // when
             final var result = jpaAttempt.transacted(() -> {
-                context("superuser-alex@hostsharing.net", "hs_office_relation#FourtheG-with-DEBITOR-FourtheG.admin");
+                context("superuser-alex@hostsharing.net", "hs_office_relationship#FourtheG-with-ACCOUNTING-FourtheG.admin");
                 assertThat(debitorRepo.findByUuid(givenDebitor.getUuid())).isPresent();
 
                 debitorRepo.deleteByUuid(givenDebitor.getUuid());
@@ -614,10 +614,10 @@ class HsOfficeDebitorRepositoryIntegrationTest extends ContextBasedTestWithClean
                     bankAccountHolder != null ? one(bankAccountRepo.findByOptionalHolderLike(bankAccountHolder)) : null;
             final var newDebitor = HsOfficeDebitorEntity.builder()
                     .debitorNumberSuffix((byte)20)
-                    .debitorRel(HsOfficeRelationEntity.builder()
-                            .type(HsOfficeRelationType.DEBITOR)
-                            .anchor(givenPartnerPerson)
-                            .holder(givenPartnerPerson)
+                    .debitorRel(HsOfficeRelationshipEntity.builder()
+                            .relType(HsOfficeRelationshipType.ACCOUNTING)
+                            .relAnchor(givenPartnerPerson)
+                            .relHolder(givenPartnerPerson)
                             .contact(givenContact)
                             .build())
                     .refundBankAccount(givenBankAccount)

src/test/java/net/hostsharing/hsadminng/hs/office/debitor/TestHsOfficeDebitor.java

@@ -2,7 +2,7 @@ package net.hostsharing.hsadminng.hs.office.debitor;
 
 import lombok.experimental.UtilityClass;
 import net.hostsharing.hsadminng.hs.office.person.HsOfficePersonEntity;
-import net.hostsharing.hsadminng.hs.office.relation.HsOfficeRelationEntity;
+import net.hostsharing.hsadminng.hs.office.relationship.HsOfficeRelationshipEntity;
 
 import static net.hostsharing.hsadminng.hs.office.contact.TestHsOfficeContact.TEST_CONTACT;
 import static net.hostsharing.hsadminng.hs.office.partner.TestHsOfficePartner.TEST_PARTNER;
@@ -14,9 +14,9 @@ public class TestHsOfficeDebitor {
 
     public static final HsOfficeDebitorEntity TEST_DEBITOR = HsOfficeDebitorEntity.builder()
             .debitorNumberSuffix(DEFAULT_DEBITOR_SUFFIX)
-            .debitorRel(HsOfficeRelationEntity.builder()
-                    .holder(HsOfficePersonEntity.builder().build())
-                    .anchor(HsOfficePersonEntity.builder().build())
+            .debitorRel(HsOfficeRelationshipEntity.builder()
+                    .relHolder(HsOfficePersonEntity.builder().build())
+                    .relAnchor(HsOfficePersonEntity.builder().build())
                     .contact(TEST_CONTACT)
                     .build())
             .partner(TEST_PARTNER)

src/test/java/net/hostsharing/hsadminng/hs/office/membership/HsOfficeMembershipControllerAcceptanceTest.java

@@ -269,7 +269,7 @@ class HsOfficeMembershipControllerAcceptanceTest extends ContextBasedTestWithCle
             RestAssured // @formatter:off
                 .given()
                     .header("current-user", "superuser-alex@hostsharing.net")
-                    .header("assumed-roles", "hs_office_relation#HostsharingeG-with-PARTNER-ThirdOHG.agent")
+                    .header("assumed-roles", "hs_office_relationship#HostsharingeG-with-PARTNER-ThirdOHG.agent")
                     .port(port)
                 .when()
                     .get("http://localhost/api/hs/office/memberships/" + givenMembershipUuid)
@@ -338,7 +338,7 @@ class HsOfficeMembershipControllerAcceptanceTest extends ContextBasedTestWithCle
         void partnerRelAgent_canPatchValidityOfRelatedMembership() {
 
             // given
-            final var givenPartnerAgent = "hs_office_relation#HostsharingeG-with-PARTNER-FirstGmbH.agent";
+            final var givenPartnerAgent = "hs_office_relationship#HostsharingeG-with-PARTNER-FirstGmbH.agent";
             context.define("superuser-alex@hostsharing.net", givenPartnerAgent);
             final var givenMembership = givenSomeTemporaryMembershipBessler("First");
 
@@ -401,7 +401,7 @@ class HsOfficeMembershipControllerAcceptanceTest extends ContextBasedTestWithCle
             RestAssured // @formatter:off
                 .given()
                     .header("current-user", "superuser-alex@hostsharing.net")
-                    .header("assumed-roles", "hs_office_relation#HostsharingeG-with-PARTNER-FirstGmbH.agent")
+                    .header("assumed-roles", "hs_office_relationship#HostsharingeG-with-PARTNER-FirstGmbH.agent")
                     .port(port)
                 .when()
                     .delete("http://localhost/api/hs/office/memberships/" + givenMembership.getUuid())

src/test/java/net/hostsharing/hsadminng/hs/office/membership/HsOfficeMembershipRepositoryIntegrationTest.java

@@ -126,16 +126,16 @@ class HsOfficeMembershipRepositoryIntegrationTest extends ContextBasedTestWithCl
                             // admin
                             "{ grant perm UPDATE on membership#M-1000117 to role membership#M-1000117.admin by system and assume }",
                             "{ grant role membership#M-1000117.admin to role membership#M-1000117.owner by system and assume }",
-                            "{ grant role membership#M-1000117.owner to role relation#HostsharingeG-with-PARTNER-FirstGmbH.admin by system and assume }",
+                            "{ grant role membership#M-1000117.owner to role relationship#HostsharingeG-with-PARTNER-FirstGmbH.admin by system and assume }",
                             "{ grant role membership#M-1000117.owner to user superuser-alex@hostsharing.net by membership#M-1000117.owner and assume }",
 
                             // agent
-                            "{ grant role membership#M-1000117.admin to role relation#HostsharingeG-with-PARTNER-FirstGmbH.agent by system and assume }",
+                            "{ grant role membership#M-1000117.admin to role relationship#HostsharingeG-with-PARTNER-FirstGmbH.agent by system and assume }",
 
                             // referrer
                             "{ grant perm SELECT on membership#M-1000117 to role membership#M-1000117.referrer by system and assume }",
                             "{ grant role membership#M-1000117.referrer to role membership#M-1000117.admin by system and assume }",
-                            "{ grant role relation#HostsharingeG-with-PARTNER-FirstGmbH.tenant to role membership#M-1000117.referrer by system and assume }",
+                            "{ grant role relationship#HostsharingeG-with-PARTNER-FirstGmbH.tenant to role membership#M-1000117.referrer by system and assume }",
 
                             null));
         }
@@ -294,7 +294,7 @@ class HsOfficeMembershipRepositoryIntegrationTest extends ContextBasedTestWithCl
 
             // when
             final var result = jpaAttempt.transacted(() -> {
-                context("superuser-alex@hostsharing.net", "hs_office_relation#HostsharingeG-with-PARTNER-FirstGmbH.agent");
+                context("superuser-alex@hostsharing.net", "hs_office_relationship#HostsharingeG-with-PARTNER-FirstGmbH.agent");
                 assertThat(membershipRepo.findByUuid(givenMembership.getUuid())).isPresent();
 
                 membershipRepo.deleteByUuid(givenMembership.getUuid());

src/test/java/net/hostsharing/hsadminng/hs/office/migration/ImportOfficeData.java

@@ -18,8 +18,8 @@ import net.hostsharing.hsadminng.hs.office.partner.HsOfficePartnerDetailsEntity;
 import net.hostsharing.hsadminng.hs.office.partner.HsOfficePartnerEntity;
 import net.hostsharing.hsadminng.hs.office.person.HsOfficePersonEntity;
 import net.hostsharing.hsadminng.hs.office.person.HsOfficePersonType;
-import net.hostsharing.hsadminng.hs.office.relation.HsOfficeRelationEntity;
-import net.hostsharing.hsadminng.hs.office.relation.HsOfficeRelationType;
+import net.hostsharing.hsadminng.hs.office.relationship.HsOfficeRelationshipEntity;
+import net.hostsharing.hsadminng.hs.office.relationship.HsOfficeRelationshipType;
 import net.hostsharing.hsadminng.hs.office.sepamandate.HsOfficeSepaMandateEntity;
 import net.hostsharing.hsadminng.rbac.rbacobject.RbacObject;
 import net.hostsharing.test.JpaAttempt;
@@ -127,7 +127,7 @@ public class ImportOfficeData extends ContextBasedTest {
             new String[]{"partner", "vip-contact", "ex-partner", "billing", "contractual", "operation"},
             SUBSCRIBER_ROLES);
 
-    static int relationId = 2000000;
+    static int relationshipId = 2000000;
 
     @Value("${spring.datasource.url}")
     private String jdbcUrl;
@@ -144,7 +144,7 @@ public class ImportOfficeData extends ContextBasedTest {
     private static Map<Integer, HsOfficeDebitorEntity> debitors = new WriteOnceMap<>();
     private static Map<Integer, HsOfficeMembershipEntity> memberships = new WriteOnceMap<>();
 
-    private static Map<Integer, HsOfficeRelationEntity> relations = new WriteOnceMap<>();
+    private static Map<Integer, HsOfficeRelationshipEntity> relationships = new WriteOnceMap<>();
     private static Map<Integer, HsOfficeSepaMandateEntity> sepaMandates = new WriteOnceMap<>();
     private static Map<Integer, HsOfficeBankAccountEntity> bankAccounts = new WriteOnceMap<>();
     private static Map<Integer, HsOfficeCoopSharesTransactionEntity> coopShares = new WriteOnceMap<>();
@@ -161,7 +161,6 @@ public class ImportOfficeData extends ContextBasedTest {
 
     @MockBean
     HttpServletRequest request;
-
     @Test
     @Order(1010)
     void importBusinessPartners() {
@@ -175,7 +174,7 @@ public class ImportOfficeData extends ContextBasedTest {
     }
 
     @Test
-    @Order(1019)
+    @Order(1011)
     void verifyBusinessPartners() {
         assumeThatWeAreImportingControlledTestData();
 
@@ -191,17 +190,17 @@ public class ImportOfficeData extends ContextBasedTest {
         assertThat(toFormattedString(contacts)).isEqualTo("{}");
         assertThat(toFormattedString(debitors)).isEqualToIgnoringWhitespace("""
                 {
-                    17=debitor(D-1001700: rel(anchor='null null, null', type='DEBITOR', holder='null null, null'), mih),
-                    20=debitor(D-1002000: rel(anchor='null null, null', type='DEBITOR', holder='null null, null'), xyz),
-                    22=debitor(D-1102200: rel(anchor='null null, null', type='DEBITOR', holder='null null, null'), xxx),
-                    99=debitor(D-1999900: rel(anchor='null null, null', type='DEBITOR', holder='null null, null'), zzz)
+                    17=debitor(D-1001700: P-10017, mih),
+                    20=debitor(D-1002000: P-10020, xyz),
+                    22=debitor(D-1102200: P-11022, xxx),
+                    99=debitor(D-1999900: P-19999, zzz)
                 }
                 """);
         assertThat(toFormattedString(memberships)).isEqualToIgnoringWhitespace("""
                 {
-                    17=Membership(M-1001700, P-10017, [2000-12-06,), NONE),
-                    20=Membership(M-1002000, P-10020, [2000-12-06,2016-01-01), UNKNOWN),
-                    22=Membership(M-1102200, P-11022, [2021-04-01,), NONE)
+                    17=Membership(M-1001700, P-10017, D-1001700, [2000-12-06,), NONE),
+                    20=Membership(M-1002000, P-10020, D-1002000, [2000-12-06,2016-01-01), UNKNOWN),
+                    22=Membership(M-1102200, P-11022, D-1102200, [2021-04-01,), NONE)
                 }
                 """);
     }
@@ -220,23 +219,6 @@ public class ImportOfficeData extends ContextBasedTest {
 
     @Test
     @Order(1021)
-    void buildDebitorRelations() {
-        debitors.forEach( (id, debitor) -> {
-            final var debitorRel = HsOfficeRelationEntity.builder()
-                    .type(HsOfficeRelationType.DEBITOR)
-                    .anchor(debitor.getPartner().getPartnerRel().getHolder())
-                    .holder(debitor.getPartner().getPartnerRel().getHolder()) //  just 1 debitor/partner in legacy hsadmin
-                    // FIXME .contact()
-                    .build();
-            if (debitorRel.getAnchor() != null && debitorRel.getHolder() != null &&
-                    debitorRel.getContact() != null ) {
-                relations.put(relationId++, debitorRel);
-            }
-        });
-    }
-
-    @Test
-    @Order(1029)
     void verifyContacts() {
         assumeThatWeAreImportingControlledTestData();
 
@@ -275,42 +257,38 @@ public class ImportOfficeData extends ContextBasedTest {
                 """);
         assertThat(toFormattedString(debitors)).isEqualToIgnoringWhitespace("""
                 {
-                    17=debitor(D-1001700: rel(anchor='NP Mellies, Michael', type='DEBITOR', holder='NP Mellies, Michael'), mih),
-                    20=debitor(D-1002000: rel(anchor='LP JM GmbH', type='DEBITOR', holder='LP JM GmbH'), xyz),
-                    22=debitor(D-1102200: rel(anchor='?? Test PS', type='DEBITOR', holder='?? Test PS'), xxx),
-                    99=debitor(D-1999900: rel(anchor='null null, null', type='DEBITOR', holder='null null, null'), zzz)
+                    17=debitor(D-1001700: P-10017, mih),
+                    20=debitor(D-1002000: P-10020, xyz),
+                    22=debitor(D-1102200: P-11022, xxx),
+                    99=debitor(D-1999900: P-19999, zzz)
                 }
                 """);
         assertThat(toFormattedString(memberships)).isEqualToIgnoringWhitespace("""
                 {
-                    17=Membership(M-1001700, P-10017, [2000-12-06,), NONE),
-                    20=Membership(M-1002000, P-10020, [2000-12-06,2016-01-01), UNKNOWN),
-                    22=Membership(M-1102200, P-11022, [2021-04-01,), NONE)
+                    17=Membership(M-1001700, P-10017, D-1001700, [2000-12-06,), NONE),
+                    20=Membership(M-1002000, P-10020, D-1002000, [2000-12-06,2016-01-01), UNKNOWN),
+                    22=Membership(M-1102200, P-11022, D-1102200, [2021-04-01,), NONE)
                 }
                 """);
-        assertThat(toFormattedString(relations)).isEqualToIgnoringWhitespace("""
+        assertThat(toFormattedString(relationships)).isEqualToIgnoringWhitespace("""
                 {
-                    2000000=rel(anchor='LP Hostsharing eG', type='PARTNER', holder='NP Mellies, Michael', contact='Herr Michael Mellies '),
-                    2000001=rel(anchor='NP Mellies, Michael', type='DEBITOR', holder='NP Mellies, Michael', contact='Herr Michael Mellies '),
-                    2000002=rel(anchor='LP Hostsharing eG', type='PARTNER', holder='LP JM GmbH', contact='Herr Philip Meyer-Contract , JM GmbH'),
-                    2000003=rel(anchor='LP JM GmbH', type='DEBITOR', holder='LP JM GmbH', contact='Frau Dr. Jenny Meyer-Billing , JM GmbH'),
-                    2000004=rel(anchor='LP Hostsharing eG', type='PARTNER', holder='?? Test PS', contact='Petra Schmidt , Test PS'),
-                    2000005=rel(anchor='?? Test PS', type='DEBITOR', holder='?? Test PS', contact='Petra Schmidt , Test PS'),
-                    2000006=rel(anchor='LP Hostsharing eG', type='PARTNER', holder='null null, null'),
-                    2000007=rel(anchor='null null, null', type='DEBITOR', holder='null null, null'),
-                    2000008=rel(anchor='NP Mellies, Michael', type='OPERATIONS', holder='NP Mellies, Michael', contact='Herr Michael Mellies '),
-                    2000009=rel(anchor='NP Mellies, Michael', type='REPRESENTATIVE', holder='NP Mellies, Michael', contact='Herr Michael Mellies '),
-                    2000010=rel(anchor='LP JM GmbH', type='EX_PARTNER', holder='LP JM e.K.', contact='JM e.K.'),
-                    2000011=rel(anchor='LP JM GmbH', type='OPERATIONS', holder='LP JM GmbH', contact='Herr Andrew Meyer-Operation , JM GmbH'),
-                    2000012=rel(anchor='LP JM GmbH', type='VIP_CONTACT', holder='LP JM GmbH', contact='Herr Andrew Meyer-Operation , JM GmbH'),
-                    2000013=rel(anchor='LP JM GmbH', type='SUBSCRIBER', mark='operations-announce', holder='LP JM GmbH', contact='Herr Andrew Meyer-Operation , JM GmbH'),
-                    2000014=rel(anchor='LP JM GmbH', type='REPRESENTATIVE', holder='LP JM GmbH', contact='Herr Philip Meyer-Contract , JM GmbH'),
-                    2000015=rel(anchor='LP JM GmbH', type='SUBSCRIBER', mark='members-announce', holder='LP JM GmbH', contact='Herr Philip Meyer-Contract , JM GmbH'),
-                    2000016=rel(anchor='LP JM GmbH', type='SUBSCRIBER', mark='customers-announce', holder='LP JM GmbH', contact='Herr Philip Meyer-Contract , JM GmbH'),
-                    2000017=rel(anchor='LP JM GmbH', type='VIP_CONTACT', holder='LP JM GmbH', contact='Frau Tammy Meyer-VIP , JM GmbH'),
-                    2000018=rel(anchor='?? Test PS', type='OPERATIONS', holder='?? Test PS', contact='Petra Schmidt , Test PS'),
-                    2000019=rel(anchor='?? Test PS', type='REPRESENTATIVE', holder='?? Test PS', contact='Petra Schmidt , Test PS'),
-                    2000020=rel(anchor='NP Mellies, Michael', type='SUBSCRIBER', mark='operations-announce', holder='NP Fanninga, Frauke', contact='Frau Frauke Fanninga ')
+                    2000000=rel(relAnchor='LP Hostsharing eG', relType='PARTNER', relHolder='NP Mellies, Michael', contact='Herr Michael Mellies '),
+                    2000001=rel(relAnchor='LP Hostsharing eG', relType='PARTNER', relHolder='LP JM GmbH', contact='Herr Philip Meyer-Contract , JM GmbH'),
+                    2000002=rel(relAnchor='LP Hostsharing eG', relType='PARTNER', relHolder='?? Test PS', contact='Petra Schmidt , Test PS'),
+                    2000003=rel(relAnchor='LP Hostsharing eG', relType='PARTNER', relHolder='null null, null'),
+                    2000004=rel(relAnchor='NP Mellies, Michael', relType='OPERATIONS', relHolder='NP Mellies, Michael', contact='Herr Michael Mellies '),
+                    2000005=rel(relAnchor='NP Mellies, Michael', relType='REPRESENTATIVE', relHolder='NP Mellies, Michael', contact='Herr Michael Mellies '),
+                    2000006=rel(relAnchor='LP JM GmbH', relType='EX_PARTNER', relHolder='LP JM e.K.', contact='JM e.K.'),
+                    2000007=rel(relAnchor='LP JM GmbH', relType='OPERATIONS', relHolder='LP JM GmbH', contact='Herr Andrew Meyer-Operation , JM GmbH'),
+                    2000008=rel(relAnchor='LP JM GmbH', relType='VIP_CONTACT', relHolder='LP JM GmbH', contact='Herr Andrew Meyer-Operation , JM GmbH'),
+                    2000009=rel(relAnchor='LP JM GmbH', relType='SUBSCRIBER', relMark='operations-announce', relHolder='LP JM GmbH', contact='Herr Andrew Meyer-Operation , JM GmbH'),
+                    2000010=rel(relAnchor='LP JM GmbH', relType='REPRESENTATIVE', relHolder='LP JM GmbH', contact='Herr Philip Meyer-Contract , JM GmbH'),
+                    2000011=rel(relAnchor='LP JM GmbH', relType='SUBSCRIBER', relMark='members-announce', relHolder='LP JM GmbH', contact='Herr Philip Meyer-Contract , JM GmbH'),
+                    2000012=rel(relAnchor='LP JM GmbH', relType='SUBSCRIBER', relMark='customers-announce', relHolder='LP JM GmbH', contact='Herr Philip Meyer-Contract , JM GmbH'),
+                    2000013=rel(relAnchor='LP JM GmbH', relType='VIP_CONTACT', relHolder='LP JM GmbH', contact='Frau Tammy Meyer-VIP , JM GmbH'),
+                    2000014=rel(relAnchor='?? Test PS', relType='OPERATIONS', relHolder='?? Test PS', contact='Petra Schmidt , Test PS'),
+                    2000015=rel(relAnchor='?? Test PS', relType='REPRESENTATIVE', relHolder='?? Test PS', contact='Petra Schmidt , Test PS'),
+                    2000016=rel(relAnchor='NP Mellies, Michael', relType='SUBSCRIBER', relMark='operations-announce', relHolder='NP Fanninga, Frauke', contact='Frau Frauke Fanninga ')
                 }
                 """);
     }
@@ -328,7 +306,7 @@ public class ImportOfficeData extends ContextBasedTest {
     }
 
     @Test
-    @Order(1039)
+    @Order(1031)
     void verifySepaMandates() {
         assumeThatWeAreImportingControlledTestData();
 
@@ -387,7 +365,7 @@ public class ImportOfficeData extends ContextBasedTest {
     }
 
     @Test
-    @Order(1059)
+    @Order(1051)
     void verifyCoopAssets() {
         assumeThatWeAreImportingControlledTestData();
 
@@ -407,35 +385,35 @@ public class ImportOfficeData extends ContextBasedTest {
 
     @Test
     @Order(2000)
-    void verifyAllPartnersHavePersons() {
+    void verifyAllPartnersHaveProperPartnerRoles() {
         partners.forEach((id, p) -> {
-            final var partnerRel = p.getPartnerRel();
-            assertThat(partnerRel).describedAs("partner " + id + " without partnerRel").isNotNull();
+            final var partnerRole = p.getPartnerRole();
+            assertThat(partnerRole).describedAs("partner " + id + " without partnerRole").isNotNull();
             if ( id != 99 ) {
-                assertThat(partnerRel.getContact()).describedAs("partner " + id + " without partnerRel.contact").isNotNull();
-                assertThat(partnerRel.getContact().getLabel()).describedAs("partner " + id + " without valid partnerRel.contact").isNotNull();
-                assertThat(partnerRel.getHolder()).describedAs("partner " + id + " without partnerRel.relHolder").isNotNull();
-                assertThat(partnerRel.getHolder().getPersonType()).describedAs("partner " + id + " without valid partnerRel.relHolder").isNotNull();
+                assertThat(partnerRole.getContact()).describedAs("partner " + id + " without partnerRole.contact").isNotNull();
+                assertThat(partnerRole.getContact().getLabel()).describedAs("partner " + id + " without valid partnerRole.contact").isNotNull();
+                assertThat(partnerRole.getRelHolder()).describedAs("partner " + id + " without partnerRole.relHolder").isNotNull();
+                assertThat(partnerRole.getRelHolder().getPersonType()).describedAs("partner " + id + " without valid partnerRole.relHolder").isNotNull();
             }
         });
     }
 
     @Test
-    @Order(2009)
-    void removeEmptyRelations() {
+    @Order(2001)
+    void removeEmptyRelationships() {
         assumeThatWeAreImportingControlledTestData();
 
         // avoid a error when persisting the deliberetely invalid partner entry #99
         final var idsToRemove = new HashSet<Integer>();
-        relations.forEach( (id, r) -> {
+        relationships.forEach( (id, r) -> {
             // such a record
             if (r.getContact() == null || r.getContact().getLabel() == null ||
-               r.getHolder() == null || r.getHolder().getPersonType() == null ) {
+               r.getRelHolder() == null | r.getRelHolder().getPersonType() == null ) {
                 idsToRemove.add(id);
             }
         });
-        assertThat(idsToRemove.size()).isEqualTo(2); // partner #99 + Hostsharing eG itself
-        idsToRemove.forEach(id -> relations.remove(id));
+        assertThat(idsToRemove.size()).isEqualTo(1); // only from partner #99 (partner+contractual roles)
+        idsToRemove.forEach(id -> relationships.remove(id));
     }
 
     @Test
@@ -446,11 +424,11 @@ public class ImportOfficeData extends ContextBasedTest {
         // avoid a error when persisting the deliberately invalid partner entry #99
         final var idsToRemove = new HashSet<Integer>();
         partners.forEach( (id, r) -> {
-            final var partnerRole = r.getPartnerRel();
+            final var partnerRole = r.getPartnerRole();
 
             // such a record is in test data to test error messages
             if (partnerRole.getContact() == null || partnerRole.getContact().getLabel() == null ||
-                    partnerRole.getHolder() == null | partnerRole.getHolder().getPersonType() == null ) {
+                    partnerRole.getRelHolder() == null | partnerRole.getRelHolder().getPersonType() == null ) {
                 idsToRemove.add(id);
             }
         });
@@ -466,10 +444,8 @@ public class ImportOfficeData extends ContextBasedTest {
         // avoid a error when persisting the deliberately invalid partner entry #99
         final var idsToRemove = new HashSet<Integer>();
         debitors.forEach( (id, d) -> {
-            final var debitorRel = d.getDebitorRel();
-            if (debitorRel.getContact() == null || debitorRel.getContact().getLabel() == null ||
-                    debitorRel.getAnchor() == null || debitorRel.getAnchor().getPersonType() == null ||
-                    debitorRel.getHolder() == null || debitorRel.getHolder().getPersonType() == null ) {
+            // such a record is in test data to test error messages
+            if (false) { // TODO: how can I now empty debitors?
                 idsToRemove.add(id);
             }
         });
@@ -478,6 +454,7 @@ public class ImportOfficeData extends ContextBasedTest {
     }
 
     @Test
+    @Disabled
     @Order(3000)
     @Commit
     void persistEntities() {
@@ -501,7 +478,7 @@ public class ImportOfficeData extends ContextBasedTest {
 
         jpaAttempt.transacted(() -> {
             context(rbacSuperuser);
-            relations.forEach(this::persist);
+            relationships.forEach(this::persist);
         }).assertSuccessful();
 
         jpaAttempt.transacted(() -> {
@@ -578,7 +555,7 @@ public class ImportOfficeData extends ContextBasedTest {
             em.createNativeQuery("delete from hs_office_bankaccount where true").executeUpdate();
             em.createNativeQuery("delete from hs_office_partner where true").executeUpdate();
             em.createNativeQuery("delete from hs_office_partner_details where true").executeUpdate();
-            em.createNativeQuery("delete from hs_office_relation where true").executeUpdate();
+            em.createNativeQuery("delete from hs_office_relationship where true").executeUpdate();
             em.createNativeQuery("delete from hs_office_contact where true").executeUpdate();
             em.createNativeQuery("delete from hs_office_person where true").executeUpdate();
         }).assertSuccessful();
@@ -682,32 +659,30 @@ public class ImportOfficeData extends ContextBasedTest {
                 .forEach(rec -> {
                     final var person = HsOfficePersonEntity.builder().build();
 
-                    final var partnerRel = HsOfficeRelationEntity.builder()
-                            .holder(person)
-                            .type(HsOfficeRelationType.PARTNER)
-                            .anchor(mandant)
+                    final var partnerRelationship = HsOfficeRelationshipEntity.builder()
+                            .relHolder(person)
+                            .relType(HsOfficeRelationshipType.PARTNER)
+                            .relAnchor(mandant)
                             .contact(null) // is set during contacts import depending on assigned roles
                             .build();
-                    relations.put(relationId++, partnerRel);
+                    relationships.put(relationshipId++, partnerRelationship);
 
                     final var partner = HsOfficePartnerEntity.builder()
                             .partnerNumber(rec.getInteger("member_id"))
                             .details(HsOfficePartnerDetailsEntity.builder().build())
-                            .partnerRel(partnerRel)
+                            .partnerRole(partnerRelationship)
                             .build();
                     partners.put(rec.getInteger("bp_id"), partner);
 
-                    final var debitorRel = HsOfficeRelationEntity.builder()
-                            .type(HsOfficeRelationType.DEBITOR)
-                            .anchor(partnerRel.getHolder())
-                            .holder(partnerRel.getHolder()) // currently debitor = partner
-                            .build();
-                    relations.put(relationId++, debitorRel);
-
                     final var debitor = HsOfficeDebitorEntity.builder()
                             .debitorNumberSuffix((byte) 0)
-                            .partner(partner)
-                            .debitorRel(debitorRel)
+                            .debitorRel(
+                                    HsOfficeRelationshipEntity.builder()
+                                            .relType(HsOfficeRelationshipType.ACCOUNTING)
+                                            .relAnchor(partnerRelationship.getRelHolder())
+                                            .relHolder(null) // gets set later
+                                            .build()
+                            )
                             .defaultPrefix(rec.getString("member_code").replace("hsh00-", ""))
                             .billable(rec.isEmpty("free") || rec.getString("free").equals("f"))
                             .vatReverseCharge(rec.getBoolean("exempt_vat"))
@@ -854,8 +829,8 @@ public class ImportOfficeData extends ContextBasedTest {
                     final var partner = partners.get(bpId);
                     final var debitor = debitors.get(bpId);
 
-                    final var partnerPerson = partner.getPartnerRel().getHolder();
-                    if (containsPartnerRel(rec)) {
+                    final var partnerPerson = partner.getPartnerRole().getRelHolder();
+                    if (containsPartnerRole(rec)) {
                         initPerson(partnerPerson, rec);
                     }
 
@@ -869,45 +844,45 @@ public class ImportOfficeData extends ContextBasedTest {
                     final var contact = HsOfficeContactEntity.builder().build();
                     initContact(contact, rec);
 
-                    if (containsPartnerRel(rec)) {
-                        assertThat(partner.getPartnerRel().getContact()).isNull();
-                        partner.getPartnerRel().setContact(contact);
+                    if (containsPartnerRole(rec)) {
+                        assertThat(partner.getPartnerRole().getContact()).isNull();
+                        partner.getPartnerRole().setContact(contact);
                     }
                     if (containsRole(rec, "billing")) {
                         assertThat(debitor.getDebitorRel().getContact()).isNull();
                         debitor.getDebitorRel().setContact(contact);
                     }
                     if (containsRole(rec, "operation")) {
-                        addRelation(partnerPerson, contactPerson, contact, HsOfficeRelationType.OPERATIONS);
+                        addRelationship(partnerPerson, contactPerson, contact, HsOfficeRelationshipType.OPERATIONS);
                     }
                     if (containsRole(rec, "contractual")) {
-                        addRelation(partnerPerson, contactPerson, contact, HsOfficeRelationType.REPRESENTATIVE);
+                        addRelationship(partnerPerson, contactPerson, contact, HsOfficeRelationshipType.REPRESENTATIVE);
                     }
                     if (containsRole(rec, "ex-partner")) {
-                        addRelation(partnerPerson, contactPerson, contact, HsOfficeRelationType.EX_PARTNER);
+                        addRelationship(partnerPerson, contactPerson, contact, HsOfficeRelationshipType.EX_PARTNER);
                     }
                     if (containsRole(rec, "vip-contact")) {
-                        addRelation(partnerPerson, contactPerson, contact, HsOfficeRelationType.VIP_CONTACT);
+                        addRelationship(partnerPerson, contactPerson, contact, HsOfficeRelationshipType.VIP_CONTACT);
                     }
                     for (String subscriberRole: SUBSCRIBER_ROLES) {
                         if (containsRole(rec, subscriberRole)) {
-                            addRelation(partnerPerson, contactPerson, contact, HsOfficeRelationType.SUBSCRIBER)
-                                    .setMark(subscriberRole.split(":")[1])
+                            addRelationship(partnerPerson, contactPerson, contact, HsOfficeRelationshipType.SUBSCRIBER)
+                                    .setRelMark(subscriberRole.split(":")[1])
                             ;
                         }
                     }
                     verifyContainsOnlyKnownRoles(rec.getString("roles"));
                 });
 
-        optionallyAddMissingContractualRelations();
+        optionallyAddMissingContractualRelationships();
     }
 
-    private static void optionallyAddMissingContractualRelations() {
+    private static void optionallyAddMissingContractualRelationships() {
         final var contractualMissing = new HashSet<Integer>();
         partners.forEach( (id, partner) -> {
-            final var partnerPerson = partner.getPartnerRel().getHolder();
-            if (relations.values().stream()
-                    .filter(rel -> rel.getAnchor() == partnerPerson && rel.getType() == HsOfficeRelationType.REPRESENTATIVE)
+            final var partnerPerson = partner.getPartnerRole().getRelHolder();
+            if (relationships.values().stream()
+                    .filter(rel -> rel.getRelAnchor() == partnerPerson && rel.getRelType() == HsOfficeRelationshipType.REPRESENTATIVE)
                     .findFirst().isEmpty()) {
                 contractualMissing.add(partner.getPartnerNumber());
             }
@@ -918,23 +893,22 @@ public class ImportOfficeData extends ContextBasedTest {
         final var roles = rec.getString("roles");
         return ("," + roles + ",").contains("," + role + ",");
     }
-
-    private static boolean containsPartnerRel(final Record rec) {
+    private static boolean containsPartnerRole(final Record rec) {
         return containsRole(rec, "partner");
     }
 
-    private static HsOfficeRelationEntity addRelation(
+    private static HsOfficeRelationshipEntity addRelationship(
             final HsOfficePersonEntity partnerPerson,
             final HsOfficePersonEntity contactPerson,
             final HsOfficeContactEntity contact,
-            final HsOfficeRelationType representative) {
-        final var rel = HsOfficeRelationEntity.builder()
-                .anchor(partnerPerson)
-                .holder(contactPerson)
+            final HsOfficeRelationshipType representative) {
+        final var rel = HsOfficeRelationshipEntity.builder()
+                .relAnchor(partnerPerson)
+                .relHolder(contactPerson)
                 .contact(contact)
-                .type(representative)
+                .relType(representative)
                 .build();
-        relations.put(relationId++, rel);
+        relationships.put(relationshipId++, rel);
         return rel;
     }
 

src/test/java/net/hostsharing/hsadminng/hs/office/partner/HsOfficePartnerControllerAcceptanceTest.java

@@ -7,9 +7,9 @@ import net.hostsharing.hsadminng.hs.office.contact.HsOfficeContactEntity;
 import net.hostsharing.hsadminng.hs.office.contact.HsOfficeContactRepository;
 import net.hostsharing.hsadminng.hs.office.person.HsOfficePersonEntity;
 import net.hostsharing.hsadminng.hs.office.person.HsOfficePersonRepository;
-import net.hostsharing.hsadminng.hs.office.relation.HsOfficeRelationEntity;
-import net.hostsharing.hsadminng.hs.office.relation.HsOfficeRelationRepository;
-import net.hostsharing.hsadminng.hs.office.relation.HsOfficeRelationType;
+import net.hostsharing.hsadminng.hs.office.relationship.HsOfficeRelationshipEntity;
+import net.hostsharing.hsadminng.hs.office.relationship.HsOfficeRelationshipRepository;
+import net.hostsharing.hsadminng.hs.office.relationship.HsOfficeRelationshipType;
 import net.hostsharing.hsadminng.hs.office.test.ContextBasedTestWithCleanup;
 import net.hostsharing.test.Accepts;
 import net.hostsharing.test.JpaAttempt;
@@ -41,7 +41,7 @@ class HsOfficePartnerControllerAcceptanceTest extends ContextBasedTestWithCleanu
     HsOfficePartnerRepository partnerRepo;
 
     @Autowired
-    HsOfficeRelationRepository relationRepository;
+    HsOfficeRelationshipRepository relationshipRepository;
 
     @Autowired
     HsOfficePersonRepository personRepo;
@@ -102,9 +102,9 @@ class HsOfficePartnerControllerAcceptanceTest extends ContextBasedTestWithCleanu
                         .body("""
                             {
                                 "partnerNumber": "20002",
-                                "partnerRel": {
-                                     "anchorUuid": "%s",
-                                     "holderUuid": "%s",
+                                "partnerRole": {
+                                     "relAnchorUuid": "%s",
+                                     "relHolderUuid": "%s",
                                      "contactUuid": "%s"
                                 },
                                 "details": {
@@ -125,11 +125,11 @@ class HsOfficePartnerControllerAcceptanceTest extends ContextBasedTestWithCleanu
                         .body("", lenientlyEquals("""
                         {
                             "partnerNumber": 20002,
-                            "partnerRel": {
-                                "anchor": { "tradeName": "Hostsharing eG" },
-                                "holder": { "tradeName": "Third OHG" },
-                                "type": "PARTNER",
-                                "mark": null,
+                            "partnerRole": {
+                                "relAnchor": { "tradeName": "Hostsharing eG" },
+                                "relHolder": { "tradeName": "Third OHG" },
+                                "relType": "PARTNER",
+                                "relMark": null,
                                 "contact": { "label": "fourth contact" }
                             },
                             "details": {
@@ -161,9 +161,9 @@ class HsOfficePartnerControllerAcceptanceTest extends ContextBasedTestWithCleanu
                     .body("""
                             {
                                 "partnerNumber": "20003",
-                                "partnerRel": {
-                                     "anchorUuid": "%s",
-                                     "holderUuid": "%s",
+                                "partnerRole": {
+                                     "relAnchorUuid": "%s",
+                                     "relHolderUuid": "%s",
                                      "contactUuid": "%s"
                                 },
                                 "personUuid": "%s",
@@ -199,9 +199,9 @@ class HsOfficePartnerControllerAcceptanceTest extends ContextBasedTestWithCleanu
                     .body("""
                             {
                                 "partnerNumber": "20004",
-                                "partnerRel": {
-                                    "anchorUuid": "%s",
-                                    "holderUuid": "%s",
+                                "partnerRole": {
+                                    "relAnchorUuid": "%s",
+                                    "relHolderUuid": "%s",
                                     "contactUuid": "%s"
                                 },
                                 "personUuid": "%s",
@@ -247,10 +247,10 @@ class HsOfficePartnerControllerAcceptanceTest extends ContextBasedTestWithCleanu
                     .body("", lenientlyEquals("""
                     {
                         "partnerNumber": 10001,
-                             "partnerRel": {
-                                 "anchor": { "tradeName": "Hostsharing eG" },
-                                 "holder": { "tradeName": "First GmbH" },
-                                 "type": "PARTNER",
+                             "partnerRole": {
+                                 "relAnchor": { "tradeName": "Hostsharing eG" },
+                                 "relHolder": { "tradeName": "First GmbH" },
+                                 "relType": "PARTNER",
                                  "contact": { "label": "first contact" }
                              },
                              "details": {
@@ -295,8 +295,8 @@ class HsOfficePartnerControllerAcceptanceTest extends ContextBasedTestWithCleanu
                     .contentType("application/json")
                     .body("", lenientlyEquals("""
                     {
-                        "partnerRel": {
-                            "holder": { "tradeName": "First GmbH" },
+                        "partnerRole": {
+                            "relHolder": { "tradeName": "First GmbH" },
                             "contact": { "label": "first contact" }
                         }
                     }
@@ -323,7 +323,7 @@ class HsOfficePartnerControllerAcceptanceTest extends ContextBasedTestWithCleanu
                     .body("""
                            {
                                "partnerNumber": "20011",
-                               "partnerRelUuid": "%s",
+                               "partnerRoleUuid": "%s",
                                "details": {
                                    "registrationOffice": "Temp Registergericht Aurich",
                                    "registrationNumber": "222222",
@@ -342,10 +342,10 @@ class HsOfficePartnerControllerAcceptanceTest extends ContextBasedTestWithCleanu
                     .body("", lenientlyEquals("""
                     {
                         "partnerNumber": 20011,
-                        "partnerRel": {
-                            "anchor": { "tradeName": "Hostsharing eG" },
-                            "holder": { "tradeName": "Third OHG" },
-                            "type": "PARTNER",
+                        "partnerRole": {
+                            "relAnchor": { "tradeName": "Hostsharing eG" },
+                            "relHolder": { "tradeName": "Third OHG" },
+                            "relType": "PARTNER",
                             "contact": { "label": "third contact" }
                         },
                         "details": {
@@ -365,8 +365,8 @@ class HsOfficePartnerControllerAcceptanceTest extends ContextBasedTestWithCleanu
             assertThat(partnerRepo.findByUuid(givenPartner.getUuid())).isPresent().get()
                     .matches(partner -> {
                         assertThat(partner.getPartnerNumber()).isEqualTo(givenPartner.getPartnerNumber());
-                        assertThat(partner.getPartnerRel().getHolder().getTradeName()).isEqualTo("Third OHG");
-                        assertThat(partner.getPartnerRel().getContact().getLabel()).isEqualTo("third contact");
+                        assertThat(partner.getPartnerRole().getRelHolder().getTradeName()).isEqualTo("Third OHG");
+                        assertThat(partner.getPartnerRole().getContact().getLabel()).isEqualTo("third contact");
                         assertThat(partner.getDetails().getRegistrationOffice()).isEqualTo("Temp Registergericht Aurich");
                         assertThat(partner.getDetails().getRegistrationNumber()).isEqualTo("222222");
                         assertThat(partner.getDetails().getBirthName()).isEqualTo("Maja Schmidt");
@@ -403,7 +403,7 @@ class HsOfficePartnerControllerAcceptanceTest extends ContextBasedTestWithCleanu
                     .contentType(ContentType.JSON)
                     .body("uuid", isUuidValid())
                     .body("details.birthName", is("Maja Schmidt"));
-            // TODO: assert partnerRel
+            // TODO: assert partnerRole
 //                    .body("contact.label", is(givenPartner.getContact().getLabel()))
 //                    .body("person.tradeName", is(givenPartner.getPerson().getTradeName()));
             // @formatter:on
@@ -411,7 +411,7 @@ class HsOfficePartnerControllerAcceptanceTest extends ContextBasedTestWithCleanu
             // finally, the partner is actually updated
             assertThat(partnerRepo.findByUuid(givenPartner.getUuid())).isPresent().get()
                     .matches(person -> {
-                        // TODO: assert partnerRel
+                        // TODO: assert partnerRole
 //                        assertThat(person.getPerson().getTradeName()).isEqualTo(givenPartner.getPerson().getTradeName());
 //                        assertThat(person.getContact().getLabel()).isEqualTo(givenPartner.getContact().getLabel());
                         assertThat(person.getDetails().getRegistrationOffice()).isEqualTo("Temp Registergericht Leer");
@@ -446,7 +446,7 @@ class HsOfficePartnerControllerAcceptanceTest extends ContextBasedTestWithCleanu
 
             // then the given partner is gone
             assertThat(partnerRepo.findByUuid(givenPartner.getUuid())).isEmpty();
-            assertThat(relationRepository.findByUuid(givenPartner.getPartnerRel().getUuid())).isEmpty();
+            assertThat(relationshipRepository.findByUuid(givenPartner.getPartnerRole().getUuid())).isEmpty();
         }
 
         @Test
@@ -454,7 +454,7 @@ class HsOfficePartnerControllerAcceptanceTest extends ContextBasedTestWithCleanu
         void contactAdminUser_canNotDeleteRelatedPartner() {
             context.define("superuser-alex@hostsharing.net");
             final var givenPartner = givenSomeTemporaryPartnerBessler(20014);
-            assertThat(givenPartner.getPartnerRel().getContact().getLabel()).isEqualTo("fourth contact");
+            assertThat(givenPartner.getPartnerRole().getContact().getLabel()).isEqualTo("fourth contact");
 
             RestAssured // @formatter:off
                 .given()
@@ -474,7 +474,7 @@ class HsOfficePartnerControllerAcceptanceTest extends ContextBasedTestWithCleanu
         void normalUser_canNotDeleteUnrelatedPartner() {
             context.define("superuser-alex@hostsharing.net");
             final var givenPartner = givenSomeTemporaryPartnerBessler(20015);
-            assertThat(givenPartner.getPartnerRel().getContact().getLabel()).isEqualTo("fourth contact");
+            assertThat(givenPartner.getPartnerRole().getContact().getLabel()).isEqualTo("fourth contact");
 
             RestAssured // @formatter:off
                 .given()
@@ -490,7 +490,7 @@ class HsOfficePartnerControllerAcceptanceTest extends ContextBasedTestWithCleanu
         }
     }
 
-    private HsOfficeRelationEntity givenSomeTemporaryPartnerRel(
+    private HsOfficeRelationshipEntity givenSomeTemporaryPartnerRel(
             final String partnerHolderName,
             final String contactName) {
         return jpaAttempt.transacted(() -> {
@@ -499,22 +499,22 @@ class HsOfficePartnerControllerAcceptanceTest extends ContextBasedTestWithCleanu
             final var givenPerson = personRepo.findPersonByOptionalNameLike(partnerHolderName).stream().findFirst().orElseThrow();
             final var givenContact = contactRepo.findContactByOptionalLabelLike(contactName).stream().findFirst().orElseThrow();
 
-            final var partnerRel = new HsOfficeRelationEntity();
-            partnerRel.setType(HsOfficeRelationType.PARTNER);
-            partnerRel.setAnchor(givenMandantPerson);
-            partnerRel.setHolder(givenPerson);
-            partnerRel.setContact(givenContact);
-            em.persist(partnerRel);
-            return partnerRel;
+            final var partnerRole = new HsOfficeRelationshipEntity();
+            partnerRole.setRelType(HsOfficeRelationshipType.PARTNER);
+            partnerRole.setRelAnchor(givenMandantPerson);
+            partnerRole.setRelHolder(givenPerson);
+            partnerRole.setContact(givenContact);
+            em.persist(partnerRole);
+            return partnerRole;
         }).assertSuccessful().returnedValue();
     }
     private HsOfficePartnerEntity givenSomeTemporaryPartnerBessler(final Integer partnerNumber) {
         return jpaAttempt.transacted(() -> {
             context.define("superuser-alex@hostsharing.net");
-            final var partnerRel = em.merge(givenSomeTemporaryPartnerRel("Erben Bessler", "fourth contact"));
+            final var partnerRole = em.merge(givenSomeTemporaryPartnerRel("Erben Bessler", "fourth contact"));
 
             final var newPartner = HsOfficePartnerEntity.builder()
-                    .partnerRel(partnerRel)
+                    .partnerRole(partnerRole)
                     .partnerNumber(partnerNumber)
                     .details(HsOfficePartnerDetailsEntity.builder()
                             .registrationOffice("Temp Registergericht Leer")
@@ -531,6 +531,6 @@ class HsOfficePartnerControllerAcceptanceTest extends ContextBasedTestWithCleanu
         cleanupAllNew(HsOfficePartnerEntity.class);
 
         // TODO: should not be necessary anymore, once it's deleted via after delete trigger
-        cleanupAllNew(HsOfficeRelationEntity.class);
+        cleanupAllNew(HsOfficeRelationshipEntity.class);
     }
 }

src/test/java/net/hostsharing/hsadminng/hs/office/partner/HsOfficePartnerControllerRestTest.java

@@ -3,8 +3,8 @@ package net.hostsharing.hsadminng.hs.office.partner;
 import net.hostsharing.hsadminng.context.Context;
 import net.hostsharing.hsadminng.hs.office.contact.HsOfficeContactEntity;
 import net.hostsharing.hsadminng.hs.office.person.HsOfficePersonEntity;
-import net.hostsharing.hsadminng.hs.office.relation.HsOfficeRelationEntity;
-import net.hostsharing.hsadminng.hs.office.relation.HsOfficeRelationRepository;
+import net.hostsharing.hsadminng.hs.office.relationship.HsOfficeRelationshipEntity;
+import net.hostsharing.hsadminng.hs.office.relationship.HsOfficeRelationshipRepository;
 import net.hostsharing.hsadminng.mapper.Mapper;
 import org.junit.jupiter.api.BeforeEach;
 import org.junit.jupiter.api.Nested;
@@ -54,7 +54,7 @@ class HsOfficePartnerControllerRestTest {
     HsOfficePartnerRepository partnerRepo;
 
     @MockBean
-    HsOfficeRelationRepository relationRepo;
+    HsOfficeRelationshipRepository relationshipRepo;
 
     @MockBean
     EntityManager em;
@@ -100,9 +100,9 @@ class HsOfficePartnerControllerRestTest {
                             .content("""
                                      {
                                         "partnerNumber": "20002",
-                                        "partnerRel": {
-                                             "anchorUuid": "%s",
-                                             "holderUuid": "%s",
+                                        "partnerRole": {
+                                             "relAnchorUuid": "%s",
+                                             "relHolderUuid": "%s",
                                              "contactUuid": "%s"
                                         },
                                         "personUuid": "%s",
@@ -137,9 +137,9 @@ class HsOfficePartnerControllerRestTest {
                             .content("""
                                      {
                                         "partnerNumber": "20002",
-                                        "partnerRel": {
-                                             "anchorUuid": "%s",
-                                             "holderUuid": "%s",
+                                        "partnerRole": {
+                                             "relAnchorUuid": "%s",
+                                             "relHolderUuid": "%s",
                                              "contactUuid": "%s"
                                         },
                                         "personUuid": "%s",
@@ -175,11 +175,11 @@ class HsOfficePartnerControllerRestTest {
             when(partnerRepo.findByUuid(givenPartnerUuid)).thenReturn(Optional.of(partnerMock));
             when(partnerRepo.deleteByUuid(givenPartnerUuid)).thenReturn(0);
 
-            final UUID givenRelationUuid = UUID.randomUUID();
-            when(partnerMock.getPartnerRel()).thenReturn(HsOfficeRelationEntity.builder()
-                    .uuid(givenRelationUuid)
+            final UUID givenRelationshipUuid = UUID.randomUUID();
+            when(partnerMock.getPartnerRole()).thenReturn(HsOfficeRelationshipEntity.builder()
+                    .uuid(givenRelationshipUuid)
                     .build());
-            when(relationRepo.deleteByUuid(givenRelationUuid)).thenReturn(0);
+            when(relationshipRepo.deleteByUuid(givenRelationshipUuid)).thenReturn(0);
 
             // when
             mockMvc.perform(MockMvcRequestBuilders

src/test/java/net/hostsharing/hsadminng/hs/office/partner/HsOfficePartnerEntityPatcherUnitTest.java

@@ -3,7 +3,7 @@ package net.hostsharing.hsadminng.hs.office.partner;
 import net.hostsharing.hsadminng.hs.office.contact.HsOfficeContactEntity;
 import net.hostsharing.hsadminng.hs.office.generated.api.v1.model.HsOfficePartnerPatchResource;
 import net.hostsharing.hsadminng.hs.office.person.HsOfficePersonEntity;
-import net.hostsharing.hsadminng.hs.office.relation.HsOfficeRelationEntity;
+import net.hostsharing.hsadminng.hs.office.relationship.HsOfficeRelationshipEntity;
 import net.hostsharing.test.PatchUnitTestBase;
 import org.junit.jupiter.api.BeforeEach;
 import org.junit.jupiter.api.TestInstance;
@@ -48,8 +48,8 @@ class HsOfficePartnerEntityPatcherUnitTest extends PatchUnitTestBase<
 
     @BeforeEach
     void initMocks() {
-        lenient().when(em.getReference(eq(HsOfficeRelationEntity.class), any())).thenAnswer(invocation ->
-                HsOfficeRelationEntity.builder().uuid(invocation.getArgument(1)).build());
+        lenient().when(em.getReference(eq(HsOfficeRelationshipEntity.class), any())).thenAnswer(invocation ->
+                HsOfficeRelationshipEntity.builder().uuid(invocation.getArgument(1)).build());
     }
 
     @Override
@@ -57,8 +57,8 @@ class HsOfficePartnerEntityPatcherUnitTest extends PatchUnitTestBase<
         final var entity = HsOfficePartnerEntity.builder()
                 .uuid(INITIAL_PARTNER_UUID)
                 .partnerNumber(12345)
-                .partnerRel(HsOfficeRelationEntity.builder()
-                        .holder(givenInitialPerson)
+                .partnerRole(HsOfficeRelationshipEntity.builder()
+                        .relHolder(givenInitialPerson)
                         .contact(givenInitialContact)
                         .build())
                 .details(givenInitialDetails)
@@ -80,19 +80,19 @@ class HsOfficePartnerEntityPatcherUnitTest extends PatchUnitTestBase<
     protected Stream<Property> propertyTestDescriptors() {
         return Stream.of(
                 new JsonNullableProperty<>(
-                        "partnerRel",
-                        HsOfficePartnerPatchResource::setPartnerRelUuid,
+                        "partnerRole",
+                        HsOfficePartnerPatchResource::setPartnerRoleUuid,
                         PATCHED_PARTNER_ROLE_UUID,
-                        HsOfficePartnerEntity::setPartnerRel,
-                        newPartnerRel(PATCHED_PARTNER_ROLE_UUID))
+                        HsOfficePartnerEntity::setPartnerRole,
+                        newPartnerRole(PATCHED_PARTNER_ROLE_UUID))
                         .notNullable()
         );
     }
 
-    private static HsOfficeRelationEntity newPartnerRel(final UUID uuid) {
-        final var newPartnerRel = HsOfficeRelationEntity.builder()
+    private static HsOfficeRelationshipEntity newPartnerRole(final UUID uuid) {
+        final var newPartnerRole = HsOfficeRelationshipEntity.builder()
                     .uuid(uuid)
                     .build();
-        return newPartnerRel;
+        return newPartnerRole;
     }
 }

src/test/java/net/hostsharing/hsadminng/hs/office/partner/HsOfficePartnerEntityUnitTest.java

@@ -3,8 +3,8 @@ package net.hostsharing.hsadminng.hs.office.partner;
 import net.hostsharing.hsadminng.hs.office.contact.HsOfficeContactEntity;
 import net.hostsharing.hsadminng.hs.office.person.HsOfficePersonEntity;
 import net.hostsharing.hsadminng.hs.office.person.HsOfficePersonType;
-import net.hostsharing.hsadminng.hs.office.relation.HsOfficeRelationEntity;
-import net.hostsharing.hsadminng.hs.office.relation.HsOfficeRelationType;
+import net.hostsharing.hsadminng.hs.office.relationship.HsOfficeRelationshipEntity;
+import net.hostsharing.hsadminng.hs.office.relationship.HsOfficeRelationshipType;
 import org.junit.jupiter.api.Test;
 
 import static org.assertj.core.api.Assertions.assertThat;
@@ -13,13 +13,13 @@ class HsOfficePartnerEntityUnitTest {
 
     private final HsOfficePartnerEntity givenPartner = HsOfficePartnerEntity.builder()
             .partnerNumber(12345)
-            .partnerRel(HsOfficeRelationEntity.builder()
-                    .anchor(HsOfficePersonEntity.builder()
+            .partnerRole(HsOfficeRelationshipEntity.builder()
+                    .relAnchor(HsOfficePersonEntity.builder()
                             .personType(HsOfficePersonType.LEGAL_PERSON)
                             .tradeName("Hostsharing eG")
                             .build())
-                    .type(HsOfficeRelationType.PARTNER)
-                    .holder(HsOfficePersonEntity.builder()
+                    .relType(HsOfficeRelationshipType.PARTNER)
+                    .relHolder(HsOfficePersonEntity.builder()
                             .personType(HsOfficePersonType.LEGAL_PERSON)
                             .tradeName("some trade name")
                             .build())

src/test/java/net/hostsharing/hsadminng/hs/office/partner/HsOfficePartnerRepositoryIntegrationTest.java

@@ -3,9 +3,9 @@ package net.hostsharing.hsadminng.hs.office.partner;
 import net.hostsharing.hsadminng.context.Context;
 import net.hostsharing.hsadminng.hs.office.contact.HsOfficeContactRepository;
 import net.hostsharing.hsadminng.hs.office.person.HsOfficePersonRepository;
-import net.hostsharing.hsadminng.hs.office.relation.HsOfficeRelationEntity;
-import net.hostsharing.hsadminng.hs.office.relation.HsOfficeRelationRepository;
-import net.hostsharing.hsadminng.hs.office.relation.HsOfficeRelationType;
+import net.hostsharing.hsadminng.hs.office.relationship.HsOfficeRelationshipEntity;
+import net.hostsharing.hsadminng.hs.office.relationship.HsOfficeRelationshipRepository;
+import net.hostsharing.hsadminng.hs.office.relationship.HsOfficeRelationshipType;
 import net.hostsharing.hsadminng.hs.office.test.ContextBasedTestWithCleanup;
 import net.hostsharing.hsadminng.rbac.rbacgrant.RawRbacGrantRepository;
 import net.hostsharing.hsadminng.rbac.rbacrole.RawRbacObjectRepository;
@@ -43,7 +43,7 @@ class HsOfficePartnerRepositoryIntegrationTest extends ContextBasedTestWithClean
     HsOfficePartnerRepository partnerRepo;
 
     @Autowired
-    HsOfficeRelationRepository relationRepo;
+    HsOfficeRelationshipRepository relationshipRepo;
 
     @Autowired
     HsOfficePersonRepository personRepo;
@@ -77,13 +77,13 @@ class HsOfficePartnerRepositoryIntegrationTest extends ContextBasedTestWithClean
             // given
             context("superuser-alex@hostsharing.net");
             final var count = partnerRepo.count();
-            final var partnerRel = givenSomeTemporaryHostsharingPartnerRel("First GmbH", "first contact");
+            final var partnerRole = givenSomeTemporaryHostsharingPartnerRole("First GmbH", "first contact");
 
             // when
             final var result = attempt(em, () -> {
                 final var newPartner = HsOfficePartnerEntity.builder()
                         .partnerNumber(20031)
-                        .partnerRel(partnerRel)
+                        .partnerRole(partnerRole)
                         .details(HsOfficePartnerDetailsEntity.builder().build())
                         .build();
                 return partnerRepo.save(newPartner);
@@ -113,17 +113,17 @@ class HsOfficePartnerRepositoryIntegrationTest extends ContextBasedTestWithClean
                 final var givenContact = contactRepo.findContactByOptionalLabelLike("fourth contact").get(0);
                 final var givenMandantPerson = personRepo.findPersonByOptionalNameLike("Hostsharing eG").get(0);
 
-                final var newRelation = HsOfficeRelationEntity.builder()
-                        .holder(givenPartnerPerson)
-                        .type(HsOfficeRelationType.PARTNER)
-                        .anchor(givenMandantPerson)
+                final var newRelationship = HsOfficeRelationshipEntity.builder()
+                        .relHolder(givenPartnerPerson)
+                        .relType(HsOfficeRelationshipType.PARTNER)
+                        .relAnchor(givenMandantPerson)
                         .contact(givenContact)
                         .build();
-                relationRepo.save(newRelation);
+                relationshipRepo.save(newRelationship);
 
                 final var newPartner = HsOfficePartnerEntity.builder()
                         .partnerNumber(20032)
-                        .partnerRel(newRelation)
+                        .partnerRole(newRelationship)
                         .details(HsOfficePartnerDetailsEntity.builder().build())
                         .build();
                 return partnerRepo.save(newPartner);
@@ -132,10 +132,10 @@ class HsOfficePartnerRepositoryIntegrationTest extends ContextBasedTestWithClean
             // then
             assertThat(distinctRoleNamesOf(rawRoleRepo.findAll())).containsExactlyInAnyOrder(Array.from(
                     initialRoleNames,
-                    "hs_office_relation#HostsharingeG-with-PARTNER-ErbenBesslerMelBessler.owner",
-                    "hs_office_relation#HostsharingeG-with-PARTNER-ErbenBesslerMelBessler.admin",
-                    "hs_office_relation#HostsharingeG-with-PARTNER-ErbenBesslerMelBessler.agent",
-                    "hs_office_relation#HostsharingeG-with-PARTNER-ErbenBesslerMelBessler.tenant"));
+                    "hs_office_relationship#HostsharingeG-with-PARTNER-ErbenBesslerMelBessler.owner",
+                    "hs_office_relationship#HostsharingeG-with-PARTNER-ErbenBesslerMelBessler.admin",
+                    "hs_office_relationship#HostsharingeG-with-PARTNER-ErbenBesslerMelBessler.agent",
+                    "hs_office_relationship#HostsharingeG-with-PARTNER-ErbenBesslerMelBessler.tenant"));
             assertThat(distinctGrantDisplaysOf(rawGrantRepo.findAll()))
                     .map(s -> s.replace("ErbenBesslerMelBessler", "EBess"))
                     .map(s -> s.replace("fourthcontact", "4th"))
@@ -143,42 +143,42 @@ class HsOfficePartnerRepositoryIntegrationTest extends ContextBasedTestWithClean
                     .containsExactlyInAnyOrder(distinct(fromFormatted(
                             initialGrantNames,
                             // FIXME: this entry is wrong in existance and format
-                            "{ grant perm INSERT on relation#HostsharingeG-with-PARTNER-EBess to role relation#HostsharingeG-with-PARTNER-EBess.admin by system and assume }",
+                            "{ grant perm INSERT on relationship#HostsharingeG-with-PARTNER-EBess to role relationship#HostsharingeG-with-PARTNER-EBess.admin by system and assume }",
 
                             // permissions on partner
-                            "{ grant perm DELETE on partner#P-20032 to role relation#HostsharingeG-with-PARTNER-EBess.admin by system and assume }",
-                            "{ grant perm UPDATE on partner#P-20032 to role relation#HostsharingeG-with-PARTNER-EBess.agent by system and assume }",
-                            "{ grant perm SELECT on partner#P-20032 to role relation#HostsharingeG-with-PARTNER-EBess.tenant by system and assume }",
+                            "{ grant perm DELETE on partner#P-20032 to role relationship#HostsharingeG-with-PARTNER-EBess.admin by system and assume }",
+                            "{ grant perm UPDATE on partner#P-20032 to role relationship#HostsharingeG-with-PARTNER-EBess.agent by system and assume }",
+                            "{ grant perm SELECT on partner#P-20032 to role relationship#HostsharingeG-with-PARTNER-EBess.tenant by system and assume }",
 
                             // permissions on partner-details
-                            "{ grant perm DELETE on partner_details#P-20032-details to role relation#HostsharingeG-with-PARTNER-EBess.admin by system and assume }",
-                            "{ grant perm UPDATE on partner_details#P-20032-details to role relation#HostsharingeG-with-PARTNER-EBess.agent by system and assume }",
-                            "{ grant perm SELECT on partner_details#P-20032-details to role relation#HostsharingeG-with-PARTNER-EBess.agent by system and assume }",
+                            "{ grant perm DELETE on partner_details#P-20032-details to role relationship#HostsharingeG-with-PARTNER-EBess.admin by system and assume }",
+                            "{ grant perm UPDATE on partner_details#P-20032-details to role relationship#HostsharingeG-with-PARTNER-EBess.agent by system and assume }",
+                            "{ grant perm SELECT on partner_details#P-20032-details to role relationship#HostsharingeG-with-PARTNER-EBess.agent by system and assume }",
 
-                            // permissions on partner-relation
-                            "{ grant perm DELETE on relation#HostsharingeG-with-PARTNER-EBess to role relation#HostsharingeG-with-PARTNER-EBess.owner by system and assume }",
-                            "{ grant perm UPDATE on relation#HostsharingeG-with-PARTNER-EBess to role relation#HostsharingeG-with-PARTNER-EBess.admin by system and assume }",
-                            "{ grant perm SELECT on relation#HostsharingeG-with-PARTNER-EBess to role relation#HostsharingeG-with-PARTNER-EBess.tenant by system and assume }",
+                            // permissions on partner-relationship
+                            "{ grant perm DELETE on relationship#HostsharingeG-with-PARTNER-EBess to role relationship#HostsharingeG-with-PARTNER-EBess.owner by system and assume }",
+                            "{ grant perm UPDATE on relationship#HostsharingeG-with-PARTNER-EBess to role relationship#HostsharingeG-with-PARTNER-EBess.admin by system and assume }",
+                            "{ grant perm SELECT on relationship#HostsharingeG-with-PARTNER-EBess to role relationship#HostsharingeG-with-PARTNER-EBess.tenant by system and assume }",
 
-                            // relation owner
-                            "{ grant role relation#HostsharingeG-with-PARTNER-EBess.owner to role global#global.admin by system and assume }",
-                            "{ grant role relation#HostsharingeG-with-PARTNER-EBess.owner to user superuser-alex@hostsharing.net by relation#HostsharingeG-with-PARTNER-EBess.owner and assume }",
+                            // relationship owner
+                            "{ grant role relationship#HostsharingeG-with-PARTNER-EBess.owner to role global#global.admin by system and assume }",
+                            "{ grant role relationship#HostsharingeG-with-PARTNER-EBess.owner to user superuser-alex@hostsharing.net by relationship#HostsharingeG-with-PARTNER-EBess.owner and assume }",
 
-                            // relation admin
-                            "{ grant role relation#HostsharingeG-with-PARTNER-EBess.admin to role relation#HostsharingeG-with-PARTNER-EBess.owner by system and assume }",
-                            "{ grant role relation#HostsharingeG-with-PARTNER-EBess.admin to role person#HostsharingeG.admin by system and assume }",
+                            // relationship admin
+                            "{ grant role relationship#HostsharingeG-with-PARTNER-EBess.admin to role relationship#HostsharingeG-with-PARTNER-EBess.owner by system and assume }",
+                            "{ grant role relationship#HostsharingeG-with-PARTNER-EBess.admin to role person#HostsharingeG.admin by system and assume }",
 
-                            // relation agent
-                            "{ grant role relation#HostsharingeG-with-PARTNER-EBess.agent to role person#EBess.admin by system and assume }",
-                            "{ grant role relation#HostsharingeG-with-PARTNER-EBess.agent to role relation#HostsharingeG-with-PARTNER-EBess.admin by system and assume }",
+                            // relationship agent
+                            "{ grant role relationship#HostsharingeG-with-PARTNER-EBess.agent to role person#EBess.admin by system and assume }",
+                            "{ grant role relationship#HostsharingeG-with-PARTNER-EBess.agent to role relationship#HostsharingeG-with-PARTNER-EBess.admin by system and assume }",
 
-                            // relation tenant
-                            "{ grant role contact#4th.referrer to role relation#HostsharingeG-with-PARTNER-EBess.tenant by system and assume }",
-                            "{ grant role person#EBess.referrer to role relation#HostsharingeG-with-PARTNER-EBess.tenant by system and assume }",
-                            "{ grant role person#HostsharingeG.referrer to role relation#HostsharingeG-with-PARTNER-EBess.tenant by system and assume }",
-                            "{ grant role relation#HostsharingeG-with-PARTNER-EBess.tenant to role contact#4th.admin by system and assume }",
-                            "{ grant role relation#HostsharingeG-with-PARTNER-EBess.tenant to role person#EBess.admin by system and assume }",
-                            "{ grant role relation#HostsharingeG-with-PARTNER-EBess.tenant to role relation#HostsharingeG-with-PARTNER-EBess.agent by system and assume }",
+                            // relationship tenant
+                            "{ grant role contact#4th.referrer to role relationship#HostsharingeG-with-PARTNER-EBess.tenant by system and assume }",
+                            "{ grant role person#EBess.referrer to role relationship#HostsharingeG-with-PARTNER-EBess.tenant by system and assume }",
+                            "{ grant role person#HostsharingeG.referrer to role relationship#HostsharingeG-with-PARTNER-EBess.tenant by system and assume }",
+                            "{ grant role relationship#HostsharingeG-with-PARTNER-EBess.tenant to role contact#4th.admin by system and assume }",
+                            "{ grant role relationship#HostsharingeG-with-PARTNER-EBess.tenant to role person#EBess.admin by system and assume }",
+                            "{ grant role relationship#HostsharingeG-with-PARTNER-EBess.tenant to role relationship#HostsharingeG-with-PARTNER-EBess.agent by system and assume }",
                             null)));
         }
 
@@ -273,7 +273,7 @@ class HsOfficePartnerRepositoryIntegrationTest extends ContextBasedTestWithClean
             // when
             final var result = jpaAttempt.transacted(() -> {
                 context("superuser-alex@hostsharing.net");
-                givenPartner.setPartnerRel(givenSomeTemporaryHostsharingPartnerRel("Third OHG", "sixth contact"));
+                givenPartner.setPartnerRole(givenSomeTemporaryHostsharingPartnerRole("Third OHG", "sixth contact"));
                 return partnerRepo.save(givenPartner);
             });
 
@@ -327,7 +327,7 @@ class HsOfficePartnerRepositoryIntegrationTest extends ContextBasedTestWithClean
             // when
             final var result = jpaAttempt.transacted(() -> {
                 context("superuser-alex@hostsharing.net",
-                        "hs_office_relation#HostsharingeG-with-PARTNER-ErbenBesslerMelBessler.tenant");
+                        "hs_office_relationship#HostsharingeG-with-PARTNER-ErbenBesslerMelBessler.tenant");
                 givenPartner.getDetails().setBirthName("new birthname");
                 return partnerRepo.save(givenPartner);
             });
@@ -335,7 +335,7 @@ class HsOfficePartnerRepositoryIntegrationTest extends ContextBasedTestWithClean
             // then
             result.assertExceptionWithRootCauseMessage(JpaSystemException.class,
                     // FIXME: the assumed role should appear, but it does not:
-                    //"[403] insert into hs_office_partner_details not allowed for current subjects {hs_office_relation#HostsharingeG-with-PARTNER-ErbenBesslerMelBessler.tenant}");
+                    //"[403] insert into hs_office_partner_details not allowed for current subjects {hs_office_relationship#HostsharingeG-with-PARTNER-ErbenBesslerMelBessler.tenant}");
                     "[403] insert into hs_office_partner_details not allowed for current subjects");
         }
 
@@ -457,11 +457,11 @@ class HsOfficePartnerRepositoryIntegrationTest extends ContextBasedTestWithClean
             final Integer partnerNumber, final String person, final String contact) {
         return jpaAttempt.transacted(() -> {
             context("superuser-alex@hostsharing.net");
-            final var partnerRel = givenSomeTemporaryHostsharingPartnerRel(person, contact);
+            final var partnerRole = givenSomeTemporaryHostsharingPartnerRole(person, contact);
 
             final var newPartner = HsOfficePartnerEntity.builder()
                     .partnerNumber(partnerNumber)
-                    .partnerRel(partnerRel)
+                    .partnerRole(partnerRole)
                     .details(HsOfficePartnerDetailsEntity.builder().build())
                     .build();
 
@@ -469,19 +469,19 @@ class HsOfficePartnerRepositoryIntegrationTest extends ContextBasedTestWithClean
         }).assertSuccessful().returnedValue();
     }
 
-    private HsOfficeRelationEntity givenSomeTemporaryHostsharingPartnerRel(final String person, final String contact) {
+    private HsOfficeRelationshipEntity givenSomeTemporaryHostsharingPartnerRole(final String person, final String contact) {
         final var givenMandantorPerson = personRepo.findPersonByOptionalNameLike("Hostsharing eG").get(0);
         final var givenPartnerPerson = personRepo.findPersonByOptionalNameLike(person).get(0);
         final var givenContact = contactRepo.findContactByOptionalLabelLike(contact).get(0);
 
-        final var partnerRel = HsOfficeRelationEntity.builder()
-                .holder(givenPartnerPerson)
-                .type(HsOfficeRelationType.PARTNER)
-                .anchor(givenMandantorPerson)
+        final var partnerRole = HsOfficeRelationshipEntity.builder()
+                .relHolder(givenPartnerPerson)
+                .relType(HsOfficeRelationshipType.PARTNER)
+                .relAnchor(givenMandantorPerson)
                 .contact(givenContact)
                 .build();
-        relationRepo.save(partnerRel);
-        return partnerRel;
+        relationshipRepo.save(partnerRole);
+        return partnerRole;
     }
 
     void exactlyThesePartnersAreReturned(final List<HsOfficePartnerEntity> actualResult, final String... partnerNames) {

src/test/java/net/hostsharing/hsadminng/hs/office/partner/TestHsOfficePartner.java

@@ -2,8 +2,8 @@ package net.hostsharing.hsadminng.hs.office.partner;
 
 import net.hostsharing.hsadminng.hs.office.contact.HsOfficeContactEntity;
 import net.hostsharing.hsadminng.hs.office.person.HsOfficePersonEntity;
-import net.hostsharing.hsadminng.hs.office.relation.HsOfficeRelationEntity;
-import net.hostsharing.hsadminng.hs.office.relation.HsOfficeRelationType;
+import net.hostsharing.hsadminng.hs.office.relationship.HsOfficeRelationshipEntity;
+import net.hostsharing.hsadminng.hs.office.relationship.HsOfficeRelationshipType;
 
 import static net.hostsharing.hsadminng.hs.office.person.HsOfficePersonType.LEGAL_PERSON;
 
@@ -14,14 +14,14 @@ public class TestHsOfficePartner {
     static public HsOfficePartnerEntity hsOfficePartnerWithLegalPerson(final String tradeName) {
         return HsOfficePartnerEntity.builder()
                 .partnerNumber(10001)
-                .partnerRel(
-                        HsOfficeRelationEntity.builder()
-                                .holder(HsOfficePersonEntity.builder()
+                .partnerRole(
+                        HsOfficeRelationshipEntity.builder()
+                                .relHolder(HsOfficePersonEntity.builder()
                                         .personType(LEGAL_PERSON)
                                         .tradeName("Hostsharing eG")
                                         .build())
-                                .type(HsOfficeRelationType.PARTNER)
-                                .holder(HsOfficePersonEntity.builder()
+                                .relType(HsOfficeRelationshipType.PARTNER)
+                                .relHolder(HsOfficePersonEntity.builder()
                                         .personType(LEGAL_PERSON)
                                         .tradeName(tradeName)
                                         .build())

src/test/java/net/hostsharing/hsadminng/hs/office/relation/HsOfficeRelationEntityUnitTest.java

@@ -1,43 +0,0 @@
-package net.hostsharing.hsadminng.hs.office.relation;
-
-import net.hostsharing.hsadminng.hs.office.person.HsOfficePersonEntity;
-import net.hostsharing.hsadminng.hs.office.person.HsOfficePersonType;
-import org.junit.jupiter.api.Test;
-
-import static org.assertj.core.api.Assertions.assertThat;
-
-class HsOfficeRelationEntityUnitTest {
-
-    private HsOfficePersonEntity anchor = HsOfficePersonEntity.builder()
-            .personType(HsOfficePersonType.LEGAL_PERSON)
-            .tradeName("some trade name")
-            .build();
-    private HsOfficePersonEntity holder = HsOfficePersonEntity.builder()
-            .personType(HsOfficePersonType.NATURAL_PERSON)
-            .familyName("Meier")
-            .givenName("Mellie")
-            .build();
-
-    @Test
-    void toStringReturnsAllProperties() {
-        final var given = HsOfficeRelationEntity.builder()
-                .type(HsOfficeRelationType.SUBSCRIBER)
-                .mark("members-announce")
-                .anchor(anchor)
-                .holder(holder)
-                .build();
-
-        assertThat(given.toString()).isEqualTo("rel(anchor='LP some trade name', type='SUBSCRIBER', mark='members-announce', holder='NP Meier, Mellie')");
-    }
-
-    @Test
-    void toShortString() {
-        final var given = HsOfficeRelationEntity.builder()
-                .type(HsOfficeRelationType.REPRESENTATIVE)
-                .anchor(anchor)
-                .holder(holder)
-                .build();
-
-        assertThat(given.toShortString()).isEqualTo("rel(anchor='LP some trade name', type='REPRESENTATIVE', holder='NP Meier, Mellie')");
-    }
-}

src/test/java/net/hostsharing/hsadminng/hs/office/relationship/HsOfficeRelationshipControllerAcceptanceTest.java

@@ -1,4 +1,4 @@
-package net.hostsharing.hsadminng.hs.office.relation;
+package net.hostsharing.hsadminng.hs.office.relationship;
 
 import io.restassured.RestAssured;
 import io.restassured.http.ContentType;
@@ -7,7 +7,7 @@ import net.hostsharing.test.Accepts;
 import net.hostsharing.hsadminng.HsadminNgApplication;
 import net.hostsharing.hsadminng.context.Context;
 import net.hostsharing.hsadminng.hs.office.contact.HsOfficeContactRepository;
-import net.hostsharing.hsadminng.hs.office.generated.api.v1.model.HsOfficeRelationTypeResource;
+import net.hostsharing.hsadminng.hs.office.generated.api.v1.model.HsOfficeRelationshipTypeResource;
 import net.hostsharing.hsadminng.hs.office.person.HsOfficePersonRepository;
 import net.hostsharing.test.JpaAttempt;
 import org.json.JSONException;
@@ -31,7 +31,7 @@ import static org.hamcrest.Matchers.startsWith;
         classes = { HsadminNgApplication.class, JpaAttempt.class }
 )
 @Transactional
-class HsOfficeRelationControllerAcceptanceTest extends ContextBasedTestWithCleanup {
+class HsOfficeRelationshipControllerAcceptanceTest extends ContextBasedTestWithCleanup {
 
     public static final UUID GIVEN_NON_EXISTING_HOLDER_PERSON_UUID = UUID.fromString("00000000-0000-0000-0000-000000000000");
     @LocalServerPort
@@ -44,7 +44,7 @@ class HsOfficeRelationControllerAcceptanceTest extends ContextBasedTestWithClean
     Context contextMock;
 
     @Autowired
-    HsOfficeRelationRepository relationRepo;
+    HsOfficeRelationshipRepository relationshipRepo;
 
     @Autowired
     HsOfficePersonRepository personRepo;
@@ -56,11 +56,11 @@ class HsOfficeRelationControllerAcceptanceTest extends ContextBasedTestWithClean
     JpaAttempt jpaAttempt;
 
     @Nested
-    @Accepts({ "Relation:F(Find)" })
-    class ListRelations {
+    @Accepts({ "Relationship:F(Find)" })
+    class ListRelationships {
 
         @Test
-        void globalAdmin_withoutAssumedRoles_canViewAllRelationsOfGivenPersonAndType_ifNoCriteriaGiven() throws JSONException {
+        void globalAdmin_withoutAssumedRoles_canViewAllRelationshipsOfGivenPersonAndType_ifNoCriteriaGiven() throws JSONException {
 
             // given
             context.define("superuser-alex@hostsharing.net");
@@ -71,45 +71,45 @@ class HsOfficeRelationControllerAcceptanceTest extends ContextBasedTestWithClean
                     .header("current-user", "superuser-alex@hostsharing.net")
                     .port(port)
                 .when()
-                    .get("http://localhost/api/hs/office/relations?personUuid=%s&relationType=%s"
-                            .formatted(givenPerson.getUuid(), HsOfficeRelationTypeResource.PARTNER))
+                    .get("http://localhost/api/hs/office/relationships?personUuid=%s&relationshipType=%s"
+                            .formatted(givenPerson.getUuid(), HsOfficeRelationshipTypeResource.PARTNER))
                 .then().log().all().assertThat()
                     .statusCode(200)
                     .contentType("application/json")
                     .body("", lenientlyEquals("""
                     [
                         {
-                            "anchor": { "personType": "LEGAL_PERSON", "tradeName": "Hostsharing eG" },
-                            "holder": { "personType": "LEGAL_PERSON", "tradeName": "First GmbH" },
-                            "type": "PARTNER",
-                            "mark": null,
+                            "relAnchor": { "personType": "LEGAL_PERSON", "tradeName": "Hostsharing eG" },
+                            "relHolder": { "personType": "LEGAL_PERSON", "tradeName": "First GmbH" },
+                            "relType": "PARTNER",
+                            "relMark": null,
                             "contact": { "label": "first contact" }
                         },
                         {
-                            "anchor": { "personType": "LEGAL_PERSON", "tradeName": "Hostsharing eG" },
-                            "holder": { "personType": "LEGAL_PERSON", "tradeName": "Fourth eG" },
-                            "type": "PARTNER",
+                            "relAnchor": { "personType": "LEGAL_PERSON", "tradeName": "Hostsharing eG" },
+                            "relHolder": { "personType": "LEGAL_PERSON", "tradeName": "Fourth eG" },
+                            "relType": "PARTNER",
                             "contact": { "label": "fourth contact" }
                         },
                         {
-                            "anchor": { "personType": "LEGAL_PERSON", "tradeName": "Hostsharing eG" },
-                            "holder": { "personType": "LEGAL_PERSON", "tradeName": "Second e.K.", "givenName": "Peter", "familyName": "Smith" },
-                            "type": "PARTNER",
-                            "mark": null,
+                            "relAnchor": { "personType": "LEGAL_PERSON", "tradeName": "Hostsharing eG" },
+                            "relHolder": { "personType": "LEGAL_PERSON", "tradeName": "Second e.K.", "givenName": "Peter", "familyName": "Smith" },
+                            "relType": "PARTNER",
+                            "relMark": null,
                             "contact": { "label": "second contact" }
                         },
                         {
-                            "anchor": { "personType": "LEGAL_PERSON", "tradeName": "Hostsharing eG" },
-                            "holder": { "personType": "NATURAL_PERSON", "givenName": "Peter", "familyName": "Smith" },
-                            "type": "PARTNER",
-                            "mark": null,
+                            "relAnchor": { "personType": "LEGAL_PERSON", "tradeName": "Hostsharing eG" },
+                            "relHolder": { "personType": "NATURAL_PERSON", "givenName": "Peter", "familyName": "Smith" },
+                            "relType": "PARTNER",
+                            "relMark": null,
                             "contact": { "label": "sixth contact" }
                         },
                         {
-                            "anchor": { "personType": "LEGAL_PERSON", "tradeName": "Hostsharing eG" },
-                            "holder": { "personType": "INCORPORATED_FIRM", "tradeName": "Third OHG" },
-                            "type": "PARTNER",
-                            "mark": null,
+                            "relAnchor": { "personType": "LEGAL_PERSON", "tradeName": "Hostsharing eG" },
+                            "relHolder": { "personType": "INCORPORATED_FIRM", "tradeName": "Third OHG" },
+                            "relType": "PARTNER",
+                            "relMark": null,
                             "contact": { "label": "third contact" }
                         }
                     ]
@@ -119,11 +119,11 @@ class HsOfficeRelationControllerAcceptanceTest extends ContextBasedTestWithClean
     }
 
     @Nested
-    @Accepts({ "Relation:C(Create)" })
-    class AddRelation {
+    @Accepts({ "Relationship:C(Create)" })
+    class AddRelationship {
 
         @Test
-        void globalAdmin_withoutAssumedRole_canAddRelation() {
+        void globalAdmin_withoutAssumedRole_canAddRelationship() {
 
             context.define("superuser-alex@hostsharing.net");
             final var givenAnchorPerson = personRepo.findPersonByOptionalNameLike("Third").get(0);
@@ -136,38 +136,38 @@ class HsOfficeRelationControllerAcceptanceTest extends ContextBasedTestWithClean
                         .contentType(ContentType.JSON)
                         .body("""
                                {
-                                   "type": "%s",
-                                   "anchorUuid": "%s",
-                                   "holderUuid": "%s",
+                                   "relType": "%s",
+                                   "relAnchorUuid": "%s",
+                                   "relHolderUuid": "%s",
                                    "contactUuid": "%s"
                                  }
                             """.formatted(
-                                HsOfficeRelationTypeResource.DEBITOR,
+                                HsOfficeRelationshipTypeResource.ACCOUNTING,
                                 givenAnchorPerson.getUuid(),
                                 givenHolderPerson.getUuid(),
                                 givenContact.getUuid()))
                         .port(port)
                     .when()
-                        .post("http://localhost/api/hs/office/relations")
+                        .post("http://localhost/api/hs/office/relationships")
                     .then().log().all().assertThat()
                         .statusCode(201)
                         .contentType(ContentType.JSON)
                         .body("uuid", isUuidValid())
-                        .body("type", is("DEBITOR"))
-                        .body("anchor.tradeName", is("Third OHG"))
-                        .body("holder.givenName", is("Paul"))
+                        .body("relType", is("ACCOUNTING"))
+                        .body("relAnchor.tradeName", is("Third OHG"))
+                        .body("relHolder.givenName", is("Paul"))
                         .body("contact.label", is("second contact"))
                         .header("Location", startsWith("http://localhost"))
                     .extract().header("Location");  // @formatter:on
 
-            // finally, the new relation can be accessed under the generated UUID
-            final var newUserUuid = toCleanup(HsOfficeRelationEntity.class, UUID.fromString(
+            // finally, the new relationship can be accessed under the generated UUID
+            final var newUserUuid = toCleanup(HsOfficeRelationshipEntity.class, UUID.fromString(
                     location.substring(location.lastIndexOf('/') + 1)));
             assertThat(newUserUuid).isNotNull();
         }
 
         @Test
-        void globalAdmin_canNotAddRelation_ifAnchorPersonDoesNotExist() {
+        void globalAdmin_canNotAddRelationship_ifAnchorPersonDoesNotExist() {
 
             context.define("superuser-alex@hostsharing.net");
             final var givenAnchorPersonUuid = GIVEN_NON_EXISTING_HOLDER_PERSON_UUID;
@@ -180,27 +180,27 @@ class HsOfficeRelationControllerAcceptanceTest extends ContextBasedTestWithClean
                     .contentType(ContentType.JSON)
                     .body("""
                                {
-                                   "type": "%s",
-                                   "anchorUuid": "%s",
-                                   "holderUuid": "%s",
+                                   "relType": "%s",
+                                   "relAnchorUuid": "%s",
+                                   "relHolderUuid": "%s",
                                    "contactUuid": "%s"
                                  }
                             """.formatted(
-                            HsOfficeRelationTypeResource.DEBITOR,
+                            HsOfficeRelationshipTypeResource.ACCOUNTING,
                             givenAnchorPersonUuid,
                             givenHolderPerson.getUuid(),
                             givenContact.getUuid()))
                     .port(port)
                 .when()
-                    .post("http://localhost/api/hs/office/relations")
+                    .post("http://localhost/api/hs/office/relationships")
                 .then().log().all().assertThat()
                     .statusCode(404)
-                    .body("message", is("cannot find anchorUuid " + GIVEN_NON_EXISTING_HOLDER_PERSON_UUID));
+                    .body("message", is("cannot find relAnchorUuid " + GIVEN_NON_EXISTING_HOLDER_PERSON_UUID));
             // @formatter:on
         }
 
         @Test
-        void globalAdmin_canNotAddRelation_ifHolderPersonDoesNotExist() {
+        void globalAdmin_canNotAddRelationship_ifHolderPersonDoesNotExist() {
 
             context.define("superuser-alex@hostsharing.net");
             final var givenAnchorPerson = personRepo.findPersonByOptionalNameLike("Third").get(0);
@@ -212,27 +212,27 @@ class HsOfficeRelationControllerAcceptanceTest extends ContextBasedTestWithClean
                     .contentType(ContentType.JSON)
                     .body("""
                                {
-                                   "type": "%s",
-                                   "anchorUuid": "%s",
-                                   "holderUuid": "%s",
+                                   "relType": "%s",
+                                   "relAnchorUuid": "%s",
+                                   "relHolderUuid": "%s",
                                    "contactUuid": "%s"
                                  }
                             """.formatted(
-                            HsOfficeRelationTypeResource.DEBITOR,
+                            HsOfficeRelationshipTypeResource.ACCOUNTING,
                             givenAnchorPerson.getUuid(),
                             GIVEN_NON_EXISTING_HOLDER_PERSON_UUID,
                             givenContact.getUuid()))
                     .port(port)
                 .when()
-                    .post("http://localhost/api/hs/office/relations")
+                    .post("http://localhost/api/hs/office/relationships")
                 .then().log().all().assertThat()
                     .statusCode(404)
-                    .body("message", is("cannot find holderUuid " + GIVEN_NON_EXISTING_HOLDER_PERSON_UUID));
+                    .body("message", is("cannot find relHolderUuid " + GIVEN_NON_EXISTING_HOLDER_PERSON_UUID));
             // @formatter:on
         }
 
         @Test
-        void globalAdmin_canNotAddRelation_ifContactDoesNotExist() {
+        void globalAdmin_canNotAddRelationship_ifContactDoesNotExist() {
 
             context.define("superuser-alex@hostsharing.net");
             final var givenAnchorPerson = personRepo.findPersonByOptionalNameLike("Third").get(0);
@@ -245,19 +245,19 @@ class HsOfficeRelationControllerAcceptanceTest extends ContextBasedTestWithClean
                     .contentType(ContentType.JSON)
                     .body("""
                            {
-                               "type": "%s",
-                               "anchorUuid": "%s",
-                               "holderUuid": "%s",
+                               "relType": "%s",
+                               "relAnchorUuid": "%s",
+                               "relHolderUuid": "%s",
                                "contactUuid": "%s"
                              }
                             """.formatted(
-                                    HsOfficeRelationTypeResource.DEBITOR,
+                                    HsOfficeRelationshipTypeResource.ACCOUNTING,
                                     givenAnchorPerson.getUuid(),
                                     givenHolderPerson.getUuid(),
                                     givenContactUuid))
                     .port(port)
                 .when()
-                    .post("http://localhost/api/hs/office/relations")
+                    .post("http://localhost/api/hs/office/relationships")
                 .then().log().all().assertThat()
                     .statusCode(404)
                     .body("message", is("cannot find contactUuid 00000000-0000-0000-0000-000000000000"));
@@ -266,97 +266,97 @@ class HsOfficeRelationControllerAcceptanceTest extends ContextBasedTestWithClean
     }
 
     @Nested
-    @Accepts({ "Relation:R(Read)" })
-    class GetRelation {
+    @Accepts({ "Relationship:R(Read)" })
+    class GetRelationship {
 
         @Test
-        void globalAdmin_withoutAssumedRole_canGetArbitraryRelation() {
+        void globalAdmin_withoutAssumedRole_canGetArbitraryRelationship() {
             context.define("superuser-alex@hostsharing.net");
-            final UUID givenRelationUuid = findRelation("First", "Firby").getUuid();
+            final UUID givenRelationshipUuid = findRelationship("First", "Firby").getUuid();
 
             RestAssured // @formatter:off
                 .given()
                     .header("current-user", "superuser-alex@hostsharing.net")
                     .port(port)
                 .when()
-                    .get("http://localhost/api/hs/office/relations/" + givenRelationUuid)
+                    .get("http://localhost/api/hs/office/relationships/" + givenRelationshipUuid)
                 .then().log().body().assertThat()
                     .statusCode(200)
                     .contentType("application/json")
                     .body("", lenientlyEquals("""
                     {
-                        "anchor": { "tradeName": "First GmbH" },
-                        "holder": { "familyName": "Firby" },
+                        "relAnchor": { "tradeName": "First GmbH" },
+                        "relHolder": { "familyName": "Firby" },
                         "contact": { "label": "first contact" }
                     }
                     """)); // @formatter:on
         }
 
         @Test
-        @Accepts({ "Relation:X(Access Control)" })
-        void normalUser_canNotGetUnrelatedRelation() {
+        @Accepts({ "Relationship:X(Access Control)" })
+        void normalUser_canNotGetUnrelatedRelationship() {
             context.define("superuser-alex@hostsharing.net");
-            final UUID givenRelationUuid = findRelation("First", "Firby").getUuid();
+            final UUID givenRelationshipUuid = findRelationship("First", "Firby").getUuid();
 
             RestAssured // @formatter:off
                 .given()
                     .header("current-user", "selfregistered-user-drew@hostsharing.org")
                     .port(port)
                 .when()
-                    .get("http://localhost/api/hs/office/relations/" + givenRelationUuid)
+                    .get("http://localhost/api/hs/office/relationships/" + givenRelationshipUuid)
                 .then().log().body().assertThat()
                     .statusCode(404); // @formatter:on
         }
 
         @Test
-        @Accepts({ "Relation:X(Access Control)" })
-        void contactAdminUser_canGetRelatedRelation() {
+        @Accepts({ "Relationship:X(Access Control)" })
+        void contactAdminUser_canGetRelatedRelationship() {
             context.define("superuser-alex@hostsharing.net");
-            final var givenRelation = findRelation("First", "Firby");
-            assertThat(givenRelation.getContact().getLabel()).isEqualTo("first contact");
+            final var givenRelationship = findRelationship("First", "Firby");
+            assertThat(givenRelationship.getContact().getLabel()).isEqualTo("first contact");
 
             RestAssured // @formatter:off
                 .given()
                     .header("current-user", "contact-admin@firstcontact.example.com")
                     .port(port)
                 .when()
-                    .get("http://localhost/api/hs/office/relations/" + givenRelation.getUuid())
+                    .get("http://localhost/api/hs/office/relationships/" + givenRelationship.getUuid())
                 .then().log().body().assertThat()
                     .statusCode(200)
                     .contentType("application/json")
                     .body("", lenientlyEquals("""
                     {
-                        "anchor": { "tradeName": "First GmbH" },
-                        "holder": { "familyName": "Firby" },
+                        "relAnchor": { "tradeName": "First GmbH" },
+                        "relHolder": { "familyName": "Firby" },
                         "contact": { "label": "first contact" }
                     }
                     """)); // @formatter:on
         }
     }
 
-    private HsOfficeRelationEntity findRelation(
+    private HsOfficeRelationshipEntity findRelationship(
             final String anchorPersonName,
             final String holderPersoneName) {
         final var anchorPersonUuid = personRepo.findPersonByOptionalNameLike(anchorPersonName).get(0).getUuid();
         final var holderPersonUuid = personRepo.findPersonByOptionalNameLike(holderPersoneName).get(0).getUuid();
-        final var givenRelation = relationRepo
-                .findRelationRelatedToPersonUuid(anchorPersonUuid)
+        final var givenRelationship = relationshipRepo
+                .findRelationshipRelatedToPersonUuid(anchorPersonUuid)
                 .stream()
-                .filter(r -> r.getHolder().getUuid().equals(holderPersonUuid))
+                .filter(r -> r.getRelHolder().getUuid().equals(holderPersonUuid))
                 .findFirst().orElseThrow();
-        return givenRelation;
+        return givenRelationship;
     }
 
     @Nested
-    @Accepts({ "Relation:U(Update)" })
-    class PatchRelation {
+    @Accepts({ "Relationship:U(Update)" })
+    class PatchRelationship {
 
         @Test
-        void globalAdmin_withoutAssumedRole_canPatchContactOfArbitraryRelation() {
+        void globalAdmin_withoutAssumedRole_canPatchContactOfArbitraryRelationship() {
 
             context.define("superuser-alex@hostsharing.net");
-            final var givenRelation = givenSomeTemporaryRelationBessler();
-            assertThat(givenRelation.getContact().getLabel()).isEqualTo("seventh contact");
+            final var givenRelationship = givenSomeTemporaryRelationshipBessler();
+            assertThat(givenRelationship.getContact().getLabel()).isEqualTo("seventh contact");
             final var givenContact = contactRepo.findContactByOptionalLabelLike("fourth").get(0);
 
             final var location = RestAssured // @formatter:off
@@ -370,109 +370,109 @@ class HsOfficeRelationControllerAcceptanceTest extends ContextBasedTestWithClean
                             """.formatted(givenContact.getUuid()))
                     .port(port)
                 .when()
-                    .patch("http://localhost/api/hs/office/relations/" + givenRelation.getUuid())
+                    .patch("http://localhost/api/hs/office/relationships/" + givenRelationship.getUuid())
                 .then().log().all().assertThat()
                     .statusCode(200)
                     .contentType(ContentType.JSON)
                     .body("uuid", isUuidValid())
-                    .body("type", is("REPRESENTATIVE"))
-                    .body("anchor.tradeName", is("Erben Bessler"))
-                    .body("holder.familyName", is("Winkler"))
+                    .body("relType", is("REPRESENTATIVE"))
+                    .body("relAnchor.tradeName", is("Erben Bessler"))
+                    .body("relHolder.familyName", is("Winkler"))
                     .body("contact.label", is("fourth contact"));
                 // @formatter:on
 
-            // finally, the relation is actually updated
+            // finally, the relationship is actually updated
             context.define("superuser-alex@hostsharing.net");
-            assertThat(relationRepo.findByUuid(givenRelation.getUuid())).isPresent().get()
+            assertThat(relationshipRepo.findByUuid(givenRelationship.getUuid())).isPresent().get()
                     .matches(rel -> {
-                        assertThat(rel.getAnchor().getTradeName()).contains("Bessler");
-                        assertThat(rel.getHolder().getFamilyName()).contains("Winkler");
+                        assertThat(rel.getRelAnchor().getTradeName()).contains("Bessler");
+                        assertThat(rel.getRelHolder().getFamilyName()).contains("Winkler");
                         assertThat(rel.getContact().getLabel()).isEqualTo("fourth contact");
-                        assertThat(rel.getType()).isEqualTo(HsOfficeRelationType.REPRESENTATIVE);
+                        assertThat(rel.getRelType()).isEqualTo(HsOfficeRelationshipType.REPRESENTATIVE);
                         return true;
                     });
         }
     }
 
     @Nested
-    @Accepts({ "Relation:D(Delete)" })
-    class DeleteRelation {
+    @Accepts({ "Relationship:D(Delete)" })
+    class DeleteRelationship {
 
         @Test
-        void globalAdmin_withoutAssumedRole_canDeleteArbitraryRelation() {
+        void globalAdmin_withoutAssumedRole_canDeleteArbitraryRelationship() {
             context.define("superuser-alex@hostsharing.net");
-            final var givenRelation = givenSomeTemporaryRelationBessler();
+            final var givenRelationship = givenSomeTemporaryRelationshipBessler();
 
             RestAssured // @formatter:off
                 .given()
                     .header("current-user", "superuser-alex@hostsharing.net")
                     .port(port)
                 .when()
-                    .delete("http://localhost/api/hs/office/relations/" + givenRelation.getUuid())
+                    .delete("http://localhost/api/hs/office/relationships/" + givenRelationship.getUuid())
                 .then().log().body().assertThat()
                     .statusCode(204); // @formatter:on
 
-            // then the given relation is gone
-            assertThat(relationRepo.findByUuid(givenRelation.getUuid())).isEmpty();
+            // then the given relationship is gone
+            assertThat(relationshipRepo.findByUuid(givenRelationship.getUuid())).isEmpty();
         }
 
         @Test
-        @Accepts({ "Relation:X(Access Control)" })
-        void contactAdminUser_canNotDeleteRelatedRelation() {
+        @Accepts({ "Relationship:X(Access Control)" })
+        void contactAdminUser_canNotDeleteRelatedRelationship() {
             context.define("superuser-alex@hostsharing.net");
-            final var givenRelation = givenSomeTemporaryRelationBessler();
-            assertThat(givenRelation.getContact().getLabel()).isEqualTo("seventh contact");
+            final var givenRelationship = givenSomeTemporaryRelationshipBessler();
+            assertThat(givenRelationship.getContact().getLabel()).isEqualTo("seventh contact");
 
             RestAssured // @formatter:off
                 .given()
                     .header("current-user", "contact-admin@seventhcontact.example.com")
                     .port(port)
                 .when()
-                    .delete("http://localhost/api/hs/office/relations/" + givenRelation.getUuid())
+                    .delete("http://localhost/api/hs/office/relationships/" + givenRelationship.getUuid())
                 .then().log().body().assertThat()
                     .statusCode(403); // @formatter:on
 
-            // then the given relation is still there
-            assertThat(relationRepo.findByUuid(givenRelation.getUuid())).isNotEmpty();
+            // then the given relationship is still there
+            assertThat(relationshipRepo.findByUuid(givenRelationship.getUuid())).isNotEmpty();
         }
 
         @Test
-        @Accepts({ "Relation:X(Access Control)" })
-        void normalUser_canNotDeleteUnrelatedRelation() {
+        @Accepts({ "Relationship:X(Access Control)" })
+        void normalUser_canNotDeleteUnrelatedRelationship() {
             context.define("superuser-alex@hostsharing.net");
-            final var givenRelation = givenSomeTemporaryRelationBessler();
-            assertThat(givenRelation.getContact().getLabel()).isEqualTo("seventh contact");
+            final var givenRelationship = givenSomeTemporaryRelationshipBessler();
+            assertThat(givenRelationship.getContact().getLabel()).isEqualTo("seventh contact");
 
             RestAssured // @formatter:off
                 .given()
                     .header("current-user", "selfregistered-user-drew@hostsharing.org")
                     .port(port)
                 .when()
-                    .delete("http://localhost/api/hs/office/relations/" + givenRelation.getUuid())
+                    .delete("http://localhost/api/hs/office/relationships/" + givenRelationship.getUuid())
                 .then().log().body().assertThat()
                     .statusCode(404); // @formatter:on
 
-            // then the given relation is still there
-            assertThat(relationRepo.findByUuid(givenRelation.getUuid())).isNotEmpty();
+            // then the given relationship is still there
+            assertThat(relationshipRepo.findByUuid(givenRelationship.getUuid())).isNotEmpty();
         }
     }
 
-    private HsOfficeRelationEntity givenSomeTemporaryRelationBessler() {
+    private HsOfficeRelationshipEntity givenSomeTemporaryRelationshipBessler() {
         return jpaAttempt.transacted(() -> {
             context.define("superuser-alex@hostsharing.net");
             final var givenAnchorPerson = personRepo.findPersonByOptionalNameLike("Erben Bessler").get(0);
             final var givenHolderPerson = personRepo.findPersonByOptionalNameLike("Winkler").get(0);
             final var givenContact = contactRepo.findContactByOptionalLabelLike("seventh contact").get(0);
-            final var newRelation = HsOfficeRelationEntity.builder()
-                    .type(HsOfficeRelationType.REPRESENTATIVE)
-                    .anchor(givenAnchorPerson)
-                    .holder(givenHolderPerson)
+            final var newRelationship = HsOfficeRelationshipEntity.builder()
+                    .relType(HsOfficeRelationshipType.REPRESENTATIVE)
+                    .relAnchor(givenAnchorPerson)
+                    .relHolder(givenHolderPerson)
                     .contact(givenContact)
                     .build();
 
-            assertThat(toCleanup(relationRepo.save(newRelation))).isEqualTo(newRelation);
+            assertThat(toCleanup(relationshipRepo.save(newRelationship))).isEqualTo(newRelationship);
 
-            return newRelation;
+            return newRelationship;
         }).assertSuccessful().returnedValue();
     }
 

src/test/java/net/hostsharing/hsadminng/hs/office/relationship/HsOfficeRelationshipEntityPatcherUnitTest.java

@@ -1,7 +1,7 @@
-package net.hostsharing.hsadminng.hs.office.relation;
+package net.hostsharing.hsadminng.hs.office.relationship;
 
 import net.hostsharing.hsadminng.hs.office.contact.HsOfficeContactEntity;
-import net.hostsharing.hsadminng.hs.office.generated.api.v1.model.HsOfficeRelationPatchResource;
+import net.hostsharing.hsadminng.hs.office.generated.api.v1.model.HsOfficeRelationshipPatchResource;
 import net.hostsharing.hsadminng.hs.office.person.HsOfficePersonEntity;
 import net.hostsharing.test.PatchUnitTestBase;
 import org.junit.jupiter.api.BeforeEach;
@@ -21,12 +21,12 @@ import static org.mockito.Mockito.lenient;
 
 @TestInstance(PER_CLASS)
 @ExtendWith(MockitoExtension.class)
-class HsOfficeRelationEntityPatcherUnitTest extends PatchUnitTestBase<
-        HsOfficeRelationPatchResource,
-        HsOfficeRelationEntity
+class HsOfficeRelationshipEntityPatcherUnitTest extends PatchUnitTestBase<
+        HsOfficeRelationshipPatchResource,
+        HsOfficeRelationshipEntity
         > {
 
-    static final UUID INITIAL_RELATION_UUID = UUID.randomUUID();
+    static final UUID INITIAL_RELATIONSHIP_UUID = UUID.randomUUID();
     static final UUID PATCHED_CONTACT_UUID = UUID.randomUUID();
 
     @Mock
@@ -49,24 +49,24 @@ class HsOfficeRelationEntityPatcherUnitTest extends PatchUnitTestBase<
             .build();
 
     @Override
-    protected HsOfficeRelationEntity newInitialEntity() {
-        final var entity = new HsOfficeRelationEntity();
-        entity.setUuid(INITIAL_RELATION_UUID);
-        entity.setType(HsOfficeRelationType.REPRESENTATIVE);
-        entity.setAnchor(givenInitialAnchorPerson);
-        entity.setHolder(givenInitialHolderPerson);
+    protected HsOfficeRelationshipEntity newInitialEntity() {
+        final var entity = new HsOfficeRelationshipEntity();
+        entity.setUuid(INITIAL_RELATIONSHIP_UUID);
+        entity.setRelType(HsOfficeRelationshipType.REPRESENTATIVE);
+        entity.setRelAnchor(givenInitialAnchorPerson);
+        entity.setRelHolder(givenInitialHolderPerson);
         entity.setContact(givenInitialContact);
         return entity;
     }
 
     @Override
-    protected HsOfficeRelationPatchResource newPatchResource() {
-        return new HsOfficeRelationPatchResource();
+    protected HsOfficeRelationshipPatchResource newPatchResource() {
+        return new HsOfficeRelationshipPatchResource();
     }
 
     @Override
-    protected HsOfficeRelationEntityPatcher createPatcher(final HsOfficeRelationEntity relation) {
-        return new HsOfficeRelationEntityPatcher(em, relation);
+    protected HsOfficeRelationshipEntityPatcher createPatcher(final HsOfficeRelationshipEntity relationship) {
+        return new HsOfficeRelationshipEntityPatcher(em, relationship);
     }
 
     @Override
@@ -74,9 +74,9 @@ class HsOfficeRelationEntityPatcherUnitTest extends PatchUnitTestBase<
         return Stream.of(
                 new JsonNullableProperty<>(
                         "contact",
-                        HsOfficeRelationPatchResource::setContactUuid,
+                        HsOfficeRelationshipPatchResource::setContactUuid,
                         PATCHED_CONTACT_UUID,
-                        HsOfficeRelationEntity::setContact,
+                        HsOfficeRelationshipEntity::setContact,
                         newContact(PATCHED_CONTACT_UUID))
                         .notNullable()
         );

src/test/java/net/hostsharing/hsadminng/hs/office/relationship/HsOfficeRelationshipEntityUnitTest.java

@@ -0,0 +1,44 @@
+package net.hostsharing.hsadminng.hs.office.relationship;
+
+import net.hostsharing.hsadminng.hs.office.person.HsOfficePersonEntity;
+import net.hostsharing.hsadminng.hs.office.person.HsOfficePersonType;
+import org.junit.jupiter.api.Test;
+
+import static org.assertj.core.api.Assertions.assertThat;
+import static org.junit.jupiter.api.Assertions.*;
+
+class HsOfficeRelationshipEntityUnitTest {
+
+    private HsOfficePersonEntity anchor = HsOfficePersonEntity.builder()
+            .personType(HsOfficePersonType.LEGAL_PERSON)
+            .tradeName("some trade name")
+            .build();
+    private HsOfficePersonEntity holder = HsOfficePersonEntity.builder()
+            .personType(HsOfficePersonType.NATURAL_PERSON)
+            .familyName("Meier")
+            .givenName("Mellie")
+            .build();
+
+    @Test
+    void toStringReturnsAllProperties() {
+        final var given = HsOfficeRelationshipEntity.builder()
+                .relType(HsOfficeRelationshipType.SUBSCRIBER)
+                .relMark("members-announce")
+                .relAnchor(anchor)
+                .relHolder(holder)
+                .build();
+
+        assertThat(given.toString()).isEqualTo("rel(relAnchor='LP some trade name', relType='SUBSCRIBER', relMark='members-announce', relHolder='NP Meier, Mellie')");
+    }
+
+    @Test
+    void toShortString() {
+        final var given = HsOfficeRelationshipEntity.builder()
+                .relType(HsOfficeRelationshipType.REPRESENTATIVE)
+                .relAnchor(anchor)
+                .relHolder(holder)
+                .build();
+
+        assertThat(given.toShortString()).isEqualTo("rel(relAnchor='LP some trade name', relType='REPRESENTATIVE', relHolder='NP Meier, Mellie')");
+    }
+}

src/test/java/net/hostsharing/hsadminng/hs/office/relationship/HsOfficeRelationshipRepositoryIntegrationTest.java

@@ -1,4 +1,4 @@
-package net.hostsharing.hsadminng.hs.office.relation;
+package net.hostsharing.hsadminng.hs.office.relationship;
 
 import net.hostsharing.hsadminng.context.Context;
 import net.hostsharing.hsadminng.hs.office.contact.HsOfficeContactRepository;
@@ -31,10 +31,10 @@ import static org.assertj.core.api.Assertions.assertThat;
 
 @DataJpaTest
 @Import( { Context.class, JpaAttempt.class })
-class HsOfficeRelationRepositoryIntegrationTest extends ContextBasedTestWithCleanup {
+class HsOfficeRelationshipRepositoryIntegrationTest extends ContextBasedTestWithCleanup {
 
     @Autowired
-    HsOfficeRelationRepository relationRepo;
+    HsOfficeRelationshipRepository relationshipRepo;
 
     @Autowired
     HsOfficePersonRepository personRepo;
@@ -58,13 +58,13 @@ class HsOfficeRelationRepositoryIntegrationTest extends ContextBasedTestWithClea
     HttpServletRequest request;
 
     @Nested
-    class CreateRelation {
+    class CreateRelationship {
 
         @Test
-        public void testHostsharingAdmin_withoutAssumedRole_canCreateNewRelation() {
+        public void testHostsharingAdmin_withoutAssumedRole_canCreateNewRelationship() {
             // given
             context("superuser-alex@hostsharing.net");
-            final var count = relationRepo.count();
+            final var count = relationshipRepo.count();
             final var givenAnchorPerson = personRepo.findPersonByOptionalNameLike("Bessler").stream()
                     .filter(p -> p.getPersonType() == UNINCORPORATED_FIRM)
                     .findFirst().orElseThrow();
@@ -76,20 +76,20 @@ class HsOfficeRelationRepositoryIntegrationTest extends ContextBasedTestWithClea
 
             // when
             final var result = attempt(em, () -> {
-                final var newRelation = HsOfficeRelationEntity.builder()
-                        .anchor(givenAnchorPerson)
-                        .holder(givenHolderPerson)
-                        .type(HsOfficeRelationType.REPRESENTATIVE)
+                final var newRelationship = HsOfficeRelationshipEntity.builder()
+                        .relAnchor(givenAnchorPerson)
+                        .relHolder(givenHolderPerson)
+                        .relType(HsOfficeRelationshipType.REPRESENTATIVE)
                         .contact(givenContact)
                         .build();
-                return toCleanup(relationRepo.save(newRelation));
+                return toCleanup(relationshipRepo.save(newRelationship));
             });
 
             // then
             result.assertSuccessful();
-            assertThat(result.returnedValue()).isNotNull().extracting(HsOfficeRelationEntity::getUuid).isNotNull();
-            assertThatRelationIsPersisted(result.returnedValue());
-            assertThat(relationRepo.count()).isEqualTo(count + 1);
+            assertThat(result.returnedValue()).isNotNull().extracting(HsOfficeRelationshipEntity::getUuid).isNotNull();
+            assertThatRelationshipIsPersisted(result.returnedValue());
+            assertThat(relationshipRepo.count()).isEqualTo(count + 1);
         }
 
         @Test
@@ -109,62 +109,62 @@ class HsOfficeRelationRepositoryIntegrationTest extends ContextBasedTestWithClea
                         .findFirst().orElseThrow();
                 final var givenContact = contactRepo.findContactByOptionalLabelLike("fourth contact").stream()
                         .findFirst().orElseThrow();
-                final var newRelation = HsOfficeRelationEntity.builder()
-                        .anchor(givenAnchorPerson)
-                        .holder(givenHolderPerson)
-                        .type(HsOfficeRelationType.REPRESENTATIVE)
+                final var newRelationship = HsOfficeRelationshipEntity.builder()
+                        .relAnchor(givenAnchorPerson)
+                        .relHolder(givenHolderPerson)
+                        .relType(HsOfficeRelationshipType.REPRESENTATIVE)
                         .contact(givenContact)
                         .build();
-                return toCleanup(relationRepo.save(newRelation));
+                return toCleanup(relationshipRepo.save(newRelationship));
             });
 
             // then
             assertThat(distinctRoleNamesOf(rawRoleRepo.findAll())).containsExactlyInAnyOrder(Array.from(
                     initialRoleNames,
-                    "hs_office_relation#ErbenBesslerMelBessler-with-REPRESENTATIVE-BesslerBert.owner",
-                    "hs_office_relation#ErbenBesslerMelBessler-with-REPRESENTATIVE-BesslerBert.admin",
-                    "hs_office_relation#ErbenBesslerMelBessler-with-REPRESENTATIVE-BesslerBert.agent",
-                    "hs_office_relation#ErbenBesslerMelBessler-with-REPRESENTATIVE-BesslerBert.tenant"));
+                    "hs_office_relationship#ErbenBesslerMelBessler-with-REPRESENTATIVE-BesslerBert.owner",
+                    "hs_office_relationship#ErbenBesslerMelBessler-with-REPRESENTATIVE-BesslerBert.admin",
+                    "hs_office_relationship#ErbenBesslerMelBessler-with-REPRESENTATIVE-BesslerBert.agent",
+                    "hs_office_relationship#ErbenBesslerMelBessler-with-REPRESENTATIVE-BesslerBert.tenant"));
             assertThat(distinctGrantDisplaysOf(rawGrantRepo.findAll())).containsExactlyInAnyOrder(Array.fromFormatted(
                     initialGrantNames,
-                    "{ grant perm INSERT on hs_office_relation#ErbenBesslerMelBessler-with-REPRESENTATIVE-BesslerBert to role hs_office_relation#ErbenBesslerMelBessler-with-REPRESENTATIVE-BesslerBert.admin by system and assume }",
+                    "{ grant perm INSERT on hs_office_relationship#ErbenBesslerMelBessler-with-REPRESENTATIVE-BesslerBert to role hs_office_relationship#ErbenBesslerMelBessler-with-REPRESENTATIVE-BesslerBert.admin by system and assume }",
 
-                    "{ grant perm DELETE on hs_office_relation#ErbenBesslerMelBessler-with-REPRESENTATIVE-BesslerBert to role hs_office_relation#ErbenBesslerMelBessler-with-REPRESENTATIVE-BesslerBert.owner by system and assume }",
-                    "{ grant role hs_office_relation#ErbenBesslerMelBessler-with-REPRESENTATIVE-BesslerBert.owner to role global#global.admin by system and assume }",
-                    "{ grant role hs_office_relation#ErbenBesslerMelBessler-with-REPRESENTATIVE-BesslerBert.owner to user superuser-alex@hostsharing.net by hs_office_relation#ErbenBesslerMelBessler-with-REPRESENTATIVE-BesslerBert.owner and assume }",
+                    "{ grant perm DELETE on hs_office_relationship#ErbenBesslerMelBessler-with-REPRESENTATIVE-BesslerBert to role hs_office_relationship#ErbenBesslerMelBessler-with-REPRESENTATIVE-BesslerBert.owner by system and assume }",
+                    "{ grant role hs_office_relationship#ErbenBesslerMelBessler-with-REPRESENTATIVE-BesslerBert.owner to role global#global.admin by system and assume }",
+                    "{ grant role hs_office_relationship#ErbenBesslerMelBessler-with-REPRESENTATIVE-BesslerBert.owner to user superuser-alex@hostsharing.net by hs_office_relationship#ErbenBesslerMelBessler-with-REPRESENTATIVE-BesslerBert.owner and assume }",
 
-                    "{ grant perm UPDATE on hs_office_relation#ErbenBesslerMelBessler-with-REPRESENTATIVE-BesslerBert to role hs_office_relation#ErbenBesslerMelBessler-with-REPRESENTATIVE-BesslerBert.admin by system and assume }",
-                    "{ grant role hs_office_relation#ErbenBesslerMelBessler-with-REPRESENTATIVE-BesslerBert.admin to role hs_office_relation#ErbenBesslerMelBessler-with-REPRESENTATIVE-BesslerBert.owner by system and assume }",
-                    "{ grant role hs_office_relation#ErbenBesslerMelBessler-with-REPRESENTATIVE-BesslerBert.admin to role hs_office_person#ErbenBesslerMelBessler.admin by system and assume }",
+                    "{ grant perm UPDATE on hs_office_relationship#ErbenBesslerMelBessler-with-REPRESENTATIVE-BesslerBert to role hs_office_relationship#ErbenBesslerMelBessler-with-REPRESENTATIVE-BesslerBert.admin by system and assume }",
+                    "{ grant role hs_office_relationship#ErbenBesslerMelBessler-with-REPRESENTATIVE-BesslerBert.admin to role hs_office_relationship#ErbenBesslerMelBessler-with-REPRESENTATIVE-BesslerBert.owner by system and assume }",
+                    "{ grant role hs_office_relationship#ErbenBesslerMelBessler-with-REPRESENTATIVE-BesslerBert.admin to role hs_office_person#ErbenBesslerMelBessler.admin by system and assume }",
 
-                    "{ grant role hs_office_relation#ErbenBesslerMelBessler-with-REPRESENTATIVE-BesslerBert.agent to role hs_office_person#BesslerBert.admin by system and assume }",
-                    "{ grant role hs_office_relation#ErbenBesslerMelBessler-with-REPRESENTATIVE-BesslerBert.agent to role hs_office_relation#ErbenBesslerMelBessler-with-REPRESENTATIVE-BesslerBert.admin by system and assume }",
+                    "{ grant role hs_office_relationship#ErbenBesslerMelBessler-with-REPRESENTATIVE-BesslerBert.agent to role hs_office_person#BesslerBert.admin by system and assume }",
+                    "{ grant role hs_office_relationship#ErbenBesslerMelBessler-with-REPRESENTATIVE-BesslerBert.agent to role hs_office_relationship#ErbenBesslerMelBessler-with-REPRESENTATIVE-BesslerBert.admin by system and assume }",
 
-                    "{ grant perm SELECT on hs_office_relation#ErbenBesslerMelBessler-with-REPRESENTATIVE-BesslerBert to role hs_office_relation#ErbenBesslerMelBessler-with-REPRESENTATIVE-BesslerBert.tenant by system and assume }",
-                    "{ grant role hs_office_relation#ErbenBesslerMelBessler-with-REPRESENTATIVE-BesslerBert.tenant to role hs_office_relation#ErbenBesslerMelBessler-with-REPRESENTATIVE-BesslerBert.agent by system and assume }",
-                    "{ grant role hs_office_person#BesslerBert.referrer to role hs_office_relation#ErbenBesslerMelBessler-with-REPRESENTATIVE-BesslerBert.tenant by system and assume }",
-                    "{ grant role hs_office_person#ErbenBesslerMelBessler.referrer to role hs_office_relation#ErbenBesslerMelBessler-with-REPRESENTATIVE-BesslerBert.tenant by system and assume }",
-                    "{ grant role hs_office_contact#fourthcontact.referrer to role hs_office_relation#ErbenBesslerMelBessler-with-REPRESENTATIVE-BesslerBert.tenant by system and assume }",
+                    "{ grant perm SELECT on hs_office_relationship#ErbenBesslerMelBessler-with-REPRESENTATIVE-BesslerBert to role hs_office_relationship#ErbenBesslerMelBessler-with-REPRESENTATIVE-BesslerBert.tenant by system and assume }",
+                    "{ grant role hs_office_relationship#ErbenBesslerMelBessler-with-REPRESENTATIVE-BesslerBert.tenant to role hs_office_relationship#ErbenBesslerMelBessler-with-REPRESENTATIVE-BesslerBert.agent by system and assume }",
+                    "{ grant role hs_office_person#BesslerBert.referrer to role hs_office_relationship#ErbenBesslerMelBessler-with-REPRESENTATIVE-BesslerBert.tenant by system and assume }",
+                    "{ grant role hs_office_person#ErbenBesslerMelBessler.referrer to role hs_office_relationship#ErbenBesslerMelBessler-with-REPRESENTATIVE-BesslerBert.tenant by system and assume }",
+                    "{ grant role hs_office_contact#fourthcontact.referrer to role hs_office_relationship#ErbenBesslerMelBessler-with-REPRESENTATIVE-BesslerBert.tenant by system and assume }",
 
                     // REPRESENTATIVE holder person -> (represented) anchor person
-                    "{ grant role hs_office_relation#ErbenBesslerMelBessler-with-REPRESENTATIVE-BesslerBert.tenant to role hs_office_contact#fourthcontact.admin by system and assume }",
-                    "{ grant role hs_office_relation#ErbenBesslerMelBessler-with-REPRESENTATIVE-BesslerBert.tenant to role hs_office_person#BesslerBert.admin by system and assume }",
+                    "{ grant role hs_office_relationship#ErbenBesslerMelBessler-with-REPRESENTATIVE-BesslerBert.tenant to role hs_office_contact#fourthcontact.admin by system and assume }",
+                    "{ grant role hs_office_relationship#ErbenBesslerMelBessler-with-REPRESENTATIVE-BesslerBert.tenant to role hs_office_person#BesslerBert.admin by system and assume }",
 
                     null)
             );
         }
 
-        private void assertThatRelationIsPersisted(final HsOfficeRelationEntity saved) {
-            final var found = relationRepo.findByUuid(saved.getUuid());
+        private void assertThatRelationshipIsPersisted(final HsOfficeRelationshipEntity saved) {
+            final var found = relationshipRepo.findByUuid(saved.getUuid());
             assertThat(found).isNotEmpty().get().usingRecursiveComparison().isEqualTo(saved);
         }
     }
 
     @Nested
-    class FindAllRelations {
+    class FindAllRelationships {
 
         @Test
-        public void globalAdmin_withoutAssumedRole_canViewAllRelationsOfArbitraryPerson() {
+        public void globalAdmin_withoutAssumedRole_canViewAllRelationshipsOfArbitraryPerson() {
             // given
             context("superuser-alex@hostsharing.net");
             final var person = personRepo.findPersonByOptionalNameLike("Smith").stream()
@@ -172,18 +172,18 @@ class HsOfficeRelationRepositoryIntegrationTest extends ContextBasedTestWithClea
                     .findFirst().orElseThrow();
 
             // when
-            final var result = relationRepo.findRelationRelatedToPersonUuid(person.getUuid());
+            final var result = relationshipRepo.findRelationshipRelatedToPersonUuid(person.getUuid());
 
             // then
-            allTheseRelationsAreReturned(
+            allTheseRelationshipsAreReturned(
                     result,
-                    "rel(anchor='LP Hostsharing eG', type='PARTNER', holder='NP Smith, Peter', contact='sixth contact')",
-                    "rel(anchor='LP Second e.K.', type='REPRESENTATIVE', holder='NP Smith, Peter', contact='second contact')",
-                    "rel(anchor='IF Third OHG', type='SUBSCRIBER', mark='members-announce', holder='NP Smith, Peter', contact='third contact')");
+                    "rel(relAnchor='LP Hostsharing eG', relType='PARTNER', relHolder='NP Smith, Peter', contact='sixth contact')",
+                    "rel(relAnchor='LP Second e.K.', relType='REPRESENTATIVE', relHolder='NP Smith, Peter', contact='second contact')",
+                    "rel(relAnchor='IF Third OHG', relType='SUBSCRIBER', relMark='members-announce', relHolder='NP Smith, Peter', contact='third contact')");
         }
 
         @Test
-        public void normalUser_canViewRelationsOfOwnedPersons() {
+        public void normalUser_canViewRelationshipsOfOwnedPersons() {
             // given:
             context("person-SmithPeter@example.com");
             final var person = personRepo.findPersonByOptionalNameLike("Smith").stream()
@@ -191,124 +191,124 @@ class HsOfficeRelationRepositoryIntegrationTest extends ContextBasedTestWithClea
                     .findFirst().orElseThrow();
 
             // when:
-            final var result = relationRepo.findRelationRelatedToPersonUuid(person.getUuid());
+            final var result = relationshipRepo.findRelationshipRelatedToPersonUuid(person.getUuid());
 
             // then:
-            exactlyTheseRelationsAreReturned(
+            exactlyTheseRelationshipsAreReturned(
                     result,
-                    "rel(anchor='LP Second e.K.', type='REPRESENTATIVE', holder='NP Smith, Peter', contact='second contact')",
-                    "rel(anchor='IF Third OHG', type='SUBSCRIBER', mark='members-announce', holder='NP Smith, Peter', contact='third contact')",
-                    "rel(anchor='LP Hostsharing eG', type='PARTNER', holder='NP Smith, Peter', contact='sixth contact')",
-                    "rel(anchor='NP Smith, Peter', type='DEBITOR', holder='NP Smith, Peter', contact='third contact')");
+                    "rel(relAnchor='LP Second e.K.', relType='REPRESENTATIVE', relHolder='NP Smith, Peter', contact='second contact')",
+                    "rel(relAnchor='IF Third OHG', relType='SUBSCRIBER', relMark='members-announce', relHolder='NP Smith, Peter', contact='third contact')",
+                    "rel(relAnchor='LP Hostsharing eG', relType='PARTNER', relHolder='NP Smith, Peter', contact='sixth contact')",
+                    "rel(relAnchor='NP Smith, Peter', relType='ACCOUNTING', relHolder='NP Smith, Peter', contact='third contact')");
         }
     }
 
     @Nested
-    class UpdateRelation {
+    class UpdateRelationship {
 
         @Test
-        public void hostsharingAdmin_withoutAssumedRole_canUpdateContactOfArbitraryRelation() {
+        public void hostsharingAdmin_withoutAssumedRole_canUpdateContactOfArbitraryRelationship() {
             // given
             context("superuser-alex@hostsharing.net");
-            final var givenRelation = givenSomeTemporaryRelationBessler(
+            final var givenRelationship = givenSomeTemporaryRelationshipBessler(
                     "Bert", "fifth contact");
-            assertThatRelationIsVisibleForUserWithRole(
-                    givenRelation,
+            assertThatRelationshipIsVisibleForUserWithRole(
+                    givenRelationship,
                     "hs_office_person#ErbenBesslerMelBessler.admin");
-            assertThatRelationActuallyInDatabase(givenRelation);
+            assertThatRelationshipActuallyInDatabase(givenRelationship);
             context("superuser-alex@hostsharing.net");
             final var givenContact = contactRepo.findContactByOptionalLabelLike("sixth contact").stream().findFirst().orElseThrow();
 
             // when
             final var result = jpaAttempt.transacted(() -> {
                 context("superuser-alex@hostsharing.net");
-                givenRelation.setContact(givenContact);
-                return toCleanup(relationRepo.save(givenRelation));
+                givenRelationship.setContact(givenContact);
+                return toCleanup(relationshipRepo.save(givenRelationship));
             });
 
             // then
             result.assertSuccessful();
             assertThat(result.returnedValue().getContact().getLabel()).isEqualTo("sixth contact");
-            assertThatRelationIsVisibleForUserWithRole(
+            assertThatRelationshipIsVisibleForUserWithRole(
                     result.returnedValue(),
                     "global#global.admin");
-            assertThatRelationIsVisibleForUserWithRole(
+            assertThatRelationshipIsVisibleForUserWithRole(
                     result.returnedValue(),
                     "hs_office_contact#sixthcontact.admin");
 
-            assertThatRelationIsNotVisibleForUserWithRole(
+            assertThatRelationshipIsNotVisibleForUserWithRole(
                     result.returnedValue(),
                     "hs_office_contact#fifthcontact.admin");
 
-            relationRepo.deleteByUuid(givenRelation.getUuid());
+            relationshipRepo.deleteByUuid(givenRelationship.getUuid());
         }
 
         @Test
-        public void holderAdmin_canNotUpdateRelatedRelation() {
+        public void relHolderAdmin_canNotUpdateRelatedRelationship() {
             // given
             context("superuser-alex@hostsharing.net");
-            final var givenRelation = givenSomeTemporaryRelationBessler(
+            final var givenRelationship = givenSomeTemporaryRelationshipBessler(
                     "Anita", "eighth");
-            assertThatRelationIsVisibleForUserWithRole(
-                    givenRelation,
+            assertThatRelationshipIsVisibleForUserWithRole(
+                    givenRelationship,
                     "hs_office_person#BesslerAnita.admin");
-            assertThatRelationActuallyInDatabase(givenRelation);
+            assertThatRelationshipActuallyInDatabase(givenRelationship);
 
             // when
             final var result = jpaAttempt.transacted(() -> {
                 context("superuser-alex@hostsharing.net", "hs_office_person#BesslerAnita.admin");
-                givenRelation.setContact(null);
-                return relationRepo.save(givenRelation);
+                givenRelationship.setContact(null);
+                return relationshipRepo.save(givenRelationship);
             });
 
             // then
             result.assertExceptionWithRootCauseMessage(JpaSystemException.class,
-                    "[403] Subject ", " is not allowed to update hs_office_relation uuid");
+                    "[403] Subject ", " is not allowed to update hs_office_relationship uuid");
         }
 
         @Test
-        public void contactAdmin_canNotUpdateRelatedRelation() {
+        public void contactAdmin_canNotUpdateRelatedRelationship() {
             // given
             context("superuser-alex@hostsharing.net");
-            final var givenRelation = givenSomeTemporaryRelationBessler(
+            final var givenRelationship = givenSomeTemporaryRelationshipBessler(
                     "Anita", "ninth");
-            assertThatRelationIsVisibleForUserWithRole(
-                    givenRelation,
+            assertThatRelationshipIsVisibleForUserWithRole(
+                    givenRelationship,
                     "hs_office_contact#ninthcontact.admin");
-            assertThatRelationActuallyInDatabase(givenRelation);
+            assertThatRelationshipActuallyInDatabase(givenRelationship);
 
             // when
             final var result = jpaAttempt.transacted(() -> {
                 context("superuser-alex@hostsharing.net", "hs_office_contact#ninthcontact.admin");
-                givenRelation.setContact(null); // TODO
-                return relationRepo.save(givenRelation);
+                givenRelationship.setContact(null); // TODO
+                return relationshipRepo.save(givenRelationship);
             });
 
             // then
             result.assertExceptionWithRootCauseMessage(JpaSystemException.class,
-                    "[403] Subject ", " is not allowed to update hs_office_relation uuid");
+                    "[403] Subject ", " is not allowed to update hs_office_relationship uuid");
         }
 
-        private void assertThatRelationActuallyInDatabase(final HsOfficeRelationEntity saved) {
-            final var found = relationRepo.findByUuid(saved.getUuid());
+        private void assertThatRelationshipActuallyInDatabase(final HsOfficeRelationshipEntity saved) {
+            final var found = relationshipRepo.findByUuid(saved.getUuid());
             assertThat(found).isNotEmpty().get().isNotSameAs(saved).usingRecursiveComparison().isEqualTo(saved);
         }
 
-        private void assertThatRelationIsVisibleForUserWithRole(
-                final HsOfficeRelationEntity entity,
+        private void assertThatRelationshipIsVisibleForUserWithRole(
+                final HsOfficeRelationshipEntity entity,
                 final String assumedRoles) {
             jpaAttempt.transacted(() -> {
                 context("superuser-alex@hostsharing.net", assumedRoles);
-                assertThatRelationActuallyInDatabase(entity);
+                assertThatRelationshipActuallyInDatabase(entity);
             }).assertSuccessful();
         }
 
-        private void assertThatRelationIsNotVisibleForUserWithRole(
-                final HsOfficeRelationEntity entity,
+        private void assertThatRelationshipIsNotVisibleForUserWithRole(
+                final HsOfficeRelationshipEntity entity,
                 final String assumedRoles) {
             jpaAttempt.transacted(() -> {
                 context("superuser-alex@hostsharing.net", assumedRoles);
-                final var found = relationRepo.findByUuid(entity.getUuid());
+                final var found = relationshipRepo.findByUuid(entity.getUuid());
                 assertThat(found).isEmpty();
             }).assertSuccessful();
         }
@@ -318,63 +318,63 @@ class HsOfficeRelationRepositoryIntegrationTest extends ContextBasedTestWithClea
     class DeleteByUuid {
 
         @Test
-        public void globalAdmin_withoutAssumedRole_canDeleteAnyRelation() {
+        public void globalAdmin_withoutAssumedRole_canDeleteAnyRelationship() {
             // given
             context("superuser-alex@hostsharing.net", null);
-            final var givenRelation = givenSomeTemporaryRelationBessler(
+            final var givenRelationship = givenSomeTemporaryRelationshipBessler(
                     "Anita", "tenth");
 
             // when
             final var result = jpaAttempt.transacted(() -> {
                 context("superuser-alex@hostsharing.net");
-                relationRepo.deleteByUuid(givenRelation.getUuid());
+                relationshipRepo.deleteByUuid(givenRelationship.getUuid());
             });
 
             // then
             result.assertSuccessful();
             assertThat(jpaAttempt.transacted(() -> {
                 context("superuser-fran@hostsharing.net", null);
-                return relationRepo.findByUuid(givenRelation.getUuid());
+                return relationshipRepo.findByUuid(givenRelationship.getUuid());
             }).assertSuccessful().returnedValue()).isEmpty();
         }
 
         @Test
-        public void contactUser_canViewButNotDeleteTheirRelatedRelation() {
+        public void contactUser_canViewButNotDeleteTheirRelatedRelationship() {
             // given
             context("superuser-alex@hostsharing.net", null);
-            final var givenRelation = givenSomeTemporaryRelationBessler(
+            final var givenRelationship = givenSomeTemporaryRelationshipBessler(
                     "Anita", "eleventh");
 
             // when
             final var result = jpaAttempt.transacted(() -> {
                 context("contact-admin@eleventhcontact.example.com");
-                assertThat(relationRepo.findByUuid(givenRelation.getUuid())).isPresent();
-                relationRepo.deleteByUuid(givenRelation.getUuid());
+                assertThat(relationshipRepo.findByUuid(givenRelationship.getUuid())).isPresent();
+                relationshipRepo.deleteByUuid(givenRelationship.getUuid());
             });
 
             // then
             result.assertExceptionWithRootCauseMessage(
                     JpaSystemException.class,
-                    "[403] Subject ", " not allowed to delete hs_office_relation");
+                    "[403] Subject ", " not allowed to delete hs_office_relationship");
             assertThat(jpaAttempt.transacted(() -> {
                 context("superuser-alex@hostsharing.net");
-                return relationRepo.findByUuid(givenRelation.getUuid());
+                return relationshipRepo.findByUuid(givenRelationship.getUuid());
             }).assertSuccessful().returnedValue()).isPresent(); // still there
         }
 
         @Test
-        public void deletingARelationAlsoDeletesRelatedRolesAndGrants() {
+        public void deletingARelationshipAlsoDeletesRelatedRolesAndGrants() {
             // given
             context("superuser-alex@hostsharing.net");
             final var initialRoleNames = Array.from(distinctRoleNamesOf(rawRoleRepo.findAll()));
             final var initialGrantNames = Array.from(distinctGrantDisplaysOf(rawGrantRepo.findAll()));
-            final var givenRelation = givenSomeTemporaryRelationBessler(
+            final var givenRelationship = givenSomeTemporaryRelationshipBessler(
                     "Anita", "twelfth");
 
             // when
             final var result = jpaAttempt.transacted(() -> {
                 context("superuser-alex@hostsharing.net");
-                return relationRepo.deleteByUuid(givenRelation.getUuid());
+                return relationshipRepo.deleteByUuid(givenRelationship.getUuid());
             });
 
             // then
@@ -391,7 +391,7 @@ class HsOfficeRelationRepositoryIntegrationTest extends ContextBasedTestWithClea
         final var query = em.createNativeQuery("""
                 select currentTask, targetTable, targetOp
                     from tx_journal_v
-                    where targettable = 'hs_office_relation';
+                    where targettable = 'hs_office_relationship';
                     """);
 
         // when
@@ -399,40 +399,40 @@ class HsOfficeRelationRepositoryIntegrationTest extends ContextBasedTestWithClea
 
         // then
         assertThat(customerLogEntries).map(Arrays::toString).contains(
-                "[creating relation test-data HostsharingeG-FirstGmbH, hs_office_relation, INSERT]",
-                "[creating relation test-data FirstGmbH-Firby, hs_office_relation, INSERT]");
+                "[creating relationship test-data HostsharingeG-FirstGmbH, hs_office_relationship, INSERT]",
+                "[creating relationship test-data FirstGmbH-Firby, hs_office_relationship, INSERT]");
     }
 
-    private HsOfficeRelationEntity givenSomeTemporaryRelationBessler(final String holderPerson, final String contact) {
+    private HsOfficeRelationshipEntity givenSomeTemporaryRelationshipBessler(final String holderPerson, final String contact) {
         return jpaAttempt.transacted(() -> {
             context("superuser-alex@hostsharing.net");
             final var givenAnchorPerson = personRepo.findPersonByOptionalNameLike("Erben Bessler").get(0);
             final var givenHolderPerson = personRepo.findPersonByOptionalNameLike(holderPerson).get(0);
             final var givenContact = contactRepo.findContactByOptionalLabelLike(contact).get(0);
-            final var newRelation = HsOfficeRelationEntity.builder()
-                    .type(HsOfficeRelationType.REPRESENTATIVE)
-                    .anchor(givenAnchorPerson)
-                    .holder(givenHolderPerson)
+            final var newRelationship = HsOfficeRelationshipEntity.builder()
+                    .relType(HsOfficeRelationshipType.REPRESENTATIVE)
+                    .relAnchor(givenAnchorPerson)
+                    .relHolder(givenHolderPerson)
                     .contact(givenContact)
                     .build();
 
-            return toCleanup(relationRepo.save(newRelation));
+            return toCleanup(relationshipRepo.save(newRelationship));
         }).assertSuccessful().returnedValue();
     }
 
-    void exactlyTheseRelationsAreReturned(
-            final List<HsOfficeRelationEntity> actualResult,
-            final String... relationNames) {
+    void exactlyTheseRelationshipsAreReturned(
+            final List<HsOfficeRelationshipEntity> actualResult,
+            final String... relationshipNames) {
         assertThat(actualResult)
-                .extracting(HsOfficeRelationEntity::toString)
-                .containsExactlyInAnyOrder(relationNames);
+                .extracting(HsOfficeRelationshipEntity::toString)
+                .containsExactlyInAnyOrder(relationshipNames);
     }
 
-    void allTheseRelationsAreReturned(
-            final List<HsOfficeRelationEntity> actualResult,
-            final String... relationNames) {
+    void allTheseRelationshipsAreReturned(
+            final List<HsOfficeRelationshipEntity> actualResult,
+            final String... relationshipNames) {
         assertThat(actualResult)
-                .extracting(HsOfficeRelationEntity::toString)
-                .contains(relationNames);
+                .extracting(HsOfficeRelationshipEntity::toString)
+                .contains(relationshipNames);
     }
 }

src/test/java/net/hostsharing/hsadminng/hs/office/sepamandate/HsOfficeSepaMandateControllerAcceptanceTest.java

@@ -357,7 +357,7 @@ class HsOfficeSepaMandateControllerAcceptanceTest extends ContextBasedTestWithCl
             context.define("superuser-alex@hostsharing.net");
             assertThat(sepaMandateRepo.findByUuid(givenSepaMandate.getUuid())).isPresent().get()
                     .matches(mandate -> {
-                        assertThat(mandate.getDebitor().toString()).isEqualTo("debitor(D-1000111: rel(anchor='LP First GmbH', type='DEBITOR', holder='LP First GmbH'), fir)");
+                        assertThat(mandate.getDebitor().toString()).isEqualTo("debitor(D-1000111: rel(relAnchor='LP First GmbH', relType='ACCOUNTING', relHolder='LP First GmbH'), fir)");
                         assertThat(mandate.getBankAccount().toShortString()).isEqualTo("First GmbH");
                         assertThat(mandate.getReference()).isEqualTo("temp ref CAT Z - patched");
                         assertThat(mandate.getValidFrom()).isEqualTo("2020-06-05");
@@ -398,7 +398,7 @@ class HsOfficeSepaMandateControllerAcceptanceTest extends ContextBasedTestWithCl
             // finally, the sepaMandate is actually updated
             assertThat(sepaMandateRepo.findByUuid(givenSepaMandate.getUuid())).isPresent().get()
                     .matches(mandate -> {
-                        assertThat(mandate.getDebitor().toString()).isEqualTo("debitor(D-1000111: rel(anchor='LP First GmbH', type='DEBITOR', holder='LP First GmbH'), fir)");
+                        assertThat(mandate.getDebitor().toString()).isEqualTo("debitor(D-1000111: rel(relAnchor='LP First GmbH', relType='ACCOUNTING', relHolder='LP First GmbH'), fir)");
                         assertThat(mandate.getBankAccount().toShortString()).isEqualTo("First GmbH");
                         assertThat(mandate.getReference()).isEqualTo("temp ref CAT Z");
                         assertThat(mandate.getValidity().asString()).isEqualTo("[2022-11-01,2023-01-01)");
@@ -503,8 +503,8 @@ class HsOfficeSepaMandateControllerAcceptanceTest extends ContextBasedTestWithCl
         return jpaAttempt.transacted(() -> {
             context.define("superuser-alex@hostsharing.net");
             final var givenDebitor = debitorRepo.findDebitorByDebitorNumber(debitorNumber).get(0);
-            final var bankAccountHolder = ofNullable(givenDebitor.getPartner().getPartnerRel().getHolder().getTradeName())
-                    .orElse(givenDebitor.getPartner().getPartnerRel().getHolder().getFamilyName());
+            final var bankAccountHolder = ofNullable(givenDebitor.getPartner().getPartnerRole().getRelHolder().getTradeName())
+                    .orElse(givenDebitor.getPartner().getPartnerRole().getRelHolder().getFamilyName());
             final var givenBankAccount = bankAccountRepo.findByOptionalHolderLike(bankAccountHolder).get(0);
             final var newSepaMandate = HsOfficeSepaMandateEntity.builder()
                     .uuid(UUID.randomUUID())

src/test/java/net/hostsharing/hsadminng/hs/office/sepamandate/HsOfficeSepaMandateRepositoryIntegrationTest.java

@@ -138,14 +138,14 @@ class HsOfficeSepaMandateRepositoryIntegrationTest extends ContextBasedTestWithC
                             // agent
                             "{ grant role bankaccount#DE02600501010002034304.referrer to role sepamandate#DE02600501010002034304-[2020-01-01,2023-01-01).agent by system and assume }",
                             "{ grant role sepamandate#DE02600501010002034304-[2020-01-01,2023-01-01).agent to role sepamandate#DE02600501010002034304-[2020-01-01,2023-01-01).admin by system and assume }",
-                            "{ grant role relation#FirstGmbH-with-DEBITOR-FirstGmbH.agent to role sepamandate#DE02600501010002034304-[2020-01-01,2023-01-01).agent by system and assume }",
+                            "{ grant role relationship#FirstGmbH-with-ACCOUNTING-FirstGmbH.agent to role sepamandate#DE02600501010002034304-[2020-01-01,2023-01-01).agent by system and assume }",
 
                             // referrer
                             "{ grant perm SELECT on sepamandate#DE02600501010002034304-[2020-01-01,2023-01-01) to role sepamandate#DE02600501010002034304-[2020-01-01,2023-01-01).referrer by system and assume }",
                             "{ grant role sepamandate#DE02600501010002034304-[2020-01-01,2023-01-01).referrer to role sepamandate#DE02600501010002034304-[2020-01-01,2023-01-01).agent by system and assume }",
                             "{ grant role sepamandate#DE02600501010002034304-[2020-01-01,2023-01-01).referrer to role bankaccount#DE02600501010002034304.admin by system and assume }",
-                            "{ grant role relation#FirstGmbH-with-DEBITOR-FirstGmbH.tenant to role sepamandate#DE02600501010002034304-[2020-01-01,2023-01-01).referrer by system and assume }",
-                            "{ grant role sepamandate#DE02600501010002034304-[2020-01-01,2023-01-01).referrer to role relation#FirstGmbH-with-DEBITOR-FirstGmbH.agent by system and assume }",
+                            "{ grant role relationship#FirstGmbH-with-ACCOUNTING-FirstGmbH.tenant to role sepamandate#DE02600501010002034304-[2020-01-01,2023-01-01).referrer by system and assume }",
+                            "{ grant role sepamandate#DE02600501010002034304-[2020-01-01,2023-01-01).referrer to role relationship#FirstGmbH-with-ACCOUNTING-FirstGmbH.agent by system and assume }",
 
                             null));
         }

tools/generate

@@ -0,0 +1,41 @@
+#!/bin/bash
+
+sourceLower=partner
+targetLower=relationship
+
+sourceStudly=Partner
+targetStudly=Relationship
+
+## for source in `find src -iname ""*$sourceLower*"" -type f \( -iname \*.yaml -o -iname \*.sql -o -iname \*.java \)`; do
+for source in `find src -iname ""*$sourceLower*"" -type f \( -iname \*.yaml \)`; do
+  target=`echo $source | sed -e "s/$sourceStudly/$targetStudly/g" -e "s/$sourceLower/$targetLower/g"`
+  echo "Generating $target from $source:"
+
+  mkdir -p `dirname $target`
+
+  sed -e 's/hs-office-partner/hs-office-relationship/g' \
+    -e 's/hs_office_partner/hs_office_relationship/g' \
+    -e 's/HsOfficePartner/HsOfficeRelationship/g' \
+    -e 's/hsOfficePartner/hsOfficeRelationship/g' \
+    -e 's/partner/relationship/g' \
+    \
+    -e 's/addPartner/addRelationship/g' \
+    -e 's/listPartners/listRelationships/g' \
+    -e 's/getPartnerByUuid/getRelationshipByUuid/g' \
+    -e 's/patchPartner/patchRelationship/g' \
+    -e 's/person/relHolder/g' \
+    -e 's/registrationOffice/relType/g' \
+  <$source >$target
+
+done
+
+exit
+
+cat >>src/main/resources/db/changelog/db.changelog-master.yaml <<EOF
+    - include:
+        file: db/changelog/2X0-hs-office-$sourceLower.sql
+    - include:
+        file: db/changelog/2X3-hs-office-$sourceLower-rbac.sql
+    - include:
+        file: db/changelog/2X8-hs-office-$sourceLower-test-data.sql
+EOF