@startuml
skinparam backgroundColor white
skinparam defaultFontColor black
skinparam ArrowColor #333333
skinparam PackageBorderColor #333333
skinparam PackageBackgroundColor #F7F7F7
skinparam RectangleBorderColor #333333
skinparam RectangleFontColor black
skinparam RectangleBackgroundColor #FFF4E6
title Before: Docs/OpenAPI Route Drift

actor "Developer" as Dev

package "Runtime (Rust Server)" #E8F4FD {
  rectangle "Plugin/Core Routes\n- Admin email/template/failure routes\n- Admin audit/client routes\n- API/session/passkey/org routes" as RuntimeRoutes #D6EBFF
}

package "Repository Docs" #FFF8E1 {
  rectangle "README.md\nCoverage tables" as Readme #FFEFC6
  rectangle "openapi.yaml\nLegacy /auth/* subset" as OpenApiLegacy #FFD5D5
  rectangle "athena-auth.yaml\nCanonical full route spec" as CanonicalSpec #E9D5FF
  rectangle "examples/README.md\nWarns openapi.yaml may be legacy" as ExamplesReadme #FFEFC6
}

Dev --> Readme : checks documented routes
Dev --> OpenApiLegacy : exports clients
RuntimeRoutes -down-> Readme : partial coverage
RuntimeRoutes -down-> OpenApiLegacy : severe mismatch
CanonicalSpec -down-> RuntimeRoutes : aligned via tests
ExamplesReadme -down-> OpenApiLegacy : stale warning

note right of OpenApiLegacy
Missing many live endpoints,
including admin email-template,
email-failure, and admin audit/client routes.
end note
@enduml
