{"id":31324782,"url":"https://github.com/nashtech-garage/online-exams","last_synced_at":"2026-05-20T05:02:59.424Z","repository":{"id":308874479,"uuid":"1031783911","full_name":"nashtech-garage/online-exams","owner":"nashtech-garage","description":"Build a comprehensive, event-driven online exams platform using Scala and Akka","archived":false,"fork":false,"pushed_at":"2025-09-17T02:49:20.000Z","size":9083,"stargazers_count":0,"open_issues_count":22,"forks_count":0,"subscribers_count":0,"default_branch":"develop","last_synced_at":"2025-09-17T04:26:36.133Z","etag":null,"topics":["akka","java17","k8s","msa","scala"],"latest_commit_sha":null,"homepage":"","language":"Scala","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/nashtech-garage.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-08-04T10:22:26.000Z","updated_at":"2025-08-05T11:16:22.000Z","dependencies_parsed_at":null,"dependency_job_id":"ee7caa75-01e1-4146-9318-5554f0aff716","html_url":"https://github.com/nashtech-garage/online-exams","commit_stats":null,"previous_names":["nashtech-garage/online-exams"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/nashtech-garage/online-exams","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nashtech-garage%2Fonline-exams","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nashtech-garage%2Fonline-exams/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nashtech-garage%2Fonline-exams/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nashtech-garage%2Fonline-exams/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nashtech-garage","download_url":"https://codeload.github.com/nashtech-garage/online-exams/tar.gz/refs/heads/develop","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nashtech-garage%2Fonline-exams/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":276987453,"owners_count":25740583,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-09-25T02:00:09.612Z","response_time":80,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["akka","java17","k8s","msa","scala"],"created_at":"2025-09-25T21:38:34.700Z","updated_at":"2025-09-25T21:38:35.736Z","avatar_url":"https://github.com/nashtech-garage.png","language":"Scala","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Online Examination System\r\nBuild a comprehensive, event-driven online exams platform using Scala and Akka\r\n\r\n---\r\n# Tech Stack:\r\n- Scala 2.13\r\n- Akka 2.9 (Akka Persistence Typed, Akka Projection, Akka HTTP)\r\n- gRPC (Protobuf)\r\n- Kafka (Alpakka Kafka)\r\n- PostgreSQL\r\n- Kubernetes (Helm)\r\n\r\n# Architectural Goals\r\n- **Scalability**: Handle thousands of concurrent exams and millions of messages.\r\n- **Resilience**: Isolate failure domains per service using Akka clustering \u0026 supervision.\r\n- **Event-driven**: Use event sourcing and projection patterns for traceability and state recovery.\r\n- **Real-time interaction**: Provide live chat and reminder mechanisms using Akka Streams \u0026 Kafka.\r\n- **Maintainability**: Align with Microservices principles and domain-driven design.\r\n\r\n# System Decomposition\r\nThe system is divided into independent bounded contexts, each implemented as a microservice:\r\n\r\n| Service Name             | Responsibilities                                   |\r\n| ------------------------ | -------------------------------------------------- |\r\n| **ExamService**          | Create/manage exams and exam content               |\r\n| **RoomService**          | Create/assign exam rooms, manage time and capacity |\r\n| **ScheduleService**      | Manage exam slots, assign students \u0026 invigilators  |\r\n| **AccessControlService** | Enforce rules on access timing, submission limits  |\r\n| **SubmissionService**    | Handle exam submissions and validations            |\r\n| **ReminderService**      | Trigger automated alerts before exams end          |\r\n| **ChatService**          | Real-time messaging during exams                   |\r\n| **NotificationService**  | Deliver reminders, notifications via email/sms     |\r\n| **UserService**          | Manage user profiles and roles                     |\r\n\r\nEach service communicates via **gRPC (internal)** and exposes APIs via **Akka HTTP** for external integration.\r\n\r\n# Communication and Integration\r\n- **Intra-Service**:\r\n  - **gRPC** for synchronous communication between microservices using Protobuf contracts.\r\n  - **Akka Cluster Sharding** (if scaling horizontally within a service)\r\n\r\n- **Event Bus**:\r\n  - Kafka (Alpakka Kafka) used for:\r\n    - Emitting domain events (e.g., ExamCreated, StudentJoinedRoom, ExamSubmitted)\r\n    - Cross-service coordination (e.g., RoomFullEvent -\u003e triggers ReminderService)\r\n\r\n- **External Interfaces**:\r\n  - Akka HTTP for RESTful APIs (admin panel, student portal, invigilator UI)\r\n  - WebSockets (via Akka Streams) for live chat and event push\r\n\r\n# Persistence \u0026 Event Sourcing\r\nEach service with state will be modeled using **Akka Persistence Typed**, backed by:\r\n\r\n- **PostgreSQL** for journal and snapshots (via Akka Persistence JDBC plugin)\r\n- **Akka Projection** to:\r\n  - Build read-side views (e.g., upcoming exams, chat history)\r\n  - Trigger side effects (e.g., sending reminders, audit logs)\r\n\r\n# Rules \u0026 Time Constraints\r\nEnforced by `AccessControlService`\r\n\r\n| Rule                                    | Mechanism                                        |\r\n| --------------------------------------- | ------------------------------------------------ |\r\n| No access after 50% of exam duration    | Akka Timer + Durable State                       |\r\n| No submission after 5 minutes post exam | Akka Timer + Scheduler                           |\r\n| No download after 15 minutes            | Akka Scheduler + Event time constraint           |\r\n| Reminder at 15 mins before end          | Kafka Event -\u003e Projection -\u003e NotificationService |\r\n\r\n\r\n# Deployment \u0026 DevOps\r\n\r\n- **CI/CD**: GitHub Actions + Helm Charts\r\n- **Kubernetes**: Minikube or k3d for local development\r\n  - Deploy each service as a separate pod\r\n  - Use StatefulSets for services with state (e.g., ExamService, SubmissionService)\r\n  - Use ConfigMaps and Secrets for configuration management\r\n\r\n- **Observability**:\r\n  - Prometheus + Grafana for metrics\r\n  - ELK Stack (Elasticsearch, Logstash, Kibana) for logging\r\n  - Akka Telemetry / Lightbend Console (optional)\r\n\r\n- **Secrets \u0026 Configs**:\r\n  - Secret Manager + Kubernetes ConfigMaps\r\n\r\n# Data Flow Example – Live Exam Session\r\n1. `ScheduleService` emits `ExamSlotStarted`\r\n1. `AccessControlService` activates access window\r\n1. Students login → `AccessControlService` checks eligibility\r\n1. Students download exam (Akka HTTP or streaming)\r\n1. Live chat via `ChatService` (WebSocket + Akka Stream)\r\n1. Reminder triggered by `ReminderService` via Kafka\r\n1. Students submit → `SubmissionService` persists \u0026 validates\r\n1. Post exam: results processed asynchronously via Kafka + Projections\r\n\r\n# Design Patterns\r\n\r\n*   **Event Sourcing** (Akka Persistence)\r\n*   **CQRS** (Write via persistent actor, read via projections)\r\n*   **Backpressure \u0026 Streaming** (Akka Streams)\r\n*   **Cluster Sharding** (for scale-out stateful actors)\r\n*   **gRPC + Protobuf** (Strong API contracts)\r\n*   **Saga Pattern** (for complex workflows like submission + grading)","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnashtech-garage%2Fonline-exams","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnashtech-garage%2Fonline-exams","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnashtech-garage%2Fonline-exams/lists"}