feat: generate Swagger API documentation for authentication endpoints

docs/docs.go

@@ -708,6 +708,56 @@ const docTemplate = `{
                 }
             }
         },
+        "/geometries/entity": {
+            "get": {
+                "description": "Search entities by name (cursor pagination) and return their linked geometries",
+                "consumes": [
+                    "application/json"
+                ],
+                "produces": [
+                    "application/json"
+                ],
+                "tags": [
+                    "Geometries"
+                ],
+                "summary": "Search geometries by entity name",
+                "parameters": [
+                    {
+                        "type": "string",
+                        "name": "cursor",
+                        "in": "query"
+                    },
+                    {
+                        "maximum": 100,
+                        "minimum": 1,
+                        "type": "integer",
+                        "name": "limit",
+                        "in": "query"
+                    },
+                    {
+                        "maxLength": 255,
+                        "type": "string",
+                        "name": "name",
+                        "in": "query",
+                        "required": true
+                    }
+                ],
+                "responses": {
+                    "200": {
+                        "description": "OK",
+                        "schema": {
+                            "$ref": "#/definitions/history-api_internal_dtos_response.CommonResponse"
+                        }
+                    },
+                    "500": {
+                        "description": "Internal Server Error",
+                        "schema": {
+                            "$ref": "#/definitions/history-api_internal_dtos_response.CommonResponse"
+                        }
+                    }
+                }
+            }
+        },
         "/geometries/{id}": {
             "get": {
                 "description": "Get detailed information about a specific geometry",

docs/swagger.json

@@ -701,6 +701,56 @@
                 }
             }
         },
+        "/geometries/entity": {
+            "get": {
+                "description": "Search entities by name (cursor pagination) and return their linked geometries",
+                "consumes": [
+                    "application/json"
+                ],
+                "produces": [
+                    "application/json"
+                ],
+                "tags": [
+                    "Geometries"
+                ],
+                "summary": "Search geometries by entity name",
+                "parameters": [
+                    {
+                        "type": "string",
+                        "name": "cursor",
+                        "in": "query"
+                    },
+                    {
+                        "maximum": 100,
+                        "minimum": 1,
+                        "type": "integer",
+                        "name": "limit",
+                        "in": "query"
+                    },
+                    {
+                        "maxLength": 255,
+                        "type": "string",
+                        "name": "name",
+                        "in": "query",
+                        "required": true
+                    }
+                ],
+                "responses": {
+                    "200": {
+                        "description": "OK",
+                        "schema": {
+                            "$ref": "#/definitions/history-api_internal_dtos_response.CommonResponse"
+                        }
+                    },
+                    "500": {
+                        "description": "Internal Server Error",
+                        "schema": {
+                            "$ref": "#/definitions/history-api_internal_dtos_response.CommonResponse"
+                        }
+                    }
+                }
+            }
+        },
         "/geometries/{id}": {
             "get": {
                 "description": "Get detailed information about a specific geometry",

docs/swagger.yaml

@@ -1095,6 +1095,40 @@ paths:
       summary: Get geometry by ID
       tags:
       - Geometries
+  /geometries/entity:
+    get:
+      consumes:
+      - application/json
+      description: Search entities by name (cursor pagination) and return their linked
+        geometries
+      parameters:
+      - in: query
+        name: cursor
+        type: string
+      - in: query
+        maximum: 100
+        minimum: 1
+        name: limit
+        type: integer
+      - in: query
+        maxLength: 255
+        name: name
+        required: true
+        type: string
+      produces:
+      - application/json
+      responses:
+        "200":
+          description: OK
+          schema:
+            $ref: '#/definitions/history-api_internal_dtos_response.CommonResponse'
+        "500":
+          description: Internal Server Error
+          schema:
+            $ref: '#/definitions/history-api_internal_dtos_response.CommonResponse'
+      summary: Search geometries by entity name
+      tags:
+      - Geometries
   /historian/application:
     get:
       consumes: