Files
git.stella-ops.org/docs/features/checked/concelier/concelier-deprecation-headers-middleware.md
2026-02-13 02:04:55 +02:00

1.7 KiB

Concelier Deprecation Headers Middleware

Module

Concelier

Status

VERIFIED

Description

HTTP deprecation headers middleware for Concelier API endpoints, signaling API version lifecycle to consumers. Not in the known list.

Implementation Details

  • Modules: src/Concelier/StellaOps.Concelier.WebService/Deprecation/
  • Key Classes:
    • DeprecationMiddleware (src/Concelier/StellaOps.Concelier.WebService/Deprecation/DeprecationMiddleware.cs) - ASP.NET Core middleware that adds HTTP deprecation headers to responses
    • DeprecationMiddlewareExtensions (src/Concelier/StellaOps.Concelier.WebService/Deprecation/DeprecationMiddleware.cs) - extension methods for middleware registration
    • DeprecationMiddlewareRegistration (src/Concelier/StellaOps.Concelier.WebService/Deprecation/DeprecationMiddleware.cs) - DI registration helpers
  • Source: Sprint 0116 (batch_14/file_17.md)

E2E Test Plan

  • Call a deprecated API endpoint and verify the response includes Deprecation and Sunset HTTP headers
  • Call a non-deprecated endpoint and verify no deprecation headers are present
  • Verify the deprecation date format conforms to RFC 7231
  • Verify middleware registration: confirm DeprecationMiddleware is in the ASP.NET Core pipeline

Verification

  • Run ID: run-001
  • Date: 2026-02-13
  • Result: PASS - WebService.Tests 215/215 passed. 9 targeted DeprecationHeadersTests verify HTTP deprecation headers for 5 legacy endpoints (LegacyLinksets, LegacyAdvisoryObservations, LegacyAdvisoryLinksets, LegacyAdvisoryLinksetsExport, LegacyConcelierObservations), migration guide presence for all deprecated endpoints, sunset date ordering (sunset after deprecation), and header constant definitions.