dashboard widgets

2026-08-03 13:10:41 +02:00
parent 2a3d75c85e
commit bbc2236c0d
14 changed files with 1196 additions and 141 deletions
@@ -460,6 +460,81 @@ export function buildOpenApiDocument() {
          responses: { '200': { description: 'Souhrnne metriky a casova rada' } },
        },
      },
+      '/api/dashboard/widgets': {
+        get: {
+          tags: ['Dashboard'],
+          summary: 'Katalog widgetu prehledu',
+          description: 'Co jde polozit na dashboard vcetne povolenych sirek.',
+          security: [{ bearerAuth: [] }],
+          responses: { '200': { description: 'Widgety' } },
+        },
+      },
+      '/api/dashboard/layout': {
+        get: {
+          tags: ['Dashboard'],
+          summary: 'Rozlozeni dashboardu',
+          description:
+            'Uklada se pro dvojici uzivatel a firma. `custom: false` znamena, ' +
+            'ze uzivatel kouka na vychozi rozlozeni.',
+          security: [{ bearerAuth: [] }],
+          parameters: [
+            {
+              name: 'tenantId',
+              in: 'query',
+              schema: { type: 'string' },
+              description: 'Firma. Bez ni se pouzije prvni, do ktere uzivatel patri.',
+            },
+          ],
+          responses: {
+            '200': { description: 'Rozlozeni' },
+            '403': { description: 'Ucet nepatri do zadne firmy' },
+            '404': { description: 'Firma neexistuje, nebo do ni uzivatel nepatri' },
+          },
+        },
+        put: {
+          tags: ['Dashboard'],
+          summary: 'Ulozit rozlozeni',
+          description: 'Overuje se proti katalogu. Neznamy widget nebo sirka vraci 400.',
+          security: [{ bearerAuth: [] }],
+          parameters: [{ name: 'tenantId', in: 'query', schema: { type: 'string' } }],
+          requestBody: {
+            required: true,
+            content: {
+              'application/json': {
+                schema: {
+                  type: 'object',
+                  required: ['items'],
+                  properties: {
+                    items: {
+                      type: 'array',
+                      items: {
+                        type: 'object',
+                        required: ['id', 'widgetId', 'size'],
+                        properties: {
+                          id: { type: 'string', example: 'w1' },
+                          widgetId: { type: 'string', example: 'stat.openTickets' },
+                          size: { type: 'string', enum: ['third', 'half', 'full'] },
+                        },
+                      },
+                    },
+                  },
+                },
+              },
+            },
+          },
+          responses: {
+            '200': { description: 'Ulozeno' },
+            '400': { description: 'Neplatne rozlozeni' },
+          },
+        },
+        delete: {
+          tags: ['Dashboard'],
+          summary: 'Vratit na vychozi rozlozeni',
+          security: [{ bearerAuth: [] }],
+          parameters: [{ name: 'tenantId', in: 'query', schema: { type: 'string' } }],
+          responses: { '200': { description: 'Vychozi rozlozeni' } },
+        },
+      },
      '/api/dashboard/access': {
        get: {
          tags: ['Dashboard'],