How tudoan21/doc2practice works
Doc2Practice is a browser-based learning platform that turns study materials into quizzes and flashcards, supports independent practice and classroom assessments, and tracks learning activity. The main path is learner → document/notes input → AI or offline generation → quiz/flashcard practice → results and history. Teachers also manage classes, assignments, and question banks; school administrators manage schools and subjects. The map reflects documented features and indexed dependencies; unsampled implementation details are not inferred beyond those links.
Main entry points: App.tsx Route dispatcher · AIGenerateQuizPage.tsx Quiz generation · assessmentService.ts Assessment service · questionBankService.ts Question bank service
Components 28
App entry and identity
- Route dispatcher
src/App.tsx - Sign in and profiles
src/services/auth.ts - Protected routes
src/components/auth/ProtectedRoute.tsx
Study creation and practice
- Documents and notes
src/pages/DocumentsPage.tsx - Quiz generation
src/pages/AIGenerateQuizPage.tsx - Quiz practice
src/pages/QuizPlayerPage.tsx - Flashcard review
src/pages/FlashcardPage.tsx - Results and history
src/pages/HistoryPage.tsx - Learning dashboard
src/pages/DashboardPage.tsx
Classroom learning
- Classroom workspace
src/pages/ClassroomsPage.tsx - Assessment taking
src/pages/TakeAssessmentPage.tsx - Assessment results
src/pages/AssessmentResultPage.tsx - Question bank
src/pages/QuestionBankPage.tsx
School management
- School administration
src/pages/SchoolsManagementPage.tsx - Subject management
src/pages/SubjectsManagementPage.tsx
Core services
- AI and offline engine
src/services/aiService.ts - Material library
src/services/materialService.ts - Quiz and study data
src/services/storage.ts - Class and assignment service
src/services/classService.ts - Assessment service
src/services/assessmentService.ts - Question bank service
src/services/questionBankService.ts - Subject service
src/services/subjectService.ts - Permission checks
src/services/rbac.ts - Audit log
src/services/auditService.ts
Other components
- Learner
- Teacher
- School admin
- Google Gemini
Connections 41
- Learner → Route dispatcher: opens platform
- Teacher → Route dispatcher: opens platform
- School admin → Route dispatcher: opens platform
- Route dispatcher → Protected routes: guards app routes
src/App.tsx - Protected routes → Sign in and profiles: checks session
src/components/auth/ProtectedRoute.tsx - Route dispatcher → Documents and notes: routes to
src/App.tsx - Learner → Documents and notes: uploads or pastes
- Documents and notes → Material library: manages materials
src/pages/DocumentsPage.tsx - Route dispatcher → Quiz generation: routes to
src/App.tsx - Learner → Quiz generation: requests study sets
- Quiz generation → Material library: uses materials
src/pages/AIGenerateQuizPage.tsx - Quiz generation → AI and offline engine: generates content
src/pages/AIGenerateQuizPage.tsx - AI and offline engine → Google Gemini: calls API
- Quiz generation → Quiz and study data: stores generated sets
src/services/storage.ts - Quiz and study data → AI and offline engine: uses generation functions
src/services/storage.ts - Route dispatcher → Quiz practice: routes to
src/App.tsx - Learner → Quiz practice: practices quizzes
- Route dispatcher → Flashcard review: routes to
src/App.tsx - Learner → Flashcard review: reviews cards
- Route dispatcher → Results and history: routes to
src/App.tsx - Learner → Learning dashboard: tracks progress
- Route dispatcher → Learning dashboard: routes to
src/App.tsx - Route dispatcher → Classroom workspace: routes to
src/App.tsx - Teacher → Classroom workspace: manages classes
- Learner → Classroom workspace: joins classes
- Classroom workspace → Class and assignment service: manages class data
src/pages/ClassroomsPage.tsx - Route dispatcher → Assessment taking: routes to
src/App.tsx - Assessment taking → Assessment service: takes assessment
src/pages/TakeAssessmentPage.tsx - Route dispatcher → Assessment results: routes to
src/App.tsx - Assessment results → Assessment service: loads results
src/pages/AssessmentResultPage.tsx - Route dispatcher → Question bank: routes to
src/App.tsx - Question bank → Question bank service: manages questions
src/pages/QuestionBankPage.tsx - Assessment service → Question bank service: loads bank questions
src/services/assessmentService.ts - Route dispatcher → School administration: routes to
src/App.tsx - School admin → School administration: manages schools
- Route dispatcher → Subject management: routes to
src/App.tsx - Subject management → Subject service: manages subjects
- Class and assignment service → Permission checks: checks permissions
src/services/classService.ts - Assessment service → Permission checks: checks permissions
src/services/assessmentService.ts - Question bank service → Permission checks: checks permissions
src/services/questionBankService.ts - Question bank service → Audit log: records actions
src/services/questionBankService.ts