feat: lepší generování mock dat při vývoji

types/paths/dev/clear.yml

@@ -1,6 +1,6 @@
 post:
   operationId: clearMockData
-  summary: Smazání všech voleb pro daný den (pouze DEV režim)
+  summary: Smazání všech voleb pro daný den nebo celý týden (pouze DEV režim)
   requestBody:
     required: false
     content:
@@ -18,6 +18,12 @@ post:
               success:
                 type: boolean
               dayIndex:
-                type: integer
+                description: Index dne, pro který byla data smazána (jen při mazání jednoho dne)
+                $ref: "../../schemas/_index.yml#/DayIndex"
+              days:
+                description: Seznam dnů, pro které byla data smazána (jen při mazání celého týdne)
+                type: array
+                items:
+                  $ref: "../../schemas/_index.yml#/MockDataDayResult"
     "403":
       description: Endpoint není dostupný v tomto režimu

types/paths/dev/generate.yml

@@ -18,8 +18,15 @@ post:
               success:
                 type: boolean
               count:
+                description: Celkový počet vygenerovaných záznamů
                 type: integer
               dayIndex:
-                type: integer
+                description: Index dne, pro který byla data vygenerována (jen při generování pro jeden den)
+                $ref: "../../schemas/_index.yml#/DayIndex"
+              days:
+                description: Rozpis vygenerovaných záznamů po dnech (jen při generování pro celý týden)
+                type: array
+                items:
+                  $ref: "../../schemas/_index.yml#/MockDataDayResult"
     "403":
       description: Endpoint není dostupný v tomto režimu

types/schemas/_index.yml

@@ -760,21 +760,40 @@ GenerateMockDataRequest:
   additionalProperties: false
   properties:
     dayIndex:
-      description: Index dne v týdnu (0 = pondělí, 4 = pátek). Pokud není zadán, použije se aktuální den.
+      description: Index dne v týdnu (0 = pondělí, 4 = pátek). Pokud není zadán, použije se aktuální den. Ignoruje se, pokud je nastaveno wholeWeek.
       $ref: "#/DayIndex"
+    wholeWeek:
+      description: Pokud je true, vygenerují se data pro všechny dny týdne (pondělí až pátek).
+      type: boolean
     count:
-      description: Počet záznamů k vygenerování. Pokud není zadán, vybere se náhodný počet 5-20.
+      description: Počet záznamů k vygenerování (u celého týdne pro každý den zvlášť). Pokud není zadán, vybere se pro každý den náhodný počet 5-20.
       type: integer
       minimum: 1
       maximum: 100
+MockDataDayResult:
+  description: Výsledek generování/mazání mock dat pro jeden den
+  type: object
+  additionalProperties: false
+  required:
+    - dayIndex
+  properties:
+    dayIndex:
+      description: Index dne v týdnu, pro který byla akce provedena
+      $ref: "#/DayIndex"
+    count:
+      description: Počet vygenerovaných záznamů pro daný den
+      type: integer
 ClearMockDataRequest:
   description: Request pro smazání mock dat (pouze DEV režim)
   type: object
   additionalProperties: false
   properties:
     dayIndex:
-      description: Index dne v týdnu (0 = pondělí, 4 = pátek). Pokud není zadán, použije se aktuální den.
+      description: Index dne v týdnu (0 = pondělí, 4 = pátek). Pokud není zadán, použije se aktuální den. Ignoruje se, pokud je nastaveno wholeWeek.
       $ref: "#/DayIndex"
+    wholeWeek:
+      description: Pokud je true, smažou se data všech dnů týdne (pondělí až pátek).
+      type: boolean
 
 # --- DEV SIMULACE BOLT ---
 BoltSimGroupRequest: