How devpanchal02/dental-edge works
Dental-Edge is a dental-study web app for browsing topic content, taking practice tests or question banks, and reviewing performance. The main workflow runs from authenticated topic browsing through quiz initialization, answering and persistence, server finalization, and results/analytics. Separate branches cover sign-in, plans, and backend topic, user, and payment endpoints. Source excerpts clarify quiz state and persistence; some page and controller internals are unsampled, so their links are limited to indexed imports or documented client calls.
Main entry points: App.tsx Route application · index.ts Function entry and routing · api.ts Client API · firebase.ts Server Firebase setup
Components 29
Client app
- Route application
client/src/App.tsx - Topic browsing
client/src/pages/TopicPage.tsx - Results review
client/src/pages/ResultsPage.tsx - Account and plans
client/src/pages - Topic analytics views
client/src/components/topic - Result visualizations
client/src/components - Client API
client/src/services/api.ts
Quiz workflow
- Quiz engine
client/src/hooks/useQuizEngine.ts - Quiz initialization
client/src/hooks/quiz/useQuizInitialization.ts - Quiz lifecycle
client/src/hooks/quiz/useQuizLifecycle.ts - Quiz state reducer
client/src/hooks/quiz/quizReducer.ts - Local attempt storage
client/src/hooks/quiz/quizStorageUtils.ts - Content loading and sanitizing
client/src/services/loader.ts - Quiz schemas and types
client/src/schemas/quiz.schemas.ts
Backend services
- Function entry and routing
functions/src/index.ts - Quiz endpoints
functions/src/controllers/quizController.ts - Topic endpoints
functions/src/controllers/topicController.ts - User endpoints
functions/src/controllers/userController.ts - Stripe endpoints
functions/src/controllers/stripeController.ts - Quiz service
functions/src/services/quizService.ts - Topic service
functions/src/services/topicService.ts - User service
functions/src/services/userService.ts
Identity and data
- Authentication context
client/src/context/AuthContext.tsx - Client Firebase setup
client/src/firebase.ts - Server Firebase setup
functions/src/firebase.ts
Other components
- Learner
- Firebase Auth and Firestore
- Topic content API
- Payment provider
Connections 34
- Learner → Route application: uses
- Route application → Topic browsing: routes to
client/src/App.tsx - Route application → Results review: routes to
client/src/App.tsx - Route application → Account and plans: routes to
client/src/App.tsx - Route application → Authentication context: checks session
client/src/App.tsx - Topic browsing → Topic analytics views: renders
client/src/pages/TopicPage.tsx - Results review → Result visualizations: renders
client/src/pages/ResultsPage.tsx - Quiz engine → Authentication context: reads user
client/src/hooks/useQuizEngine.ts - Quiz engine → Quiz state reducer: dispatches state
client/src/hooks/useQuizEngine.ts - Quiz engine → Quiz initialization: initializes quiz
client/src/hooks/useQuizEngine.ts - Quiz engine → Quiz lifecycle: manages lifecycle
client/src/hooks/useQuizEngine.ts - Quiz initialization → Content loading and sanitizing: loads content
client/src/hooks/quiz/useQuizInitialization.ts - Quiz initialization → Client API: loads attempts
client/src/hooks/quiz/useQuizInitialization.ts - Quiz initialization → Local attempt storage: reads and saves
client/src/hooks/quiz/useQuizInitialization.ts - Quiz lifecycle → Client API: saves and finalizes
client/src/hooks/quiz/useQuizLifecycle.ts - Quiz lifecycle → Local attempt storage: persists results
client/src/hooks/quiz/useQuizLifecycle.ts - Content loading and sanitizing → Client API: fetches data
client/src/services/loader.ts - Client API → Topic content API: requests topic data
client/src/services/api.ts - Client API → Function entry and routing: calls functions
- Authentication context → Client Firebase setup: uses Firebase
client/src/context/AuthContext.tsx - Authentication context → Firebase Auth and Firestore: authenticates and observes profile
client/src/context/AuthContext.tsx - Function entry and routing → Quiz endpoints: routes to
functions/src/index.ts - Function entry and routing → Topic endpoints: routes to
functions/src/index.ts - Function entry and routing → User endpoints: routes to
functions/src/index.ts - Function entry and routing → Stripe endpoints: routes to
functions/src/index.ts - Quiz endpoints → Quiz service: delegates to
functions/src/controllers/quizController.ts - Quiz endpoints → User service: looks up attempts
functions/src/controllers/quizController.ts - Topic endpoints → Topic service: delegates to
functions/src/controllers/topicController.ts - Quiz service → Server Firebase setup: uses Firebase
functions/src/services/quizService.ts - Topic service → Server Firebase setup: uses Firebase
functions/src/services/topicService.ts - User service → Server Firebase setup: uses Firebase
functions/src/services/userService.ts - User endpoints → Server Firebase setup: uses Firebase
functions/src/controllers/userController.ts - Stripe endpoints → Server Firebase setup: uses Firebase
functions/src/controllers/stripeController.ts - Stripe endpoints → Payment provider: payment integration