1.9 KiB
1.9 KiB
ADR-API-BASELINE-001 — Current Host OpenAPI baseline scope
Status
Accepted for candidate-baseline work; final release baseline remains evidence-gated.
Date
2026-08-13 (user approval recorded in session)
Decision
Use the current Host's generated 31-operation OpenAPI artifact as the candidate baseline scope for K-ArtSell Aegis. Treat the KBX v60 reference's 66 operations as selective design references only. Do not import reference routes, permissions, DTOs, database tables, or workflows without a separate approved WBS Slice.
Rationale
- Exact operation ID intersection between the current Host and KBX reference is zero.
- The current Host artifact is generated from registered runtime endpoints and is therefore the only available source for current API surface evidence.
- Automatic reference-to-product generation would create route, authorization, DTO, and data-contract drift.
- Candidate and approved baseline are distinct lifecycle states; approval requires preserved artifact, hash, parity output, and API Architect sign-off.
Guardrails
- No automatic order/KIS submission or model promotion path is introduced.
- No client-supplied evidence is trusted as production PIT context.
- No API operation is added solely because it exists in the KBX reference.
- OpenAPI generation runs with Hangfire disabled for deterministic lifecycle behavior.
Evidence
- Candidate:
src/KArtSell.Host/artifacts/openapi/current_20260813_auto-off.json - Generation log:
evidence/AEG-X-008/openapi-generation_20260813_auto-off.log - Prior parity: 31 live operations, 66 KBX reference operations, 0 shared IDs.
Consequences
- API baseline work can proceed against an actual Host surface.
- KBX adoption must continue as bounded FE/BE/component/template slices.
- Release completion remains blocked until the approved baseline is stored at the designated release artifact location and the gate is executed successfully.