How continuousactivelearning/poll-question-gen works
Project Type and Purpose
• This is a full-stack, interactive “Poll Automation System” designed for educational live polling.
• Frontend: React (TypeScript) SPA built with Vite, Firebase Authentication, and a shadcn/ui component library.
• Backend: Node.js + TypeScript (Inversify for DI, class-validator/transformer, OpenAPI generation) deployed as Firebase Cloud Functions. Uses MongoDB for persistence, integrates with Firebase Auth, Sentry, SMTP, and OpenAI APIs for GenAI services.
File Structure Analysis
• Top-level: /frontend, /backend
• Frontend:
• src/pages (student, teacher views)
• src/lib/api (REST client hooks)
• src/context, src/store (auth state)
• components (UI atoms, molecules)
• routes (React Router)
• Backend:
• src/modules (feature modules: auth, genai, livequizzes, users)
• src/shared (common middleware, database interfaces/providers for MongoDB, OpenAPI spec generator)
• config, bootstrap, container (framework wiring, Inversify DI)
• firebase.json / .firebaserc (Firebase Functions config)
README Insights
• Real-time polls, feedback sessions, quick assessments.
• Key use cases: teacher creates poll rooms; students join via code; real-time question distribution; live response aggregation; GenAI content generation for adaptive questions.