ADR-0054: Standalone quiz app owns its authentication and database

Status

Accepted (2026-08-08)

Tags

quiz, astro, architecture, better-auth, postgresql, product-boundary

Decision

The certification quiz is an independently deployed Astro application at frontend/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.