stella-ops.org/git.stella-ops.org
1
0
Fork 0
Code Issues Pull Requests Actions 2 Releases Wiki Activity
Files
d0f2cc3b2cf0dfa4b1ea69737ad5ebd02089fbc6
git.stella-ops.org/docs/features/checked/web/web-gateway-openapi-discovery-with-deprecation-and-idempotency.md
master 9911b7d73c save checkpoint
2026-02-12 21:02:43 +02:00

1.9 KiB
Raw Blame History

Web Gateway OpenAPI Discovery with Deprecation and Idempotency

Module

Web

Status

IMPLEMENTED

Description

Gateway OpenAPI discovery endpoint with ETag caching, standard error envelope migration, cursor pagination normalization, Idempotency-Key support, and deprecation header middleware with Sunset link emission.

Implementation Details

  • Feature directory: src/Web/StellaOps.Web/src/app/core/api/
  • Services:
    • gateway-metrics (src/Web/StellaOps.Web/src/app/core/api/gateway-metrics.service.ts)
    • policy-interop (src/Web/StellaOps.Web/src/app/core/api/policy-interop.service.ts)
    • reachability-integration (src/Web/StellaOps.Web/src/app/core/api/reachability-integration.service.ts)
    • vuln-export-orchestrator (src/Web/StellaOps.Web/src/app/core/api/vuln-export-orchestrator.service.ts)
  • Models:
    • src/Web/StellaOps.Web/src/app/core/api/advisories.models.ts
    • src/Web/StellaOps.Web/src/app/core/api/advisory-ai.models.ts
    • src/Web/StellaOps.Web/src/app/core/api/ai-runs.models.ts
    • src/Web/StellaOps.Web/src/app/core/api/analytics.models.ts
    • src/Web/StellaOps.Web/src/app/core/api/aoc.models.ts
  • Source: SPRINT_0214_0001_0001_web_iii.md

E2E Test Plan

  • Setup:
    • Log in with a user that has appropriate permissions
    • Navigate to the relevant page/section where this feature appears
    • Ensure test data exists (scanned artifacts, SBOM data, or seed data as needed)
  • Core verification:
    • Verify the component renders correctly with sample data
    • Verify interactive elements respond to user input
    • Verify data is fetched and displayed from the correct API endpoints
  • Edge cases:
    • Verify graceful handling when backend API is unavailable (error state)
    • Verify responsive layout at different viewport sizes
    • Verify accessibility (keyboard navigation, screen reader labels, ARIA attributes)