feat: generování mock dat ve vývoji pro objednávky

types/api.yml

@@ -162,6 +162,8 @@ paths:
     $ref: "./paths/dev/generate.yml"
   /dev/clear:
     $ref: "./paths/dev/clear.yml"
+  /dev/generateOrders:
+    $ref: "./paths/dev/generateOrders.yml"
   /dev/bolt/simulate:
     $ref: "./paths/dev/boltSimulate.yml"
   /dev/bolt/advance:

types/paths/dev/generateOrders.yml

@@ -0,0 +1,31 @@
+post:
+  operationId: generateMockOrders
+  summary: Vygenerování mock dat pro sekci Objednání – vždy jen pro aktuální den (pouze DEV režim)
+  requestBody:
+    required: false
+    content:
+      application/json:
+        schema:
+          $ref: "../../schemas/_index.yml#/GenerateMockOrdersRequest"
+  responses:
+    "200":
+      description: Mock data pro objednávání byla úspěšně vygenerována
+      content:
+        application/json:
+          schema:
+            type: object
+            properties:
+              success:
+                type: boolean
+              count:
+                description: Celkový počet doplněných osob
+                type: integer
+              groups:
+                description: Rozpis doplněných osob po skupinách
+                type: array
+                items:
+                  $ref: "../../schemas/_index.yml#/MockOrdersGroupResult"
+    "400":
+      description: Chybný požadavek (např. není nadefinován žádný obchod)
+    "403":
+      description: Endpoint není dostupný v tomto režimu

types/schemas/_index.yml

@@ -783,6 +783,47 @@ MockDataDayResult:
     count:
       description: Počet vygenerovaných záznamů pro daný den
       type: integer
+GenerateMockOrdersRequest:
+  description: Request pro generování mock dat sekce Objednání (pouze DEV režim)
+  type: object
+  additionalProperties: false
+  properties:
+    count:
+      description: Počet osob, které se doplní do každé existující skupiny objednávky
+      type: integer
+      minimum: 1
+      maximum: 50
+    minAmount:
+      description: Dolní hranice náhodně generované částky v Kč
+      type: integer
+      minimum: 0
+      maximum: 100000
+    maxAmount:
+      description: Horní hranice náhodně generované částky v Kč
+      type: integer
+      minimum: 0
+      maximum: 100000
+MockOrdersGroupResult:
+  description: Výsledek doplnění mock osob do jedné skupiny objednávky
+  type: object
+  additionalProperties: false
+  required:
+    - id
+    - name
+    - added
+  properties:
+    id:
+      description: ID skupiny objednávky
+      type: string
+    name:
+      description: Název obchodu skupiny
+      type: string
+    added:
+      description: Počet osob doplněných do skupiny
+      type: integer
+    created:
+      description: Příznak, zda byla skupina právě založena (neexistovala žádná)
+      type: boolean
 ClearMockDataRequest:
   description: Request pro smazání mock dat (pouze DEV režim)
   type: object