How mina-hany-dev/bubblesheet-api works
BubbleSheet is an ASP.NET Core backend for an educational assessment platform. Its main workflow is student or staff API requests to create exams and question banks, submit attempts, receive scoring, and review results; supporting branches cover accounts, payments, learning content, and platform operations. The map combines documented capabilities with sampled controller, service, worker, and persistence relationships. Several feature implementations were not excerpted, so their internal call paths are not inferred.
Main entry points: Repos Repositories and unit of work · AccountService.cs Account service · ExamService.cs Exam service · QuestionBankService.cs Question bank service
Components 26
API and Accounts
- Account endpoints
BubleSheet/Controllers/AccountController.cs - Account service
BubleSheet/Services/Implementation/AccountService.cs - JWT service
BubleSheet/Services/Implementation/JwtServiceImplementation.cs - Recharge code endpoints
BubleSheet/Controllers/CodeController.cs - Code service
BubleSheet/Services/Implementation/CodeService.cs
Assessment Workflow
- Exam endpoints
BubleSheet/Controllers/ExamController.cs - Exam service
BubleSheet/Services/Implementation/ExamService.cs - Question bank endpoints
BubleSheet/Controllers/QuestionBankController.cs - Question bank service
BubleSheet/Services/Implementation/QuestionBankService.cs - Attempt review
BubleSheet/Services/Implementation/ReviewService.cs - Assessment domain
Domain.bublesheet/Entities
Learning and Operations
- Lesson endpoints
BubleSheet/Controllers/LessonsController.cs - Lesson service
BubleSheet/Services/Implementation/LessonService.cs - PDF management
BubleSheet/Services/Implementation/PdfService.cs - Bunny file storage
BubleSheet/Services/Implementation/BunnyStorageService .cs - Platform endpoints
BubleSheet/Controllers - Platform services
BubleSheet/Services/Implementation
Persistence and Background
- Notification service
BubleSheet/Services/Implementation/NotificationService.cs - Notification queue
BubleSheet/Services/Implementation/NotificationQueue.cs - Notification worker
BubleSheet/Worker/NotificationWorker.cs - Notification cleanup
BubleSheet/Worker/CleanupWorker.cs - Repositories and unit of work
bubblesheet.Infrastracture/Repos - EF Core context
bubblesheet.Infrastracture/Data/bubblesheetDbContext.cs - SQL Server
- Brevo email
Other components
- Students and staff
Connections 26
- Students and staff → Account endpoints: requests access
- Students and staff → Exam endpoints: manages exams
- Students and staff → Question bank endpoints: manages banks
- Students and staff → Lesson endpoints: accesses lessons
- Account endpoints → Account service: delegates to
BubleSheet/Controllers/AccountController.cs - Account service → JWT service: uses tokens
- Recharge code endpoints → Code service: delegates to
BubleSheet/Controllers/CodeController.cs - Exam endpoints → Exam service: delegates to
BubleSheet/Controllers/ExamController.cs - Question bank endpoints → Question bank service: delegates to
BubleSheet/Controllers/QuestionBankController.cs - Exam service → Assessment domain: uses assessment contracts
BubleSheet/Services/Implementation/ExamService.cs - Question bank service → Assessment domain: uses assessment contracts
BubleSheet/Services/Implementation/QuestionBankService.cs - Attempt review → Assessment domain: reads attempts and answers
BubleSheet/Services/Implementation/ReviewService.cs - Lesson endpoints → Lesson service: delegates to
BubleSheet/Controllers/LessonsController.cs - Lesson service → Bunny file storage: stores lesson files
- PDF management → Bunny file storage: stores PDF files
- Platform endpoints → Platform services: routes requests
- Notification service → Notification queue: queues notices
- Notification worker → Notification queue: dequeues notices
BubleSheet/Worker/NotificationWorker.cs - Notification worker → Repositories and unit of work: creates student notices
BubleSheet/Worker/NotificationWorker.cs - Notification cleanup → Repositories and unit of work: cleans old notices
BubleSheet/Worker/CleanupWorker.cs - Account service → Repositories and unit of work: uses persistence
- Exam service → Repositories and unit of work: uses persistence
BubleSheet/Services/Implementation/ExamService.cs - Question bank service → Repositories and unit of work: uses persistence
BubleSheet/Services/Implementation/QuestionBankService.cs - Repositories and unit of work → EF Core context: accesses data
- EF Core context → SQL Server: persists entities
- Platform services → Brevo email: sends transactional email