{
  "openapi": "3.0.1",
  "info": {
    "title": "Omega AI Önkormányzat API",
    "description": "Az Omega AI Önkormányzat hitelesített és nyilvános API-végpontjai. A Swagger UI a /api-docs címen, az OpenAPI JSON a /api-docs/v1/swagger.json címen érhető el.",
    "contact": {
      "name": "Omega Code Hungary Kft."
    },
    "version": "v1"
  },
  "paths": {
    "/api/accounting/documents": {
      "get": {
        "tags": [
          "Accounting"
        ],
        "summary": "List",
        "description": "**Cél:** Számla-OCR, kontírozási javaslatok, ellenőrzés és pénzügyi nyilvántartás.\n\n**Végpont:** `GET /api/accounting/documents`\n\n**Bemenet:** Nincs külön bemeneti paraméter, vagy a bemenet az útvonalból/hitelesített kontextusból származik.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Accounting_List",
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Accounting.AccountingListItem"
                  }
                }
              },
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Accounting.AccountingListItem"
                  }
                }
              },
              "text/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Accounting.AccountingListItem"
                  }
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      },
      "post": {
        "tags": [
          "Accounting"
        ],
        "summary": "Upload",
        "description": "**Cél:** Számla-OCR, kontírozási javaslatok, ellenőrzés és pénzügyi nyilvántartás.\n\n**Végpont:** `POST /api/accounting/documents`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik. Maximális request méret: 104 857 600 byte.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Accounting_Upload",
        "requestBody": {
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "document": {
                    "type": "string",
                    "format": "binary"
                  }
                }
              },
              "encoding": {
                "document": {
                  "style": "form"
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Common.BackgroundJobAccepted"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Common.BackgroundJobAccepted"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Common.BackgroundJobAccepted"
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/accounting/documents/search": {
      "get": {
        "tags": [
          "Accounting"
        ],
        "summary": "Search",
        "description": "**Cél:** Számla-OCR, kontírozási javaslatok, ellenőrzés és pénzügyi nyilvántartás.\n\n**Végpont:** `GET /api/accounting/documents/search`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Accounting_Search",
        "parameters": [
          {
            "name": "search",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "from",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "to",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "costCenter",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "status",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "page",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32",
              "default": 1
            }
          },
          {
            "name": "pageSize",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32",
              "default": 50
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Accounting.AccountingSearchResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Accounting.AccountingSearchResponse"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Accounting.AccountingSearchResponse"
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/accounting/cost-centers": {
      "get": {
        "tags": [
          "Accounting"
        ],
        "summary": "Cost Centers",
        "description": "**Cél:** Számla-OCR, kontírozási javaslatok, ellenőrzés és pénzügyi nyilvántartás.\n\n**Végpont:** `GET /api/accounting/cost-centers`\n\n**Bemenet:** Nincs külön bemeneti paraméter, vagy a bemenet az útvonalból/hitelesített kontextusból származik.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Accounting_CostCenters",
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Accounting.AccountingCodeDto"
                  }
                }
              },
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Accounting.AccountingCodeDto"
                  }
                }
              },
              "text/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Accounting.AccountingCodeDto"
                  }
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/accounting/configuration/{type}": {
      "get": {
        "tags": [
          "Accounting"
        ],
        "summary": "Configuration",
        "description": "**Cél:** Számla-OCR, kontírozási javaslatok, ellenőrzés és pénzügyi nyilvántartás.\n\n**Végpont:** `GET /api/accounting/configuration/{type}`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Accounting_Configuration",
        "parameters": [
          {
            "name": "type",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Accounting.AccountingMasterDataItemDto"
                  }
                }
              },
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Accounting.AccountingMasterDataItemDto"
                  }
                }
              },
              "text/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Accounting.AccountingMasterDataItemDto"
                  }
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      },
      "post": {
        "tags": [
          "Accounting"
        ],
        "summary": "Create Configuration",
        "description": "**Cél:** Számla-OCR, kontírozási javaslatok, ellenőrzés és pénzügyi nyilvántartás.\n\n**Végpont:** `POST /api/accounting/configuration/{type}`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Accounting_CreateConfiguration",
        "parameters": [
          {
            "name": "type",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Accounting.UpsertAccountingMasterDataRequest"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Accounting.UpsertAccountingMasterDataRequest"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Accounting.UpsertAccountingMasterDataRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Accounting.AccountingMasterDataItemDto"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Accounting.AccountingMasterDataItemDto"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Accounting.AccountingMasterDataItemDto"
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/accounting/configuration/{type}/{id}": {
      "put": {
        "tags": [
          "Accounting"
        ],
        "summary": "Update Configuration",
        "description": "**Cél:** Számla-OCR, kontírozási javaslatok, ellenőrzés és pénzügyi nyilvántartás.\n\n**Végpont:** `PUT /api/accounting/configuration/{type}/{id}`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Accounting_UpdateConfiguration",
        "parameters": [
          {
            "name": "type",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Accounting.UpsertAccountingMasterDataRequest"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Accounting.UpsertAccountingMasterDataRequest"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Accounting.UpsertAccountingMasterDataRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Accounting.AccountingMasterDataItemDto"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Accounting.AccountingMasterDataItemDto"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Accounting.AccountingMasterDataItemDto"
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      },
      "delete": {
        "tags": [
          "Accounting"
        ],
        "summary": "Disable Configuration",
        "description": "**Cél:** Számla-OCR, kontírozási javaslatok, ellenőrzés és pénzügyi nyilvántartás.\n\n**Végpont:** `DELETE /api/accounting/configuration/{type}/{id}`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Accounting_DisableConfiguration",
        "parameters": [
          {
            "name": "type",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/accounting/configuration/keyword-rules": {
      "get": {
        "tags": [
          "Accounting"
        ],
        "summary": "Keyword Rules",
        "description": "**Cél:** Számla-OCR, kontírozási javaslatok, ellenőrzés és pénzügyi nyilvántartás.\n\n**Végpont:** `GET /api/accounting/configuration/keyword-rules`\n\n**Bemenet:** Nincs külön bemeneti paraméter, vagy a bemenet az útvonalból/hitelesített kontextusból származik.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Accounting_KeywordRules",
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Accounting.AccountingKeywordRuleDto"
                  }
                }
              },
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Accounting.AccountingKeywordRuleDto"
                  }
                }
              },
              "text/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Accounting.AccountingKeywordRuleDto"
                  }
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      },
      "post": {
        "tags": [
          "Accounting"
        ],
        "summary": "Create Keyword Rule",
        "description": "**Cél:** Számla-OCR, kontírozási javaslatok, ellenőrzés és pénzügyi nyilvántartás.\n\n**Végpont:** `POST /api/accounting/configuration/keyword-rules`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Accounting_CreateKeywordRule",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Accounting.UpsertAccountingKeywordRuleRequest"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Accounting.UpsertAccountingKeywordRuleRequest"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Accounting.UpsertAccountingKeywordRuleRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Accounting.AccountingKeywordRuleDto"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Accounting.AccountingKeywordRuleDto"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Accounting.AccountingKeywordRuleDto"
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/accounting/configuration/keyword-rules/{id}": {
      "put": {
        "tags": [
          "Accounting"
        ],
        "summary": "Update Keyword Rule",
        "description": "**Cél:** Számla-OCR, kontírozási javaslatok, ellenőrzés és pénzügyi nyilvántartás.\n\n**Végpont:** `PUT /api/accounting/configuration/keyword-rules/{id}`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Accounting_UpdateKeywordRule",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Accounting.UpsertAccountingKeywordRuleRequest"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Accounting.UpsertAccountingKeywordRuleRequest"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Accounting.UpsertAccountingKeywordRuleRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Accounting.AccountingKeywordRuleDto"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Accounting.AccountingKeywordRuleDto"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Accounting.AccountingKeywordRuleDto"
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      },
      "delete": {
        "tags": [
          "Accounting"
        ],
        "summary": "Disable Keyword Rule",
        "description": "**Cél:** Számla-OCR, kontírozási javaslatok, ellenőrzés és pénzügyi nyilvántartás.\n\n**Végpont:** `DELETE /api/accounting/configuration/keyword-rules/{id}`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Accounting_DisableKeywordRule",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/accounting/documents/{id}": {
      "get": {
        "tags": [
          "Accounting"
        ],
        "summary": "Get",
        "description": "**Cél:** Számla-OCR, kontírozási javaslatok, ellenőrzés és pénzügyi nyilvántartás.\n\n**Végpont:** `GET /api/accounting/documents/{id}`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Accounting_Get",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Accounting.AccountingDocumentDetails"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Accounting.AccountingDocumentDetails"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Accounting.AccountingDocumentDetails"
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      },
      "delete": {
        "tags": [
          "Accounting"
        ],
        "summary": "Delete Document",
        "description": "**Cél:** Számla-OCR, kontírozási javaslatok, ellenőrzés és pénzügyi nyilvántartás.\n\n**Végpont:** `DELETE /api/accounting/documents/{id}`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Accounting_DeleteDocument",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/accounting/documents/batch": {
      "post": {
        "tags": [
          "Accounting"
        ],
        "summary": "Upload Batch",
        "description": "**Cél:** Számla-OCR, kontírozási javaslatok, ellenőrzés és pénzügyi nyilvántartás.\n\n**Végpont:** `POST /api/accounting/documents/batch`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik. Maximális request méret: 524 288 000 byte.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Accounting_UploadBatch",
        "requestBody": {
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "documents": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "format": "binary"
                    }
                  }
                }
              },
              "encoding": {
                "documents": {
                  "style": "form"
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Accounting.AccountingBatchItemResult"
                  }
                }
              },
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Accounting.AccountingBatchItemResult"
                  }
                }
              },
              "text/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Accounting.AccountingBatchItemResult"
                  }
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/accounting/documents/{id}/correction": {
      "put": {
        "tags": [
          "Accounting"
        ],
        "summary": "Correct",
        "description": "**Cél:** Számla-OCR, kontírozási javaslatok, ellenőrzés és pénzügyi nyilvántartás.\n\n**Végpont:** `PUT /api/accounting/documents/{id}/correction`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Accounting_Correct",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Accounting.AccountingCorrectionRequest"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Accounting.AccountingCorrectionRequest"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Accounting.AccountingCorrectionRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/accounting/documents/{id}/delete": {
      "post": {
        "tags": [
          "Accounting"
        ],
        "summary": "Delete Document Post",
        "description": "**Cél:** Számla-OCR, kontírozási javaslatok, ellenőrzés és pénzügyi nyilvántartás.\n\n**Végpont:** `POST /api/accounting/documents/{id}/delete`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Accounting_DeleteDocumentPost",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/accounting/documents/{id}/approve": {
      "post": {
        "tags": [
          "Accounting"
        ],
        "summary": "Approve",
        "description": "**Cél:** Számla-OCR, kontírozási javaslatok, ellenőrzés és pénzügyi nyilvántartás.\n\n**Végpont:** `POST /api/accounting/documents/{id}/approve`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Accounting_Approve",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Accounting.ApprovalRequest"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Accounting.ApprovalRequest"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Accounting.ApprovalRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/accounting/documents/{id}/asp-package": {
      "get": {
        "tags": [
          "Accounting"
        ],
        "summary": "Export",
        "description": "**Cél:** Számla-OCR, kontírozási javaslatok, ellenőrzés és pénzügyi nyilvántartás.\n\n**Végpont:** `GET /api/accounting/documents/{id}/asp-package`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Accounting_Export",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/ai/status": {
      "get": {
        "tags": [
          "Ai"
        ],
        "summary": "Status",
        "description": "**Cél:** A megadott erőforrás vagy lista lekérdezése.\n\n**Végpont:** `GET /api/ai/status`\n\n**Bemenet:** Nincs külön bemeneti paraméter, vagy a bemenet az útvonalból/hitelesített kontextusból származik.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Ai_Status",
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Ai.AiSystemStatus"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Ai.AiSystemStatus"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Ai.AiSystemStatus"
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/ai/usage": {
      "get": {
        "tags": [
          "Ai"
        ],
        "summary": "Usage",
        "description": "**Cél:** A megadott erőforrás vagy lista lekérdezése.\n\n**Végpont:** `GET /api/ai/usage`\n\n**Bemenet:** Nincs külön bemeneti paraméter, vagy a bemenet az útvonalból/hitelesített kontextusból származik.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Ai_Usage",
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Ai.AiUsageSummary"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Ai.AiUsageSummary"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Ai.AiUsageSummary"
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/ai/test": {
      "post": {
        "tags": [
          "Ai"
        ],
        "summary": "Test",
        "description": "**Cél:** Új erőforrás létrehozása vagy szerveroldali feldolgozás indítása.\n\n**Végpont:** `POST /api/ai/test`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Ai_Test",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Ai.AiTestRequest"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Ai.AiTestRequest"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Ai.AiTestRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Ai.AiTestResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Ai.AiTestResponse"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Ai.AiTestResponse"
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/appointments/summary": {
      "get": {
        "tags": [
          "Appointments"
        ],
        "summary": "Summary",
        "description": "**Cél:** Lakossági időpontfoglalás és hivatali időpontkezelés.\n\n**Végpont:** `GET /api/appointments/summary`\n\n**Bemenet:** Nincs külön bemeneti paraméter, vagy a bemenet az útvonalból/hitelesített kontextusból származik.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Appointments_Summary",
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Citizens.AppointmentSummaryDto"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Citizens.AppointmentSummaryDto"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Citizens.AppointmentSummaryDto"
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/appointments": {
      "get": {
        "tags": [
          "Appointments"
        ],
        "summary": "List",
        "description": "**Cél:** Lakossági időpontfoglalás és hivatali időpontkezelés.\n\n**Végpont:** `GET /api/appointments`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Appointments_List",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32",
              "default": 1
            }
          },
          {
            "name": "pageSize",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32",
              "default": 50
            }
          },
          {
            "name": "search",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "status",
            "in": "query",
            "schema": {
              "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Enums.AppointmentStatus"
            }
          },
          {
            "name": "department",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "from",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "to",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Common.PagedResult`1[[OmegaMunicipal.Contracts.Citizens.AppointmentBookingDto, OmegaMunicipal.Contracts, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null]]"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Common.PagedResult`1[[OmegaMunicipal.Contracts.Citizens.AppointmentBookingDto, OmegaMunicipal.Contracts, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null]]"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Common.PagedResult`1[[OmegaMunicipal.Contracts.Citizens.AppointmentBookingDto, OmegaMunicipal.Contracts, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null]]"
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/appointments/{id}": {
      "put": {
        "tags": [
          "Appointments"
        ],
        "summary": "Update",
        "description": "**Cél:** Lakossági időpontfoglalás és hivatali időpontkezelés.\n\n**Végpont:** `PUT /api/appointments/{id}`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Appointments_Update",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Citizens.UpdateAppointmentRequest"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Citizens.UpdateAppointmentRequest"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Citizens.UpdateAppointmentRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Citizens.AppointmentBookingDto"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Citizens.AppointmentBookingDto"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Citizens.AppointmentBookingDto"
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/appointments/{id}/update": {
      "post": {
        "tags": [
          "Appointments"
        ],
        "summary": "Update Post",
        "description": "**Cél:** Lakossági időpontfoglalás és hivatali időpontkezelés.\n\n**Végpont:** `POST /api/appointments/{id}/update`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Appointments_UpdatePost",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Citizens.UpdateAppointmentRequest"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Citizens.UpdateAppointmentRequest"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Citizens.UpdateAppointmentRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Citizens.AppointmentBookingDto"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Citizens.AppointmentBookingDto"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Citizens.AppointmentBookingDto"
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/appointments/slot-bookings": {
      "get": {
        "tags": [
          "Appointments"
        ],
        "summary": "Slot Bookings",
        "description": "**Cél:** Lakossági időpontfoglalás és hivatali időpontkezelés.\n\n**Végpont:** `GET /api/appointments/slot-bookings`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Appointments_SlotBookings",
        "parameters": [
          {
            "name": "department",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "start",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "end",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Citizens.AppointmentBookingDto"
                  }
                }
              },
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Citizens.AppointmentBookingDto"
                  }
                }
              },
              "text/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Citizens.AppointmentBookingDto"
                  }
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/appointments/schedules": {
      "get": {
        "tags": [
          "Appointments"
        ],
        "summary": "Schedules",
        "description": "**Cél:** Lakossági időpontfoglalás és hivatali időpontkezelés.\n\n**Végpont:** `GET /api/appointments/schedules`\n\n**Bemenet:** Nincs külön bemeneti paraméter, vagy a bemenet az útvonalból/hitelesített kontextusból származik.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Appointments_Schedules",
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Citizens.AppointmentScheduleDto"
                  }
                }
              },
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Citizens.AppointmentScheduleDto"
                  }
                }
              },
              "text/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Citizens.AppointmentScheduleDto"
                  }
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      },
      "post": {
        "tags": [
          "Appointments"
        ],
        "summary": "Create Schedule",
        "description": "**Cél:** Lakossági időpontfoglalás és hivatali időpontkezelés.\n\n**Végpont:** `POST /api/appointments/schedules`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Appointments_CreateSchedule",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Citizens.UpsertAppointmentScheduleRequest"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Citizens.UpsertAppointmentScheduleRequest"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Citizens.UpsertAppointmentScheduleRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Citizens.AppointmentScheduleDto"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Citizens.AppointmentScheduleDto"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Citizens.AppointmentScheduleDto"
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/appointments/slots": {
      "get": {
        "tags": [
          "Appointments"
        ],
        "summary": "Slots",
        "description": "**Cél:** Lakossági időpontfoglalás és hivatali időpontkezelés.\n\n**Végpont:** `GET /api/appointments/slots`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Appointments_Slots",
        "parameters": [
          {
            "name": "department",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "date",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Citizens.AppointmentSlotDto"
                  }
                }
              },
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Citizens.AppointmentSlotDto"
                  }
                }
              },
              "text/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Citizens.AppointmentSlotDto"
                  }
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/appointments/schedules/{id}": {
      "put": {
        "tags": [
          "Appointments"
        ],
        "summary": "Update Schedule",
        "description": "**Cél:** Lakossági időpontfoglalás és hivatali időpontkezelés.\n\n**Végpont:** `PUT /api/appointments/schedules/{id}`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Appointments_UpdateSchedule",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Citizens.UpsertAppointmentScheduleRequest"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Citizens.UpsertAppointmentScheduleRequest"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Citizens.UpsertAppointmentScheduleRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Citizens.AppointmentScheduleDto"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Citizens.AppointmentScheduleDto"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Citizens.AppointmentScheduleDto"
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      },
      "delete": {
        "tags": [
          "Appointments"
        ],
        "summary": "Delete Schedule",
        "description": "**Cél:** Lakossági időpontfoglalás és hivatali időpontkezelés.\n\n**Végpont:** `DELETE /api/appointments/schedules/{id}`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Appointments_DeleteSchedule",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/assistant/ask": {
      "post": {
        "tags": [
          "Assistant"
        ],
        "summary": "Ask",
        "description": "**Cél:** A helyi AI Asszisztens beszélgetései, háttérfeladatai, csatolmányai és generált eredményei.\n\n**Végpont:** `POST /api/assistant/ask`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik. Rate-limit szabály: ai.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Assistant_Ask",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Assistant.AskAssistantRequest"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Assistant.AskAssistantRequest"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Assistant.AskAssistantRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Assistant.AssistantAnswer"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Assistant.AssistantAnswer"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Assistant.AssistantAnswer"
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/assistant/stream": {
      "post": {
        "tags": [
          "Assistant"
        ],
        "summary": "Valódi streaming AI chat. ONLINE módban az OpenAI Responses API SSE delta eseményeit továbbítja.",
        "description": "**Cél:** A helyi AI Asszisztens beszélgetései, háttérfeladatai, csatolmányai és generált eredményei.\n\n**Végpont:** `POST /api/assistant/stream`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik. Rate-limit szabály: ai.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Assistant_Stream",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Assistant.AskAssistantRequest"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Assistant.AskAssistantRequest"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Assistant.AskAssistantRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/assistant/ask-with-files": {
      "post": {
        "tags": [
          "Assistant"
        ],
        "summary": "Ask With Files",
        "description": "**Cél:** A helyi AI Asszisztens beszélgetései, háttérfeladatai, csatolmányai és generált eredményei.\n\n**Végpont:** `POST /api/assistant/ask-with-files`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik. Rate-limit szabály: ai. Maximális request méret: 524 288 000 byte.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Assistant_AskWithFiles",
        "requestBody": {
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "question": {
                    "type": "string"
                  },
                  "conversationId": {
                    "type": "string",
                    "format": "uuid"
                  },
                  "files": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "format": "binary"
                    }
                  }
                }
              },
              "encoding": {
                "question": {
                  "style": "form"
                },
                "conversationId": {
                  "style": "form"
                },
                "files": {
                  "style": "form"
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Assistant.AssistantAnswer"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Assistant.AssistantAnswer"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Assistant.AssistantAnswer"
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/assistant/jobs": {
      "post": {
        "tags": [
          "Assistant"
        ],
        "summary": "AI-kérdés háttérfeladatként történő sorba állítása.",
        "description": "A 202 Accepted válasz után a feladat szerveroldalon tovább fut akkor is, ha a felhasználó másik oldalra navigál.\n\n**Cél:** A helyi AI Asszisztens beszélgetései, háttérfeladatai, csatolmányai és generált eredményei.\n\n**Végpont:** `POST /api/assistant/jobs`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik. Rate-limit szabály: ai.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Assistant_Queue",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Assistant.AskAssistantRequest"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Assistant.AskAssistantRequest"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Assistant.AskAssistantRequest"
              }
            }
          }
        },
        "responses": {
          "202": {
            "description": "Accepted",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Assistant.AssistantJobAccepted"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Assistant.AssistantJobAccepted"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Assistant.AssistantJobAccepted"
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/assistant/jobs-with-files": {
      "post": {
        "tags": [
          "Assistant"
        ],
        "summary": "Fájlokkal kiegészített AI-kérdés háttérfeladatként történő sorba állítása.",
        "description": "**Cél:** A helyi AI Asszisztens beszélgetései, háttérfeladatai, csatolmányai és generált eredményei.\n\n**Végpont:** `POST /api/assistant/jobs-with-files`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik. Rate-limit szabály: ai. Maximális request méret: 524 288 000 byte.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Assistant_QueueWithFiles",
        "requestBody": {
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "question": {
                    "type": "string"
                  },
                  "conversationId": {
                    "type": "string",
                    "format": "uuid"
                  },
                  "files": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "format": "binary"
                    }
                  }
                }
              },
              "encoding": {
                "question": {
                  "style": "form"
                },
                "conversationId": {
                  "style": "form"
                },
                "files": {
                  "style": "form"
                }
              }
            }
          }
        },
        "responses": {
          "202": {
            "description": "Accepted",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Assistant.AssistantJobAccepted"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Assistant.AssistantJobAccepted"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Assistant.AssistantJobAccepted"
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/assistant/jobs/{id}": {
      "get": {
        "tags": [
          "Assistant"
        ],
        "summary": "Háttérben futó AI-asszisztens feladat állapotának lekérdezése.",
        "description": "**Cél:** A helyi AI Asszisztens beszélgetései, háttérfeladatai, csatolmányai és generált eredményei.\n\n**Végpont:** `GET /api/assistant/jobs/{id}`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Assistant_JobStatus",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Assistant.AssistantJobStatusDto"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Assistant.AssistantJobStatusDto"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Assistant.AssistantJobStatusDto"
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/assistant/transcribe": {
      "post": {
        "tags": [
          "Assistant"
        ],
        "summary": "Transcribe",
        "description": "**Cél:** A helyi AI Asszisztens beszélgetései, háttérfeladatai, csatolmányai és generált eredményei.\n\n**Végpont:** `POST /api/assistant/transcribe`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik. Rate-limit szabály: ai. Maximális request méret: 104 857 600 byte.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Assistant_Transcribe",
        "requestBody": {
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary"
                  }
                }
              },
              "encoding": {
                "file": {
                  "style": "form"
                }
              }
            }
          }
        },
        "responses": {
          "202": {
            "description": "Accepted",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Common.BackgroundJobAccepted"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Common.BackgroundJobAccepted"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Common.BackgroundJobAccepted"
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/assistant/artifact": {
      "post": {
        "tags": [
          "Assistant"
        ],
        "summary": "Artifact",
        "description": "**Cél:** A helyi AI Asszisztens beszélgetései, háttérfeladatai, csatolmányai és generált eredményei.\n\n**Végpont:** `POST /api/assistant/artifact`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik. Rate-limit szabály: ai.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Assistant_Artifact",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Assistant.AssistantArtifactRequest"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Assistant.AssistantArtifactRequest"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Assistant.AssistantArtifactRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/assistant/messages/{messageId}/artifact": {
      "get": {
        "tags": [
          "Assistant"
        ],
        "summary": "Generated Artifact",
        "description": "**Cél:** A helyi AI Asszisztens beszélgetései, háttérfeladatai, csatolmányai és generált eredményei.\n\n**Végpont:** `GET /api/assistant/messages/{messageId}/artifact`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik. Rate-limit szabály: export.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Assistant_GeneratedArtifact",
        "parameters": [
          {
            "name": "messageId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/assistant/conversations": {
      "get": {
        "tags": [
          "Assistant"
        ],
        "summary": "Conversations",
        "description": "**Cél:** A helyi AI Asszisztens beszélgetései, háttérfeladatai, csatolmányai és generált eredményei.\n\n**Végpont:** `GET /api/assistant/conversations`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Assistant_Conversations",
        "parameters": [
          {
            "name": "q",
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Assistant.ConversationListItem"
                  }
                }
              },
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Assistant.ConversationListItem"
                  }
                }
              },
              "text/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Assistant.ConversationListItem"
                  }
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/assistant/conversations/{id}": {
      "get": {
        "tags": [
          "Assistant"
        ],
        "summary": "Conversation",
        "description": "**Cél:** A helyi AI Asszisztens beszélgetései, háttérfeladatai, csatolmányai és generált eredményei.\n\n**Végpont:** `GET /api/assistant/conversations/{id}`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Assistant_Conversation",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Assistant.ConversationDetails"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Assistant.ConversationDetails"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Assistant.ConversationDetails"
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      },
      "delete": {
        "tags": [
          "Assistant"
        ],
        "summary": "Delete Conversation",
        "description": "**Cél:** A helyi AI Asszisztens beszélgetései, háttérfeladatai, csatolmányai és generált eredményei.\n\n**Végpont:** `DELETE /api/assistant/conversations/{id}`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Assistant_DeleteConversation",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/assistant/conversations/{id}/delete": {
      "post": {
        "tags": [
          "Assistant"
        ],
        "summary": "Delete Conversation Post",
        "description": "**Cél:** A helyi AI Asszisztens beszélgetései, háttérfeladatai, csatolmányai és generált eredményei.\n\n**Végpont:** `POST /api/assistant/conversations/{id}/delete`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Assistant_DeleteConversationPost",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/audit": {
      "get": {
        "tags": [
          "Audit"
        ],
        "summary": "List",
        "description": "**Cél:** Visszakereshető biztonsági és üzleti eseménynapló lekérdezése.\n\n**Végpont:** `GET /api/audit`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Audit_List",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32",
              "default": 1
            }
          },
          {
            "name": "pageSize",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32",
              "default": 50
            }
          },
          {
            "name": "search",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "user",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "action",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "entityType",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "from",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "to",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "trackView",
            "in": "query",
            "schema": {
              "type": "boolean",
              "default": true
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Common.PagedResult`1[[OmegaMunicipal.Contracts.Audit.AuditLogDto, OmegaMunicipal.Contracts, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null]]"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Common.PagedResult`1[[OmegaMunicipal.Contracts.Audit.AuditLogDto, OmegaMunicipal.Contracts, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null]]"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Common.PagedResult`1[[OmegaMunicipal.Contracts.Audit.AuditLogDto, OmegaMunicipal.Contracts, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null]]"
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/audit/export.xlsx": {
      "get": {
        "tags": [
          "Audit"
        ],
        "summary": "Export Excel",
        "description": "**Cél:** Visszakereshető biztonsági és üzleti eseménynapló lekérdezése.\n\n**Végpont:** `GET /api/audit/export.xlsx`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Audit_ExportExcel",
        "parameters": [
          {
            "name": "search",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "user",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "action",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "entityType",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "from",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "to",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/auth/login": {
      "post": {
        "tags": [
          "Auth"
        ],
        "summary": "Login",
        "description": "**Cél:** Felhasználói hitelesítés, tokenfrissítés és munkamenet-kezelés.\n\n**Végpont:** `POST /api/auth/login`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Nyilvános végpont: JWT nem szükséges. A nyilvános végpontokra IP-alapú rate limit és bemenet-validáció vonatkozik. Rate-limit szabály: auth.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Auth_Login",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Auth.LoginRequest"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Auth.LoginRequest"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Auth.LoginRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Auth.AuthResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Auth.AuthResponse"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Auth.AuthResponse"
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        }
      }
    },
    "/api/auth/refresh": {
      "post": {
        "tags": [
          "Auth"
        ],
        "summary": "Refresh",
        "description": "**Cél:** Felhasználói hitelesítés, tokenfrissítés és munkamenet-kezelés.\n\n**Végpont:** `POST /api/auth/refresh`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Nyilvános végpont: JWT nem szükséges. A nyilvános végpontokra IP-alapú rate limit és bemenet-validáció vonatkozik. Rate-limit szabály: auth.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Auth_Refresh",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Auth.RefreshTokenRequest"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Auth.RefreshTokenRequest"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Auth.RefreshTokenRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Auth.AuthResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Auth.AuthResponse"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Auth.AuthResponse"
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        }
      }
    },
    "/api/auth/logout": {
      "post": {
        "tags": [
          "Auth"
        ],
        "summary": "Logout",
        "description": "**Cél:** Felhasználói hitelesítés, tokenfrissítés és munkamenet-kezelés.\n\n**Végpont:** `POST /api/auth/logout`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Nyilvános végpont: JWT nem szükséges. A nyilvános végpontokra IP-alapú rate limit és bemenet-validáció vonatkozik. Rate-limit szabály: auth.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Auth_Logout",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Auth.LogoutRequest"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Auth.LogoutRequest"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Auth.LogoutRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        }
      }
    },
    "/api/auth/me": {
      "get": {
        "tags": [
          "Auth"
        ],
        "summary": "Me",
        "description": "**Cél:** Felhasználói hitelesítés, tokenfrissítés és munkamenet-kezelés.\n\n**Végpont:** `GET /api/auth/me`\n\n**Bemenet:** Nincs külön bemeneti paraméter, vagy a bemenet az útvonalból/hitelesített kontextusból származik.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Auth_Me",
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Auth.UserProfile"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Auth.UserProfile"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Auth.UserProfile"
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/background-jobs/{id}": {
      "get": {
        "tags": [
          "BackgroundJobs"
        ],
        "summary": "Get",
        "description": "**Cél:** A megadott erőforrás vagy lista lekérdezése.\n\n**Végpont:** `GET /api/background-jobs/{id}`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "BackgroundJobs_Get",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Common.BackgroundJobStatusDto"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Common.BackgroundJobStatusDto"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Common.BackgroundJobStatusDto"
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/background-jobs/activity": {
      "get": {
        "tags": [
          "BackgroundJobs"
        ],
        "summary": "Activity",
        "description": "**Cél:** A megadott erőforrás vagy lista lekérdezése.\n\n**Végpont:** `GET /api/background-jobs/activity`\n\n**Bemenet:** Nincs külön bemeneti paraméter, vagy a bemenet az útvonalból/hitelesített kontextusból származik.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "BackgroundJobs_Activity",
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Common.BackgroundActivityDto"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Common.BackgroundActivityDto"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Common.BackgroundActivityDto"
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/system/background-jobs": {
      "get": {
        "tags": [
          "BackgroundJobsAdmin"
        ],
        "summary": "List",
        "description": "**Cél:** A megadott erőforrás vagy lista lekérdezése.\n\n**Végpont:** `GET /api/system/background-jobs`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik. Engedélyezett szerepkörök: SystemAdmin.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "BackgroundJobsAdmin_List",
        "parameters": [
          {
            "name": "status",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "kind",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "page",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32",
              "default": 1
            }
          },
          {
            "name": "pageSize",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32",
              "default": 50
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Common.PagedResult`1[[OmegaMunicipal.Contracts.Common.BackgroundJobAdminDto, OmegaMunicipal.Contracts, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null]]"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Common.PagedResult`1[[OmegaMunicipal.Contracts.Common.BackgroundJobAdminDto, OmegaMunicipal.Contracts, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null]]"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Common.PagedResult`1[[OmegaMunicipal.Contracts.Common.BackgroundJobAdminDto, OmegaMunicipal.Contracts, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null]]"
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/system/background-jobs/runtime": {
      "get": {
        "tags": [
          "BackgroundJobsAdmin"
        ],
        "summary": "Runtime",
        "description": "**Cél:** A megadott erőforrás vagy lista lekérdezése.\n\n**Végpont:** `GET /api/system/background-jobs/runtime`\n\n**Bemenet:** Nincs külön bemeneti paraméter, vagy a bemenet az útvonalból/hitelesített kontextusból származik.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik. Engedélyezett szerepkörök: SystemAdmin.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "BackgroundJobsAdmin_Runtime",
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Common.BackgroundWorkerRuntimeDto"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Common.BackgroundWorkerRuntimeDto"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Common.BackgroundWorkerRuntimeDto"
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/system/background-jobs/{id}": {
      "delete": {
        "tags": [
          "BackgroundJobsAdmin"
        ],
        "summary": "Delete",
        "description": "**Cél:** Meglévő erőforrás törlése a jogosultsági szabályok szerint.\n\n**Végpont:** `DELETE /api/system/background-jobs/{id}`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik. Engedélyezett szerepkörök: SystemAdmin.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "BackgroundJobsAdmin_Delete",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Common.BackgroundJobMutationResult"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Common.BackgroundJobMutationResult"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Common.BackgroundJobMutationResult"
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/system/background-jobs/delete-filtered": {
      "post": {
        "tags": [
          "BackgroundJobsAdmin"
        ],
        "summary": "Delete Filtered",
        "description": "**Cél:** Új erőforrás létrehozása vagy szerveroldali feldolgozás indítása.\n\n**Végpont:** `POST /api/system/background-jobs/delete-filtered`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik. Engedélyezett szerepkörök: SystemAdmin.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "BackgroundJobsAdmin_DeleteFiltered",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Common.BackgroundJobBulkDeleteRequest"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Common.BackgroundJobBulkDeleteRequest"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Common.BackgroundJobBulkDeleteRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Common.BackgroundJobMutationResult"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Common.BackgroundJobMutationResult"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Common.BackgroundJobMutationResult"
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/system/background-jobs/{id}/requeue": {
      "post": {
        "tags": [
          "BackgroundJobsAdmin"
        ],
        "summary": "Requeue",
        "description": "**Cél:** Új erőforrás létrehozása vagy szerveroldali feldolgozás indítása.\n\n**Végpont:** `POST /api/system/background-jobs/{id}/requeue`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik. Engedélyezett szerepkörök: SystemAdmin.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "BackgroundJobsAdmin_Requeue",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Common.BackgroundJobMutationResult"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Common.BackgroundJobMutationResult"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Common.BackgroundJobMutationResult"
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/citizen-reports/summary": {
      "get": {
        "tags": [
          "CitizenReports"
        ],
        "summary": "Summary",
        "description": "**Cél:** Lakossági hibabejelentések fogadása és ügykövetése.\n\n**Végpont:** `GET /api/citizen-reports/summary`\n\n**Bemenet:** Nincs külön bemeneti paraméter, vagy a bemenet az útvonalból/hitelesített kontextusból származik.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "CitizenReports_Summary",
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Citizens.CitizenReportSummaryDto"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Citizens.CitizenReportSummaryDto"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Citizens.CitizenReportSummaryDto"
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/citizen-reports": {
      "get": {
        "tags": [
          "CitizenReports"
        ],
        "summary": "List",
        "description": "**Cél:** Lakossági hibabejelentések fogadása és ügykövetése.\n\n**Végpont:** `GET /api/citizen-reports`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "CitizenReports_List",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32",
              "default": 1
            }
          },
          {
            "name": "pageSize",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32",
              "default": 50
            }
          },
          {
            "name": "search",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "status",
            "in": "query",
            "schema": {
              "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Enums.CitizenReportStatus"
            }
          },
          {
            "name": "category",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "department",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "assignedUserId",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "from",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "to",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Common.PagedResult`1[[OmegaMunicipal.Contracts.Citizens.CitizenReportDto, OmegaMunicipal.Contracts, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null]]"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Common.PagedResult`1[[OmegaMunicipal.Contracts.Citizens.CitizenReportDto, OmegaMunicipal.Contracts, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null]]"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Common.PagedResult`1[[OmegaMunicipal.Contracts.Citizens.CitizenReportDto, OmegaMunicipal.Contracts, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null]]"
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/citizen-reports/departments": {
      "get": {
        "tags": [
          "CitizenReports"
        ],
        "summary": "Departments",
        "description": "**Cél:** Lakossági hibabejelentések fogadása és ügykövetése.\n\n**Végpont:** `GET /api/citizen-reports/departments`\n\n**Bemenet:** Nincs külön bemeneti paraméter, vagy a bemenet az útvonalból/hitelesített kontextusból származik.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "CitizenReports_Departments",
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Common.DepartmentDto"
                  }
                }
              },
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Common.DepartmentDto"
                  }
                }
              },
              "text/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Common.DepartmentDto"
                  }
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/citizen-reports/assignees": {
      "get": {
        "tags": [
          "CitizenReports"
        ],
        "summary": "Assignees",
        "description": "**Cél:** Lakossági hibabejelentések fogadása és ügykövetése.\n\n**Végpont:** `GET /api/citizen-reports/assignees`\n\n**Bemenet:** Nincs külön bemeneti paraméter, vagy a bemenet az útvonalból/hitelesített kontextusból származik.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "CitizenReports_Assignees",
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Citizens.CitizenAssigneeDto"
                  }
                }
              },
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Citizens.CitizenAssigneeDto"
                  }
                }
              },
              "text/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Citizens.CitizenAssigneeDto"
                  }
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/citizen-reports/{id}": {
      "get": {
        "tags": [
          "CitizenReports"
        ],
        "summary": "Get",
        "description": "**Cél:** Lakossági hibabejelentések fogadása és ügykövetése.\n\n**Végpont:** `GET /api/citizen-reports/{id}`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "CitizenReports_Get",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Citizens.CitizenReportDto"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Citizens.CitizenReportDto"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Citizens.CitizenReportDto"
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      },
      "put": {
        "tags": [
          "CitizenReports"
        ],
        "summary": "Update",
        "description": "**Cél:** Lakossági hibabejelentések fogadása és ügykövetése.\n\n**Végpont:** `PUT /api/citizen-reports/{id}`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "CitizenReports_Update",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Citizens.UpdateCitizenReportRequest"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Citizens.UpdateCitizenReportRequest"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Citizens.UpdateCitizenReportRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Citizens.CitizenReportDto"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Citizens.CitizenReportDto"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Citizens.CitizenReportDto"
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/citizen-reports/{id}/update": {
      "post": {
        "tags": [
          "CitizenReports"
        ],
        "summary": "Update Post",
        "description": "**Cél:** Lakossági hibabejelentések fogadása és ügykövetése.\n\n**Végpont:** `POST /api/citizen-reports/{id}/update`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "CitizenReports_UpdatePost",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Citizens.UpdateCitizenReportRequest"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Citizens.UpdateCitizenReportRequest"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Citizens.UpdateCitizenReportRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Citizens.CitizenReportDto"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Citizens.CitizenReportDto"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Citizens.CitizenReportDto"
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/citizen-reports/{id}/attachments": {
      "get": {
        "tags": [
          "CitizenReports"
        ],
        "summary": "Attachments",
        "description": "**Cél:** Lakossági hibabejelentések fogadása és ügykövetése.\n\n**Végpont:** `GET /api/citizen-reports/{id}/attachments`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "CitizenReports_Attachments",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Citizens.CitizenReportAttachmentDto"
                  }
                }
              },
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Citizens.CitizenReportAttachmentDto"
                  }
                }
              },
              "text/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Citizens.CitizenReportAttachmentDto"
                  }
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/citizen-reports/{id}/attachments/{attachmentId}": {
      "get": {
        "tags": [
          "CitizenReports"
        ],
        "summary": "Attachment",
        "description": "**Cél:** Lakossági hibabejelentések fogadása és ügykövetése.\n\n**Végpont:** `GET /api/citizen-reports/{id}/attachments/{attachmentId}`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "CitizenReports_Attachment",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "attachmentId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/citizen-supports/programs": {
      "get": {
        "tags": [
          "CitizenSupports"
        ],
        "summary": "Programs",
        "description": "**Cél:** Lakossági támogatási programok, kérelmek és dokumentumok kezelése.\n\n**Végpont:** `GET /api/citizen-supports/programs`\n\n**Bemenet:** Nincs külön bemeneti paraméter, vagy a bemenet az útvonalból/hitelesített kontextusból származik.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "CitizenSupports_Programs",
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Supports.CitizenSupportProgramDto"
                  }
                }
              },
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Supports.CitizenSupportProgramDto"
                  }
                }
              },
              "text/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Supports.CitizenSupportProgramDto"
                  }
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      },
      "post": {
        "tags": [
          "CitizenSupports"
        ],
        "summary": "Create Program",
        "description": "**Cél:** Lakossági támogatási programok, kérelmek és dokumentumok kezelése.\n\n**Végpont:** `POST /api/citizen-supports/programs`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "CitizenSupports_CreateProgram",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Supports.SaveCitizenSupportProgramRequest"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Supports.SaveCitizenSupportProgramRequest"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Supports.SaveCitizenSupportProgramRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Supports.CitizenSupportProgramDto"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Supports.CitizenSupportProgramDto"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Supports.CitizenSupportProgramDto"
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/citizen-supports/programs/{id}": {
      "get": {
        "tags": [
          "CitizenSupports"
        ],
        "summary": "Program",
        "description": "**Cél:** Lakossági támogatási programok, kérelmek és dokumentumok kezelése.\n\n**Végpont:** `GET /api/citizen-supports/programs/{id}`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "CitizenSupports_Program",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Supports.CitizenSupportProgramDto"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Supports.CitizenSupportProgramDto"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Supports.CitizenSupportProgramDto"
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      },
      "put": {
        "tags": [
          "CitizenSupports"
        ],
        "summary": "Update Program",
        "description": "**Cél:** Lakossági támogatási programok, kérelmek és dokumentumok kezelése.\n\n**Végpont:** `PUT /api/citizen-supports/programs/{id}`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "CitizenSupports_UpdateProgram",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Supports.SaveCitizenSupportProgramRequest"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Supports.SaveCitizenSupportProgramRequest"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Supports.SaveCitizenSupportProgramRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Supports.CitizenSupportProgramDto"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Supports.CitizenSupportProgramDto"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Supports.CitizenSupportProgramDto"
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      },
      "delete": {
        "tags": [
          "CitizenSupports"
        ],
        "summary": "Delete Program",
        "description": "**Cél:** Lakossági támogatási programok, kérelmek és dokumentumok kezelése.\n\n**Végpont:** `DELETE /api/citizen-supports/programs/{id}`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "CitizenSupports_DeleteProgram",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/citizen-supports/programs/{id}/source-document": {
      "post": {
        "tags": [
          "CitizenSupports"
        ],
        "summary": "Upload Source Document",
        "description": "**Cél:** Lakossági támogatási programok, kérelmek és dokumentumok kezelése.\n\n**Végpont:** `POST /api/citizen-supports/programs/{id}/source-document`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik. Maximális request méret: 26 214 400 byte.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "CitizenSupports_UploadSourceDocument",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "kind",
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary"
                  }
                }
              },
              "encoding": {
                "file": {
                  "style": "form"
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Supports.CitizenSupportProgramDto"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Supports.CitizenSupportProgramDto"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Supports.CitizenSupportProgramDto"
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/citizen-supports/programs/{id}/generate-source-document": {
      "post": {
        "tags": [
          "CitizenSupports"
        ],
        "summary": "Generate Source Document",
        "description": "**Cél:** Lakossági támogatási programok, kérelmek és dokumentumok kezelése.\n\n**Végpont:** `POST /api/citizen-supports/programs/{id}/generate-source-document`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "CitizenSupports_GenerateSourceDocument",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "kind",
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Supports.CitizenSupportProgramDto"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Supports.CitizenSupportProgramDto"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Supports.CitizenSupportProgramDto"
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/citizen-supports/summary": {
      "get": {
        "tags": [
          "CitizenSupports"
        ],
        "summary": "Summary",
        "description": "**Cél:** Lakossági támogatási programok, kérelmek és dokumentumok kezelése.\n\n**Végpont:** `GET /api/citizen-supports/summary`\n\n**Bemenet:** Nincs külön bemeneti paraméter, vagy a bemenet az útvonalból/hitelesített kontextusból származik.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "CitizenSupports_Summary",
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Supports.CitizenSupportSummaryDto"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Supports.CitizenSupportSummaryDto"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Supports.CitizenSupportSummaryDto"
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/citizen-supports/applications": {
      "get": {
        "tags": [
          "CitizenSupports"
        ],
        "summary": "Applications",
        "description": "**Cél:** Lakossági támogatási programok, kérelmek és dokumentumok kezelése.\n\n**Végpont:** `GET /api/citizen-supports/applications`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "CitizenSupports_Applications",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32",
              "default": 1
            }
          },
          {
            "name": "pageSize",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32",
              "default": 50
            }
          },
          {
            "name": "search",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "status",
            "in": "query",
            "schema": {
              "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Enums.CitizenSupportApplicationStatus"
            }
          },
          {
            "name": "programId",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Common.PagedResult`1[[OmegaMunicipal.Contracts.Supports.CitizenSupportApplicationDto, OmegaMunicipal.Contracts, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null]]"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Common.PagedResult`1[[OmegaMunicipal.Contracts.Supports.CitizenSupportApplicationDto, OmegaMunicipal.Contracts, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null]]"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Common.PagedResult`1[[OmegaMunicipal.Contracts.Supports.CitizenSupportApplicationDto, OmegaMunicipal.Contracts, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null]]"
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/citizen-supports/applications/{id}": {
      "get": {
        "tags": [
          "CitizenSupports"
        ],
        "summary": "Application",
        "description": "**Cél:** Lakossági támogatási programok, kérelmek és dokumentumok kezelése.\n\n**Végpont:** `GET /api/citizen-supports/applications/{id}`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "CitizenSupports_Application",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Supports.CitizenSupportApplicationDto"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Supports.CitizenSupportApplicationDto"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Supports.CitizenSupportApplicationDto"
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      },
      "put": {
        "tags": [
          "CitizenSupports"
        ],
        "summary": "Update Application",
        "description": "**Cél:** Lakossági támogatási programok, kérelmek és dokumentumok kezelése.\n\n**Végpont:** `PUT /api/citizen-supports/applications/{id}`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "CitizenSupports_UpdateApplication",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Supports.UpdateCitizenSupportApplicationRequest"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Supports.UpdateCitizenSupportApplicationRequest"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Supports.UpdateCitizenSupportApplicationRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Supports.CitizenSupportApplicationDto"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Supports.CitizenSupportApplicationDto"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Supports.CitizenSupportApplicationDto"
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/citizen-supports/applications/{id}/analyze": {
      "post": {
        "tags": [
          "CitizenSupports"
        ],
        "summary": "Analyze",
        "description": "**Cél:** Lakossági támogatási programok, kérelmek és dokumentumok kezelése.\n\n**Végpont:** `POST /api/citizen-supports/applications/{id}/analyze`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik. Rate-limit szabály: ai.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "CitizenSupports_Analyze",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Common.BackgroundJobAccepted"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Common.BackgroundJobAccepted"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Common.BackgroundJobAccepted"
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/citizen-supports/applications/{id}/documents/{documentId}": {
      "get": {
        "tags": [
          "CitizenSupports"
        ],
        "summary": "Download Application Document",
        "description": "**Cél:** Lakossági támogatási programok, kérelmek és dokumentumok kezelése.\n\n**Végpont:** `GET /api/citizen-supports/applications/{id}/documents/{documentId}`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "CitizenSupports_DownloadApplicationDocument",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "documentId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/citizen-supports/applications/{id}/decision-document": {
      "post": {
        "tags": [
          "CitizenSupports"
        ],
        "summary": "Generate Decision",
        "description": "**Cél:** Lakossági támogatási programok, kérelmek és dokumentumok kezelése.\n\n**Végpont:** `POST /api/citizen-supports/applications/{id}/decision-document`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik. Rate-limit szabály: ai.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "CitizenSupports_GenerateDecision",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Common.BackgroundJobAccepted"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Common.BackgroundJobAccepted"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Common.BackgroundJobAccepted"
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/dashboard/overview": {
      "get": {
        "tags": [
          "Dashboard"
        ],
        "summary": "Overview",
        "description": "**Cél:** A megadott erőforrás vagy lista lekérdezése.\n\n**Végpont:** `GET /api/dashboard/overview`\n\n**Bemenet:** Nincs külön bemeneti paraméter, vagy a bemenet az útvonalból/hitelesített kontextusból származik.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Dashboard_Overview",
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Dashboard.DashboardOverview"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Dashboard.DashboardOverview"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Dashboard.DashboardOverview"
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/documents": {
      "get": {
        "tags": [
          "Documents"
        ],
        "summary": "List",
        "description": "**Cél:** Önkormányzati Dokumentumtár feltöltési, keresési és feldolgozási műveletei.\n\n**Végpont:** `GET /api/documents`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Documents_List",
        "parameters": [
          {
            "name": "search",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "category",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "status",
            "in": "query",
            "schema": {
              "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Enums.DocumentStatus"
            }
          },
          {
            "name": "from",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "to",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "page",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32",
              "default": 1
            }
          },
          {
            "name": "pageSize",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32",
              "default": 50
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Common.PagedResult`1[[OmegaMunicipal.Contracts.Documents.DocumentListItem, OmegaMunicipal.Contracts, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null]]"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Common.PagedResult`1[[OmegaMunicipal.Contracts.Documents.DocumentListItem, OmegaMunicipal.Contracts, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null]]"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Common.PagedResult`1[[OmegaMunicipal.Contracts.Documents.DocumentListItem, OmegaMunicipal.Contracts, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null]]"
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/documents/{id}": {
      "get": {
        "tags": [
          "Documents"
        ],
        "summary": "Get",
        "description": "**Cél:** Önkormányzati Dokumentumtár feltöltési, keresési és feldolgozási műveletei.\n\n**Végpont:** `GET /api/documents/{id}`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Documents_Get",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Documents.DocumentDetails"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Documents.DocumentDetails"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Documents.DocumentDetails"
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      },
      "put": {
        "tags": [
          "Documents"
        ],
        "summary": "Update",
        "description": "**Cél:** Önkormányzati Dokumentumtár feltöltési, keresési és feldolgozási műveletei.\n\n**Végpont:** `PUT /api/documents/{id}`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Documents_Update",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Documents.UpdateDocumentRequest"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Documents.UpdateDocumentRequest"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Documents.UpdateDocumentRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Documents.DocumentDetails"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Documents.DocumentDetails"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Documents.DocumentDetails"
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      },
      "delete": {
        "tags": [
          "Documents"
        ],
        "summary": "Delete",
        "description": "**Cél:** Önkormányzati Dokumentumtár feltöltési, keresési és feldolgozási műveletei.\n\n**Végpont:** `DELETE /api/documents/{id}`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Documents_Delete",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/documents/text": {
      "post": {
        "tags": [
          "Documents"
        ],
        "summary": "Create Text",
        "description": "**Cél:** Önkormányzati Dokumentumtár feltöltési, keresési és feldolgozási műveletei.\n\n**Végpont:** `POST /api/documents/text`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Documents_CreateText",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Documents.CreateTextDocumentRequest"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Documents.CreateTextDocumentRequest"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Documents.CreateTextDocumentRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Documents.DocumentDetails"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Documents.DocumentDetails"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Documents.DocumentDetails"
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/documents/upload": {
      "post": {
        "tags": [
          "Documents"
        ],
        "summary": "Upload",
        "description": "**Cél:** Önkormányzati Dokumentumtár feltöltési, keresési és feldolgozási műveletei.\n\n**Végpont:** `POST /api/documents/upload`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik. Maximális request méret: 26 214 400 byte.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Documents_Upload",
        "requestBody": {
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "title": {
                    "type": "string"
                  },
                  "category": {
                    "type": "string"
                  },
                  "isPublic": {
                    "type": "boolean"
                  },
                  "file": {
                    "type": "string",
                    "format": "binary"
                  }
                }
              },
              "encoding": {
                "title": {
                  "style": "form"
                },
                "category": {
                  "style": "form"
                },
                "isPublic": {
                  "style": "form"
                },
                "file": {
                  "style": "form"
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Documents.DocumentDetails"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Documents.DocumentDetails"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Documents.DocumentDetails"
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/documents/{id}/analyze": {
      "post": {
        "tags": [
          "Documents"
        ],
        "summary": "Analyze",
        "description": "**Cél:** Önkormányzati Dokumentumtár feltöltési, keresési és feldolgozási műveletei.\n\n**Végpont:** `POST /api/documents/{id}/analyze`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik. Rate-limit szabály: ai.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Documents_Analyze",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Common.BackgroundJobAccepted"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Common.BackgroundJobAccepted"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Common.BackgroundJobAccepted"
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/documents/{id}/reindex": {
      "post": {
        "tags": [
          "Documents"
        ],
        "summary": "Reindex",
        "description": "**Cél:** Önkormányzati Dokumentumtár feltöltési, keresési és feldolgozási műveletei.\n\n**Végpont:** `POST /api/documents/{id}/reindex`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Documents_Reindex",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Common.BackgroundJobAccepted"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Common.BackgroundJobAccepted"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Common.BackgroundJobAccepted"
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/documents/reindex-all": {
      "post": {
        "tags": [
          "Documents"
        ],
        "summary": "Reindex All",
        "description": "**Cél:** Önkormányzati Dokumentumtár feltöltési, keresési és feldolgozási műveletei.\n\n**Végpont:** `POST /api/documents/reindex-all`\n\n**Bemenet:** Nincs külön bemeneti paraméter, vagy a bemenet az útvonalból/hitelesített kontextusból származik.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Documents_ReindexAll",
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Documents.DocumentReindexResult"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Documents.DocumentReindexResult"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Documents.DocumentReindexResult"
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/documents/{id}/download": {
      "get": {
        "tags": [
          "Documents"
        ],
        "summary": "Download",
        "description": "**Cél:** Önkormányzati Dokumentumtár feltöltési, keresési és feldolgozási műveletei.\n\n**Végpont:** `GET /api/documents/{id}/download`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Documents_Download",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/energy/dashboard": {
      "get": {
        "tags": [
          "Energy"
        ],
        "summary": "Dashboard",
        "description": "**Cél:** A megadott erőforrás vagy lista lekérdezése.\n\n**Végpont:** `GET /api/energy/dashboard`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Energy_Dashboard",
        "parameters": [
          {
            "name": "days",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32",
              "default": 90
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Energy.EnergyDashboardDto"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Energy.EnergyDashboardDto"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Energy.EnergyDashboardDto"
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/energy/sites/{siteId}/history": {
      "get": {
        "tags": [
          "Energy"
        ],
        "summary": "History",
        "description": "**Cél:** A megadott erőforrás vagy lista lekérdezése.\n\n**Végpont:** `GET /api/energy/sites/{siteId}/history`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Energy_History",
        "parameters": [
          {
            "name": "siteId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "days",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32",
              "default": 90
            }
          },
          {
            "name": "aggregation",
            "in": "query",
            "schema": {
              "type": "string",
              "default": "day"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Energy.EnergySiteHistoryDto"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Energy.EnergySiteHistoryDto"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Energy.EnergySiteHistoryDto"
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/energy/analyze": {
      "post": {
        "tags": [
          "Energy"
        ],
        "summary": "Analyze",
        "description": "**Cél:** Új erőforrás létrehozása vagy szerveroldali feldolgozás indítása.\n\n**Végpont:** `POST /api/energy/analyze`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik. Rate-limit szabály: ai.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Energy_Analyze",
        "parameters": [
          {
            "name": "days",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32",
              "default": 90
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Common.BackgroundJobAccepted"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Common.BackgroundJobAccepted"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Common.BackgroundJobAccepted"
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/energy/sites": {
      "post": {
        "tags": [
          "Energy"
        ],
        "summary": "Create Site",
        "description": "**Cél:** Új erőforrás létrehozása vagy szerveroldali feldolgozás indítása.\n\n**Végpont:** `POST /api/energy/sites`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Energy_CreateSite",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Energy.UpsertEnergySiteRequest"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Energy.UpsertEnergySiteRequest"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Energy.UpsertEnergySiteRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Energy.EnergySiteDto"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Energy.EnergySiteDto"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Energy.EnergySiteDto"
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/energy/sites/{id}": {
      "put": {
        "tags": [
          "Energy"
        ],
        "summary": "Update Site",
        "description": "**Cél:** Meglévő erőforrás módosítása.\n\n**Végpont:** `PUT /api/energy/sites/{id}`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Energy_UpdateSite",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Energy.UpsertEnergySiteRequest"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Energy.UpsertEnergySiteRequest"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Energy.UpsertEnergySiteRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Energy.EnergySiteDto"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Energy.EnergySiteDto"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Energy.EnergySiteDto"
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      },
      "delete": {
        "tags": [
          "Energy"
        ],
        "summary": "Delete Site",
        "description": "**Cél:** Meglévő erőforrás törlése a jogosultsági szabályok szerint.\n\n**Végpont:** `DELETE /api/energy/sites/{id}`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Energy_DeleteSite",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/energy/sites/{siteId}/readings/import": {
      "post": {
        "tags": [
          "Energy"
        ],
        "summary": "Import",
        "description": "**Cél:** Új erőforrás létrehozása vagy szerveroldali feldolgozás indítása.\n\n**Végpont:** `POST /api/energy/sites/{siteId}/readings/import`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik. Maximális request méret: 10 485 760 byte.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Energy_Import",
        "parameters": [
          {
            "name": "siteId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary"
                  }
                }
              },
              "encoding": {
                "file": {
                  "style": "form"
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/error-logs": {
      "get": {
        "tags": [
          "ErrorLogs"
        ],
        "summary": "List",
        "description": "**Cél:** Központi SQL hibanapló és diagnosztikai adatok lekérdezése.\n\n**Végpont:** `GET /api/error-logs`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik. Engedélyezett szerepkörök: SystemAdmin, MunicipalityAdmin.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "ErrorLogs_List",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32",
              "default": 1
            }
          },
          {
            "name": "pageSize",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32",
              "default": 25
            }
          },
          {
            "name": "search",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "level",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "category",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "traceId",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "resolved",
            "in": "query",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "from",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "to",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Common.PagedResult`1[[OmegaMunicipal.Contracts.Audit.ErrorLogDto, OmegaMunicipal.Contracts, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null]]"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Common.PagedResult`1[[OmegaMunicipal.Contracts.Audit.ErrorLogDto, OmegaMunicipal.Contracts, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null]]"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Common.PagedResult`1[[OmegaMunicipal.Contracts.Audit.ErrorLogDto, OmegaMunicipal.Contracts, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null]]"
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/grants": {
      "get": {
        "tags": [
          "Grants"
        ],
        "summary": "List",
        "description": "**Cél:** Pályázatok keresése, frissítése, projektillesztése és pályázati döntéstámogatás.\n\n**Végpont:** `GET /api/grants`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Grants_List",
        "parameters": [
          {
            "name": "search",
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Grants.GrantOpportunityDto"
                  }
                }
              },
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Grants.GrantOpportunityDto"
                  }
                }
              },
              "text/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Grants.GrantOpportunityDto"
                  }
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/grants/search": {
      "get": {
        "tags": [
          "Grants"
        ],
        "summary": "Search",
        "description": "**Cél:** Pályázatok keresése, frissítése, projektillesztése és pályázati döntéstámogatás.\n\n**Végpont:** `GET /api/grants/search`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Grants_Search",
        "parameters": [
          {
            "name": "search",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "source",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "deadlineFrom",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date"
            }
          },
          {
            "name": "deadlineTo",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date"
            }
          },
          {
            "name": "page",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32",
              "default": 1
            }
          },
          {
            "name": "pageSize",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32",
              "default": 50
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Grants.GrantSearchResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Grants.GrantSearchResponse"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Grants.GrantSearchResponse"
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/grants/feed-status": {
      "get": {
        "tags": [
          "Grants"
        ],
        "summary": "Feed Status",
        "description": "**Cél:** Pályázatok keresése, frissítése, projektillesztése és pályázati döntéstámogatás.\n\n**Végpont:** `GET /api/grants/feed-status`\n\n**Bemenet:** Nincs külön bemeneti paraméter, vagy a bemenet az útvonalból/hitelesített kontextusból származik.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Grants_FeedStatus",
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Grants.GrantFeedStatusDto"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Grants.GrantFeedStatusDto"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Grants.GrantFeedStatusDto"
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/grants/refresh-now": {
      "post": {
        "tags": [
          "Grants"
        ],
        "summary": "Azonnali, teljes OpenAI webes pályázatfrissítés kézi indítása.",
        "description": "SystemAdmin jogosultság szükséges. Ugyanazt a teljes discovery-folyamatot futtatja, mint az esti automatikus frissítés, majd az eredményt a helyi adatbázisba menti.\n\n**Cél:** Pályázatok keresése, frissítése, projektillesztése és pályázati döntéstámogatás.\n\n**Végpont:** `POST /api/grants/refresh-now`\n\n**Bemenet:** Nincs külön bemeneti paraméter, vagy a bemenet az útvonalból/hitelesített kontextusból származik.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik. Engedélyezett szerepkörök: SystemAdmin.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Grants_RefreshNow",
        "responses": {
          "202": {
            "description": "Accepted"
          },
          "409": {
            "description": "Conflict",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/Microsoft.AspNetCore.Mvc.ProblemDetails"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Microsoft.AspNetCore.Mvc.ProblemDetails"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/Microsoft.AspNetCore.Mvc.ProblemDetails"
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/grants/reset-and-rebuild": {
      "post": {
        "tags": [
          "Grants"
        ],
        "summary": "Reset And Rebuild",
        "description": "**Cél:** Pályázatok keresése, frissítése, projektillesztése és pályázati döntéstámogatás.\n\n**Végpont:** `POST /api/grants/reset-and-rebuild`\n\n**Bemenet:** Nincs külön bemeneti paraméter, vagy a bemenet az útvonalból/hitelesített kontextusból származik.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik. Engedélyezett szerepkörök: SystemAdmin.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Grants_ResetAndRebuild",
        "responses": {
          "200": {
            "description": "OK"
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/grants/refresh-status": {
      "get": {
        "tags": [
          "Grants"
        ],
        "summary": "Refresh Status",
        "description": "**Cél:** Pályázatok keresése, frissítése, projektillesztése és pályázati döntéstámogatás.\n\n**Végpont:** `GET /api/grants/refresh-status`\n\n**Bemenet:** Nincs külön bemeneti paraméter, vagy a bemenet az útvonalból/hitelesített kontextusból származik.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik. Engedélyezett szerepkörök: SystemAdmin.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Grants_RefreshStatus",
        "responses": {
          "200": {
            "description": "OK"
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/grants/reset-job/current": {
      "get": {
        "tags": [
          "Grants"
        ],
        "summary": "Current Reset Job",
        "description": "**Cél:** Pályázatok keresése, frissítése, projektillesztése és pályázati döntéstámogatás.\n\n**Végpont:** `GET /api/grants/reset-job/current`\n\n**Bemenet:** Nincs külön bemeneti paraméter, vagy a bemenet az útvonalból/hitelesített kontextusból származik.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik. Engedélyezett szerepkörök: SystemAdmin.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Grants_CurrentResetJob",
        "responses": {
          "200": {
            "description": "OK"
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/grants/reset-job/{id}": {
      "get": {
        "tags": [
          "Grants"
        ],
        "summary": "Reset Job",
        "description": "**Cél:** Pályázatok keresése, frissítése, projektillesztése és pályázati döntéstámogatás.\n\n**Végpont:** `GET /api/grants/reset-job/{id}`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik. Engedélyezett szerepkörök: SystemAdmin.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Grants_ResetJob",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/grants/partners": {
      "get": {
        "tags": [
          "Grants"
        ],
        "summary": "Partners",
        "description": "**Cél:** Pályázatok keresése, frissítése, projektillesztése és pályázati döntéstámogatás.\n\n**Végpont:** `GET /api/grants/partners`\n\n**Bemenet:** Nincs külön bemeneti paraméter, vagy a bemenet az útvonalból/hitelesített kontextusból származik.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Grants_Partners",
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Grants.GrantPartnerDto"
                  }
                }
              },
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Grants.GrantPartnerDto"
                  }
                }
              },
              "text/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Grants.GrantPartnerDto"
                  }
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      },
      "post": {
        "tags": [
          "Grants"
        ],
        "summary": "Create Partner",
        "description": "**Cél:** Pályázatok keresése, frissítése, projektillesztése és pályázati döntéstámogatás.\n\n**Végpont:** `POST /api/grants/partners`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Grants_CreatePartner",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Grants.UpsertGrantPartnerRequest"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Grants.UpsertGrantPartnerRequest"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Grants.UpsertGrantPartnerRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Grants.GrantPartnerDto"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Grants.GrantPartnerDto"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Grants.GrantPartnerDto"
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/grants/partners/{id}": {
      "put": {
        "tags": [
          "Grants"
        ],
        "summary": "Update Partner",
        "description": "**Cél:** Pályázatok keresése, frissítése, projektillesztése és pályázati döntéstámogatás.\n\n**Végpont:** `PUT /api/grants/partners/{id}`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Grants_UpdatePartner",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Grants.UpsertGrantPartnerRequest"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Grants.UpsertGrantPartnerRequest"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Grants.UpsertGrantPartnerRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Grants.GrantPartnerDto"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Grants.GrantPartnerDto"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Grants.GrantPartnerDto"
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      },
      "delete": {
        "tags": [
          "Grants"
        ],
        "summary": "Delete Partner",
        "description": "**Cél:** Pályázatok keresése, frissítése, projektillesztése és pályázati döntéstámogatás.\n\n**Végpont:** `DELETE /api/grants/partners/{id}`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Grants_DeletePartner",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/grants/recommendations/{projectId}": {
      "get": {
        "tags": [
          "Grants"
        ],
        "summary": "Recommendations",
        "description": "**Cél:** Pályázatok keresése, frissítése, projektillesztése és pályázati döntéstámogatás.\n\n**Végpont:** `GET /api/grants/recommendations/{projectId}`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Grants_Recommendations",
        "parameters": [
          {
            "name": "projectId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Grants.GrantMatchResult"
                  }
                }
              },
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Grants.GrantMatchResult"
                  }
                }
              },
              "text/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Grants.GrantMatchResult"
                  }
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/grants/recommendations/{projectId}/refresh": {
      "post": {
        "tags": [
          "Grants"
        ],
        "summary": "Refresh Recommendations",
        "description": "**Cél:** Pályázatok keresése, frissítése, projektillesztése és pályázati döntéstámogatás.\n\n**Végpont:** `POST /api/grants/recommendations/{projectId}/refresh`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik. Rate-limit szabály: ai.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Grants_RefreshRecommendations",
        "parameters": [
          {
            "name": "projectId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "202": {
            "description": "Accepted",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Common.BackgroundJobAccepted"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Common.BackgroundJobAccepted"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Common.BackgroundJobAccepted"
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/grants/{grantId}/assess-project/queue": {
      "post": {
        "tags": [
          "Grants"
        ],
        "summary": "Queue Assess Project",
        "description": "**Cél:** Pályázatok keresése, frissítése, projektillesztése és pályázati döntéstámogatás.\n\n**Végpont:** `POST /api/grants/{grantId}/assess-project/queue`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik. Rate-limit szabály: ai.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Grants_QueueAssessProject",
        "parameters": [
          {
            "name": "grantId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Grants.GrantProjectAssessmentRequest"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Grants.GrantProjectAssessmentRequest"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Grants.GrantProjectAssessmentRequest"
              }
            }
          }
        },
        "responses": {
          "202": {
            "description": "Accepted"
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/grants/{grantId}/assess-project": {
      "post": {
        "tags": [
          "Grants"
        ],
        "summary": "Assess Project",
        "description": "**Cél:** Pályázatok keresése, frissítése, projektillesztése és pályázati döntéstámogatás.\n\n**Végpont:** `POST /api/grants/{grantId}/assess-project`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik. Rate-limit szabály: ai.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Grants_AssessProject",
        "parameters": [
          {
            "name": "grantId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Grants.GrantProjectAssessmentRequest"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Grants.GrantProjectAssessmentRequest"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Grants.GrantProjectAssessmentRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Grants.GrantProjectAssessmentDto"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Grants.GrantProjectAssessmentDto"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Grants.GrantProjectAssessmentDto"
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/grants/{id}": {
      "get": {
        "tags": [
          "Grants"
        ],
        "summary": "Get",
        "description": "**Cél:** Pályázatok keresése, frissítése, projektillesztése és pályázati döntéstámogatás.\n\n**Végpont:** `GET /api/grants/{id}`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Grants_Get",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Grants.GrantOpportunityDto"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Grants.GrantOpportunityDto"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Grants.GrantOpportunityDto"
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/integrations": {
      "get": {
        "tags": [
          "Integrations"
        ],
        "summary": "List",
        "description": "**Cél:** A megadott erőforrás vagy lista lekérdezése.\n\n**Végpont:** `GET /api/integrations`\n\n**Bemenet:** Nincs külön bemeneti paraméter, vagy a bemenet az útvonalból/hitelesített kontextusból származik.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Integrations_List",
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Integrations.IntegrationConnectionDto"
                  }
                }
              },
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Integrations.IntegrationConnectionDto"
                  }
                }
              },
              "text/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Integrations.IntegrationConnectionDto"
                  }
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      },
      "post": {
        "tags": [
          "Integrations"
        ],
        "summary": "Create",
        "description": "**Cél:** Új erőforrás létrehozása vagy szerveroldali feldolgozás indítása.\n\n**Végpont:** `POST /api/integrations`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Integrations_Create",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Integrations.UpsertIntegrationRequest"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Integrations.UpsertIntegrationRequest"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Integrations.UpsertIntegrationRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Integrations.IntegrationConnectionDto"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Integrations.IntegrationConnectionDto"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Integrations.IntegrationConnectionDto"
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/integrations/{id}": {
      "put": {
        "tags": [
          "Integrations"
        ],
        "summary": "Update",
        "description": "**Cél:** Meglévő erőforrás módosítása.\n\n**Végpont:** `PUT /api/integrations/{id}`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Integrations_Update",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Integrations.UpsertIntegrationRequest"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Integrations.UpsertIntegrationRequest"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Integrations.UpsertIntegrationRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Integrations.IntegrationConnectionDto"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Integrations.IntegrationConnectionDto"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Integrations.IntegrationConnectionDto"
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      },
      "delete": {
        "tags": [
          "Integrations"
        ],
        "summary": "Delete",
        "description": "**Cél:** Meglévő erőforrás törlése a jogosultsági szabályok szerint.\n\n**Végpont:** `DELETE /api/integrations/{id}`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Integrations_Delete",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/integrations/{id}/test": {
      "post": {
        "tags": [
          "Integrations"
        ],
        "summary": "Test",
        "description": "**Cél:** Új erőforrás létrehozása vagy szerveroldali feldolgozás indítása.\n\n**Végpont:** `POST /api/integrations/{id}/test`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Integrations_Test",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Integrations.IntegrationTestResult"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Integrations.IntegrationTestResult"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Integrations.IntegrationTestResult"
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/meeting-drafts/analyze": {
      "post": {
        "tags": [
          "MeetingDrafts"
        ],
        "summary": "Analyze",
        "description": "**Cél:** Új erőforrás létrehozása vagy szerveroldali feldolgozás indítása.\n\n**Végpont:** `POST /api/meeting-drafts/analyze`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik. Rate-limit szabály: ai. Maximális request méret: 524 288 000 byte.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "MeetingDrafts_Analyze",
        "requestBody": {
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "title": {
                    "type": "string"
                  },
                  "file": {
                    "type": "string",
                    "format": "binary"
                  },
                  "localRecordingId": {
                    "type": "string"
                  },
                  "liveTranscript": {
                    "type": "string"
                  },
                  "speakerMapJson": {
                    "type": "string"
                  }
                }
              },
              "encoding": {
                "title": {
                  "style": "form"
                },
                "file": {
                  "style": "form"
                },
                "localRecordingId": {
                  "style": "form"
                },
                "liveTranscript": {
                  "style": "form"
                },
                "speakerMapJson": {
                  "style": "form"
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Meetings.MeetingDraftJobAccepted"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Meetings.MeetingDraftJobAccepted"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Meetings.MeetingDraftJobAccepted"
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/meeting-drafts/{id}": {
      "get": {
        "tags": [
          "MeetingDrafts"
        ],
        "summary": "Get",
        "description": "**Cél:** A megadott erőforrás vagy lista lekérdezése.\n\n**Végpont:** `GET /api/meeting-drafts/{id}`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "MeetingDrafts_Get",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Meetings.MeetingDraftAnalysisResult"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Meetings.MeetingDraftAnalysisResult"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Meetings.MeetingDraftAnalysisResult"
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      },
      "delete": {
        "tags": [
          "MeetingDrafts"
        ],
        "summary": "Delete",
        "description": "**Cél:** Meglévő erőforrás törlése a jogosultsági szabályok szerint.\n\n**Végpont:** `DELETE /api/meeting-drafts/{id}`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "MeetingDrafts_Delete",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/meeting-drafts/{id}/publish": {
      "post": {
        "tags": [
          "MeetingDrafts"
        ],
        "summary": "Publish",
        "description": "**Cél:** Új erőforrás létrehozása vagy szerveroldali feldolgozás indítása.\n\n**Végpont:** `POST /api/meeting-drafts/{id}/publish`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "MeetingDrafts_Publish",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Meetings.MeetingAnalysisResult"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Meetings.MeetingAnalysisResult"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Meetings.MeetingAnalysisResult"
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/meetings": {
      "get": {
        "tags": [
          "Meetings"
        ],
        "summary": "List",
        "description": "**Cél:** Hangfelvételek, helyi átirat/diarizáció és jegyzőkönyvi eredmények kezelése.\n\n**Végpont:** `GET /api/meetings`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Meetings_List",
        "parameters": [
          {
            "name": "search",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "from",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "to",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "page",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32",
              "default": 1
            }
          },
          {
            "name": "pageSize",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32",
              "default": 50
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Common.PagedResult`1[[OmegaMunicipal.Contracts.Meetings.MeetingListItem, OmegaMunicipal.Contracts, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null]]"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Common.PagedResult`1[[OmegaMunicipal.Contracts.Meetings.MeetingListItem, OmegaMunicipal.Contracts, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null]]"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Common.PagedResult`1[[OmegaMunicipal.Contracts.Meetings.MeetingListItem, OmegaMunicipal.Contracts, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null]]"
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/meetings/{id}": {
      "get": {
        "tags": [
          "Meetings"
        ],
        "summary": "Get",
        "description": "**Cél:** Hangfelvételek, helyi átirat/diarizáció és jegyzőkönyvi eredmények kezelése.\n\n**Végpont:** `GET /api/meetings/{id}`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Meetings_Get",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Meetings.MeetingAnalysisResult"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Meetings.MeetingAnalysisResult"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Meetings.MeetingAnalysisResult"
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      },
      "put": {
        "tags": [
          "Meetings"
        ],
        "summary": "Update",
        "description": "**Cél:** Hangfelvételek, helyi átirat/diarizáció és jegyzőkönyvi eredmények kezelése.\n\n**Végpont:** `PUT /api/meetings/{id}`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Meetings_Update",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Meetings.UpdateMeetingContentRequest"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Meetings.UpdateMeetingContentRequest"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Meetings.UpdateMeetingContentRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Meetings.MeetingAnalysisResult"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Meetings.MeetingAnalysisResult"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Meetings.MeetingAnalysisResult"
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      },
      "delete": {
        "tags": [
          "Meetings"
        ],
        "summary": "Delete",
        "description": "**Cél:** Hangfelvételek, helyi átirat/diarizáció és jegyzőkönyvi eredmények kezelése.\n\n**Végpont:** `DELETE /api/meetings/{id}`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Meetings_Delete",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/meetings/minutes-template": {
      "get": {
        "tags": [
          "Meetings"
        ],
        "summary": "Get Minutes Template",
        "description": "**Cél:** Hangfelvételek, helyi átirat/diarizáció és jegyzőkönyvi eredmények kezelése.\n\n**Végpont:** `GET /api/meetings/minutes-template`\n\n**Bemenet:** Nincs külön bemeneti paraméter, vagy a bemenet az útvonalból/hitelesített kontextusból származik.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Meetings_GetMinutesTemplate",
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Meetings.MeetingMinutesTemplateDto"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Meetings.MeetingMinutesTemplateDto"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Meetings.MeetingMinutesTemplateDto"
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      },
      "put": {
        "tags": [
          "Meetings"
        ],
        "summary": "Update Minutes Template",
        "description": "**Cél:** Hangfelvételek, helyi átirat/diarizáció és jegyzőkönyvi eredmények kezelése.\n\n**Végpont:** `PUT /api/meetings/minutes-template`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Meetings_UpdateMinutesTemplate",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Meetings.UpdateMeetingMinutesTemplateRequest"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Meetings.UpdateMeetingMinutesTemplateRequest"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Meetings.UpdateMeetingMinutesTemplateRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Meetings.MeetingMinutesTemplateDto"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Meetings.MeetingMinutesTemplateDto"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Meetings.MeetingMinutesTemplateDto"
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/meetings/minutes-template/file": {
      "post": {
        "tags": [
          "Meetings"
        ],
        "summary": "Upload Minutes Template",
        "description": "**Cél:** Hangfelvételek, helyi átirat/diarizáció és jegyzőkönyvi eredmények kezelése.\n\n**Végpont:** `POST /api/meetings/minutes-template/file`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik. Maximális request méret: 10 485 760 byte.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Meetings_UploadMinutesTemplate",
        "requestBody": {
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary"
                  }
                }
              },
              "encoding": {
                "file": {
                  "style": "form"
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Meetings.MeetingMinutesTemplateDto"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Meetings.MeetingMinutesTemplateDto"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Meetings.MeetingMinutesTemplateDto"
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      },
      "delete": {
        "tags": [
          "Meetings"
        ],
        "summary": "Delete Minutes Template",
        "description": "**Cél:** Hangfelvételek, helyi átirat/diarizáció és jegyzőkönyvi eredmények kezelése.\n\n**Végpont:** `DELETE /api/meetings/minutes-template/file`\n\n**Bemenet:** Nincs külön bemeneti paraméter, vagy a bemenet az útvonalból/hitelesített kontextusból származik.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Meetings_DeleteMinutesTemplate",
        "responses": {
          "200": {
            "description": "OK"
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/meetings/preview-normalize": {
      "post": {
        "tags": [
          "Meetings"
        ],
        "summary": "Normalize Preview",
        "description": "**Cél:** Hangfelvételek, helyi átirat/diarizáció és jegyzőkönyvi eredmények kezelése.\n\n**Végpont:** `POST /api/meetings/preview-normalize`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik. Maximális request méret: 524 288 000 byte.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Meetings_NormalizePreview",
        "requestBody": {
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary"
                  }
                }
              },
              "encoding": {
                "file": {
                  "style": "form"
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/meetings/analyze": {
      "post": {
        "tags": [
          "Meetings"
        ],
        "summary": "Analyze",
        "description": "**Cél:** Hangfelvételek, helyi átirat/diarizáció és jegyzőkönyvi eredmények kezelése.\n\n**Végpont:** `POST /api/meetings/analyze`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik. Rate-limit szabály: ai. Maximális request méret: 524 288 000 byte.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Meetings_Analyze",
        "requestBody": {
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "title": {
                    "type": "string"
                  },
                  "file": {
                    "type": "string",
                    "format": "binary"
                  },
                  "liveTranscript": {
                    "type": "string"
                  },
                  "speakerMapJson": {
                    "type": "string"
                  },
                  "transcriptionMode": {
                    "type": "string"
                  }
                }
              },
              "encoding": {
                "title": {
                  "style": "form"
                },
                "file": {
                  "style": "form"
                },
                "liveTranscript": {
                  "style": "form"
                },
                "speakerMapJson": {
                  "style": "form"
                },
                "transcriptionMode": {
                  "style": "form"
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Common.BackgroundJobAccepted"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Common.BackgroundJobAccepted"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Common.BackgroundJobAccepted"
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/meetings/{id}/export": {
      "get": {
        "tags": [
          "Meetings"
        ],
        "summary": "Export",
        "description": "**Cél:** Hangfelvételek, helyi átirat/diarizáció és jegyzőkönyvi eredmények kezelése.\n\n**Végpont:** `GET /api/meetings/{id}/export`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik. Rate-limit szabály: export.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Meetings_Export",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "kind",
            "in": "query",
            "schema": {
              "type": "string",
              "default": "report"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/notifications": {
      "get": {
        "tags": [
          "Notifications"
        ],
        "summary": "List",
        "description": "**Cél:** A megadott erőforrás vagy lista lekérdezése.\n\n**Végpont:** `GET /api/notifications`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Notifications_List",
        "parameters": [
          {
            "name": "take",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32",
              "default": 50
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Common.NotificationSummaryDto"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Common.NotificationSummaryDto"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Common.NotificationSummaryDto"
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/notifications/{id}/read": {
      "put": {
        "tags": [
          "Notifications"
        ],
        "summary": "Read",
        "description": "**Cél:** Meglévő erőforrás módosítása.\n\n**Végpont:** `PUT /api/notifications/{id}/read`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Notifications_Read",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/notifications/read-all": {
      "put": {
        "tags": [
          "Notifications"
        ],
        "summary": "Read All",
        "description": "**Cél:** Meglévő erőforrás módosítása.\n\n**Végpont:** `PUT /api/notifications/read-all`\n\n**Bemenet:** Nincs külön bemeneti paraméter, vagy a bemenet az útvonalból/hitelesített kontextusból származik.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Notifications_ReadAll",
        "responses": {
          "200": {
            "description": "OK"
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/offline/status": {
      "get": {
        "tags": [
          "Offline"
        ],
        "summary": "Status",
        "description": "**Cél:** A megadott erőforrás vagy lista lekérdezése.\n\n**Végpont:** `GET /api/offline/status`\n\n**Bemenet:** Nincs külön bemeneti paraméter, vagy a bemenet az útvonalból/hitelesített kontextusból származik.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Offline_Status",
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Offline.OfflineHealthResult"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Offline.OfflineHealthResult"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Offline.OfflineHealthResult"
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/offline/models": {
      "get": {
        "tags": [
          "Offline"
        ],
        "summary": "Models",
        "description": "**Cél:** A megadott erőforrás vagy lista lekérdezése.\n\n**Végpont:** `GET /api/offline/models`\n\n**Bemenet:** Nincs külön bemeneti paraméter, vagy a bemenet az útvonalból/hitelesített kontextusból származik.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Offline_Models",
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Offline.OfflineModelSettingsResult"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Offline.OfflineModelSettingsResult"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Offline.OfflineModelSettingsResult"
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/offline/models/active": {
      "put": {
        "tags": [
          "Offline"
        ],
        "summary": "Select Model",
        "description": "**Cél:** Meglévő erőforrás módosítása.\n\n**Végpont:** `PUT /api/offline/models/active`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Offline_SelectModel",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Offline.UpdateOfflineModelRequest"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Offline.UpdateOfflineModelRequest"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Offline.UpdateOfflineModelRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Offline.OfflineModelSettingsResult"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Offline.OfflineModelSettingsResult"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Offline.OfflineModelSettingsResult"
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/offline/tts": {
      "post": {
        "tags": [
          "Offline"
        ],
        "summary": "Speak",
        "description": "**Cél:** Új erőforrás létrehozása vagy szerveroldali feldolgozás indítása.\n\n**Végpont:** `POST /api/offline/tts`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Offline_Speak",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Offline.TtsRequest"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Offline.TtsRequest"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Offline.TtsRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/": {
      "get": {
        "tags": [
          "OmegaMunicipal.Api"
        ],
        "summary": "Omega API művelet",
        "description": "**Cél:** A megadott erőforrás vagy lista lekérdezése.\n\n**Végpont:** `GET /`\n\n**Bemenet:** Nincs külön bemeneti paraméter, vagy a bemenet az útvonalból/hitelesített kontextusból származik.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Nyilvános végpont: JWT nem szükséges. A nyilvános végpontokra IP-alapú rate limit és bemenet-validáció vonatkozik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "OmegaMunicipal.Api_Action",
        "responses": {
          "200": {
            "description": "OK"
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        }
      }
    },
    "/api-info": {
      "get": {
        "tags": [
          "OmegaMunicipal.Api"
        ],
        "summary": "Omega API művelet",
        "description": "**Cél:** A megadott erőforrás vagy lista lekérdezése.\n\n**Végpont:** `GET /api-info`\n\n**Bemenet:** Nincs külön bemeneti paraméter, vagy a bemenet az útvonalból/hitelesített kontextusból származik.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Nyilvános végpont: JWT nem szükséges. A nyilvános végpontokra IP-alapú rate limit és bemenet-validáció vonatkozik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "OmegaMunicipal.Api_Action",
        "responses": {
          "200": {
            "description": "OK"
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        }
      }
    },
    "/api/processing-mode": {
      "get": {
        "tags": [
          "ProcessingMode"
        ],
        "summary": "Get",
        "description": "**Cél:** A megadott erőforrás vagy lista lekérdezése.\n\n**Végpont:** `GET /api/processing-mode`\n\n**Bemenet:** Nincs külön bemeneti paraméter, vagy a bemenet az útvonalból/hitelesített kontextusból származik.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "ProcessingMode_Get",
        "responses": {
          "200": {
            "description": "OK"
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      },
      "put": {
        "tags": [
          "ProcessingMode"
        ],
        "summary": "Set",
        "description": "**Cél:** Meglévő erőforrás módosítása.\n\n**Végpont:** `PUT /api/processing-mode`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik. Engedélyezett szerepkörök: SystemAdmin.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "ProcessingMode_Set",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Ai.SetProcessingModeRequest"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Ai.SetProcessingModeRequest"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Ai.SetProcessingModeRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      },
      "post": {
        "tags": [
          "ProcessingMode"
        ],
        "summary": "Set",
        "description": "**Cél:** Új erőforrás létrehozása vagy szerveroldali feldolgozás indítása.\n\n**Végpont:** `POST /api/processing-mode`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik. Engedélyezett szerepkörök: SystemAdmin.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "ProcessingMode_Set",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Ai.SetProcessingModeRequest"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Ai.SetProcessingModeRequest"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Ai.SetProcessingModeRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/processing-mode/reset-default": {
      "post": {
        "tags": [
          "ProcessingMode"
        ],
        "summary": "Reset Default",
        "description": "**Cél:** Új erőforrás létrehozása vagy szerveroldali feldolgozás indítása.\n\n**Végpont:** `POST /api/processing-mode/reset-default`\n\n**Bemenet:** Nincs külön bemeneti paraméter, vagy a bemenet az útvonalból/hitelesített kontextusból származik.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik. Engedélyezett szerepkörök: SystemAdmin.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "ProcessingMode_ResetDefault",
        "responses": {
          "200": {
            "description": "OK"
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/projects": {
      "get": {
        "tags": [
          "Projects"
        ],
        "summary": "List",
        "description": "**Cél:** A megadott erőforrás vagy lista lekérdezése.\n\n**Végpont:** `GET /api/projects`\n\n**Bemenet:** Nincs külön bemeneti paraméter, vagy a bemenet az útvonalból/hitelesített kontextusból származik.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Projects_List",
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Projects.MunicipalProjectDto"
                  }
                }
              },
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Projects.MunicipalProjectDto"
                  }
                }
              },
              "text/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Projects.MunicipalProjectDto"
                  }
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      },
      "post": {
        "tags": [
          "Projects"
        ],
        "summary": "Create",
        "description": "**Cél:** Új erőforrás létrehozása vagy szerveroldali feldolgozás indítása.\n\n**Végpont:** `POST /api/projects`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Projects_Create",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Projects.UpsertProjectRequest"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Projects.UpsertProjectRequest"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Projects.UpsertProjectRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Projects.MunicipalProjectDto"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Projects.MunicipalProjectDto"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Projects.MunicipalProjectDto"
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/projects/{id}": {
      "get": {
        "tags": [
          "Projects"
        ],
        "summary": "Get",
        "description": "**Cél:** A megadott erőforrás vagy lista lekérdezése.\n\n**Végpont:** `GET /api/projects/{id}`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Projects_Get",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Projects.MunicipalProjectDto"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Projects.MunicipalProjectDto"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Projects.MunicipalProjectDto"
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      },
      "put": {
        "tags": [
          "Projects"
        ],
        "summary": "Update",
        "description": "**Cél:** Meglévő erőforrás módosítása.\n\n**Végpont:** `PUT /api/projects/{id}`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Projects_Update",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Projects.UpsertProjectRequest"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Projects.UpsertProjectRequest"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Projects.UpsertProjectRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Projects.MunicipalProjectDto"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Projects.MunicipalProjectDto"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Projects.MunicipalProjectDto"
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      },
      "delete": {
        "tags": [
          "Projects"
        ],
        "summary": "Delete",
        "description": "**Cél:** Meglévő erőforrás törlése a jogosultsági szabályok szerint.\n\n**Végpont:** `DELETE /api/projects/{id}`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Projects_Delete",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/projects/{id}/analyze": {
      "post": {
        "tags": [
          "Projects"
        ],
        "summary": "Analyze",
        "description": "**Cél:** Új erőforrás létrehozása vagy szerveroldali feldolgozás indítása.\n\n**Végpont:** `POST /api/projects/{id}/analyze`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik. Rate-limit szabály: ai.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Projects_Analyze",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Common.BackgroundJobAccepted"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Common.BackgroundJobAccepted"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Common.BackgroundJobAccepted"
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/projects/{projectId}/tasks": {
      "post": {
        "tags": [
          "Projects"
        ],
        "summary": "Add Task",
        "description": "**Cél:** Új erőforrás létrehozása vagy szerveroldali feldolgozás indítása.\n\n**Végpont:** `POST /api/projects/{projectId}/tasks`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Projects_AddTask",
        "parameters": [
          {
            "name": "projectId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Projects.CreateProjectTaskRequest"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Projects.CreateProjectTaskRequest"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Projects.CreateProjectTaskRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Projects.ProjectTaskDto"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Projects.ProjectTaskDto"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Projects.ProjectTaskDto"
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/projects/{projectId}/tasks/{taskId}": {
      "put": {
        "tags": [
          "Projects"
        ],
        "summary": "Update Task",
        "description": "**Cél:** Meglévő erőforrás módosítása.\n\n**Végpont:** `PUT /api/projects/{projectId}/tasks/{taskId}`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Projects_UpdateTask",
        "parameters": [
          {
            "name": "projectId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "taskId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Projects.UpdateProjectTaskRequest"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Projects.UpdateProjectTaskRequest"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Projects.UpdateProjectTaskRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Projects.ProjectTaskDto"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Projects.ProjectTaskDto"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Projects.ProjectTaskDto"
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      },
      "delete": {
        "tags": [
          "Projects"
        ],
        "summary": "Delete Task",
        "description": "**Cél:** Meglévő erőforrás törlése a jogosultsági szabályok szerint.\n\n**Végpont:** `DELETE /api/projects/{projectId}/tasks/{taskId}`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Projects_DeleteTask",
        "parameters": [
          {
            "name": "projectId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "taskId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/public/{municipalitySlug}/municipality": {
      "get": {
        "tags": [
          "PublicPortal"
        ],
        "summary": "Municipality",
        "description": "**Cél:** A nyilvános lakossági portál és tájékoztató szolgáltatások.\n\n**Végpont:** `GET /api/public/{municipalitySlug}/municipality`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Nyilvános végpont: JWT nem szükséges. A nyilvános végpontokra IP-alapú rate limit és bemenet-validáció vonatkozik. Rate-limit szabály: public.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "PublicPortal_Municipality",
        "parameters": [
          {
            "name": "municipalitySlug",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        }
      }
    },
    "/api/public/{municipalitySlug}/reports": {
      "post": {
        "tags": [
          "PublicPortal"
        ],
        "summary": "Submit Report",
        "description": "**Cél:** A nyilvános lakossági portál és tájékoztató szolgáltatások.\n\n**Végpont:** `POST /api/public/{municipalitySlug}/reports`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Nyilvános végpont: JWT nem szükséges. A nyilvános végpontokra IP-alapú rate limit és bemenet-validáció vonatkozik. Rate-limit szabály: public.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "PublicPortal_SubmitReport",
        "parameters": [
          {
            "name": "municipalitySlug",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Citizens.SubmitCitizenReportRequest"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Citizens.SubmitCitizenReportRequest"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Citizens.SubmitCitizenReportRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Citizens.CitizenReportReceipt"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Citizens.CitizenReportReceipt"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Citizens.CitizenReportReceipt"
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        }
      }
    },
    "/api/public/{municipalitySlug}/reports/{reference}/attachments": {
      "post": {
        "tags": [
          "PublicPortal"
        ],
        "summary": "Upload Report Attachment",
        "description": "**Cél:** A nyilvános lakossági portál és tájékoztató szolgáltatások.\n\n**Végpont:** `POST /api/public/{municipalitySlug}/reports/{reference}/attachments`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Nyilvános végpont: JWT nem szükséges. A nyilvános végpontokra IP-alapú rate limit és bemenet-validáció vonatkozik. Rate-limit szabály: public. Maximális request méret: 12 582 912 byte.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "PublicPortal_UploadReportAttachment",
        "parameters": [
          {
            "name": "municipalitySlug",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "reference",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "token",
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary"
                  }
                }
              },
              "encoding": {
                "file": {
                  "style": "form"
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        }
      }
    },
    "/api/public/{municipalitySlug}/reports/{reference}/confirmation": {
      "post": {
        "tags": [
          "PublicPortal"
        ],
        "summary": "Send Report Confirmation",
        "description": "**Cél:** A nyilvános lakossági portál és tájékoztató szolgáltatások.\n\n**Végpont:** `POST /api/public/{municipalitySlug}/reports/{reference}/confirmation`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Nyilvános végpont: JWT nem szükséges. A nyilvános végpontokra IP-alapú rate limit és bemenet-validáció vonatkozik. Rate-limit szabály: public.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "PublicPortal_SendReportConfirmation",
        "parameters": [
          {
            "name": "municipalitySlug",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "reference",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "token",
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Citizens.CitizenReportConfirmationResult"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Citizens.CitizenReportConfirmationResult"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Citizens.CitizenReportConfirmationResult"
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        }
      }
    },
    "/api/public/{municipalitySlug}/reports/{reference}/status": {
      "get": {
        "tags": [
          "PublicPortal"
        ],
        "summary": "Report Status",
        "description": "**Cél:** A nyilvános lakossági portál és tájékoztató szolgáltatások.\n\n**Végpont:** `GET /api/public/{municipalitySlug}/reports/{reference}/status`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Nyilvános végpont: JWT nem szükséges. A nyilvános végpontokra IP-alapú rate limit és bemenet-validáció vonatkozik. Rate-limit szabály: public.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "PublicPortal_ReportStatus",
        "parameters": [
          {
            "name": "municipalitySlug",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "reference",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "token",
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Citizens.PublicCitizenReportStatus"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Citizens.PublicCitizenReportStatus"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Citizens.PublicCitizenReportStatus"
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        }
      }
    },
    "/api/public/{municipalitySlug}/appointments/slots": {
      "get": {
        "tags": [
          "PublicPortal"
        ],
        "summary": "Appointment Slots",
        "description": "**Cél:** A nyilvános lakossági portál és tájékoztató szolgáltatások.\n\n**Végpont:** `GET /api/public/{municipalitySlug}/appointments/slots`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Nyilvános végpont: JWT nem szükséges. A nyilvános végpontokra IP-alapú rate limit és bemenet-validáció vonatkozik. Rate-limit szabály: public.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "PublicPortal_AppointmentSlots",
        "parameters": [
          {
            "name": "municipalitySlug",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "department",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "date",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Citizens.AppointmentSlotDto"
                  }
                }
              },
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Citizens.AppointmentSlotDto"
                  }
                }
              },
              "text/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Citizens.AppointmentSlotDto"
                  }
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        }
      }
    },
    "/api/public/{municipalitySlug}/appointments/departments": {
      "get": {
        "tags": [
          "PublicPortal"
        ],
        "summary": "Appointment Departments",
        "description": "**Cél:** A nyilvános lakossági portál és tájékoztató szolgáltatások.\n\n**Végpont:** `GET /api/public/{municipalitySlug}/appointments/departments`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Nyilvános végpont: JWT nem szükséges. A nyilvános végpontokra IP-alapú rate limit és bemenet-validáció vonatkozik. Rate-limit szabály: public.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "PublicPortal_AppointmentDepartments",
        "parameters": [
          {
            "name": "municipalitySlug",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                }
              },
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                }
              },
              "text/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        }
      }
    },
    "/api/public/{municipalitySlug}/appointments/schedules": {
      "get": {
        "tags": [
          "PublicPortal"
        ],
        "summary": "Appointment Schedules",
        "description": "**Cél:** A nyilvános lakossági portál és tájékoztató szolgáltatások.\n\n**Végpont:** `GET /api/public/{municipalitySlug}/appointments/schedules`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Nyilvános végpont: JWT nem szükséges. A nyilvános végpontokra IP-alapú rate limit és bemenet-validáció vonatkozik. Rate-limit szabály: public.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "PublicPortal_AppointmentSchedules",
        "parameters": [
          {
            "name": "municipalitySlug",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Citizens.AppointmentScheduleDto"
                  }
                }
              },
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Citizens.AppointmentScheduleDto"
                  }
                }
              },
              "text/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Citizens.AppointmentScheduleDto"
                  }
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        }
      }
    },
    "/api/public/{municipalitySlug}/appointments": {
      "post": {
        "tags": [
          "PublicPortal"
        ],
        "summary": "Submit Appointment",
        "description": "**Cél:** A nyilvános lakossági portál és tájékoztató szolgáltatások.\n\n**Végpont:** `POST /api/public/{municipalitySlug}/appointments`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Nyilvános végpont: JWT nem szükséges. A nyilvános végpontokra IP-alapú rate limit és bemenet-validáció vonatkozik. Rate-limit szabály: public.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "PublicPortal_SubmitAppointment",
        "parameters": [
          {
            "name": "municipalitySlug",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Citizens.SubmitAppointmentRequest"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Citizens.SubmitAppointmentRequest"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Citizens.SubmitAppointmentRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Citizens.AppointmentReceipt"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Citizens.AppointmentReceipt"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Citizens.AppointmentReceipt"
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        }
      }
    },
    "/api/public/{municipalitySlug}/appointments/{reference}/status": {
      "get": {
        "tags": [
          "PublicPortal"
        ],
        "summary": "Appointment Status",
        "description": "**Cél:** A nyilvános lakossági portál és tájékoztató szolgáltatások.\n\n**Végpont:** `GET /api/public/{municipalitySlug}/appointments/{reference}/status`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Nyilvános végpont: JWT nem szükséges. A nyilvános végpontokra IP-alapú rate limit és bemenet-validáció vonatkozik. Rate-limit szabály: public.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "PublicPortal_AppointmentStatus",
        "parameters": [
          {
            "name": "municipalitySlug",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "reference",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "token",
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Citizens.PublicAppointmentStatus"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Citizens.PublicAppointmentStatus"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Citizens.PublicAppointmentStatus"
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        }
      }
    },
    "/api/public/{municipalitySlug}/supports": {
      "get": {
        "tags": [
          "PublicPortal"
        ],
        "summary": "Supports",
        "description": "**Cél:** A nyilvános lakossági portál és tájékoztató szolgáltatások.\n\n**Végpont:** `GET /api/public/{municipalitySlug}/supports`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Nyilvános végpont: JWT nem szükséges. A nyilvános végpontokra IP-alapú rate limit és bemenet-validáció vonatkozik. Rate-limit szabály: public.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "PublicPortal_Supports",
        "parameters": [
          {
            "name": "municipalitySlug",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Supports.PublicCitizenSupportProgramDto"
                  }
                }
              },
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Supports.PublicCitizenSupportProgramDto"
                  }
                }
              },
              "text/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Supports.PublicCitizenSupportProgramDto"
                  }
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        }
      }
    },
    "/api/public/{municipalitySlug}/supports/{id}": {
      "get": {
        "tags": [
          "PublicPortal"
        ],
        "summary": "Support",
        "description": "**Cél:** A nyilvános lakossági portál és tájékoztató szolgáltatások.\n\n**Végpont:** `GET /api/public/{municipalitySlug}/supports/{id}`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Nyilvános végpont: JWT nem szükséges. A nyilvános végpontokra IP-alapú rate limit és bemenet-validáció vonatkozik. Rate-limit szabály: public.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "PublicPortal_Support",
        "parameters": [
          {
            "name": "municipalitySlug",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Supports.PublicCitizenSupportProgramDto"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Supports.PublicCitizenSupportProgramDto"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Supports.PublicCitizenSupportProgramDto"
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        }
      }
    },
    "/api/public/{municipalitySlug}/supports/applications": {
      "post": {
        "tags": [
          "PublicPortal"
        ],
        "summary": "Submit Support Application",
        "description": "**Cél:** A nyilvános lakossági portál és tájékoztató szolgáltatások.\n\n**Végpont:** `POST /api/public/{municipalitySlug}/supports/applications`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Nyilvános végpont: JWT nem szükséges. A nyilvános végpontokra IP-alapú rate limit és bemenet-validáció vonatkozik. Rate-limit szabály: public.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "PublicPortal_SubmitSupportApplication",
        "parameters": [
          {
            "name": "municipalitySlug",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Supports.SubmitCitizenSupportApplicationRequest"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Supports.SubmitCitizenSupportApplicationRequest"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Supports.SubmitCitizenSupportApplicationRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Supports.CitizenSupportApplicationReceipt"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Supports.CitizenSupportApplicationReceipt"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Supports.CitizenSupportApplicationReceipt"
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        }
      }
    },
    "/api/public/{municipalitySlug}/supports/applications/{reference}/documents": {
      "post": {
        "tags": [
          "PublicPortal"
        ],
        "summary": "Upload Support Application Document",
        "description": "**Cél:** A nyilvános lakossági portál és tájékoztató szolgáltatások.\n\n**Végpont:** `POST /api/public/{municipalitySlug}/supports/applications/{reference}/documents`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Nyilvános végpont: JWT nem szükséges. A nyilvános végpontokra IP-alapú rate limit és bemenet-validáció vonatkozik. Rate-limit szabály: public. Maximális request méret: 23 068 672 byte.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "PublicPortal_UploadSupportApplicationDocument",
        "parameters": [
          {
            "name": "municipalitySlug",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "reference",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "token",
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary"
                  }
                }
              },
              "encoding": {
                "file": {
                  "style": "form"
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        }
      }
    },
    "/api/public/{municipalitySlug}/supports/applications/{reference}/analyze": {
      "post": {
        "tags": [
          "PublicPortal"
        ],
        "summary": "Analyze Support Application",
        "description": "**Cél:** A nyilvános lakossági portál és tájékoztató szolgáltatások.\n\n**Végpont:** `POST /api/public/{municipalitySlug}/supports/applications/{reference}/analyze`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Nyilvános végpont: JWT nem szükséges. A nyilvános végpontokra IP-alapú rate limit és bemenet-validáció vonatkozik. Rate-limit szabály: public.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "PublicPortal_AnalyzeSupportApplication",
        "parameters": [
          {
            "name": "municipalitySlug",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "reference",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "token",
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Common.BackgroundJobAccepted"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Common.BackgroundJobAccepted"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Common.BackgroundJobAccepted"
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        }
      }
    },
    "/api/public/{municipalitySlug}/supports/applications/{reference}/status": {
      "get": {
        "tags": [
          "PublicPortal"
        ],
        "summary": "Support Application Status",
        "description": "**Cél:** A nyilvános lakossági portál és tájékoztató szolgáltatások.\n\n**Végpont:** `GET /api/public/{municipalitySlug}/supports/applications/{reference}/status`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Nyilvános végpont: JWT nem szükséges. A nyilvános végpontokra IP-alapú rate limit és bemenet-validáció vonatkozik. Rate-limit szabály: public.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "PublicPortal_SupportApplicationStatus",
        "parameters": [
          {
            "name": "municipalitySlug",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "reference",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "token",
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Supports.PublicCitizenSupportApplicationStatus"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Supports.PublicCitizenSupportApplicationStatus"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Supports.PublicCitizenSupportApplicationStatus"
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        }
      }
    },
    "/api/public/{municipalitySlug}/faq": {
      "post": {
        "tags": [
          "PublicPortal"
        ],
        "summary": "Faq",
        "description": "**Cél:** A nyilvános lakossági portál és tájékoztató szolgáltatások.\n\n**Végpont:** `POST /api/public/{municipalitySlug}/faq`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Nyilvános végpont: JWT nem szükséges. A nyilvános végpontokra IP-alapú rate limit és bemenet-validáció vonatkozik. Rate-limit szabály: public.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "PublicPortal_Faq",
        "parameters": [
          {
            "name": "municipalitySlug",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Citizens.PublicFaqRequest"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Citizens.PublicFaqRequest"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Citizens.PublicFaqRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Common.BackgroundJobAccepted"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Common.BackgroundJobAccepted"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Common.BackgroundJobAccepted"
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        }
      }
    },
    "/api/public/{municipalitySlug}/background-jobs/{id}": {
      "get": {
        "tags": [
          "PublicPortal"
        ],
        "summary": "Public Job",
        "description": "**Cél:** A nyilvános lakossági portál és tájékoztató szolgáltatások.\n\n**Végpont:** `GET /api/public/{municipalitySlug}/background-jobs/{id}`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Nyilvános végpont: JWT nem szükséges. A nyilvános végpontokra IP-alapú rate limit és bemenet-validáció vonatkozik. Rate-limit szabály: public.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "PublicPortal_PublicJob",
        "parameters": [
          {
            "name": "municipalitySlug",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "token",
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Common.BackgroundJobStatusDto"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Common.BackgroundJobStatusDto"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Common.BackgroundJobStatusDto"
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        }
      }
    },
    "/api/tts/synthesize": {
      "post": {
        "tags": [
          "Speech"
        ],
        "summary": "Synthesize",
        "description": "**Cél:** Új erőforrás létrehozása vagy szerveroldali feldolgozás indítása.\n\n**Végpont:** `POST /api/tts/synthesize`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik. Maximális request méret: 131 072 byte.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Speech_Synthesize",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Api.Controllers.SpeechController.SpeechRequest"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Api.Controllers.SpeechController.SpeechRequest"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Api.Controllers.SpeechController.SpeechRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/system/background-worker": {
      "get": {
        "tags": [
          "SystemBackgroundWorker"
        ],
        "summary": "Get",
        "description": "**Cél:** A megadott erőforrás vagy lista lekérdezése.\n\n**Végpont:** `GET /api/system/background-worker`\n\n**Bemenet:** Nincs külön bemeneti paraméter, vagy a bemenet az útvonalból/hitelesített kontextusból származik.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik. Engedélyezett szerepkörök: SystemAdmin.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "SystemBackgroundWorker_Get",
        "responses": {
          "200": {
            "description": "OK"
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/users/my-permissions": {
      "get": {
        "tags": [
          "Users"
        ],
        "summary": "My Permissions",
        "description": "**Cél:** Felhasználók, szerepkörök és hozzáférések adminisztrációja.\n\n**Végpont:** `GET /api/users/my-permissions`\n\n**Bemenet:** Nincs külön bemeneti paraméter, vagy a bemenet az útvonalból/hitelesített kontextusból származik.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Users_MyPermissions",
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Users.RoleModulePermissionDto"
                  }
                }
              },
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Users.RoleModulePermissionDto"
                  }
                }
              },
              "text/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Users.RoleModulePermissionDto"
                  }
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/users": {
      "get": {
        "tags": [
          "Users"
        ],
        "summary": "List",
        "description": "**Cél:** Felhasználók, szerepkörök és hozzáférések adminisztrációja.\n\n**Végpont:** `GET /api/users`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Users_List",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32",
              "default": 1
            }
          },
          {
            "name": "pageSize",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32",
              "default": 50
            }
          },
          {
            "name": "search",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "role",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "active",
            "in": "query",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "department",
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Common.PagedResult`1[[OmegaMunicipal.Contracts.Auth.UserListItem, OmegaMunicipal.Contracts, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null]]"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Common.PagedResult`1[[OmegaMunicipal.Contracts.Auth.UserListItem, OmegaMunicipal.Contracts, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null]]"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Common.PagedResult`1[[OmegaMunicipal.Contracts.Auth.UserListItem, OmegaMunicipal.Contracts, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null]]"
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      },
      "post": {
        "tags": [
          "Users"
        ],
        "summary": "Create",
        "description": "**Cél:** Felhasználók, szerepkörök és hozzáférések adminisztrációja.\n\n**Végpont:** `POST /api/users`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Users_Create",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Auth.CreateUserRequest"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Auth.CreateUserRequest"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Auth.CreateUserRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Auth.UserListItem"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Auth.UserListItem"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Auth.UserListItem"
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/users/departments": {
      "get": {
        "tags": [
          "Users"
        ],
        "summary": "Departments",
        "description": "**Cél:** Felhasználók, szerepkörök és hozzáférések adminisztrációja.\n\n**Végpont:** `GET /api/users/departments`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Users_Departments",
        "parameters": [
          {
            "name": "includeInactive",
            "in": "query",
            "schema": {
              "type": "boolean",
              "default": true
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Common.DepartmentDto"
                  }
                }
              },
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Common.DepartmentDto"
                  }
                }
              },
              "text/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Common.DepartmentDto"
                  }
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      },
      "post": {
        "tags": [
          "Users"
        ],
        "summary": "Create Department",
        "description": "**Cél:** Felhasználók, szerepkörök és hozzáférések adminisztrációja.\n\n**Végpont:** `POST /api/users/departments`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Users_CreateDepartment",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Common.UpsertDepartmentRequest"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Common.UpsertDepartmentRequest"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Common.UpsertDepartmentRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Common.DepartmentDto"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Common.DepartmentDto"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Common.DepartmentDto"
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/users/departments/{id}": {
      "put": {
        "tags": [
          "Users"
        ],
        "summary": "Update Department",
        "description": "**Cél:** Felhasználók, szerepkörök és hozzáférések adminisztrációja.\n\n**Végpont:** `PUT /api/users/departments/{id}`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Users_UpdateDepartment",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Common.UpsertDepartmentRequest"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Common.UpsertDepartmentRequest"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Common.UpsertDepartmentRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Common.DepartmentDto"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Common.DepartmentDto"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Common.DepartmentDto"
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      },
      "delete": {
        "tags": [
          "Users"
        ],
        "summary": "Delete Department",
        "description": "**Cél:** Felhasználók, szerepkörök és hozzáférések adminisztrációja.\n\n**Végpont:** `DELETE /api/users/departments/{id}`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Users_DeleteDepartment",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/users/roles": {
      "get": {
        "tags": [
          "Users"
        ],
        "summary": "Roles",
        "description": "**Cél:** Felhasználók, szerepkörök és hozzáférések adminisztrációja.\n\n**Végpont:** `GET /api/users/roles`\n\n**Bemenet:** Nincs külön bemeneti paraméter, vagy a bemenet az útvonalból/hitelesített kontextusból származik.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Users_Roles",
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Users.RoleInfoDto"
                  }
                }
              },
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Users.RoleInfoDto"
                  }
                }
              },
              "text/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Users.RoleInfoDto"
                  }
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      },
      "post": {
        "tags": [
          "Users"
        ],
        "summary": "Create Role",
        "description": "**Cél:** Felhasználók, szerepkörök és hozzáférések adminisztrációja.\n\n**Végpont:** `POST /api/users/roles`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Users_CreateRole",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Users.UpsertRoleRequest"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Users.UpsertRoleRequest"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Users.UpsertRoleRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Users.RoleInfoDto"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Users.RoleInfoDto"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Users.RoleInfoDto"
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/users/roles/{key}": {
      "put": {
        "tags": [
          "Users"
        ],
        "summary": "Update Role",
        "description": "**Cél:** Felhasználók, szerepkörök és hozzáférések adminisztrációja.\n\n**Végpont:** `PUT /api/users/roles/{key}`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Users_UpdateRole",
        "parameters": [
          {
            "name": "key",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Users.UpsertRoleRequest"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Users.UpsertRoleRequest"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Users.UpsertRoleRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Users.RoleInfoDto"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Users.RoleInfoDto"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Users.RoleInfoDto"
                }
              }
            }
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      },
      "delete": {
        "tags": [
          "Users"
        ],
        "summary": "Delete Role",
        "description": "**Cél:** Felhasználók, szerepkörök és hozzáférések adminisztrációja.\n\n**Végpont:** `DELETE /api/users/roles/{key}`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Users_DeleteRole",
        "parameters": [
          {
            "name": "key",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    },
    "/api/users/{id}/active": {
      "put": {
        "tags": [
          "Users"
        ],
        "summary": "Set Active",
        "description": "**Cél:** Felhasználók, szerepkörök és hozzáférések adminisztrációja.\n\n**Végpont:** `PUT /api/users/{id}/active`\n\n**Bemenet:** A Swagger **Parameters** / **Request body** része a konkrét DTO mezőket, típusokat és kötelező értékeket automatikusan megjeleníti.\n\n**Kimenet:** a Swagger **Responses** és **Schemas** része a válasz DTO-kat és HTTP státuszkódokat mutatja.\n\n**Biztonság:** Védett végpont: Authorization: Bearer <JWT> szükséges. A JWT aláírása, issuer/audience és lejárata ellenőrzött; a tenant-azonosító a hitelesített claimből származik.\n\n**Általános protokoll:** éles környezetben HTTPS/TLS 1.2+; JSON UTF-8; hibák RFC 7807 `application/problem+json`; szerveroldali audit- és SQL hibanapló Trace ID-val; önkormányzati tenant-izoláció; szerepkör- és jogosultság-ellenőrzés.",
        "operationId": "Users_SetActive",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "boolean"
              }
            },
            "text/json": {
              "schema": {
                "type": "boolean"
              }
            },
            "application/*+json": {
              "schema": {
                "type": "boolean"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          },
          "400": {
            "description": "Érvénytelen bemenet / üzleti validációs hiba (ProblemDetails)."
          },
          "401": {
            "description": "Hiányzó, lejárt vagy hibás JWT token."
          },
          "403": {
            "description": "A hitelesített felhasználó nem jogosult a műveletre."
          },
          "429": {
            "description": "Rate limit elérve; a Retry-After fejléc alapján próbálható újra."
          },
          "500": {
            "description": "Nem várt szerverhiba; Trace ID alapján visszakereshető a Hibanaplóban."
          }
        },
        "security": [
          {
            "Bearer": [ ]
          }
        ]
      }
    }
  },
  "components": {
    "schemas": {
      "Microsoft.AspNetCore.Mvc.ProblemDetails": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "nullable": true
          },
          "title": {
            "type": "string",
            "nullable": true
          },
          "status": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          },
          "detail": {
            "type": "string",
            "nullable": true
          },
          "instance": {
            "type": "string",
            "nullable": true
          }
        },
        "additionalProperties": { }
      },
      "OmegaMunicipal.Api.Controllers.SpeechController.SpeechRequest": {
        "type": "object",
        "properties": {
          "text": {
            "type": "string",
            "nullable": true
          },
          "mode": {
            "type": "string",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Accounting.AccountingBatchItemResult": {
        "type": "object",
        "properties": {
          "fileName": {
            "type": "string",
            "nullable": true
          },
          "success": {
            "type": "boolean"
          },
          "id": {
            "type": "string",
            "format": "uuid",
            "nullable": true
          },
          "error": {
            "type": "string",
            "nullable": true
          },
          "document": {
            "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Accounting.AccountingUploadResponse"
          },
          "jobId": {
            "type": "string",
            "format": "uuid",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Accounting.AccountingCodeDto": {
        "type": "object",
        "properties": {
          "code": {
            "type": "string",
            "nullable": true
          },
          "name": {
            "type": "string",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Accounting.AccountingCorrectionRequest": {
        "type": "object",
        "properties": {
          "supplierName": {
            "type": "string",
            "nullable": true
          },
          "supplierTaxNumber": {
            "type": "string",
            "nullable": true
          },
          "invoiceNumber": {
            "type": "string",
            "nullable": true
          },
          "performanceDate": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "netAmount": {
            "type": "number",
            "format": "double",
            "nullable": true
          },
          "vatAmount": {
            "type": "number",
            "format": "double",
            "nullable": true
          },
          "grossAmount": {
            "type": "number",
            "format": "double",
            "nullable": true
          },
          "governmentFunctionCode": {
            "type": "string",
            "nullable": true
          },
          "budgetRowCode": {
            "type": "string",
            "nullable": true
          },
          "costCenterCode": {
            "type": "string",
            "nullable": true
          },
          "projectCode": {
            "type": "string",
            "nullable": true
          },
          "financingSource": {
            "type": "string",
            "nullable": true
          },
          "correctionComment": {
            "type": "string",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Accounting.AccountingDocumentDetails": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "fileName": {
            "type": "string",
            "nullable": true
          },
          "status": {
            "type": "string",
            "nullable": true
          },
          "supplierName": {
            "type": "string",
            "nullable": true
          },
          "supplierTaxNumber": {
            "type": "string",
            "nullable": true
          },
          "invoiceNumber": {
            "type": "string",
            "nullable": true
          },
          "performanceDate": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "netAmount": {
            "type": "number",
            "format": "double",
            "nullable": true
          },
          "vatAmount": {
            "type": "number",
            "format": "double",
            "nullable": true
          },
          "grossAmount": {
            "type": "number",
            "format": "double",
            "nullable": true
          },
          "lines": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Accounting.InvoiceLineDto"
            },
            "nullable": true
          },
          "suggestion": {
            "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Accounting.AccountingSuggestionDto"
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Accounting.AccountingKeywordRuleDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "keyword": {
            "type": "string",
            "nullable": true
          },
          "governmentFunctionCode": {
            "type": "string",
            "nullable": true
          },
          "budgetRowCode": {
            "type": "string",
            "nullable": true
          },
          "costCenterCode": {
            "type": "string",
            "nullable": true
          },
          "projectCode": {
            "type": "string",
            "nullable": true
          },
          "requiresBudgetCheck": {
            "type": "boolean"
          },
          "weight": {
            "type": "number",
            "format": "double"
          },
          "rationale": {
            "type": "string",
            "nullable": true
          },
          "isActive": {
            "type": "boolean"
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Accounting.AccountingListItem": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "fileName": {
            "type": "string",
            "nullable": true
          },
          "status": {
            "type": "string",
            "nullable": true
          },
          "supplierName": {
            "type": "string",
            "nullable": true
          },
          "invoiceNumber": {
            "type": "string",
            "nullable": true
          },
          "performanceDate": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "grossAmount": {
            "type": "number",
            "format": "double",
            "nullable": true
          },
          "costCenterCode": {
            "type": "string",
            "nullable": true
          },
          "createdAt": {
            "type": "string",
            "format": "date-time"
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Accounting.AccountingMasterDataItemDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "type": {
            "type": "string",
            "nullable": true
          },
          "code": {
            "type": "string",
            "nullable": true
          },
          "name": {
            "type": "string",
            "nullable": true
          },
          "aspIdentifier": {
            "type": "string",
            "nullable": true
          },
          "source": {
            "type": "string",
            "nullable": true
          },
          "isActive": {
            "type": "boolean"
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Accounting.AccountingSearchResponse": {
        "type": "object",
        "properties": {
          "items": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Accounting.AccountingListItem"
            },
            "nullable": true
          },
          "totalCount": {
            "type": "integer",
            "format": "int32"
          },
          "page": {
            "type": "integer",
            "format": "int32"
          },
          "pageSize": {
            "type": "integer",
            "format": "int32"
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Accounting.AccountingSuggestionDto": {
        "type": "object",
        "properties": {
          "governmentFunctionCode": {
            "type": "string",
            "nullable": true
          },
          "budgetRowCode": {
            "type": "string",
            "nullable": true
          },
          "costCenterCode": {
            "type": "string",
            "nullable": true
          },
          "projectCode": {
            "type": "string",
            "nullable": true
          },
          "financingSource": {
            "type": "string",
            "nullable": true
          },
          "confidence": {
            "type": "number",
            "format": "double"
          },
          "decisionMode": {
            "type": "string",
            "nullable": true
          },
          "rationale": {
            "type": "string",
            "nullable": true
          },
          "requiresManualApproval": {
            "type": "boolean"
          },
          "requiresBudgetCheck": {
            "type": "boolean"
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Accounting.AccountingUploadResponse": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "status": {
            "type": "string",
            "nullable": true
          },
          "supplierName": {
            "type": "string",
            "nullable": true
          },
          "supplierTaxNumber": {
            "type": "string",
            "nullable": true
          },
          "invoiceNumber": {
            "type": "string",
            "nullable": true
          },
          "grossAmount": {
            "type": "number",
            "format": "double",
            "nullable": true
          },
          "suggestion": {
            "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Accounting.AccountingSuggestionDto"
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Accounting.ApprovalRequest": {
        "type": "object",
        "properties": {
          "comment": {
            "type": "string",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Accounting.InvoiceLineDto": {
        "type": "object",
        "properties": {
          "lineNumber": {
            "type": "integer",
            "format": "int32"
          },
          "description": {
            "type": "string",
            "nullable": true
          },
          "quantity": {
            "type": "number",
            "format": "double",
            "nullable": true
          },
          "netAmount": {
            "type": "number",
            "format": "double",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Accounting.UpsertAccountingKeywordRuleRequest": {
        "required": [
          "keyword"
        ],
        "type": "object",
        "properties": {
          "keyword": {
            "maxLength": 200,
            "minLength": 1,
            "type": "string"
          },
          "governmentFunctionCode": {
            "type": "string",
            "nullable": true
          },
          "budgetRowCode": {
            "type": "string",
            "nullable": true
          },
          "costCenterCode": {
            "type": "string",
            "nullable": true
          },
          "projectCode": {
            "type": "string",
            "nullable": true
          },
          "requiresBudgetCheck": {
            "type": "boolean"
          },
          "weight": {
            "maximum": 1,
            "minimum": 0,
            "type": "number",
            "format": "double"
          },
          "rationale": {
            "maxLength": 1200,
            "type": "string",
            "nullable": true
          },
          "isActive": {
            "type": "boolean"
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Accounting.UpsertAccountingMasterDataRequest": {
        "required": [
          "code",
          "name"
        ],
        "type": "object",
        "properties": {
          "code": {
            "maxLength": 80,
            "minLength": 1,
            "type": "string"
          },
          "name": {
            "maxLength": 300,
            "minLength": 1,
            "type": "string"
          },
          "aspIdentifier": {
            "maxLength": 120,
            "type": "string",
            "nullable": true
          },
          "source": {
            "maxLength": 300,
            "type": "string",
            "nullable": true
          },
          "isActive": {
            "type": "boolean"
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Ai.AiOperationUsage": {
        "type": "object",
        "properties": {
          "operation": {
            "type": "string",
            "nullable": true
          },
          "calls": {
            "type": "integer",
            "format": "int32"
          },
          "inputTokens": {
            "type": "integer",
            "format": "int64"
          },
          "outputTokens": {
            "type": "integer",
            "format": "int64"
          },
          "failures": {
            "type": "integer",
            "format": "int32"
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Ai.AiSystemStatus": {
        "type": "object",
        "properties": {
          "enabled": {
            "type": "boolean"
          },
          "configured": {
            "type": "boolean"
          },
          "reachable": {
            "type": "boolean"
          },
          "textModel": {
            "type": "string",
            "nullable": true
          },
          "embeddingModel": {
            "type": "string",
            "nullable": true
          },
          "transcriptionModel": {
            "type": "string",
            "nullable": true
          },
          "moderationModel": {
            "type": "string",
            "nullable": true
          },
          "message": {
            "type": "string",
            "nullable": true
          },
          "checkedAt": {
            "type": "string",
            "format": "date-time"
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Ai.AiTestRequest": {
        "required": [
          "prompt"
        ],
        "type": "object",
        "properties": {
          "prompt": {
            "maxLength": 500,
            "minLength": 3,
            "type": "string"
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Ai.AiTestResponse": {
        "type": "object",
        "properties": {
          "answer": {
            "type": "string",
            "nullable": true
          },
          "model": {
            "type": "string",
            "nullable": true
          },
          "inputTokens": {
            "type": "integer",
            "format": "int32"
          },
          "outputTokens": {
            "type": "integer",
            "format": "int32"
          },
          "durationMilliseconds": {
            "type": "integer",
            "format": "int64"
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Ai.AiUsageSummary": {
        "type": "object",
        "properties": {
          "callsToday": {
            "type": "integer",
            "format": "int32"
          },
          "callsThisMonth": {
            "type": "integer",
            "format": "int32"
          },
          "inputTokensThisMonth": {
            "type": "integer",
            "format": "int64"
          },
          "outputTokensThisMonth": {
            "type": "integer",
            "format": "int64"
          },
          "failedCallsThisMonth": {
            "type": "integer",
            "format": "int32"
          },
          "operations": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Ai.AiOperationUsage"
            },
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Ai.SetProcessingModeRequest": {
        "type": "object",
        "properties": {
          "mode": {
            "type": "string",
            "nullable": true
          },
          "transcriptionMode": {
            "type": "string",
            "nullable": true
          },
          "speechSynthesisMode": {
            "type": "string",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Assistant.AskAssistantRequest": {
        "required": [
          "question"
        ],
        "type": "object",
        "properties": {
          "conversationId": {
            "type": "string",
            "format": "uuid",
            "nullable": true
          },
          "question": {
            "maxLength": 4000,
            "minLength": 3,
            "type": "string"
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Assistant.AssistantAnswer": {
        "type": "object",
        "properties": {
          "conversationId": {
            "type": "string",
            "format": "uuid"
          },
          "messageId": {
            "type": "string",
            "format": "uuid"
          },
          "answer": {
            "type": "string",
            "nullable": true
          },
          "sources": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Assistant.AssistantSource"
            },
            "nullable": true
          },
          "usedExternalAi": {
            "type": "boolean"
          },
          "createdAt": {
            "type": "string",
            "format": "date-time"
          },
          "internalKnowledgeSearchPerformed": {
            "type": "boolean"
          },
          "internalKnowledgeResultCount": {
            "type": "integer",
            "format": "int32"
          },
          "generatedArtifactFormat": {
            "type": "string",
            "nullable": true
          },
          "generatedArtifactFileName": {
            "type": "string",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Assistant.AssistantArtifactRequest": {
        "required": [
          "content",
          "format"
        ],
        "type": "object",
        "properties": {
          "content": {
            "maxLength": 200000,
            "minLength": 1,
            "type": "string"
          },
          "format": {
            "maxLength": 20,
            "minLength": 1,
            "type": "string"
          },
          "fileName": {
            "maxLength": 120,
            "type": "string",
            "nullable": true
          },
          "templateBase64": {
            "type": "string",
            "description": "Opcionális DOCX sablon Base64 formában. Belső szerveroldali használatra.",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Assistant.AssistantJobAccepted": {
        "type": "object",
        "properties": {
          "jobId": {
            "type": "string",
            "format": "uuid"
          },
          "status": {
            "type": "string",
            "nullable": true
          },
          "createdAt": {
            "type": "string",
            "format": "date-time"
          }
        },
        "additionalProperties": false,
        "description": "Háttérben futó AI asszisztens feladat átvételi válasza."
      },
      "OmegaMunicipal.Contracts.Assistant.AssistantJobStatusDto": {
        "type": "object",
        "properties": {
          "jobId": {
            "type": "string",
            "format": "uuid"
          },
          "status": {
            "type": "string",
            "nullable": true
          },
          "conversationId": {
            "type": "string",
            "format": "uuid",
            "nullable": true
          },
          "answer": {
            "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Assistant.AssistantAnswer"
          },
          "error": {
            "type": "string",
            "nullable": true
          },
          "createdAt": {
            "type": "string",
            "format": "date-time"
          },
          "startedAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "completedAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "Háttérben futó AI asszisztens feladat állapota és – elkészülés után – eredménye."
      },
      "OmegaMunicipal.Contracts.Assistant.AssistantSource": {
        "type": "object",
        "properties": {
          "documentId": {
            "type": "string",
            "format": "uuid"
          },
          "title": {
            "type": "string",
            "nullable": true
          },
          "fileName": {
            "type": "string",
            "nullable": true
          },
          "snippet": {
            "type": "string",
            "nullable": true
          },
          "relevance": {
            "type": "number",
            "format": "double"
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Assistant.ConversationDetails": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "title": {
            "type": "string",
            "nullable": true
          },
          "messages": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Assistant.ConversationMessage"
            },
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Assistant.ConversationListItem": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "title": {
            "type": "string",
            "nullable": true
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time"
          },
          "messageCount": {
            "type": "integer",
            "format": "int32"
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Assistant.ConversationMessage": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "role": {
            "type": "string",
            "nullable": true
          },
          "content": {
            "type": "string",
            "nullable": true
          },
          "createdAt": {
            "type": "string",
            "format": "date-time"
          },
          "sources": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Assistant.AssistantSource"
            },
            "nullable": true
          },
          "internalKnowledgeSearchPerformed": {
            "type": "boolean"
          },
          "internalKnowledgeResultCount": {
            "type": "integer",
            "format": "int32"
          },
          "generatedArtifactFormat": {
            "type": "string",
            "nullable": true
          },
          "generatedArtifactFileName": {
            "type": "string",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Audit.AuditLogDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "timestamp": {
            "type": "string",
            "format": "date-time"
          },
          "userName": {
            "type": "string",
            "nullable": true
          },
          "action": {
            "type": "string",
            "nullable": true
          },
          "entityType": {
            "type": "string",
            "nullable": true
          },
          "entityId": {
            "type": "string",
            "nullable": true
          },
          "details": {
            "type": "string",
            "nullable": true
          },
          "ipAddress": {
            "type": "string",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Audit.ErrorLogDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "createdAt": {
            "type": "string",
            "format": "date-time"
          },
          "municipalityId": {
            "type": "string",
            "format": "uuid",
            "nullable": true
          },
          "userId": {
            "type": "string",
            "format": "uuid",
            "nullable": true
          },
          "userName": {
            "type": "string",
            "nullable": true
          },
          "level": {
            "type": "string",
            "nullable": true
          },
          "category": {
            "type": "string",
            "nullable": true
          },
          "eventId": {
            "type": "integer",
            "format": "int32"
          },
          "eventName": {
            "type": "string",
            "nullable": true
          },
          "message": {
            "type": "string",
            "nullable": true
          },
          "exceptionType": {
            "type": "string",
            "nullable": true
          },
          "exceptionMessage": {
            "type": "string",
            "nullable": true
          },
          "stackTrace": {
            "type": "string",
            "nullable": true
          },
          "innerException": {
            "type": "string",
            "nullable": true
          },
          "source": {
            "type": "string",
            "nullable": true
          },
          "requestMethod": {
            "type": "string",
            "nullable": true
          },
          "requestPath": {
            "type": "string",
            "nullable": true
          },
          "traceId": {
            "type": "string",
            "nullable": true
          },
          "ipAddress": {
            "type": "string",
            "nullable": true
          },
          "userAgent": {
            "type": "string",
            "nullable": true
          },
          "machineName": {
            "type": "string",
            "nullable": true
          },
          "environmentName": {
            "type": "string",
            "nullable": true
          },
          "additionalData": {
            "type": "string",
            "nullable": true
          },
          "isResolved": {
            "type": "boolean"
          },
          "resolvedAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "resolutionNote": {
            "type": "string",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Auth.AuthResponse": {
        "type": "object",
        "properties": {
          "accessToken": {
            "type": "string",
            "nullable": true
          },
          "refreshToken": {
            "type": "string",
            "nullable": true
          },
          "accessTokenExpiresAt": {
            "type": "string",
            "format": "date-time"
          },
          "user": {
            "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Auth.UserProfile"
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Auth.CreateUserRequest": {
        "required": [
          "displayName",
          "email",
          "password",
          "role"
        ],
        "type": "object",
        "properties": {
          "email": {
            "minLength": 1,
            "type": "string",
            "format": "email"
          },
          "password": {
            "minLength": 10,
            "type": "string"
          },
          "displayName": {
            "maxLength": 160,
            "minLength": 1,
            "type": "string"
          },
          "department": {
            "maxLength": 160,
            "type": "string",
            "nullable": true
          },
          "role": {
            "minLength": 1,
            "type": "string"
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Auth.LoginRequest": {
        "required": [
          "email",
          "password"
        ],
        "type": "object",
        "properties": {
          "email": {
            "minLength": 1,
            "type": "string",
            "format": "email"
          },
          "password": {
            "minLength": 8,
            "type": "string"
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Auth.LogoutRequest": {
        "type": "object",
        "properties": {
          "refreshToken": {
            "type": "string",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Auth.RefreshTokenRequest": {
        "type": "object",
        "properties": {
          "refreshToken": {
            "type": "string",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Auth.UserListItem": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "email": {
            "type": "string",
            "nullable": true
          },
          "displayName": {
            "type": "string",
            "nullable": true
          },
          "department": {
            "type": "string",
            "nullable": true
          },
          "isActive": {
            "type": "boolean"
          },
          "roles": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "nullable": true
          },
          "createdAt": {
            "type": "string",
            "format": "date-time"
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Auth.UserProfile": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "email": {
            "type": "string",
            "nullable": true
          },
          "displayName": {
            "type": "string",
            "nullable": true
          },
          "department": {
            "type": "string",
            "nullable": true
          },
          "municipalityId": {
            "type": "string",
            "format": "uuid"
          },
          "municipalityName": {
            "type": "string",
            "nullable": true
          },
          "roles": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Citizens.AppointmentBookingDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "referenceNumber": {
            "type": "string",
            "nullable": true
          },
          "citizenName": {
            "type": "string",
            "nullable": true
          },
          "citizenEmail": {
            "type": "string",
            "nullable": true
          },
          "citizenPhone": {
            "type": "string",
            "nullable": true
          },
          "department": {
            "type": "string",
            "nullable": true
          },
          "subject": {
            "type": "string",
            "nullable": true
          },
          "requestedStart": {
            "type": "string",
            "format": "date-time"
          },
          "durationMinutes": {
            "type": "integer",
            "format": "int32"
          },
          "status": {
            "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Enums.AppointmentStatus"
          },
          "internalComment": {
            "type": "string",
            "nullable": true
          },
          "publicComment": {
            "type": "string",
            "nullable": true
          },
          "createdAt": {
            "type": "string",
            "format": "date-time"
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time"
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Citizens.AppointmentReceipt": {
        "type": "object",
        "properties": {
          "referenceNumber": {
            "type": "string",
            "nullable": true
          },
          "trackingToken": {
            "type": "string",
            "nullable": true
          },
          "requestedStart": {
            "type": "string",
            "format": "date-time"
          },
          "submittedAt": {
            "type": "string",
            "format": "date-time"
          },
          "emailSent": {
            "type": "boolean"
          },
          "emailMessage": {
            "type": "string",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Citizens.AppointmentScheduleDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "department": {
            "type": "string",
            "nullable": true
          },
          "dayOfWeek": {
            "$ref": "#/components/schemas/System.DayOfWeek"
          },
          "startTime": {
            "type": "string",
            "format": "time"
          },
          "endTime": {
            "type": "string",
            "format": "time"
          },
          "slotMinutes": {
            "type": "integer",
            "format": "int32"
          },
          "capacity": {
            "type": "integer",
            "format": "int32"
          },
          "isActive": {
            "type": "boolean"
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Citizens.AppointmentSlotDto": {
        "type": "object",
        "properties": {
          "start": {
            "type": "string",
            "format": "date-time"
          },
          "end": {
            "type": "string",
            "format": "date-time"
          },
          "capacity": {
            "type": "integer",
            "format": "int32"
          },
          "reservedCount": {
            "type": "integer",
            "format": "int32"
          },
          "available": {
            "type": "boolean"
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Citizens.AppointmentSummaryDto": {
        "type": "object",
        "properties": {
          "total": {
            "type": "integer",
            "format": "int32"
          },
          "requestedCount": {
            "type": "integer",
            "format": "int32"
          },
          "confirmedCount": {
            "type": "integer",
            "format": "int32"
          },
          "rescheduledCount": {
            "type": "integer",
            "format": "int32"
          },
          "completedCount": {
            "type": "integer",
            "format": "int32"
          },
          "cancelledCount": {
            "type": "integer",
            "format": "int32"
          },
          "rejectedCount": {
            "type": "integer",
            "format": "int32"
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Citizens.CitizenAssigneeDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "displayName": {
            "type": "string",
            "nullable": true
          },
          "department": {
            "type": "string",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Citizens.CitizenReportAttachmentDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "fileName": {
            "type": "string",
            "nullable": true
          },
          "contentType": {
            "type": "string",
            "nullable": true
          },
          "fileSize": {
            "type": "integer",
            "format": "int64"
          },
          "createdAt": {
            "type": "string",
            "format": "date-time"
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Citizens.CitizenReportConfirmationResult": {
        "type": "object",
        "properties": {
          "emailSent": {
            "type": "boolean"
          },
          "message": {
            "type": "string",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Citizens.CitizenReportDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "referenceNumber": {
            "type": "string",
            "nullable": true
          },
          "reporterName": {
            "type": "string",
            "nullable": true
          },
          "reporterEmail": {
            "type": "string",
            "nullable": true
          },
          "category": {
            "type": "string",
            "nullable": true
          },
          "title": {
            "type": "string",
            "nullable": true
          },
          "description": {
            "type": "string",
            "nullable": true
          },
          "location": {
            "type": "string",
            "nullable": true
          },
          "latitude": {
            "type": "number",
            "format": "double",
            "nullable": true
          },
          "longitude": {
            "type": "number",
            "format": "double",
            "nullable": true
          },
          "status": {
            "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Enums.CitizenReportStatus"
          },
          "assignedDepartment": {
            "type": "string",
            "nullable": true
          },
          "assignedUserId": {
            "type": "string",
            "format": "uuid",
            "nullable": true
          },
          "assignedUserName": {
            "type": "string",
            "nullable": true
          },
          "assignedExternalName": {
            "type": "string",
            "nullable": true
          },
          "internalComment": {
            "type": "string",
            "nullable": true
          },
          "publicComment": {
            "type": "string",
            "nullable": true
          },
          "aiCategory": {
            "type": "string",
            "nullable": true
          },
          "aiPriority": {
            "type": "string",
            "nullable": true
          },
          "aiSummary": {
            "type": "string",
            "nullable": true
          },
          "aiRationale": {
            "type": "string",
            "nullable": true
          },
          "aiFlagged": {
            "type": "boolean"
          },
          "aiProcessedAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "acknowledgedAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "assignedAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "workStartedAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "closedAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "attachmentCount": {
            "type": "integer",
            "format": "int32"
          },
          "createdAt": {
            "type": "string",
            "format": "date-time"
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time"
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Citizens.CitizenReportReceipt": {
        "type": "object",
        "properties": {
          "referenceNumber": {
            "type": "string",
            "nullable": true
          },
          "trackingToken": {
            "type": "string",
            "nullable": true
          },
          "submittedAt": {
            "type": "string",
            "format": "date-time"
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Citizens.CitizenReportSummaryDto": {
        "type": "object",
        "properties": {
          "total": {
            "type": "integer",
            "format": "int32"
          },
          "newCount": {
            "type": "integer",
            "format": "int32"
          },
          "acknowledgedCount": {
            "type": "integer",
            "format": "int32"
          },
          "assignedCount": {
            "type": "integer",
            "format": "int32"
          },
          "inProgressCount": {
            "type": "integer",
            "format": "int32"
          },
          "resolvedCount": {
            "type": "integer",
            "format": "int32"
          },
          "rejectedCount": {
            "type": "integer",
            "format": "int32"
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Citizens.PublicAppointmentStatus": {
        "type": "object",
        "properties": {
          "referenceNumber": {
            "type": "string",
            "nullable": true
          },
          "department": {
            "type": "string",
            "nullable": true
          },
          "subject": {
            "type": "string",
            "nullable": true
          },
          "requestedStart": {
            "type": "string",
            "format": "date-time"
          },
          "durationMinutes": {
            "type": "integer",
            "format": "int32"
          },
          "status": {
            "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Enums.AppointmentStatus"
          },
          "publicComment": {
            "type": "string",
            "nullable": true
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time"
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Citizens.PublicCitizenReportStatus": {
        "type": "object",
        "properties": {
          "referenceNumber": {
            "type": "string",
            "nullable": true
          },
          "title": {
            "type": "string",
            "nullable": true
          },
          "category": {
            "type": "string",
            "nullable": true
          },
          "status": {
            "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Enums.CitizenReportStatus"
          },
          "publicComment": {
            "type": "string",
            "nullable": true
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time"
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Citizens.PublicFaqRequest": {
        "required": [
          "question"
        ],
        "type": "object",
        "properties": {
          "question": {
            "maxLength": 500,
            "minLength": 3,
            "type": "string"
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Citizens.SubmitAppointmentRequest": {
        "required": [
          "citizenEmail",
          "citizenName",
          "department",
          "requestedStart",
          "subject"
        ],
        "type": "object",
        "properties": {
          "citizenName": {
            "maxLength": 160,
            "minLength": 1,
            "type": "string"
          },
          "citizenEmail": {
            "maxLength": 260,
            "minLength": 1,
            "type": "string",
            "format": "email"
          },
          "citizenPhone": {
            "maxLength": 60,
            "type": "string",
            "nullable": true
          },
          "department": {
            "maxLength": 160,
            "minLength": 1,
            "type": "string"
          },
          "subject": {
            "maxLength": 240,
            "minLength": 1,
            "type": "string"
          },
          "requestedStart": {
            "type": "string",
            "format": "date-time"
          },
          "durationMinutes": {
            "maximum": 120,
            "minimum": 15,
            "type": "integer",
            "format": "int32"
          },
          "notes": {
            "maxLength": 2000,
            "type": "string",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Citizens.SubmitCitizenReportRequest": {
        "required": [
          "category",
          "description",
          "location",
          "reporterEmail",
          "reporterName",
          "title"
        ],
        "type": "object",
        "properties": {
          "reporterName": {
            "maxLength": 160,
            "minLength": 1,
            "type": "string"
          },
          "reporterEmail": {
            "maxLength": 260,
            "minLength": 1,
            "type": "string",
            "format": "email"
          },
          "category": {
            "maxLength": 120,
            "minLength": 1,
            "type": "string"
          },
          "title": {
            "maxLength": 240,
            "minLength": 1,
            "type": "string"
          },
          "description": {
            "maxLength": 5000,
            "minLength": 10,
            "type": "string"
          },
          "location": {
            "maxLength": 500,
            "minLength": 1,
            "type": "string"
          },
          "latitude": {
            "maximum": 90,
            "minimum": -90,
            "type": "number",
            "format": "double",
            "nullable": true
          },
          "longitude": {
            "maximum": 180,
            "minimum": -180,
            "type": "number",
            "format": "double",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Citizens.UpdateAppointmentRequest": {
        "type": "object",
        "properties": {
          "status": {
            "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Enums.AppointmentStatus"
          },
          "requestedStart": {
            "type": "string",
            "format": "date-time"
          },
          "durationMinutes": {
            "maximum": 120,
            "minimum": 15,
            "type": "integer",
            "format": "int32"
          },
          "internalComment": {
            "maxLength": 2000,
            "type": "string",
            "nullable": true
          },
          "publicComment": {
            "maxLength": 2000,
            "type": "string",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Citizens.UpdateCitizenReportRequest": {
        "type": "object",
        "properties": {
          "status": {
            "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Enums.CitizenReportStatus"
          },
          "assignedDepartment": {
            "maxLength": 180,
            "type": "string",
            "nullable": true
          },
          "assignedUserId": {
            "type": "string",
            "format": "uuid",
            "nullable": true
          },
          "assignedExternalName": {
            "maxLength": 240,
            "type": "string",
            "nullable": true
          },
          "internalComment": {
            "maxLength": 4000,
            "type": "string",
            "nullable": true
          },
          "publicComment": {
            "maxLength": 2000,
            "type": "string",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Citizens.UpsertAppointmentScheduleRequest": {
        "required": [
          "department"
        ],
        "type": "object",
        "properties": {
          "department": {
            "maxLength": 160,
            "minLength": 1,
            "type": "string"
          },
          "dayOfWeek": {
            "$ref": "#/components/schemas/System.DayOfWeek"
          },
          "startTime": {
            "type": "string",
            "format": "time"
          },
          "endTime": {
            "type": "string",
            "format": "time"
          },
          "slotMinutes": {
            "maximum": 120,
            "minimum": 15,
            "type": "integer",
            "format": "int32"
          },
          "capacity": {
            "maximum": 20,
            "minimum": 1,
            "type": "integer",
            "format": "int32"
          },
          "isActive": {
            "type": "boolean"
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Common.BackgroundActivityDto": {
        "type": "object",
        "properties": {
          "queued": {
            "type": "integer",
            "format": "int32"
          },
          "running": {
            "type": "integer",
            "format": "int32"
          },
          "failed": {
            "type": "integer",
            "format": "int32"
          },
          "activeTotal": {
            "type": "integer",
            "format": "int32"
          }
        },
        "additionalProperties": false,
        "description": "A bejelentkezett felhasználó saját tartós háttérfeladatainak rövid összesítése.\r\nA felső sáv ezt használja, így oldalváltás után is látszik, hogy a háttérben dolgozik-e valami."
      },
      "OmegaMunicipal.Contracts.Common.BackgroundJobAccepted": {
        "type": "object",
        "properties": {
          "jobId": {
            "type": "string",
            "format": "uuid"
          },
          "kind": {
            "type": "string",
            "nullable": true
          },
          "status": {
            "type": "string",
            "nullable": true
          },
          "createdAt": {
            "type": "string",
            "format": "date-time"
          },
          "publicAccessToken": {
            "type": "string",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Common.BackgroundJobAdminDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "municipalityId": {
            "type": "string",
            "format": "uuid"
          },
          "municipalityName": {
            "type": "string",
            "nullable": true
          },
          "userId": {
            "type": "string",
            "format": "uuid",
            "nullable": true
          },
          "userName": {
            "type": "string",
            "nullable": true
          },
          "kind": {
            "type": "string",
            "nullable": true
          },
          "status": {
            "type": "string",
            "nullable": true
          },
          "description": {
            "type": "string",
            "nullable": true
          },
          "error": {
            "type": "string",
            "nullable": true
          },
          "targetUrl": {
            "type": "string",
            "nullable": true
          },
          "createdAt": {
            "type": "string",
            "format": "date-time"
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time"
          },
          "startedAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "completedAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "activeInCurrentProcess": {
            "type": "boolean"
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Common.BackgroundJobBulkDeleteRequest": {
        "type": "object",
        "properties": {
          "status": {
            "type": "string",
            "nullable": true
          },
          "kind": {
            "type": "string",
            "nullable": true
          },
          "search": {
            "type": "string",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Common.BackgroundJobMutationResult": {
        "type": "object",
        "properties": {
          "affected": {
            "type": "integer",
            "format": "int32"
          },
          "cancellationSignals": {
            "type": "integer",
            "format": "int32"
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Common.BackgroundJobStatusDto": {
        "type": "object",
        "properties": {
          "jobId": {
            "type": "string",
            "format": "uuid"
          },
          "kind": {
            "type": "string",
            "nullable": true
          },
          "status": {
            "type": "string",
            "nullable": true
          },
          "resultJson": {
            "type": "string",
            "nullable": true
          },
          "error": {
            "type": "string",
            "nullable": true
          },
          "createdAt": {
            "type": "string",
            "format": "date-time"
          },
          "startedAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "completedAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "targetUrl": {
            "type": "string",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Common.BackgroundWorkerLaneDto": {
        "type": "object",
        "properties": {
          "running": {
            "type": "boolean"
          },
          "startedAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "lastHeartbeat": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "lastError": {
            "type": "string",
            "nullable": true
          },
          "currentJobId": {
            "type": "string",
            "format": "uuid",
            "nullable": true
          },
          "currentJobKind": {
            "type": "string",
            "nullable": true
          },
          "currentJobStartedAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Common.BackgroundWorkerRuntimeDto": {
        "type": "object",
        "properties": {
          "processorRunning": {
            "type": "boolean"
          },
          "processorStartedAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "processorStoppedAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "lastRecoveryAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "lastProcessorError": {
            "type": "string",
            "nullable": true
          },
          "serverTimeUtc": {
            "type": "string",
            "format": "date-time"
          },
          "meetingLane": {
            "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Common.BackgroundWorkerLaneDto"
          },
          "generalLane": {
            "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Common.BackgroundWorkerLaneDto"
          },
          "activeJobCount": {
            "type": "integer",
            "format": "int32"
          },
          "queuedCount": {
            "type": "integer",
            "format": "int32"
          },
          "runningCount": {
            "type": "integer",
            "format": "int32"
          },
          "failedCount": {
            "type": "integer",
            "format": "int32"
          },
          "completedCount": {
            "type": "integer",
            "format": "int32"
          },
          "healthy": {
            "type": "boolean"
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Common.DepartmentDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "name": {
            "type": "string",
            "nullable": true
          },
          "code": {
            "type": "string",
            "nullable": true
          },
          "isActive": {
            "type": "boolean"
          },
          "sortOrder": {
            "type": "integer",
            "format": "int32"
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Common.NotificationDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "type": {
            "type": "string",
            "nullable": true
          },
          "title": {
            "type": "string",
            "nullable": true
          },
          "message": {
            "type": "string",
            "nullable": true
          },
          "targetUrl": {
            "type": "string",
            "nullable": true
          },
          "isRead": {
            "type": "boolean"
          },
          "createdAt": {
            "type": "string",
            "format": "date-time"
          },
          "readAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Common.NotificationSummaryDto": {
        "type": "object",
        "properties": {
          "unreadCount": {
            "type": "integer",
            "format": "int32"
          },
          "items": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Common.NotificationDto"
            },
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Common.PagedResult`1[[OmegaMunicipal.Contracts.Audit.AuditLogDto, OmegaMunicipal.Contracts, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null]]": {
        "type": "object",
        "properties": {
          "items": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Audit.AuditLogDto"
            },
            "nullable": true
          },
          "page": {
            "type": "integer",
            "format": "int32"
          },
          "pageSize": {
            "type": "integer",
            "format": "int32"
          },
          "totalCount": {
            "type": "integer",
            "format": "int32"
          },
          "totalPages": {
            "type": "integer",
            "format": "int32",
            "readOnly": true
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Common.PagedResult`1[[OmegaMunicipal.Contracts.Audit.ErrorLogDto, OmegaMunicipal.Contracts, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null]]": {
        "type": "object",
        "properties": {
          "items": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Audit.ErrorLogDto"
            },
            "nullable": true
          },
          "page": {
            "type": "integer",
            "format": "int32"
          },
          "pageSize": {
            "type": "integer",
            "format": "int32"
          },
          "totalCount": {
            "type": "integer",
            "format": "int32"
          },
          "totalPages": {
            "type": "integer",
            "format": "int32",
            "readOnly": true
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Common.PagedResult`1[[OmegaMunicipal.Contracts.Auth.UserListItem, OmegaMunicipal.Contracts, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null]]": {
        "type": "object",
        "properties": {
          "items": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Auth.UserListItem"
            },
            "nullable": true
          },
          "page": {
            "type": "integer",
            "format": "int32"
          },
          "pageSize": {
            "type": "integer",
            "format": "int32"
          },
          "totalCount": {
            "type": "integer",
            "format": "int32"
          },
          "totalPages": {
            "type": "integer",
            "format": "int32",
            "readOnly": true
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Common.PagedResult`1[[OmegaMunicipal.Contracts.Citizens.AppointmentBookingDto, OmegaMunicipal.Contracts, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null]]": {
        "type": "object",
        "properties": {
          "items": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Citizens.AppointmentBookingDto"
            },
            "nullable": true
          },
          "page": {
            "type": "integer",
            "format": "int32"
          },
          "pageSize": {
            "type": "integer",
            "format": "int32"
          },
          "totalCount": {
            "type": "integer",
            "format": "int32"
          },
          "totalPages": {
            "type": "integer",
            "format": "int32",
            "readOnly": true
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Common.PagedResult`1[[OmegaMunicipal.Contracts.Citizens.CitizenReportDto, OmegaMunicipal.Contracts, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null]]": {
        "type": "object",
        "properties": {
          "items": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Citizens.CitizenReportDto"
            },
            "nullable": true
          },
          "page": {
            "type": "integer",
            "format": "int32"
          },
          "pageSize": {
            "type": "integer",
            "format": "int32"
          },
          "totalCount": {
            "type": "integer",
            "format": "int32"
          },
          "totalPages": {
            "type": "integer",
            "format": "int32",
            "readOnly": true
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Common.PagedResult`1[[OmegaMunicipal.Contracts.Common.BackgroundJobAdminDto, OmegaMunicipal.Contracts, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null]]": {
        "type": "object",
        "properties": {
          "items": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Common.BackgroundJobAdminDto"
            },
            "nullable": true
          },
          "page": {
            "type": "integer",
            "format": "int32"
          },
          "pageSize": {
            "type": "integer",
            "format": "int32"
          },
          "totalCount": {
            "type": "integer",
            "format": "int32"
          },
          "totalPages": {
            "type": "integer",
            "format": "int32",
            "readOnly": true
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Common.PagedResult`1[[OmegaMunicipal.Contracts.Documents.DocumentListItem, OmegaMunicipal.Contracts, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null]]": {
        "type": "object",
        "properties": {
          "items": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Documents.DocumentListItem"
            },
            "nullable": true
          },
          "page": {
            "type": "integer",
            "format": "int32"
          },
          "pageSize": {
            "type": "integer",
            "format": "int32"
          },
          "totalCount": {
            "type": "integer",
            "format": "int32"
          },
          "totalPages": {
            "type": "integer",
            "format": "int32",
            "readOnly": true
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Common.PagedResult`1[[OmegaMunicipal.Contracts.Meetings.MeetingListItem, OmegaMunicipal.Contracts, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null]]": {
        "type": "object",
        "properties": {
          "items": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Meetings.MeetingListItem"
            },
            "nullable": true
          },
          "page": {
            "type": "integer",
            "format": "int32"
          },
          "pageSize": {
            "type": "integer",
            "format": "int32"
          },
          "totalCount": {
            "type": "integer",
            "format": "int32"
          },
          "totalPages": {
            "type": "integer",
            "format": "int32",
            "readOnly": true
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Common.PagedResult`1[[OmegaMunicipal.Contracts.Supports.CitizenSupportApplicationDto, OmegaMunicipal.Contracts, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null]]": {
        "type": "object",
        "properties": {
          "items": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Supports.CitizenSupportApplicationDto"
            },
            "nullable": true
          },
          "page": {
            "type": "integer",
            "format": "int32"
          },
          "pageSize": {
            "type": "integer",
            "format": "int32"
          },
          "totalCount": {
            "type": "integer",
            "format": "int32"
          },
          "totalPages": {
            "type": "integer",
            "format": "int32",
            "readOnly": true
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Common.UpsertDepartmentRequest": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "nullable": true
          },
          "code": {
            "type": "string",
            "nullable": true
          },
          "isActive": {
            "type": "boolean"
          },
          "sortOrder": {
            "type": "integer",
            "format": "int32"
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Dashboard.CitizenSummaryDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "referenceNumber": {
            "type": "string",
            "nullable": true
          },
          "title": {
            "type": "string",
            "nullable": true
          },
          "category": {
            "type": "string",
            "nullable": true
          },
          "status": {
            "type": "string",
            "nullable": true
          },
          "createdAt": {
            "type": "string",
            "format": "date-time"
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Dashboard.DashboardAlertDto": {
        "type": "object",
        "properties": {
          "severity": {
            "type": "string",
            "nullable": true
          },
          "title": {
            "type": "string",
            "nullable": true
          },
          "description": {
            "type": "string",
            "nullable": true
          },
          "targetUrl": {
            "type": "string",
            "nullable": true
          },
          "occurredAt": {
            "type": "string",
            "format": "date-time"
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Dashboard.DashboardOverview": {
        "type": "object",
        "properties": {
          "metrics": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Dashboard.MetricDto"
            },
            "nullable": true
          },
          "monthlyEfficiency": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Dashboard.TimelinePointDto"
            },
            "nullable": true
          },
          "energyTrend": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Dashboard.TimelinePointDto"
            },
            "nullable": true
          },
          "efficiencySummary": {
            "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Dashboard.EfficiencySummaryDto"
          },
          "savingsSummary": {
            "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Dashboard.SavingsSummaryDto"
          },
          "priorityProjects": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Dashboard.ProjectSummaryDto"
            },
            "nullable": true
          },
          "upcomingGrants": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Dashboard.GrantSummaryDto"
            },
            "nullable": true
          },
          "latestReports": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Dashboard.CitizenSummaryDto"
            },
            "nullable": true
          },
          "alerts": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Dashboard.DashboardAlertDto"
            },
            "nullable": true
          },
          "generatedAt": {
            "type": "string",
            "format": "date-time"
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Dashboard.EfficiencySummaryDto": {
        "type": "object",
        "properties": {
          "savedHoursThisMonth": {
            "type": "number",
            "format": "double"
          },
          "supportedOperationsThisMonth": {
            "type": "integer",
            "format": "int32"
          },
          "changePercent": {
            "type": "number",
            "format": "double",
            "nullable": true
          },
          "methodology": {
            "type": "string",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Dashboard.GrantSummaryDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "title": {
            "type": "string",
            "nullable": true
          },
          "summary": {
            "type": "string",
            "nullable": true
          },
          "deadline": {
            "type": "string",
            "format": "date",
            "nullable": true
          },
          "matchScore": {
            "type": "integer",
            "format": "int32"
          },
          "status": {
            "type": "string",
            "nullable": true
          },
          "maximumSupportHuf": {
            "type": "number",
            "format": "double",
            "nullable": true
          },
          "supportAmountText": {
            "type": "string",
            "nullable": true
          },
          "eligibilitySummary": {
            "type": "string",
            "nullable": true
          },
          "supportIntensityPercent": {
            "type": "number",
            "format": "double",
            "nullable": true
          },
          "consortiumPossible": {
            "type": "boolean"
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Dashboard.MetricDto": {
        "type": "object",
        "properties": {
          "key": {
            "type": "string",
            "nullable": true
          },
          "label": {
            "type": "string",
            "nullable": true
          },
          "value": {
            "type": "number",
            "format": "double"
          },
          "unit": {
            "type": "string",
            "nullable": true
          },
          "changePercent": {
            "type": "number",
            "format": "double",
            "nullable": true
          },
          "trend": {
            "type": "string",
            "nullable": true
          },
          "icon": {
            "type": "string",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Dashboard.ProjectSummaryDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "name": {
            "type": "string",
            "nullable": true
          },
          "status": {
            "type": "string",
            "nullable": true
          },
          "progressPercent": {
            "type": "integer",
            "format": "int32"
          },
          "budgetHuf": {
            "type": "number",
            "format": "double"
          },
          "spentHuf": {
            "type": "number",
            "format": "double"
          },
          "endDate": {
            "type": "string",
            "format": "date",
            "nullable": true
          },
          "riskLevel": {
            "type": "string",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Dashboard.SavingsSummaryDto": {
        "type": "object",
        "properties": {
          "estimatedLaborSavingsHuf": {
            "type": "number",
            "format": "double"
          },
          "estimatedEnergySavingsHuf": {
            "type": "number",
            "format": "double"
          },
          "estimatedTotalSavingsHuf": {
            "type": "number",
            "format": "double"
          },
          "methodology": {
            "type": "string",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Dashboard.TimelinePointDto": {
        "type": "object",
        "properties": {
          "label": {
            "type": "string",
            "nullable": true
          },
          "value": {
            "type": "number",
            "format": "double"
          },
          "secondaryValue": {
            "type": "number",
            "format": "double",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Documents.CreateTextDocumentRequest": {
        "required": [
          "category",
          "text",
          "title"
        ],
        "type": "object",
        "properties": {
          "title": {
            "maxLength": 260,
            "minLength": 1,
            "type": "string"
          },
          "category": {
            "maxLength": 120,
            "minLength": 1,
            "type": "string"
          },
          "text": {
            "minLength": 1,
            "type": "string"
          },
          "isPublic": {
            "type": "boolean"
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Documents.DocumentDetails": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "title": {
            "type": "string",
            "nullable": true
          },
          "fileName": {
            "type": "string",
            "nullable": true
          },
          "category": {
            "type": "string",
            "nullable": true
          },
          "contentType": {
            "type": "string",
            "nullable": true
          },
          "fileSize": {
            "type": "integer",
            "format": "int64"
          },
          "status": {
            "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Enums.DocumentStatus"
          },
          "summary": {
            "type": "string",
            "nullable": true
          },
          "extractedText": {
            "type": "string",
            "nullable": true
          },
          "createdAt": {
            "type": "string",
            "format": "date-time"
          },
          "uploadedBy": {
            "type": "string",
            "nullable": true
          },
          "isPublic": {
            "type": "boolean"
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Documents.DocumentListItem": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "title": {
            "type": "string",
            "nullable": true
          },
          "fileName": {
            "type": "string",
            "nullable": true
          },
          "category": {
            "type": "string",
            "nullable": true
          },
          "contentType": {
            "type": "string",
            "nullable": true
          },
          "fileSize": {
            "type": "integer",
            "format": "int64"
          },
          "status": {
            "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Enums.DocumentStatus"
          },
          "summary": {
            "type": "string",
            "nullable": true
          },
          "createdAt": {
            "type": "string",
            "format": "date-time"
          },
          "uploadedBy": {
            "type": "string",
            "nullable": true
          },
          "isPublic": {
            "type": "boolean"
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Documents.DocumentReindexResult": {
        "type": "object",
        "properties": {
          "indexedDocuments": {
            "type": "integer",
            "format": "int32"
          },
          "completedAt": {
            "type": "string",
            "format": "date-time"
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Documents.UpdateDocumentRequest": {
        "required": [
          "category",
          "title"
        ],
        "type": "object",
        "properties": {
          "title": {
            "maxLength": 260,
            "minLength": 1,
            "type": "string"
          },
          "category": {
            "maxLength": 120,
            "minLength": 1,
            "type": "string"
          },
          "isPublic": {
            "type": "boolean"
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Energy.EnergyAnomalyDto": {
        "type": "object",
        "properties": {
          "siteId": {
            "type": "string",
            "format": "uuid"
          },
          "siteName": {
            "type": "string",
            "nullable": true
          },
          "timestamp": {
            "type": "string",
            "format": "date-time"
          },
          "type": {
            "type": "string",
            "nullable": true
          },
          "severity": {
            "type": "string",
            "nullable": true
          },
          "description": {
            "type": "string",
            "nullable": true
          },
          "value": {
            "type": "number",
            "format": "double"
          },
          "baseline": {
            "type": "number",
            "format": "double"
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Energy.EnergyDashboardDto": {
        "type": "object",
        "properties": {
          "sites": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Energy.EnergySiteDto"
            },
            "nullable": true
          },
          "trend": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Energy.EnergyReadingDto"
            },
            "nullable": true
          },
          "anomalies": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Energy.EnergyAnomalyDto"
            },
            "nullable": true
          },
          "totalConsumptionKwh": {
            "type": "number",
            "format": "double"
          },
          "totalProductionKwh": {
            "type": "number",
            "format": "double"
          },
          "totalCostHuf": {
            "type": "number",
            "format": "double"
          },
          "estimatedSavingsHuf": {
            "type": "number",
            "format": "double"
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Energy.EnergyHistoryPointDto": {
        "type": "object",
        "properties": {
          "periodStart": {
            "type": "string",
            "format": "date-time"
          },
          "periodLabel": {
            "type": "string",
            "nullable": true
          },
          "consumptionKwh": {
            "type": "number",
            "format": "double"
          },
          "productionKwh": {
            "type": "number",
            "format": "double"
          },
          "costHuf": {
            "type": "number",
            "format": "double"
          },
          "co2Kg": {
            "type": "number",
            "format": "double"
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Energy.EnergyReadingDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "timestamp": {
            "type": "string",
            "format": "date-time"
          },
          "consumptionKwh": {
            "type": "number",
            "format": "double"
          },
          "productionKwh": {
            "type": "number",
            "format": "double"
          },
          "costHuf": {
            "type": "number",
            "format": "double"
          },
          "co2Kg": {
            "type": "number",
            "format": "double",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Energy.EnergySiteDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "name": {
            "type": "string",
            "nullable": true
          },
          "address": {
            "type": "string",
            "nullable": true
          },
          "type": {
            "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Enums.EnergySiteType"
          },
          "floorAreaM2": {
            "type": "number",
            "format": "double",
            "nullable": true
          },
          "annualTargetKwh": {
            "type": "number",
            "format": "double"
          },
          "currentMonthConsumptionKwh": {
            "type": "number",
            "format": "double"
          },
          "currentMonthProductionKwh": {
            "type": "number",
            "format": "double"
          },
          "currentMonthCostHuf": {
            "type": "number",
            "format": "double"
          },
          "changePercent": {
            "type": "number",
            "format": "double"
          },
          "status": {
            "type": "string",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Energy.EnergySiteHistoryDto": {
        "type": "object",
        "properties": {
          "siteId": {
            "type": "string",
            "format": "uuid"
          },
          "siteName": {
            "type": "string",
            "nullable": true
          },
          "rangeLabel": {
            "type": "string",
            "nullable": true
          },
          "aggregationLabel": {
            "type": "string",
            "nullable": true
          },
          "points": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Energy.EnergyHistoryPointDto"
            },
            "nullable": true
          },
          "totalConsumptionKwh": {
            "type": "number",
            "format": "double"
          },
          "totalProductionKwh": {
            "type": "number",
            "format": "double"
          },
          "totalCostHuf": {
            "type": "number",
            "format": "double"
          },
          "averageConsumptionKwh": {
            "type": "number",
            "format": "double"
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Energy.UpsertEnergySiteRequest": {
        "required": [
          "address",
          "name"
        ],
        "type": "object",
        "properties": {
          "name": {
            "maxLength": 240,
            "minLength": 1,
            "type": "string"
          },
          "address": {
            "maxLength": 500,
            "minLength": 1,
            "type": "string"
          },
          "type": {
            "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Enums.EnergySiteType"
          },
          "floorAreaM2": {
            "minimum": 0,
            "type": "number",
            "format": "double",
            "nullable": true
          },
          "annualTargetKwh": {
            "minimum": 0,
            "type": "number",
            "format": "double"
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Enums.AppointmentStatus": {
        "enum": [
          "Requested",
          "Confirmed",
          "Rescheduled",
          "Completed",
          "Cancelled",
          "Rejected"
        ],
        "type": "string"
      },
      "OmegaMunicipal.Contracts.Enums.CitizenReportStatus": {
        "enum": [
          "New",
          "Acknowledged",
          "Assigned",
          "InProgress",
          "Resolved",
          "Rejected"
        ],
        "type": "string"
      },
      "OmegaMunicipal.Contracts.Enums.CitizenSupportApplicationStatus": {
        "enum": [
          "Received",
          "NeedsDocuments",
          "ReadyForReview",
          "UnderReview",
          "Approved",
          "Rejected",
          "Withdrawn"
        ],
        "type": "string"
      },
      "OmegaMunicipal.Contracts.Enums.DocumentStatus": {
        "enum": [
          "Uploaded",
          "Processing",
          "Ready",
          "NeedsExternalProcessing",
          "Failed",
          "Archived"
        ],
        "type": "string"
      },
      "OmegaMunicipal.Contracts.Enums.EnergySiteType": {
        "enum": [
          "Office",
          "School",
          "Kindergarten",
          "Cultural",
          "Sports",
          "Healthcare",
          "PublicLighting",
          "Other"
        ],
        "type": "string"
      },
      "OmegaMunicipal.Contracts.Enums.GrantRegion": {
        "enum": [
          "Hungary",
          "EuropeanUnion",
          "International"
        ],
        "type": "string"
      },
      "OmegaMunicipal.Contracts.Enums.GrantStatus": {
        "enum": [
          "New",
          "Evaluating",
          "Recommended",
          "Preparing",
          "Submitted",
          "Won",
          "Lost",
          "Closed"
        ],
        "type": "string"
      },
      "OmegaMunicipal.Contracts.Enums.IntegrationStatus": {
        "enum": [
          "NotConfigured",
          "Unknown",
          "Healthy",
          "Degraded",
          "Offline",
          "Disabled"
        ],
        "type": "string"
      },
      "OmegaMunicipal.Contracts.Enums.IntegrationType": {
        "enum": [
          "Asp",
          "EOnkormanyzat",
          "EPapir",
          "DocumentManagement",
          "Finance",
          "Gis",
          "EKozmu",
          "Email",
          "Calendar",
          "Iot",
          "Other"
        ],
        "type": "string"
      },
      "OmegaMunicipal.Contracts.Enums.PriorityLevel": {
        "enum": [
          "Low",
          "Normal",
          "High",
          "Critical"
        ],
        "type": "string"
      },
      "OmegaMunicipal.Contracts.Enums.ProjectStatus": {
        "enum": [
          "Planned",
          "Approved",
          "Active",
          "OnHold",
          "Completed",
          "Cancelled"
        ],
        "type": "string"
      },
      "OmegaMunicipal.Contracts.Enums.ProjectTaskStatus": {
        "enum": [
          "Todo",
          "InProgress",
          "Blocked",
          "Review",
          "Done"
        ],
        "type": "string"
      },
      "OmegaMunicipal.Contracts.Enums.RiskLevel": {
        "enum": [
          "Low",
          "Medium",
          "High",
          "Critical"
        ],
        "type": "string"
      },
      "OmegaMunicipal.Contracts.Enums.SupportCompletenessStatus": {
        "enum": [
          "NotChecked",
          "Complete",
          "Incomplete",
          "NeedsReview"
        ],
        "type": "string"
      },
      "OmegaMunicipal.Contracts.Enums.SupportEligibilityAssessment": {
        "enum": [
          "NotEvaluated",
          "LikelyEligible",
          "NeedsReview",
          "LikelyNotEligible"
        ],
        "type": "string"
      },
      "OmegaMunicipal.Contracts.Grants.GrantFeedStatusDto": {
        "type": "object",
        "properties": {
          "lastSuccess": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "lastAttempt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "lastSeen": {
            "type": "integer",
            "format": "int32"
          },
          "lastError": {
            "type": "string",
            "nullable": true
          },
          "refreshMinutes": {
            "type": "integer",
            "format": "int32"
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Grants.GrantMatchResult": {
        "type": "object",
        "properties": {
          "grantId": {
            "type": "string",
            "format": "uuid"
          },
          "title": {
            "type": "string",
            "nullable": true
          },
          "score": {
            "type": "integer",
            "format": "int32"
          },
          "reasons": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "nullable": true
          },
          "deadline": {
            "type": "string",
            "format": "date",
            "nullable": true
          },
          "maximumSupportHuf": {
            "type": "number",
            "format": "double",
            "nullable": true
          },
          "usedExternalAi": {
            "type": "boolean"
          },
          "summary": {
            "type": "string",
            "nullable": true
          },
          "supportAmountText": {
            "type": "string",
            "nullable": true
          },
          "eligibilitySummary": {
            "type": "string",
            "nullable": true
          },
          "supportIntensityPercent": {
            "type": "number",
            "format": "double",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Grants.GrantOpportunityDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "title": {
            "type": "string",
            "nullable": true
          },
          "program": {
            "type": "string",
            "nullable": true
          },
          "fundingSource": {
            "type": "string",
            "nullable": true
          },
          "region": {
            "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Enums.GrantRegion"
          },
          "summary": {
            "type": "string",
            "nullable": true
          },
          "deadline": {
            "type": "string",
            "format": "date",
            "nullable": true
          },
          "minimumSupportHuf": {
            "type": "number",
            "format": "double",
            "nullable": true
          },
          "maximumSupportHuf": {
            "type": "number",
            "format": "double",
            "nullable": true
          },
          "supportIntensityPercent": {
            "type": "number",
            "format": "double",
            "nullable": true
          },
          "supportAmountText": {
            "type": "string",
            "nullable": true
          },
          "eligibilitySummary": {
            "type": "string",
            "nullable": true
          },
          "consortiumPossible": {
            "type": "boolean"
          },
          "officialDetailsLastCheckedAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "status": {
            "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Enums.GrantStatus"
          },
          "matchScore": {
            "type": "integer",
            "format": "int32"
          },
          "url": {
            "type": "string",
            "nullable": true
          },
          "downloadUrl": {
            "type": "string",
            "nullable": true
          },
          "applicantTypes": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "nullable": true
          },
          "tags": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "nullable": true
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time"
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Grants.GrantPartnerDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "name": {
            "type": "string",
            "nullable": true
          },
          "capabilities": {
            "type": "string",
            "nullable": true
          },
          "website": {
            "type": "string",
            "nullable": true
          },
          "affiliation": {
            "type": "string",
            "nullable": true
          },
          "isActive": {
            "type": "boolean"
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Grants.GrantProjectAssessmentDto": {
        "type": "object",
        "properties": {
          "grantId": {
            "type": "string",
            "format": "uuid"
          },
          "projectId": {
            "type": "string",
            "format": "uuid"
          },
          "fitScore": {
            "type": "integer",
            "format": "int32"
          },
          "analysisMarkdown": {
            "type": "string",
            "nullable": true
          },
          "suggestedPartners": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Grants.GrantPartnerDto"
            },
            "nullable": true
          },
          "proposalDraftMarkdown": {
            "type": "string",
            "nullable": true
          },
          "generatedAt": {
            "type": "string",
            "format": "date-time"
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Grants.GrantProjectAssessmentRequest": {
        "required": [
          "projectId"
        ],
        "type": "object",
        "properties": {
          "projectId": {
            "type": "string",
            "format": "uuid"
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Grants.GrantSearchResponse": {
        "type": "object",
        "properties": {
          "items": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Grants.GrantOpportunityDto"
            },
            "nullable": true
          },
          "totalCount": {
            "type": "integer",
            "format": "int32"
          },
          "page": {
            "type": "integer",
            "format": "int32"
          },
          "pageSize": {
            "type": "integer",
            "format": "int32"
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Grants.UpsertGrantPartnerRequest": {
        "required": [
          "affiliation",
          "capabilities",
          "name"
        ],
        "type": "object",
        "properties": {
          "name": {
            "maxLength": 260,
            "minLength": 1,
            "type": "string"
          },
          "capabilities": {
            "maxLength": 2000,
            "minLength": 1,
            "type": "string"
          },
          "website": {
            "maxLength": 1000,
            "type": "string",
            "format": "uri",
            "nullable": true
          },
          "affiliation": {
            "maxLength": 80,
            "minLength": 1,
            "type": "string"
          },
          "isActive": {
            "type": "boolean"
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Integrations.IntegrationConnectionDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "name": {
            "type": "string",
            "nullable": true
          },
          "type": {
            "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Enums.IntegrationType"
          },
          "baseUrl": {
            "type": "string",
            "nullable": true
          },
          "authenticationMode": {
            "type": "string",
            "nullable": true
          },
          "status": {
            "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Enums.IntegrationStatus"
          },
          "isEnabled": {
            "type": "boolean"
          },
          "lastCheckedAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "lastMessage": {
            "type": "string",
            "nullable": true
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time"
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Integrations.IntegrationTestResult": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "status": {
            "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Enums.IntegrationStatus"
          },
          "message": {
            "type": "string",
            "nullable": true
          },
          "duration": {
            "type": "string",
            "format": "date-span"
          },
          "checkedAt": {
            "type": "string",
            "format": "date-time"
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Integrations.UpsertIntegrationRequest": {
        "required": [
          "authenticationMode",
          "name"
        ],
        "type": "object",
        "properties": {
          "name": {
            "maxLength": 180,
            "minLength": 1,
            "type": "string"
          },
          "type": {
            "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Enums.IntegrationType"
          },
          "baseUrl": {
            "maxLength": 1000,
            "type": "string",
            "format": "uri",
            "nullable": true
          },
          "authenticationMode": {
            "maxLength": 80,
            "minLength": 1,
            "type": "string"
          },
          "secretReference": {
            "maxLength": 260,
            "type": "string",
            "nullable": true
          },
          "isEnabled": {
            "type": "boolean"
          },
          "notes": {
            "maxLength": 4000,
            "type": "string",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Meetings.MeetingActionItem": {
        "type": "object",
        "properties": {
          "task": {
            "type": "string",
            "nullable": true
          },
          "responsible": {
            "type": "string",
            "nullable": true
          },
          "deadline": {
            "type": "string",
            "nullable": true
          },
          "priority": {
            "type": "string",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Meetings.MeetingAnalysisResult": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "title": {
            "type": "string",
            "nullable": true
          },
          "fileName": {
            "type": "string",
            "nullable": true
          },
          "transcription": {
            "type": "string",
            "nullable": true
          },
          "summary": {
            "type": "string",
            "nullable": true
          },
          "detailedSummary": {
            "type": "string",
            "nullable": true
          },
          "diarizedTranscription": {
            "type": "string",
            "nullable": true
          },
          "speakerMap": {
            "type": "object",
            "additionalProperties": {
              "type": "string"
            },
            "nullable": true
          },
          "participants": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "nullable": true
          },
          "keyTopics": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "nullable": true
          },
          "decisions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Meetings.MeetingDecision"
            },
            "nullable": true
          },
          "actionItems": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Meetings.MeetingActionItem"
            },
            "nullable": true
          },
          "openQuestions": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "nullable": true
          },
          "risks": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "nullable": true
          },
          "nextSteps": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "nullable": true
          },
          "usedExternalAi": {
            "type": "boolean"
          },
          "createdAt": {
            "type": "string",
            "format": "date-time"
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Meetings.MeetingDecision": {
        "type": "object",
        "properties": {
          "decision": {
            "type": "string",
            "nullable": true
          },
          "legalOrFinancialReview": {
            "type": "string",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Meetings.MeetingDraftAnalysisResult": {
        "type": "object",
        "properties": {
          "draftId": {
            "type": "string",
            "format": "uuid"
          },
          "status": {
            "type": "string",
            "nullable": true
          },
          "stage": {
            "type": "string",
            "nullable": true
          },
          "error": {
            "type": "string",
            "nullable": true
          },
          "title": {
            "type": "string",
            "nullable": true
          },
          "fileName": {
            "type": "string",
            "nullable": true
          },
          "transcription": {
            "type": "string",
            "nullable": true
          },
          "summary": {
            "type": "string",
            "nullable": true
          },
          "detailedSummary": {
            "type": "string",
            "nullable": true
          },
          "diarizedTranscription": {
            "type": "string",
            "nullable": true
          },
          "speakerMap": {
            "type": "object",
            "additionalProperties": {
              "type": "string"
            },
            "nullable": true
          },
          "participants": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "nullable": true
          },
          "keyTopics": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "nullable": true
          },
          "decisions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Meetings.MeetingDecision"
            },
            "nullable": true
          },
          "actionItems": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Meetings.MeetingActionItem"
            },
            "nullable": true
          },
          "openQuestions": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "nullable": true
          },
          "risks": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "nullable": true
          },
          "nextSteps": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "nullable": true
          },
          "usedExternalAi": {
            "type": "boolean"
          },
          "publishedMeetingId": {
            "type": "string",
            "format": "uuid",
            "nullable": true
          },
          "createdAt": {
            "type": "string",
            "format": "date-time"
          }
        },
        "additionalProperties": false,
        "description": "A mobilon indított, még nem önkormányzati meetingként publikált AI-eredmény.\r\nA DraftId csak a létrehozó felhasználó számára érhető el."
      },
      "OmegaMunicipal.Contracts.Meetings.MeetingDraftJobAccepted": {
        "type": "object",
        "properties": {
          "draftId": {
            "type": "string",
            "format": "uuid"
          },
          "jobId": {
            "type": "string",
            "format": "uuid"
          },
          "status": {
            "type": "string",
            "nullable": true
          },
          "createdAt": {
            "type": "string",
            "format": "date-time"
          }
        },
        "additionalProperties": false,
        "description": "Privát mobil meeting AI-feldolgozás indításának visszaigazolása."
      },
      "OmegaMunicipal.Contracts.Meetings.MeetingListItem": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "title": {
            "type": "string",
            "nullable": true
          },
          "fileName": {
            "type": "string",
            "nullable": true
          },
          "summary": {
            "type": "string",
            "nullable": true
          },
          "actionItemCount": {
            "type": "integer",
            "format": "int32"
          },
          "decisionCount": {
            "type": "integer",
            "format": "int32"
          },
          "createdAt": {
            "type": "string",
            "format": "date-time"
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Meetings.MeetingMinutesTemplateDto": {
        "type": "object",
        "properties": {
          "municipalityName": {
            "type": "string",
            "nullable": true
          },
          "templateName": {
            "type": "string",
            "nullable": true
          },
          "customPrompt": {
            "type": "string",
            "nullable": true
          },
          "templateFileName": {
            "type": "string",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Meetings.UpdateMeetingContentRequest": {
        "required": [
          "detailedSummary",
          "summary",
          "title"
        ],
        "type": "object",
        "properties": {
          "title": {
            "maxLength": 260,
            "minLength": 1,
            "type": "string"
          },
          "summary": {
            "maxLength": 12000,
            "minLength": 1,
            "type": "string"
          },
          "detailedSummary": {
            "minLength": 1,
            "type": "string"
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Meetings.UpdateMeetingMinutesTemplateRequest": {
        "type": "object",
        "properties": {
          "templateName": {
            "type": "string",
            "nullable": true
          },
          "customPrompt": {
            "type": "string",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Offline.OfflineComponentStatus": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "nullable": true
          },
          "ready": {
            "type": "boolean"
          },
          "detail": {
            "type": "string",
            "nullable": true
          },
          "pathOrEndpoint": {
            "type": "string",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Offline.OfflineHealthResult": {
        "type": "object",
        "properties": {
          "offlineMode": {
            "type": "boolean"
          },
          "ready": {
            "type": "boolean"
          },
          "llmModel": {
            "type": "string",
            "nullable": true
          },
          "embeddingModel": {
            "type": "string",
            "nullable": true
          },
          "components": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Offline.OfflineComponentStatus"
            },
            "nullable": true
          },
          "checkedAt": {
            "type": "string",
            "format": "date-time"
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Offline.OfflineModelInfo": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "nullable": true
          },
          "displayName": {
            "type": "string",
            "nullable": true
          },
          "installed": {
            "type": "boolean"
          },
          "recommended": {
            "type": "boolean"
          },
          "quality": {
            "type": "string",
            "nullable": true
          },
          "minimumMemoryGb": {
            "type": "integer",
            "format": "int32"
          },
          "contextWindowTokens": {
            "type": "integer",
            "format": "int32"
          },
          "description": {
            "type": "string",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Offline.OfflineModelSettingsResult": {
        "type": "object",
        "properties": {
          "selectedChatModel": {
            "type": "string",
            "nullable": true
          },
          "embeddingModel": {
            "type": "string",
            "nullable": true
          },
          "models": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Offline.OfflineModelInfo"
            },
            "nullable": true
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Offline.TtsRequest": {
        "type": "object",
        "properties": {
          "text": {
            "type": "string",
            "nullable": true
          },
          "language": {
            "type": "string",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Offline.UpdateOfflineModelRequest": {
        "type": "object",
        "properties": {
          "chatModel": {
            "type": "string",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Projects.CreateProjectTaskRequest": {
        "required": [
          "title"
        ],
        "type": "object",
        "properties": {
          "title": {
            "maxLength": 300,
            "minLength": 1,
            "type": "string"
          },
          "assignedTo": {
            "maxLength": 180,
            "type": "string",
            "nullable": true
          },
          "dueDate": {
            "type": "string",
            "format": "date",
            "nullable": true
          },
          "status": {
            "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Enums.ProjectTaskStatus"
          },
          "priority": {
            "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Enums.PriorityLevel"
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Projects.MunicipalProjectDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "name": {
            "type": "string",
            "nullable": true
          },
          "description": {
            "type": "string",
            "nullable": true
          },
          "status": {
            "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Enums.ProjectStatus"
          },
          "riskLevel": {
            "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Enums.RiskLevel"
          },
          "budgetHuf": {
            "type": "number",
            "format": "double"
          },
          "spentHuf": {
            "type": "number",
            "format": "double"
          },
          "startDate": {
            "type": "string",
            "format": "date",
            "nullable": true
          },
          "endDate": {
            "type": "string",
            "format": "date",
            "nullable": true
          },
          "progressPercent": {
            "type": "integer",
            "format": "int32"
          },
          "owner": {
            "type": "string",
            "nullable": true
          },
          "ownerUserId": {
            "type": "string",
            "format": "uuid",
            "nullable": true
          },
          "ownerDepartmentId": {
            "type": "string",
            "format": "uuid",
            "nullable": true
          },
          "tasks": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Projects.ProjectTaskDto"
            },
            "nullable": true
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time"
          },
          "progressIsAutomatic": {
            "type": "boolean"
          },
          "progressExplanation": {
            "type": "string",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Projects.ProjectTaskDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "title": {
            "type": "string",
            "nullable": true
          },
          "assignedTo": {
            "type": "string",
            "nullable": true
          },
          "dueDate": {
            "type": "string",
            "format": "date",
            "nullable": true
          },
          "status": {
            "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Enums.ProjectTaskStatus"
          },
          "priority": {
            "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Enums.PriorityLevel"
          },
          "sortOrder": {
            "type": "integer",
            "format": "int32"
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Projects.UpdateProjectTaskRequest": {
        "required": [
          "title"
        ],
        "type": "object",
        "properties": {
          "title": {
            "maxLength": 300,
            "minLength": 1,
            "type": "string"
          },
          "assignedTo": {
            "maxLength": 180,
            "type": "string",
            "nullable": true
          },
          "dueDate": {
            "type": "string",
            "format": "date",
            "nullable": true
          },
          "status": {
            "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Enums.ProjectTaskStatus"
          },
          "priority": {
            "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Enums.PriorityLevel"
          },
          "sortOrder": {
            "type": "integer",
            "format": "int32"
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Projects.UpsertProjectRequest": {
        "required": [
          "name"
        ],
        "type": "object",
        "properties": {
          "name": {
            "maxLength": 260,
            "minLength": 1,
            "type": "string"
          },
          "description": {
            "maxLength": 6000,
            "type": "string",
            "nullable": true
          },
          "status": {
            "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Enums.ProjectStatus"
          },
          "riskLevel": {
            "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Enums.RiskLevel"
          },
          "budgetHuf": {
            "minimum": 0,
            "type": "number",
            "format": "double"
          },
          "spentHuf": {
            "minimum": 0,
            "type": "number",
            "format": "double"
          },
          "startDate": {
            "type": "string",
            "format": "date",
            "nullable": true
          },
          "endDate": {
            "type": "string",
            "format": "date",
            "nullable": true
          },
          "progressPercent": {
            "maximum": 100,
            "minimum": 0,
            "type": "integer",
            "format": "int32"
          },
          "owner": {
            "maxLength": 180,
            "type": "string",
            "nullable": true
          },
          "ownerUserId": {
            "type": "string",
            "format": "uuid",
            "nullable": true
          },
          "ownerDepartmentId": {
            "type": "string",
            "format": "uuid",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Supports.CitizenSupportApplicationDocumentDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "fileName": {
            "type": "string",
            "nullable": true
          },
          "contentType": {
            "type": "string",
            "nullable": true
          },
          "fileSize": {
            "type": "integer",
            "format": "int64"
          },
          "detectedDocumentType": {
            "type": "string",
            "nullable": true
          },
          "hasExtractedText": {
            "type": "boolean"
          },
          "extractionError": {
            "type": "string",
            "nullable": true
          },
          "createdAt": {
            "type": "string",
            "format": "date-time"
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Supports.CitizenSupportApplicationDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "programId": {
            "type": "string",
            "format": "uuid"
          },
          "programName": {
            "type": "string",
            "nullable": true
          },
          "programCode": {
            "type": "string",
            "nullable": true
          },
          "referenceNumber": {
            "type": "string",
            "nullable": true
          },
          "applicantName": {
            "type": "string",
            "nullable": true
          },
          "applicantEmail": {
            "type": "string",
            "nullable": true
          },
          "applicantPhone": {
            "type": "string",
            "nullable": true
          },
          "applicantAddress": {
            "type": "string",
            "nullable": true
          },
          "applicantNote": {
            "type": "string",
            "nullable": true
          },
          "status": {
            "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Enums.CitizenSupportApplicationStatus"
          },
          "completenessStatus": {
            "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Enums.SupportCompletenessStatus"
          },
          "eligibilityAssessment": {
            "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Enums.SupportEligibilityAssessment"
          },
          "aiSummary": {
            "type": "string",
            "nullable": true
          },
          "aiRationale": {
            "type": "string",
            "nullable": true
          },
          "extractedData": {
            "type": "object",
            "additionalProperties": {
              "type": "string"
            },
            "nullable": true
          },
          "missingItems": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "nullable": true
          },
          "assignedDepartment": {
            "type": "string",
            "nullable": true
          },
          "internalComment": {
            "type": "string",
            "nullable": true
          },
          "publicComment": {
            "type": "string",
            "nullable": true
          },
          "decisionDocumentId": {
            "type": "string",
            "format": "uuid",
            "nullable": true
          },
          "aiProcessedAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "decidedAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "createdAt": {
            "type": "string",
            "format": "date-time"
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time"
          },
          "documents": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Supports.CitizenSupportApplicationDocumentDto"
            },
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Supports.CitizenSupportApplicationReceipt": {
        "type": "object",
        "properties": {
          "referenceNumber": {
            "type": "string",
            "nullable": true
          },
          "trackingToken": {
            "type": "string",
            "nullable": true
          },
          "applicationId": {
            "type": "string",
            "format": "uuid"
          },
          "programName": {
            "type": "string",
            "nullable": true
          },
          "submittedAt": {
            "type": "string",
            "format": "date-time"
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Supports.CitizenSupportProgramDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "code": {
            "type": "string",
            "nullable": true
          },
          "name": {
            "type": "string",
            "nullable": true
          },
          "category": {
            "type": "string",
            "nullable": true
          },
          "shortDescription": {
            "type": "string",
            "nullable": true
          },
          "description": {
            "type": "string",
            "nullable": true
          },
          "targetGroupSummary": {
            "type": "string",
            "nullable": true
          },
          "eligibilityRules": {
            "type": "string",
            "nullable": true
          },
          "requiredDocuments": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "nullable": true
          },
          "requiredFields": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "nullable": true
          },
          "extractionPrompt": {
            "type": "string",
            "nullable": true
          },
          "eligibilityPrompt": {
            "type": "string",
            "nullable": true
          },
          "decisionTemplatePrompt": {
            "type": "string",
            "nullable": true
          },
          "department": {
            "type": "string",
            "nullable": true
          },
          "supportAmountText": {
            "type": "string",
            "nullable": true
          },
          "isActive": {
            "type": "boolean"
          },
          "isPublished": {
            "type": "boolean"
          },
          "onlineApplicationEnabled": {
            "type": "boolean"
          },
          "appointmentRecommended": {
            "type": "boolean"
          },
          "validFrom": {
            "type": "string",
            "format": "date",
            "nullable": true
          },
          "validTo": {
            "type": "string",
            "format": "date",
            "nullable": true
          },
          "applicationStart": {
            "type": "string",
            "format": "date",
            "nullable": true
          },
          "applicationEnd": {
            "type": "string",
            "format": "date",
            "nullable": true
          },
          "decisionSourceDocumentId": {
            "type": "string",
            "format": "uuid",
            "nullable": true
          },
          "decisionSourceDocumentTitle": {
            "type": "string",
            "nullable": true
          },
          "requirementsSourceDocumentId": {
            "type": "string",
            "format": "uuid",
            "nullable": true
          },
          "requirementsSourceDocumentTitle": {
            "type": "string",
            "nullable": true
          },
          "createdAt": {
            "type": "string",
            "format": "date-time"
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time"
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Supports.CitizenSupportSummaryDto": {
        "type": "object",
        "properties": {
          "total": {
            "type": "integer",
            "format": "int32"
          },
          "newCount": {
            "type": "integer",
            "format": "int32"
          },
          "needsDocumentsCount": {
            "type": "integer",
            "format": "int32"
          },
          "readyCount": {
            "type": "integer",
            "format": "int32"
          },
          "underReviewCount": {
            "type": "integer",
            "format": "int32"
          },
          "approvedCount": {
            "type": "integer",
            "format": "int32"
          },
          "rejectedCount": {
            "type": "integer",
            "format": "int32"
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Supports.PublicCitizenSupportApplicationStatus": {
        "type": "object",
        "properties": {
          "referenceNumber": {
            "type": "string",
            "nullable": true
          },
          "programName": {
            "type": "string",
            "nullable": true
          },
          "status": {
            "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Enums.CitizenSupportApplicationStatus"
          },
          "completenessStatus": {
            "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Enums.SupportCompletenessStatus"
          },
          "eligibilityAssessment": {
            "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Enums.SupportEligibilityAssessment"
          },
          "aiSummary": {
            "type": "string",
            "nullable": true
          },
          "missingItems": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "nullable": true
          },
          "publicComment": {
            "type": "string",
            "nullable": true
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time"
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Supports.PublicCitizenSupportProgramDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "code": {
            "type": "string",
            "nullable": true
          },
          "name": {
            "type": "string",
            "nullable": true
          },
          "category": {
            "type": "string",
            "nullable": true
          },
          "shortDescription": {
            "type": "string",
            "nullable": true
          },
          "description": {
            "type": "string",
            "nullable": true
          },
          "targetGroupSummary": {
            "type": "string",
            "nullable": true
          },
          "eligibilityRules": {
            "type": "string",
            "nullable": true
          },
          "requiredDocuments": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "nullable": true
          },
          "requiredFields": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "nullable": true
          },
          "department": {
            "type": "string",
            "nullable": true
          },
          "supportAmountText": {
            "type": "string",
            "nullable": true
          },
          "onlineApplicationEnabled": {
            "type": "boolean"
          },
          "appointmentRecommended": {
            "type": "boolean"
          },
          "applicationStart": {
            "type": "string",
            "format": "date",
            "nullable": true
          },
          "applicationEnd": {
            "type": "string",
            "format": "date",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Supports.SaveCitizenSupportProgramRequest": {
        "required": [
          "category",
          "code",
          "department",
          "description",
          "eligibilityRules",
          "name",
          "shortDescription",
          "targetGroupSummary"
        ],
        "type": "object",
        "properties": {
          "code": {
            "maxLength": 80,
            "minLength": 1,
            "type": "string"
          },
          "name": {
            "maxLength": 240,
            "minLength": 1,
            "type": "string"
          },
          "category": {
            "maxLength": 120,
            "minLength": 1,
            "type": "string"
          },
          "shortDescription": {
            "maxLength": 700,
            "minLength": 1,
            "type": "string"
          },
          "description": {
            "maxLength": 8000,
            "minLength": 1,
            "type": "string"
          },
          "targetGroupSummary": {
            "maxLength": 3000,
            "minLength": 1,
            "type": "string"
          },
          "eligibilityRules": {
            "maxLength": 10000,
            "minLength": 1,
            "type": "string"
          },
          "requiredDocuments": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "nullable": true
          },
          "requiredFields": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "nullable": true
          },
          "extractionPrompt": {
            "maxLength": 16000,
            "type": "string",
            "nullable": true
          },
          "eligibilityPrompt": {
            "maxLength": 16000,
            "type": "string",
            "nullable": true
          },
          "decisionTemplatePrompt": {
            "maxLength": 16000,
            "type": "string",
            "nullable": true
          },
          "department": {
            "maxLength": 160,
            "minLength": 1,
            "type": "string"
          },
          "supportAmountText": {
            "maxLength": 500,
            "type": "string",
            "nullable": true
          },
          "isActive": {
            "type": "boolean"
          },
          "isPublished": {
            "type": "boolean"
          },
          "onlineApplicationEnabled": {
            "type": "boolean"
          },
          "appointmentRecommended": {
            "type": "boolean"
          },
          "validFrom": {
            "type": "string",
            "format": "date",
            "nullable": true
          },
          "validTo": {
            "type": "string",
            "format": "date",
            "nullable": true
          },
          "applicationStart": {
            "type": "string",
            "format": "date",
            "nullable": true
          },
          "applicationEnd": {
            "type": "string",
            "format": "date",
            "nullable": true
          },
          "decisionSourceDocumentId": {
            "type": "string",
            "format": "uuid",
            "nullable": true
          },
          "requirementsSourceDocumentId": {
            "type": "string",
            "format": "uuid",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Supports.SubmitCitizenSupportApplicationRequest": {
        "required": [
          "applicantEmail",
          "applicantName"
        ],
        "type": "object",
        "properties": {
          "programId": {
            "type": "string",
            "format": "uuid"
          },
          "applicantName": {
            "maxLength": 160,
            "minLength": 1,
            "type": "string"
          },
          "applicantEmail": {
            "maxLength": 260,
            "minLength": 1,
            "type": "string",
            "format": "email"
          },
          "applicantPhone": {
            "maxLength": 60,
            "type": "string",
            "nullable": true
          },
          "applicantAddress": {
            "maxLength": 500,
            "type": "string",
            "nullable": true
          },
          "applicantNote": {
            "maxLength": 3000,
            "type": "string",
            "nullable": true
          },
          "dataProcessingAccepted": {
            "type": "boolean"
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Supports.UpdateCitizenSupportApplicationRequest": {
        "type": "object",
        "properties": {
          "status": {
            "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Enums.CitizenSupportApplicationStatus"
          },
          "assignedDepartment": {
            "maxLength": 160,
            "type": "string",
            "nullable": true
          },
          "internalComment": {
            "maxLength": 6000,
            "type": "string",
            "nullable": true
          },
          "publicComment": {
            "maxLength": 4000,
            "type": "string",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Users.RoleInfoDto": {
        "type": "object",
        "properties": {
          "key": {
            "type": "string",
            "nullable": true
          },
          "displayName": {
            "type": "string",
            "nullable": true
          },
          "description": {
            "type": "string",
            "nullable": true
          },
          "baseRole": {
            "type": "string",
            "nullable": true
          },
          "isBuiltIn": {
            "type": "boolean"
          },
          "userCount": {
            "type": "integer",
            "format": "int32"
          },
          "permissions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Users.RoleModulePermissionDto"
            },
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Users.RoleModulePermissionDto": {
        "type": "object",
        "properties": {
          "moduleKey": {
            "type": "string",
            "nullable": true
          },
          "moduleName": {
            "type": "string",
            "nullable": true
          },
          "canView": {
            "type": "boolean"
          },
          "canSearch": {
            "type": "boolean"
          },
          "canUseInAi": {
            "type": "boolean"
          },
          "canCreate": {
            "type": "boolean"
          },
          "canEdit": {
            "type": "boolean"
          },
          "canDelete": {
            "type": "boolean"
          },
          "canAiAnalyze": {
            "type": "boolean"
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Users.RoleModulePermissionInput": {
        "type": "object",
        "properties": {
          "moduleKey": {
            "type": "string",
            "nullable": true
          },
          "canView": {
            "type": "boolean"
          },
          "canSearch": {
            "type": "boolean"
          },
          "canUseInAi": {
            "type": "boolean"
          },
          "canCreate": {
            "type": "boolean"
          },
          "canEdit": {
            "type": "boolean"
          },
          "canDelete": {
            "type": "boolean"
          },
          "canAiAnalyze": {
            "type": "boolean"
          }
        },
        "additionalProperties": false
      },
      "OmegaMunicipal.Contracts.Users.UpsertRoleRequest": {
        "required": [
          "baseRole",
          "displayName"
        ],
        "type": "object",
        "properties": {
          "displayName": {
            "maxLength": 160,
            "minLength": 1,
            "type": "string"
          },
          "description": {
            "maxLength": 1000,
            "type": "string",
            "nullable": true
          },
          "baseRole": {
            "minLength": 1,
            "type": "string"
          },
          "permissions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/OmegaMunicipal.Contracts.Users.RoleModulePermissionInput"
            },
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "System.DayOfWeek": {
        "enum": [
          "Sunday",
          "Monday",
          "Tuesday",
          "Wednesday",
          "Thursday",
          "Friday",
          "Saturday"
        ],
        "type": "string"
      }
    },
    "securitySchemes": {
      "Bearer": {
        "type": "http",
        "description": "JWT hozzáférési token.",
        "scheme": "bearer",
        "bearerFormat": "JWT"
      }
    }
  },
  "security": [
    {
      "Bearer": [ ]
    }
  ],
  "tags": [
    {
      "name": "MeetingDrafts",
      "description": "Mobil privát meeting AI-feldolgozás. A draft nem jelenik meg az önkormányzati meeting listában,\r\namíg a felhasználó külön nem publikálja."
    }
  ]
}