How akshat-shukla18/scalable-auth works
This is a web authentication and session-management platform. The main workflow runs from browser registration and email verification through login, token refresh, and session management; the API persists identity/session state and queues verification email for background delivery. Separate branches provide distributed rate limiting and operational health/metrics. The README documents broader scaling and security capabilities, but the supplied tree does not include the reverse-proxy or deployment configuration, so those runtime components are not mapped.
Main entry points: client.ts API client · App.tsx Web application · app.ts HTTP application · auth.routes.ts Auth routes
Components 26
Web client
- Web application
apps/web/src/App.tsx - Auth context
apps/web/src/context/AuthContext.tsx - API client
apps/web/src/api/client.ts - Auth pages
apps/web/src/pages/RegisterPage.tsx - Session dashboard
apps/web/src/pages/DashboardPage.tsx - Observability UI
apps/web/src/pages/ObservabilityPage.tsx
API and identity
- HTTP application
apps/api/src/app.ts - Auth routes
apps/api/src/modules/auth/auth.routes.ts - Auth controller
apps/api/src/modules/auth/auth.controller.ts - Auth service
apps/api/src/modules/auth/auth.service.ts - Auth repository
apps/api/src/modules/auth/auth.repository.ts - Session routes
apps/api/src/modules/sessions/session.routes.ts - Session controller
apps/api/src/modules/sessions/session.controller.ts - Session service
apps/api/src/modules/sessions/session.service.ts - Authentication middleware
apps/api/src/middleware/authenticate.ts - Rate limiting
apps/api/src/middleware/rate-limiter.ts - Shared auth contracts
packages/shared/src/schemas/auth.schema.ts
Email delivery
- Email job queue
apps/api/src/queues/email.queue.ts - Email worker
apps/api/src/workers/email.worker.ts - Email providers
apps/api/src/services/email/email.factory.ts - Dev mailbox
apps/api/src/modules/dev/dev.routes.ts
Shared state
- PostgreSQL
apps/api/src/database/prisma.ts - Redis
apps/api/src/redis/redis.ts
Operations
- System endpoints
apps/api/src/modules/system/system.routes.ts - Health and metrics
apps/api/src/modules/system/system.controller.ts
Other components
- Browser user
Connections 36
- Browser user → Web application: uses
apps/web/src/App.tsx - Web application → Auth pages: routes to
apps/web/src/App.tsx - Web application → Session dashboard: routes to
apps/web/src/App.tsx - Web application → Observability UI: routes to
apps/web/src/App.tsx - Web application → Auth context: provides auth
apps/web/src/App.tsx - Auth pages → Auth context: updates auth
apps/web/src/pages/RegisterPage.tsx - Auth pages → API client: calls API
apps/web/src/pages/RegisterPage.tsx - Session dashboard → API client: calls API
apps/web/src/pages/DashboardPage.tsx - Observability UI → API client: fetches metrics
apps/web/src/pages/ObservabilityPage.tsx - Auth context → API client: restores session
apps/web/src/context/AuthContext.tsx - API client → HTTP application: HTTP requests
- HTTP application → Auth routes: mounts
apps/api/src/app.ts - HTTP application → Session routes: mounts
apps/api/src/app.ts - HTTP application → System endpoints: mounts
apps/api/src/app.ts - HTTP application → Dev mailbox: mounts in dev
apps/api/src/app.ts - Auth routes → Auth controller: dispatches
apps/api/src/modules/auth/auth.routes.ts - Auth controller → Auth service: delegates to
apps/api/src/modules/auth/auth.controller.ts - Auth service → Auth repository: reads and writes
apps/api/src/modules/auth/auth.service.ts - Auth repository → PostgreSQL: queries
apps/api/src/modules/auth/auth.repository.ts - Auth service → Email job queue: queues verification
apps/api/src/modules/auth/auth.service.ts - Email job queue → Redis: stores jobs
- Email worker → Email providers: dispatches email
apps/api/src/workers/email.worker.ts - Dev mailbox → Email providers: inspects mock inbox
apps/api/src/modules/dev/dev.routes.ts - Session routes → Session controller: dispatches
apps/api/src/modules/sessions/session.routes.ts - Session controller → Session service: delegates to
apps/api/src/modules/sessions/session.controller.ts - Session service → Auth repository: uses session data
apps/api/src/modules/sessions/session.service.ts - Session routes → Authentication middleware: protects routes
apps/api/src/modules/sessions/session.routes.ts - Auth routes → Authentication middleware: protects routes
apps/api/src/modules/auth/auth.routes.ts - Auth routes → Rate limiting: limits requests
apps/api/src/modules/auth/auth.routes.ts - Rate limiting → Redis: checks limits
- System endpoints → Health and metrics: dispatches
apps/api/src/modules/system/system.routes.ts - Health and metrics → PostgreSQL: checks health
apps/api/src/modules/system/system.controller.ts - Health and metrics → Redis: checks health
apps/api/src/modules/system/system.controller.ts - Health and metrics → Email job queue: reads queue metrics
apps/api/src/modules/system/system.controller.ts - Auth service → Shared auth contracts: uses auth types
apps/api/src/modules/auth/auth.service.ts - API client → Shared auth contracts: uses response types
apps/web/src/api/client.ts