verbaStruct engineering

Mit verbaStruct tech erstellen Sie Technische Dokumentationen, Protokolle und Tickets effizient und sicher mit KI-Unterstützung.

🔍 Ausgangsdokumente (z.B. Email)

Mir ist aufgefallen, dass beim Hochladen größerer Dateien (ab ca. 50 MB) im Admin-Bereich gelegentlich ein Timeout kommt. Scheint mit der neuen API-Version zusammenzuhängen – vorher war das kein Problem. Betrifft vermutlich Upload-Endpoint /api/upload/file. Tritt aber nicht jedes Mal auf.

📋 Zielstruktur (Schema)

Titel
Typ
Beschreibung
Reproduktionsschritte
Erwartetes Verhalten
Tatsächliches Verhalten
Betroffene Komponenten
Priorität
Labels / Tags
Angehängte Dateien / Screenshots
Zugewiesene Person / Team

📝 Ergebnis (generiertes Ticket bspw. Jira^®)

Mit diesem generierten Json kann über die API Schnittstelle direkt ein Ticket in Jira^® erstellt werden.

{
 "fields": {
  "project": {
   "key": "PROJ"
  },
  "summary": "Timeout bei Datei-Upload ab 50 MB im Admin-Bereich",
  "description": {
   "type": "doc",
   "version": 1,
   "content": [
    {
     "type": "paragraph",
     "content": [
      {
       "text": "Beim Hochladen von Dateien ≥ 50 MB über den Adminbereich (Endpoint: /api/upload/file) tritt sporadisch ein Timeout-Fehler auf. Dieses Verhalten ist seit Einführung der neuen API-Version (v2.3.0) beobachtbar. Vorher trat das Problem nicht auf.",
       "type": "text"
      }
     ]
    },
    {
     "type": "heading",
     "attrs": {
      "level": 2
     },
     "content": [
      {
       "type": "text",
       "text": "Reproduktionsschritte"
      }
     ]
    },
    {
     "type": "bulletList",
     "content": [
      {
       "type": "listItem",
       "content": [
        {
         "type": "paragraph",
         "content": [
          {
           "type": "text",
           "text": "1. Melde dich als Admin an"
          }
         ]
        }
       ]
      },
      {
       "type": "listItem",
       "content": [
        {
         "type": "paragraph",
         "content": [
          {
           "type": "text",
           "text": "2. Navigiere zu „Dateiverwaltung“ → „Datei hochladen“"
          }
         ]
        }
       ]
      },
      {
       "type": "listItem",
       "content": [
        {
         "type": "paragraph",
         "content": [
          {
           "type": "text",
           "text": "3. Wähle eine Datei mit ≥ 50 MB aus"
          }
         ]
        }
       ]
      },
      {
       "type": "listItem",
       "content": [
        {
         "type": "paragraph",
         "content": [
          {
           "type": "text",
           "text": "4. Klicke auf „Hochladen“"
          }
         ]
        }
       ]
      },
      {
       "type": "listItem",
       "content": [
        {
         "type": "paragraph",
         "content": [
          {
           "type": "text",
           "text": "5. Beobachte Verhalten (Timeout)"
          }
         ]
        }
       ]
      }
     ]
    },
    {
     "type": "heading",
     "attrs": {
      "level": 2
     },
     "content": [
      {
       "type": "text",
       "text": "Erwartetes Verhalten"
      }
     ]
    },
    {
     "type": "paragraph",
     "content": [
      {
       "type": "text",
       "text": "Dateien werden korrekt hochgeladen, Upload-Bestätigung erscheint."
      }
     ]
    },
    {
     "type": "heading",
     "attrs": {
      "level": 2
     },
     "content": [
      {
       "type": "text",
       "text": "Tatsächliches Verhalten"
      }
     ]
    },
    {
     "type": "paragraph",
     "content": [
      {
       "type": "text",
       "text": "Upload endet mit 504 Gateway Timeout nach ca. 10–15 Sekunden (sporadisch)."
      }
     ]
    },
    {
     "type": "heading",
     "attrs": {
      "level": 2
     },
     "content": [
      {
       "type": "text",
       "text": "Betroffene Komponenten"
      }
     ]
    },
    {
     "type": "bulletList",
     "content": [
      {
       "type": "listItem",
       "content": [
        {
         "type": "paragraph",
         "content": [
          {
           "type": "text",
           "text": "upload-service"
          }
         ]
        }
       ]
      },
      {
       "type": "listItem",
       "content": [
        {
         "type": "paragraph",
         "content": [
          {
           "type": "text",
           "text": "API v2.3.0"
          }
         ]
        }
       ]
      },
      {
       "type": "listItem",
       "content": [
        {
         "type": "paragraph",
         "content": [
          {
           "type": "text",
           "text": "Reverse Proxy (Nginx?)"
          }
         ]
        }
       ]
      }
     ]
    }
   ]
  },
  "issuetype": {
   "name": "Bug"
  },
  "priority": {
   "name": "Medium"
  },
  "labels": [
   "bug",
   "upload",
   "timeout",
   "api-v2.3"
  ],
  "components": [
   {
    "name": "Backend Services"
   }
  ],
  "assignee": {
   "name": "backend.team"
  }
 }
}

Diese Textdarstellung dient nur als Beispiel für die generierten Texte. Ein Ticket wird in der Regel direkt an einen Ticket-System (bspw. Jira^®) weitergeleitet.

verbaStruct engineering

🔍 Ausgangsdokumente (z.B. Email)

📋 Zielstruktur (Schema)

📝 Ergebnis (generiertes Ticket bspw. Jira®)

Ticket #123456

📝 Ergebnis (generiertes Ticket bspw. Jira^®)