feat: nová stránka pro návrhy na vylepšení

types/paths/suggestions/add.yml

@@ -0,0 +1,28 @@
+post:
+  operationId: addSuggestion
+  summary: Přidá nový návrh na vylepšení. Autorovi se automaticky nastaví hlas pro.
+  requestBody:
+    required: true
+    content:
+      application/json:
+        schema:
+          type: object
+          required:
+            - title
+            - description
+          properties:
+            title:
+              type: string
+              description: Stručný jednořádkový název návrhu
+            description:
+              type: string
+              description: Detailní popis navrhované úpravy
+  responses:
+    "200":
+      description: Aktualizovaný seznam návrhů.
+      content:
+        application/json:
+          schema:
+            type: array
+            items:
+              $ref: "../../schemas/_index.yml#/Suggestion"

types/paths/suggestions/delete.yml

@@ -0,0 +1,26 @@
+post:
+  operationId: deleteSuggestion
+  summary: >-
+    Smaže návrh včetně všech jeho hlasů. Smazat lze pouze vlastní návrh
+    (validováno na serveru).
+  requestBody:
+    required: true
+    content:
+      application/json:
+        schema:
+          type: object
+          required:
+            - id
+          properties:
+            id:
+              type: string
+              description: Identifikátor návrhu ke smazání
+  responses:
+    "200":
+      description: Aktualizovaný seznam návrhů.
+      content:
+        application/json:
+          schema:
+            type: array
+            items:
+              $ref: "../../schemas/_index.yml#/Suggestion"

types/paths/suggestions/list.yml

@@ -0,0 +1,11 @@
+get:
+  operationId: listSuggestions
+  summary: Vrátí seznam návrhů na vylepšení seřazený sestupně dle počtu hlasů.
+  responses:
+    "200":
+      content:
+        application/json:
+          schema:
+            type: array
+            items:
+              $ref: "../../schemas/_index.yml#/Suggestion"

types/paths/suggestions/vote.yml

@@ -0,0 +1,30 @@
+post:
+  operationId: voteSuggestion
+  summary: >-
+    Přepne hlas přihlášeného uživatele u návrhu. Klik na již aktivní směr hlas
+    zruší, opačný směr stávající hlas přepíše.
+  requestBody:
+    required: true
+    content:
+      application/json:
+        schema:
+          type: object
+          required:
+            - id
+            - direction
+          properties:
+            id:
+              type: string
+              description: Identifikátor návrhu
+            direction:
+              description: Směr hlasu, na který uživatel klikl
+              $ref: "../../schemas/_index.yml#/VoteDirection"
+  responses:
+    "200":
+      description: Aktualizovaný seznam návrhů.
+      content:
+        application/json:
+          schema:
+            type: array
+            items:
+              $ref: "../../schemas/_index.yml#/Suggestion"

types/paths/voting/getVotes.yml

@@ -1,11 +0,0 @@
-get:
-  operationId: getVotes
-  summary: Vrátí statistiky hlasování o nových funkcích.
-  responses:
-    "200":
-      content:
-        application/json:
-          schema:
-            type: array
-            items:
-              $ref: "../../schemas/_index.yml#/FeatureRequest"

types/paths/voting/getVotingStats.yml

@@ -1,9 +0,0 @@
-get:
-  operationId: getVotingStats
-  summary: Vrátí agregované statistiky hlasování o nových funkcích.
-  responses:
-    "200":
-      content:
-        application/json:
-          schema:
-            $ref: "../../schemas/_index.yml#/VotingStats"

types/paths/voting/updateVote.yml

@@ -1,22 +0,0 @@
-post:
-  operationId: updateVote
-  summary: Aktualizuje hlasování uživatele o dané funkcionalitě.
-  requestBody:
-    required: true
-    content:
-      application/json:
-        schema:
-          type: object
-          required:
-            - option
-            - active
-          properties:
-            option:
-              description: Hlasovací možnost, kterou uživatel zvolil.
-              $ref: "../../schemas/_index.yml#/FeatureRequest"
-            active:
-              type: boolean
-              description: True, pokud uživatel hlasoval pro, jinak false.
-  responses:
-    "200":
-      description: Hlasování bylo úspěšně aktualizováno.