Audit conformitate Standard API

Acest conținut nu este încă disponibil în limba selectată.

Standard sursă și checklist: skill-ul standard-api (CU-API-003..006) — încarcă-l înainte de pasul 1.

Pași

Inventariază țintele: specuri OpenAPI din 03-development/ (*openapi*.json|yaml|yml) și/sau un base URL live. Scanare:

python3 .claude/skills/api-standard-audit/scripts/api_audit.py --scan 03-development --out .workplace/state/api-audit.json
# sau un singur spec / live:
python3 .claude/skills/api-standard-audit/scripts/api_audit.py --spec path/to/openapi.json
python3 .claude/skills/api-standard-audit/scripts/api_audit.py --base-url https://host --live

Interpretează raportul (PASS/WARN/FAIL per regulă, per serviciu): structură URL, zone, fără-verbe, operaționale, RFC7807, OpenAPI valid, operationId, versionare.
Propune ajustări concrete pentru fiecare FAIL/WARN (ex. redenumiri de căi, endpoint-uri lipsă). Nu doar „e greșit” — spune exact ce să schimbe.
Issue-uri GitLab (gitlab-sync): câte un issue type:api-conformance per serviciu cu abateri, label block:C, cu lista de propuneri. Idempotent (nu dubla la re-rulare).
Evoluția standardului: dacă observi pattern-uri recurente care ar justifica o schimbare a standardului, propune-o separat pentru aprobarea govstack-architect/teamlead (batch), nu o aplica singur.
Checkpoint + actualizează .workplace/state/api-audit.json.

Cadență (regula periodică)

config/workplace.json → governance.api_audit_cadence (default „weekly”). Orchestratorul rulează /api-audit la fiecare ciclu de guvernanță și auditul rulează automat în CI (vezi 03-development/ci-templates/api-conformance.gitlab-ci.yml).

Severitate

FAIL (MUST încălcat): blochează în CI, issue obligatoriu.
WARN (SHOULD / neverificabil static): issue de follow-up.
PASS: conform.