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"