Richard/Deploymentcenter
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat(2.7.0): Roadmap im DC, Testinstanz mit Testtor, Supervisor und MCP

Browse Source 
Sammelcommit fuer den ueber mehrere Sitzungen gewachsenen, bisher nicht
eingecheckten Stand. Getrennte Commits waeren ehrlicher gewesen, sind es
nachtraeglich aber nicht mehr: BugRepo, changelog.json und die Doku tragen
Aenderungen aus allen Straengen gleichzeitig, und keine Zwischenstufe waere
lauffaehig.

ROADMAP IM DEPLOYMENTCENTER (2.7.0)

Planungsstand, Reihenfolge und Zustaendigkeit lagen in handgepflegten
Markdown-Dateien neben einem Bugtracker, der genau diese drei Dinge bereits
fuehrt. Zwei Pfleger fuer dasselbe Feld - Drift war eine Frage der Zeit.

Ab jetzt: Zustand im DC, Begruendung in der Datei. Kein Feld hat zwei Pfleger.

  - Migration 016: epic, roadmap_rank, target_build, defer_trigger,
    doc_anchor, Status "deferred", Tabelle roadmap_epics.
    KEINE Roadmap-Tabelle - ein Eintrag ist ein bugtracker_item.
  - Zugehoerigkeit ist ein Feld: Ein Item steht auf der Roadmap, wenn es ein
    epic hat. Ein zweites Kennzeichen daneben koennte auseinanderlaufen.
  - Kennung ist die Item-ID. Handvergebene Kuerzel ("A12") erzeugen die
    schlimmste Fehlerart: Beide Seiten stimmig, Verschiedenes gemeint, weil
    die Kennung nach einer Loeschung neu vergeben wurde.
  - Zurueckstellen verlangt defer_trigger. Ohne benannten Anlass ist ein
    Vorhaben nicht zurueckgestellt, sondern vergessen. Die Regel sitzt im
    Repository, damit sie auf allen drei Schreibwegen gleich greift.
  - Modules/Bugtracker/Roadmap.php, /api/bugtracker/v1/roadmap.php,
    WebUI-Modul mit Filtern, cli/roadmap.php --write/--check,
    dc_roadmap und dc_roadmap_set im MCP-Adapter.
  - cli/roadmap.php --write ERZEUGT den Zustandsteil der Markdown-Datei;
    --check prueft nur die Prosa. Was erzeugt wird, kann nicht driften.
  - docs/ROADMAP_MIGRATION.md: Uebernahme fuer die anderen Projekte.

TESTINSTANZ UND TESTTOR

  - dc-dev.mhdf.de: zweite Installation, eigene DB, eigene Schluessel,
    Basic-Auth davor, Rocket.Chat aus.
  - 124 Testfaelle in tests/e2e gegen API, Rechte, Migrationen, Sperre.
  - scripts/deploy.py bringt vor jedem Upload erst den anstehenden Stand auf
    die Testinstanz und laesst dann den Testlauf laufen. Erst bei
    Rueckgabewert 0 geht etwas auf die Produktion (--ohne-test als Notausgang).
    Andersherum prueft der Lauf aelteren Code als den, der gleich hochgeht.
  - tests/ ist aus dem Produktiv-Deploy ausgeschlossen; testctl.php kann
    nicht versehentlich auf dc.mhdf.de landen.
  - Ein Lauf mit mehr uebersprungenen als geprueften Faellen endet mit
    Rueckgabewert 2 statt 0. Nichts ist kaputt, geprueft wurde es aber auch
    nicht - der Unterschied darf nicht am Rueckgabewert verschwinden.

SUPERVISOR, PROJEKTLANDSCHAFT, NACHPRUEFUNG (2.6.0/2.6.1)

  - Migration 013: projektuebergreifend melden (dev_agent, evidence,
    triage_external, affects).
  - Migration 014: supervisor_findings, Katalog, fuenf serverseitige
    Detektoren im Tick.
  - Migration 015: Nachpruefung als Arbeitsschlange statt Benachrichtigung.
  - DEV-Lizenzschluessel zur Selbstbedienung, dc-testkit fuer die Test-VM.
  - MCP-Adapter: 15 Werkzeuge, ohne Fremdabhaengigkeiten, mit Abgrenzung
    von Fremddaten gegen Prompt-Injektion.

