feat: Základ generování QR kódů

types/api.yml

@@ -65,6 +65,10 @@ paths:
   /voting/updateVote:
     $ref: "./paths/voting/updateVote.yml"
 
+  # QR kódy (/api/qr)
+  /qr/generate:
+    $ref: "./paths/qr/generateQr.yml"
+
 components:
   schemas:
     $ref: "./schemas/_index.yml"

types/paths/qr/generateQr.yml

@@ -0,0 +1,12 @@
+post:
+  operationId: generateQr
+  summary: Generování QR kódů.
+  requestBody:
+    required: true
+    content:
+      application/json:
+        schema:
+          $ref: "../../schemas/_index.yml#/GenerateQrCodesRequest"
+  responses:
+    "200":
+      description: QR kódy byly úspěšně vygenerovány.

types/schemas/_index.yml

@@ -469,6 +469,43 @@ PizzaDay:
       items:
         $ref: "#/PizzaOrder"
 
+# --- QR KÓDY ---
+QrCodeRequest:
+  description: Data potřebná pro vygenerování jednoho QR kódu pro platbu
+  type: object
+  required:
+    - login
+    - note
+    - amount
+  properties:
+    login:
+      description: Přihlašovací jméno uživatele, pro kterého bude QR kód vygenerován
+      type: string
+    note:
+      description: Popis platby
+      type: string
+    amount:
+      description: Částka platby v Kč
+      type: number
+GenerateQrCodesRequest:
+  description: Data potřebná pro vygenerování QR kódů pro platbu
+  type: object
+  required:
+    - bankAccount
+    - bankAccountHolder
+  properties:
+    bankAccount:
+      description: Číslo bankovního účtu objednávajícího
+      type: string
+    bankAccountHolder:
+      description: Jméno majitele bankovního účtu
+      type: string
+    qrCodes:
+      description: Pole požadavků na vygenerování QR kódů
+      type: array
+      items:
+        $ref: "#/QrCodeRequest"
+
 # --- NOTIFIKACE ---
 UdalostEnum:
   type: string