Data Flow
Application-level data flow across CodHoot services
System Architecture
Browser
codhoot-frontend
codhoot-backend
PostgreSQL
Redis
Asynq
Compiler Workers
Docker
AI Providers
Authentication Flow
User login/register -> JWT issued -> Session stored
Browser
codhoot-frontend
codhoot-backend
PostgreSQL
Compiler Execution Flow
Code submitted -> Queued via Asynq -> Worker picks up -> Docker executes -> Result stored
Browser
codhoot-backend
Asynq Queue
Compiler Worker
Docker
codhoot-backend
PostgreSQL
AI Request Flow
AI request -> Backend routes to provider -> Response streamed -> Usage recorded
Browser
codhoot-backend
AI Proxy
AI Provider
codhoot-backend
PostgreSQL
Learning Progress Flow
Lesson completed -> XP awarded -> Progress updated -> Certificate issued
Browser
codhoot-backend
PostgreSQL
Organization & RBAC Flow
Org created -> Members invited -> Roles assigned -> Permissions checked per request
Browser
codhoot-backend
RBAC Middleware
PostgreSQL
Feedback Flow
User submits feedback -> Stored in DB -> Admin reviews via console
Browser
codhoot-backend
PostgreSQL
Admin Console
Workspace & Projects Flow
Workspace created -> Files managed -> Snapshots taken -> Milestones tracked
Browser
codhoot-backend
PostgreSQL
Career Path & Competency Flow
Career path defined -> Stages created -> Competencies linked -> Evidence collected -> Reviews performed
Browser
codhoot-backend
PostgreSQL