BEHOBEN

  - observe und status im Supervisor legten den Zustand des Befundes als
    "status" in die Antwort. Http::ok() merged ['status' => 'success']
    darunter, also gewann der Befundzustand - eine angenommene Meldung kam
    als status="open" an. Heisst jetzt finding_status. War Item #59.

Migrationen 013-016 sind auf dem Produktivserver noch NICHT ausgefuehrt.
Ohne sie bricht das WebUI, weil die Roadmap-Ansicht bei jedem Seitenaufruf
gegen bugtracker_items.epic abfragt.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
Deploymentcenter Bot
2026-08-29 21:59:20 +02:00
co-authored by Claude Opus 5
parent 9d0261306c
commit 1d5ac92051
52 changed files with 15261 additions and 103 deletions
Download Patch File Download Diff File Expand all files Collapse all files
public/api/openapi.php
+329 -2
View File
@@ -15,6 +15,7 @@ require_once __DIR__ . '/../../src/bootstrap.php';
use Deploymentcenter\Core\Config;
use Deploymentcenter\Core\Http;
use Deploymentcenter\Modules\Bugtracker\BugRepo;
use Deploymentcenter\Modules\Supervisor\FindingRepo;
use Deploymentcenter\Modules\Watchdog\EventLog;
use Deploymentcenter\Core\TokenManager;
@@ -118,6 +119,21 @@ $spec = [
'file_path' => ['type' => 'string'],
'line_no' => ['type' => 'integer'],
'context' => ['type' => 'object', 'description' => 'Beliebiger strukturierter Zusatzkontext'],
'evidence' => [
'type' => 'string',
'minLength' => 40,
'description' =>
'Pflicht, wenn project_slug ein fremdes Projekt bezeichnet: was wurde '
. 'beobachtet, und warum liegt die Ursache dort und nicht im eigenen '
. 'Projekt? Wird bei einer Meldung ins eigene Projekt ignoriert.',
],
'reported_from' => [
'type' => 'string',
'readOnly' => true,
'description' =>
'Herkunft der Meldung. Wird vom Server aus der Token-Bindung '
. 'abgeleitet; ein Wert im Body wird verworfen.',
],
],
],
'Release' => [
@@ -226,7 +242,38 @@ $spec = [
'post' => [
'tags' => ['Bugtracker'],
'summary' => 'Bug, Feature Request oder Idee melden',
'description' => 'Benoetigt den Scope bugtracker:report. Gleiche Fehler werden automatisch zusammengefasst und hochgezaehlt.',
'description' =>
"Benoetigt den Scope bugtracker:report. Gleiche Fehler werden automatisch "
. "zusammengefasst und hochgezaehlt.\n\n"
. "**Meldung gegen ein fremdes Projekt.** Ein Token vom Typ dev_agent "
. "(Werkbank-Token: Claude Code, MCP-Adapter, CI) darf project_slug auf ein "
. "anderes Projekt setzen - etwa wenn beim Integrieren des SDK ein Fehler im "
. "Deploymentcenter selbst auffaellt. Laufzeit-Token duerfen das nicht; sie "
. "stecken im ausgelieferten Client und sind extrahierbar.\n\n"
. "Fuer solche Meldungen gilt:\n"
. "- `evidence` ist Pflicht (mindestens 40 Zeichen): was wurde beobachtet, "
. "und warum liegt die Ursache dort und nicht im eigenen Projekt?\n"
. "- `reported_from` wird aus der Token-Bindung abgeleitet und aus dem Body "
. "ignoriert - die Herkunft ist bezeugt, nicht behauptet.\n"
. "- Das Item landet im Status `triage_external` und zaehlt erst nach "
. "Bestaetigung in die Statistik.\n"
. "- Der Schweregrad wird auf `medium` gedeckelt; `high` und `critical` "
. "vergibt die empfangende Seite.\n"
. "- Meldet ein zweites Projekt dieselbe Sache, entsteht kein neues Item - "
. "es waechst die Liste der Betroffenen (`affects`).\n\n"
. "**Schicke immer `build_version`.** Trifft die Meldung auf ein bereits "
. "behobenes Item, entscheidet der Vergleich mit dessen `resolved_in_build` "
. "ueber drei sehr verschiedene Ausgaenge - ohne die Angabe faellt die "
. "Entscheidung im Zweifel auf den unguenstigsten:\n"
. "- **aeltere Fassung als der Fix** -> es passiert nichts. Die Antwort traegt "
. "`known_fixed_in`, kein Item wird angelegt und kein Zaehler erhoeht. "
. "Aktualisieren und erneut pruefen.\n"
. "- **Fix war noch nicht bestaetigt** (`resolved`, `awaiting_verification`, "
. "`in_verification`) -> das bestehende Item wechselt auf `fix_insufficient` "
. "und liegt wieder in der Arbeitsschlange. `fix_insufficient: true` in der "
. "Antwort. Kein neues Item: Versuch und Fehlschlag gehoeren auf einen Strang.\n"
. "- **Item war bestaetigt geschlossen** -> Regression, neues Item mit "
. "`regression_of` auf das alte.",
'requestBody' => [
'required' => true,
'content' => ['application/json' => ['schema' => ['$ref' => '#/components/schemas/ReportRequest']]],
@@ -234,7 +281,9 @@ $spec = [
'responses' => [
'201' => ['description' => 'Neu angelegt'],
'200' => ['description' => 'Bestehendes Item aktualisiert (Duplikat oder Idempotenz-Treffer)'],
'400' => $errorResponse,
'401' => $errorResponse,
'403' => $errorResponse,
'429' => $errorResponse,
],
],
@@ -300,7 +349,14 @@ $spec = [
'get' => [
'tags' => ['Bugtracker'],
'summary' => 'Projekte auflisten (Discovery)',
'description' => 'Benoetigt den Scope bugtracker:read.',
'description' =>
"Benoetigt den Scope bugtracker:read.\n\n"
. "Jeder Eintrag traegt `relation`: wie das Projekt mit dem eigenen "
. "zusammenhaengt (`uses_sdk`, `depends_on`, `shares_code`, Richtung und "
. "integrierte Fassung). `null` heisst schlicht: gar nicht.\n\n"
. "Ein Laufzeit-Token sieht nur sein eigenes Projekt. Ein Werkbank-Token "
. "(dev_agent) sieht alle - es soll ja entscheiden koennen, wohin ein "
. "Fehler gehoert, und dafuer muss es die Nachbarn kennen.",
'responses' => ['200' => ['description' => 'Projektliste'], '401' => $errorResponse],
],
],
@@ -350,6 +406,169 @@ $spec = [
],
],
'/api/bugtracker/v1/roadmap.php' => [
'get' => [
'tags' => ['Bugtracker'],
'summary' => 'Roadmap lesen',
'description' =>
"Scope bugtracker:read.\n\n"
. "**Keine eigene Datenhaltung.** Ein Roadmap-Eintrag ist ein "
. "bugtracker_item mit gesetztem `epic`; dieser Endpunkt ist die Sicht "
. "darauf. Angelegt wird ueber `/report`, abgeschlossen ueber `/manage`.\n\n"
. "- `action=list` Eintraege, nach Bereich und Reihenfolge sortiert\n"
. "- `action=epics` Themenbereiche samt Zaehlung je Lage\n"
. "- `action=next` die vorderen Eintraege der Warteschlange\n"
. "- `action=active` wer haelt gerade welches Item\n"
. "- `action=render` der erzeugte Markdown-Block fuer die Projektdatei\n"
. "- `action=check` Abgleich einer mitgeschickten Datei (`content`) gegen "
. "die Items\n\n"
. "`status` nimmt eine Lage statt eines ENUM-Werts: `aktiv`, `offen`, "
. "`arbeit`, `erledigt`, `zurueckgestellt`, `verworfen`. Einzelstatus "
. "funktionieren weiterhin.",
'parameters' => [
['name' => 'action', 'in' => 'query', 'schema' => ['type' => 'string', 'enum' => ['list', 'epics', 'next', 'active', 'render', 'check'], 'default' => 'list']],
['name' => 'project_slug', 'in' => 'query', 'schema' => ['type' => 'string']],
['name' => 'epic', 'in' => 'query', 'schema' => ['type' => 'string'], 'description' => 'Themenbereich, z. B. "A"'],
['name' => 'status', 'in' => 'query', 'schema' => ['type' => 'string'], 'description' => 'Lage oder kommagetrennte Einzelstatus'],
['name' => 'target_build', 'in' => 'query', 'schema' => ['type' => 'string']],
['name' => 'claimed_by', 'in' => 'query', 'schema' => ['type' => 'string']],
['name' => 'q', 'in' => 'query', 'schema' => ['type' => 'string'], 'description' => 'Volltextsuche'],
['name' => 'limit', 'in' => 'query', 'schema' => ['type' => 'integer', 'default' => 200, 'maximum' => 500]],
],
'responses' => ['200' => ['description' => 'Roadmap-Eintraege bzw. Bereiche'], '401' => $errorResponse],
],
'post' => [
'tags' => ['Bugtracker'],
'summary' => 'Roadmap-Angaben setzen',
'description' =>
"Scope bugtracker:manage. Nur im eigenen Projekt - fremde Planung wird "
. "nicht umsortiert.\n\n"
. "- `action=set&id=` setzt `epic`, `roadmap_rank`, `target_build`, "
. "`defer_trigger`, `doc_anchor` und optional `status`\n"
. "- `action=move&id=` schiebt einen Eintrag eine Position (`direction=up|down`)\n"
. "- `action=reorder` vergibt die Reihenfolge eines Bereichs neu (`epic`, `ids[]`)\n"
. "- `action=epic` legt einen Themenbereich an oder aendert ihn\n\n"
. "**Zurueckstellen verlangt einen Ausloeser.** `status=deferred` ohne "
. "`defer_trigger` wird mit 400 abgelehnt: Ohne benannten Anlass ist ein "
. "Vorhaben nicht zurueckgestellt, sondern vergessen.",
'parameters' => [
['name' => 'action', 'in' => 'query', 'required' => true, 'schema' => ['type' => 'string', 'enum' => ['set', 'move', 'reorder', 'epic']]],
['name' => 'id', 'in' => 'query', 'schema' => ['type' => 'integer']],
],
'responses' => [
'200' => ['description' => 'Erfolg'],
'400' => ['description' => 'Regelverletzung, etwa Zurueckstellen ohne Ausloeser'],
'403' => ['description' => 'Item gehoert einem anderen Projekt'],
'401' => $errorResponse,
],
],
],
'/api/supervisor/v1/observe' => [
'post' => [
'tags' => ['Supervisor'],
'summary' => 'Befund einliefern',
'description' =>
"Scope supervisor:report.\n\n"
. "Ein Befund ist keine Fehlermeldung. Er behauptet nicht, dass etwas kaputt "
. "ist, sondern dass etwas ungewoehnlich ist - deshalb loest er keine "
. "Benachrichtigung aus. Die Einstufung trifft die empfangende Seite, die den "
. "Flottenblick hat; `severity_hint` heisst darum Hinweis und nicht "
. "Schweregrad.\n\n"
. "`client_ref` bewusst aus Detektor, Gegenstand und Fassung bauen statt "
. "zufaellig zu erzeugen: derselbe Befund darf beliebig oft gemeldet werden "
. "und erhoeht dann nur den Zaehler. Ein Beobachter, der minuetlich nachsieht, "
. "legt sonst 1.440 Eintraege am Tag an. Fehlt das Feld, baut der Server es "
. "selbst zusammen.\n\n"
. "Die Liste gueltiger Detektornamen liefert `?action=catalog`. Ein "
. "unbekannter Name wird angenommen, in der Antwort aber mit "
. "`known_detector: false` gekennzeichnet - stilles Verwerfen waere "
. "schlimmer, denn dann suchte jemand nach Befunden, die nie ankamen.",
'requestBody' => [
'required' => true,
'content' => ['application/json' => ['schema' => [
'type' => 'object',
'required' => ['detector'],
'properties' => [
'project_slug' => ['type' => 'string'],
'detector' => ['type' => 'string', 'example' => 'trend.monotonic'],
'subject' => ['type' => 'string', 'example' => 'memory.working_set'],
'instance' => ['type' => 'string', 'example' => 'kunde-4711/app-01'],
'severity_hint' => ['type' => 'string', 'enum' => FindingRepo::SEVERITY_HINTS],
'observed' => ['type' => 'object', 'description' => 'Was wurde gemessen?'],
'baseline' => ['type' => 'object', 'description' => 'Wogegen?'],
'build' => ['type' => 'string'],
'commit_sha' => ['type' => 'string'],
'environment' => ['type' => 'string', 'enum' => FindingRepo::ENVIRONMENTS],
'client_ref' => ['type' => 'string'],
],
]]],
],
'responses' => [
'201' => ['description' => 'Neuer Befund - finding_id, finding_status, '
. 'occurrence_count, known_detector'],
'200' => ['description' => 'Bekannter Befund, Zaehler erhoeht'],
'400' => $errorResponse,
'401' => $errorResponse,
'429' => $errorResponse,
],
],
],
'/api/supervisor/v1/findings' => [
'get' => [
'tags' => ['Supervisor'],
'summary' => 'Befunde abfragen',
'description' =>
"Scope supervisor:read. Filter: project_slug, detector, status, instance, "
. "build, environment, since, limit, offset.\n\n"
. "`detector` nimmt auch einen Familiennamen: \"deviation\" liefert "
. "deviation.self und deviation.fleet.\n\n"
. "`status` ist standardmaessig \"active\" (open und acknowledged).",
'responses' => ['200' => ['description' => 'Befundliste'], '401' => $errorResponse],
],
],
'/api/supervisor/v1/summary' => [
'get' => [
'tags' => ['Supervisor'],
'summary' => 'Befunde je Detektor zaehlen',
'description' => 'Scope supervisor:read. Der Ueberblick vor dem Einzelbefund.',
'responses' => ['200' => ['description' => 'Zaehlung'], '401' => $errorResponse],
],
],
'/api/supervisor/v1/catalog' => [
'get' => [
'tags' => ['Supervisor'],
'summary' => 'Detektor-Katalog',
'description' =>
"Scope supervisor:read. Alle bekannten Detektoren mit Herkunft (client oder "
. "server), wonach sie suchen und was sie dafuer brauchen.\n\n"
. "Die Namen sind stabil und wandern nicht - nur so bleiben Befunde aus "
. "verschiedenen Projekten vergleichbar.",
'responses' => ['200' => ['description' => 'Katalog'], '401' => $errorResponse],
],
],
'/api/supervisor/v1/status' => [
'post' => [
'tags' => ['Supervisor'],
'summary' => 'Befund einstufen',
'description' =>
"Scope supervisor:manage - bewusst getrennt von supervisor:report. Ein "
. "Beobachter auf Kundenhardware darf melden, aber nicht entscheiden, dass "
. "seine eigene Meldung erledigt ist.\n\n"
. "Status: open, acknowledged, promoted, resolved, ignored.",
'responses' => [
'200' => ['description' => 'Geaendert'],
'400' => $errorResponse,
'401' => $errorResponse,
'404' => $errorResponse,
],
],
],
'/api/updateservice/v1/check' => [
'get' => [
'tags' => ['UpdateService'],
@@ -663,6 +882,64 @@ $spec = [
],
],
'/api/setup/v1/agent' => [
'post' => [
'tags' => ['Setup'],
'summary' => 'Watchdog-Agent fuer die Maschine selbst',
'description' =>
"Scope `setup:install`. Legt den Monitor an, stellt ein Token mit genau "
. "`watchdog:ping` aus und liefert das fertige Skript fuer diesen Host - "
. "Shell unter Linux, PowerShell unter Windows.\n\n"
. "Gedacht fuer den Installer, der ohnehin auf dem Zielsystem laeuft: der Weg "
. "ueber die Oberflaeche verlangte Monitor anlegen, Token erzeugen, Skript "
. "herunterladen, kopieren und einplanen - fuenf Schritte an einem anderen "
. "Rechner.\n\n"
. "Einen bereits vorhandenen Monitor gleichen Namens lehnt der Endpunkt mit "
. "`409 monitor_exists` ab. Sonst uebernaehme eine zweite Maschine "
. "stillschweigend die Historie der ersten; `overwrite: true` erlaubt es "
. "ausdruecklich.\n\n"
. "Das Skript enthaelt das Token im Klartext und wird nur einmal ausgeliefert.",
'requestBody' => [
'required' => true,
'content' => ['application/json' => ['schema' => [
'type' => 'object',
'required' => ['project', 'source'],
'properties' => [
'project' => ['type' => 'string', 'description' => 'Produkt, an das das Token gebunden wird.'],
'source' => ['type' => 'string', 'description' => 'Name des Monitors im Dashboard.'],
'os' => ['type' => 'string', 'enum' => ['linux', 'windows'], 'default' => 'linux'],
'interval' => ['type' => 'integer', 'default' => 60, 'description' => 'Erwarteter Abstand der Heartbeats in Sekunden (30 bis 3600).'],
'group' => ['type' => 'string', 'description' => 'Gruppierung im Dashboard.'],
'parent' => ['type' => 'string', 'description' => 'Uebergeordneter Monitor, etwa der Hypervisor.'],
'overwrite' => ['type' => 'boolean', 'default' => false, 'description' => 'Einen bestehenden Monitor gleichen Namens uebernehmen.'],
],
]]],
],
'responses' => [
'201' => [
'description' => 'Monitor eingerichtet, Skript enthaelt das Token',
'content' => ['application/json' => ['schema' => [
'type' => 'object',
'properties' => [
'source' => ['type' => 'string'],
'os' => ['type' => 'string'],
'filename' => ['type' => 'string'],
'script' => ['type' => 'string'],
'schedule' => ['type' => 'string', 'description' => 'Einplanungsbefehl; {PFAD} steht fuer den Ablageort.'],
'interval' => ['type' => 'integer'],
'token_id' => ['type' => 'string'],
'existing' => ['type' => 'boolean'],
],
]]],
],
'401' => $errorResponse,
'403' => $errorResponse,
'404' => $errorResponse,
'409' => $errorResponse,
],
],
],
'/api/watchdog/v1/ping' => [
'post' => [
'tags' => ['Watchdog'],
@@ -874,6 +1151,56 @@ $spec = [
],
],
'/api/license/v1/dev-key' => [
'post' => [
'tags' => ['Lizenz'],
'summary' => 'Entwicklungsschluessel abholen (Selbstbedienung)',
'description' =>
"Scope `license:dev`. Gedacht fuer Werkbank-Token auf Testmaschinen.\n\n"
. "**Antwortet im Hausformat** (`status: \"success\"`) - anders als `validate` und "
. "`deactivate` daneben, die ihr abweichendes Altformat behalten.\n\n"
. "**Der Aufruf ist wiederholbar.** Fuer dieselbe Kombination aus `project_slug` "
. "und `instance_id` kommt derselbe Schluessel zurueck und seine Frist wird "
. "verlaengert. Ein Testskript darf ihn deshalb an den Anfang jedes Laufs setzen, "
. "ohne bei jedem Lauf einen weiteren Schluessel zu hinterlassen. `created` sagt, "
. "ob er neu ist.\n\n"
. "Der ausgestellte Schluessel ist eine gewoehnliche Lizenz: befristet (Vorgabe 30 "
. "Tage, einstellbar ueber `license.dev_ttl_days`), mit wenigen Aktivierungen, und "
. "in `customer_email` als Testschluessel markiert. Er oeffnet damit auch die "
. "Release-Ablage des Produkts - die `.htpasswd` wird beim Ausstellen sofort "
. "nachgezogen.\n\n"
. "Projektgebundene Token kommen nur an ihr eigenes Projekt; die Ausnahme fuer "
. "Werkbank-Token gilt hier **nicht**. Ein Lizenzschluessel oeffnet Pakete, eine "
. "Meldung tut das nicht.\n\n"
. "Zum Zurueckgeben `action_mode: \"revoke\"` senden. Abgelaufene Schluessel "
. "verschwinden ohnehin von selbst.\n\n"
. "Begrenzt auf 10 Anfragen pro Minute und IP, und auf 12 gleichzeitig gueltige "
. "Schluessel je Projekt.",
'requestBody' => [
'required' => true,
'content' => ['application/json' => ['schema' => [
'type' => 'object',
'required' => ['project_slug', 'instance_id'],
'properties' => [
'project_slug' => ['type' => 'string', 'description' => 'Slug aus dc_projects.'],
'instance_id' => ['type' => 'string', 'example' => 'testvm', 'description' => 'Kennung der Maschine. Ueber sie findet ein wiederholter Aufruf denselben Schluessel wieder; ein FQDN wird auf den kurzen Namen gekuerzt.'],
'ttl_days' => ['type' => 'integer', 'example' => 30, 'description' => 'Gewuenschte Laufzeit, begrenzt auf 90 Tage.'],
'action_mode' => ['type' => 'string', 'enum' => ['issue', 'revoke'], 'default' => 'issue'],
],
]]],
],
'responses' => [
'200' => ['description' => 'Bestehender Schluessel verlaengert oder zurueckgegeben'],
'201' => ['description' => 'Neuer Schluessel ausgestellt'],
'400' => $errorResponse,
'401' => $errorResponse,
'403' => $errorResponse,
'409' => $errorResponse,
'429' => $errorResponse,
],
],
],
'/api/license/v1/status' => [
'get' => [
'tags' => ['Lizenz'],