ADR-0054: Standalone quiz app owns its authentication and database
Status
Accepted (2026-08-08)Tags
quiz, astro, architecture, better-auth, postgresql, product-boundaryDecision
The certification quiz is an independently deployed Astro application atfrontend/astro/apps/quiz. It owns a dedicated PostgreSQL database and its own
Better Auth configuration, users, sessions, and application routes. It does not
call the Bun or Go backends and does not share the platform authentication or
authorization domain.
This is a deliberate exception to frontend/astro/AGENTS.md, which describes
one main Astro application and requires the platform frontend to route backend
calls through Bun. Those rules still apply to Gremlin platform features; the
quiz is a separate product that only shares repository tooling. Routing it
through Bun or reusing the platform database would couple unrelated users and
data, require proxy and backend modules with no business integration, and make
future independent deployment harder. The cost is a second auth deployment,
database migration path, and operational configuration that the quiz must own.