memberNumber as partnerNumber+memberNumberSuffix (#13)

Co-authored-by: Michael Hoennig <michael@hoennig.de>
Reviewed-on: https://dev.hostsharing.net/hostsharing/hs.hsadmin.ng/pulls/13
Reviewed-by: Michael Hierweck <michael.hierweck@hostsharing.net>

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

@@ -25,6 +25,13 @@ components:
                     $ref: './hs-office-debitor-schemas.yaml#/components/schemas/HsOfficeDebitor'
                 memberNumber:
                     type: integer
+                    minimum: 1000000
+                    maximum: 9999999
+                memberNumberSuffix:
+                    type: string
+                    minLength: 2
+                    maxLength: 2
+                    pattern: '[0-9]+'
                 validFrom:
                    type: string
                    format: date
@@ -66,8 +73,11 @@ components:
                     type: string
                     format: uuid
                     nullable: false
-                memberNumber:
-                    type: integer
+                memberNumberSuffix:
+                    type: string
+                    minLength: 2
+                    maxLength: 2
+                    pattern: '[0-9]+'
                     nullable: false
                 validFrom:
                     type: string
@@ -84,6 +94,7 @@ components:
                     type: boolean
             required:
                 - partnerUuid
+                - memberNumberSuffix
                 - mainDebitorUuid
                 - validFrom
                 - membershipFeeBillable

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

@@ -1,6 +1,7 @@
 get:
     summary: Returns a list of (optionally filtered) memberships.
-    description: Returns the list of (optionally filtered) memberships which are visible to the current user or any of it's assumed roles.
+    description: Returns the list of memberships which are visible to the current user or any of it's assumed roles.
+        The list can optionally be filtered by either the `partnerUuid` or the `memberNumber` - not both at the same time.
     tags:
         - hs-office-memberships
     operationId: listMemberships
@@ -13,13 +14,13 @@ get:
           schema:
               type: string
               format: uuid
-          description: UUID of the business partner.
+          description: UUID of the business partner, exclusive to `memberNumber`.
         - name: memberNumber
           in: query
           required: false
           schema:
               type: integer
-          description: Member number.
+          description: Member number, exclusive to `partnerUuid`.
     responses:
         "200":
             description: OK

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

@@ -9,7 +9,7 @@ components:
                 uuid:
                     type: string
                     format: uuid
-                debitorNumberPrefix:
+                partnerNumber:
                     type: integer
                     format: int8
                     minimum: 10000
@@ -91,7 +91,7 @@ components:
         HsOfficePartnerInsert:
             type: object
             properties:
-                debitorNumberPrefix:
+                partnerNumber:
                     type: integer
                     format: int8
                     minimum: 10000
@@ -105,7 +105,7 @@ components:
                 details:
                     $ref: '#/components/schemas/HsOfficePartnerDetailsInsert'
             required:
-                - debitorNumberPrefix
+                - partnerNumber
                 - personUuid
                 - contactUuid
                 - details