How ragavendren/assessa works
Assessa is an online assessment and learning platform. Admins create question banks and assessments, control availability, and share links; participants authenticate or enter via public links, take server-scored assessments, and review progress. A separate play experience provides live Arena and Pulse activities alongside self-paced modes, leaderboards, and rewards. The graph also includes authentication/email, AI insights, and help capabilities documented in the README. Some feature modules were not sampled, so their connections are included only where README or indexed references support them.
Main entry points: auth.tsx Sign-in & callback · platform.functions.ts Assessment services · play.functions.ts Play operations · route.tsx Authenticated routes
Components 28
Access & profiles
- Public entry
src/routes/index.tsx - Sign-in & callback
src/routes/auth.tsx - Client session
src/lib/auth-session.ts - Authenticated routes
src/routes/_authenticated/route.tsx - App shell
src/components/AppShell.tsx - Profile bootstrap
src/lib/platform.functions.ts
Assessment management
- Exam authoring
src/components/admin/ExamEditor.tsx - Question pools & blueprints
src/routes/_authenticated/admin.pools.index.tsx - Admin operations
src/lib/admin.functions.ts - Assessment services
src/lib/platform.functions.ts - Scoring & attempts
src/lib/platform.server.ts
Play & rewards
- Play experiences
src/routes/_authenticated/play.session.$sessionId.tsx - Play operations
src/lib/play.functions.ts - Play session engine
src/lib/play.server.ts - Live Arena
src/lib/play.arena.server.ts - Pulse activities
src/lib/play.pulse.server.ts - Progress & rewards
src/lib/gamification.ts
Platform services
- Route registry
src/routeTree.gen.ts - Supabase client
src/integrations/supabase/client.ts - Server auth middleware
src/integrations/supabase/auth-middleware.ts - Privileged database client
src/integrations/supabase/client.server.ts - Supabase
- Gemini / AI gateway
- AI insights service
src/lib/ai-gateway.server.ts - Auth email hook
src/lib/auth-email-hook.server.ts - Resend
- Help center & bot
src/components/help/HelpCenter.tsx
Other components
- Participant / admin
Connections 31
- Participant / admin → Public entry: visits
src/routes/index.tsx - Public entry → Sign-in & callback: links to
src/routes/index.tsx - Participant / admin → Sign-in & callback: signs in
README.md - Sign-in & callback → Supabase client: authenticates with
src/routes/auth.tsx - Sign-in & callback → Client session: persists signup context
src/routes/auth.tsx - Authenticated routes → Client session: resolves session
src/routes/_authenticated/route.tsx - Authenticated routes → App shell: renders
src/routes/_authenticated/route.tsx - App shell → Profile bootstrap: loads profile
src/components/AppShell.tsx - Profile bootstrap → Server auth middleware: requires auth
src/lib/platform.functions.ts - Exam authoring → Admin operations: uses admin operations
src/components/admin/ExamEditor.tsx - Exam authoring → Assessment services: uses platform services
src/components/admin/ExamEditor.tsx - Question pools & blueprints → Admin operations: manages pools
- Participant / admin → Play experiences: starts activities
README.md - Play experiences → Play operations: invokes
src/routes/_authenticated/play.session.$sessionId.tsx - Play operations → Play session engine: delegates to
src/lib/play.functions.ts - Play operations → Live Arena: dispatches Arena
src/lib/play.functions.ts - Play operations → Pulse activities: dispatches Pulse
- Play session engine → Progress & rewards: uses reward logic
- Route registry → Authenticated routes: registers route
src/routeTree.gen.ts - Sign-in & callback → Supabase client: uses auth client
src/routes/auth.tsx - Assessment services → Server auth middleware: protects functions
src/lib/platform.functions.ts - Assessment services → Scoring & attempts: delegates assessment work
src/lib/platform.functions.ts - Assessment services → Privileged database client: uses privileged access
src/lib/platform.functions.ts - Scoring & attempts → Supabase: reads and writes
- Supabase client → Supabase: connects to
src/integrations/supabase/client.ts - Privileged database client → Supabase: connects with service role
src/integrations/supabase/client.server.ts - Server auth middleware → Supabase: validates user
src/integrations/supabase/auth-middleware.ts - Participant / admin → AI insights service: requests insights
README.md - AI insights service → Gemini / AI gateway: uses model provider
README.md - Auth email hook → Resend: sends auth email
README.md - Participant / admin → Help center & bot: asks for help