Skip to content

architecture.md

Latest commit

 

History

History
42 lines (32 loc) · 1.43 KB

architecture.md

File metadata and controls

42 lines (32 loc) · 1.43 KB
Raw

🏗️ System Architecture

Overview

Examme is built on a Monolithic Architecture using the Spring Boot framework. It follows a layered design pattern to ensure separation of concerns and maintainability.

Layered Structure

  1. Controller Layer: Handles HTTP requests and maps them to service methods.
  2. Service Layer: Contains business logic, AI integration (Gemini), and orchestration.
  3. Repository Layer: Manages data persistence using Spring Data JPA.
  4. Security Layer: Implements JWT-based stateless authentication.

🔄 User Flow & System Workflow

The following diagram illustrates the primary workflow for creating and taking an exam.

graph TD
    A[Teacher] -->|Uploads Document| B(Backend Service)
    B -->|Calls| C[Gemini AI]
    C -->|Returns Questions| B
    B -->|Saves| D[(MySQL Database)]
    A -->|Invites Students| E[Email Notification]
    F[Student] -->|Logins| G{Auth Check}
    G -->|Success| H[Take Quiz]
    H -->|Submits| B
    B -->|Calculates Score| D
    B -->|Shows Results| F
Loading

🔐 Security Architecture

The system uses a stateless security model:

  • JWT (JSON Web Token): Used for session management.
  • Refresh Tokens: Stored in the database to allow secure session renewal.
  • Role-Based Access Control (RBAC): Distinct permissions for TEACHER, STUDENT, and ADMIN.

Return to README | Back to Top