# bradfernando/eduplay architecture

> Architecture diagram of the GitHub repository bradfernando/eduplay, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-10). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/bradfernando/eduplay
- Repository: https://github.com/bradfernando/eduplay

## Overview

##### Project type and purpose
- This is a full-stack web application built with Next.js (App Router), React and Tailwind CSS, providing a trivia game platform with user authentication, trivia sessions, and score history.
- The README confirms it’s a “create-next-app” Next.js project that serves pages and API routes, backed by MongoDB.

##### File structure
- Top-level “app” directory:
- app/page.js, app/layout.js, app/globals.css – main entry, layout and global styles
- app/login/page.js, app/register/page.js, app/dashboard/page.js – client‐side pages
- app/trivia/.../page.js – category pages (biologia, fisica, quimica)
- app/components – shared React components (e.g. UserAvatar.js)
- app/lib/mongodb.js – MongoDB connection utility
- app/models – Mongoose schemas (Trivia.js, User.js)
- app/api – serverless API routes grouped by domain:
- auth/login, auth/register
- trivia/start-trivia, trivia/update-score, trivia/scores, trivia/history
- Config-and-build scripts: next.config.mjs, tailwind.config.mjs, postcss.config.mjs, tsconfig.json, eslint.config.mjs.

##### README for additional insights
- No custom architecture docs, but confirms standard Next.js App Router with optimized font loading and deployment on Vercel.

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Client Layer
    subgraph "Client Layer"
        direction TB
        Browser["User Browser"]:::frontend
        NextServer["Next.js Server"]:::frontend
        Browser -->|"HTTP GET pages"| NextServer

        subgraph "Pages & Layout"
            direction TB
            Entry["app/page.js"]:::frontend
            Layout["app/layout.js"]:::frontend
            GlobalsCSS["app/globals.css"]:::frontend
        end

        subgraph "Auth Pages"
            direction TB
            LoginPage["app/login/page.js"]:::frontend
            RegisterPage["app/register/page.js"]:::frontend
        end

        subgraph "User Pages"
            direction TB
            Dashboard["app/dashboard/page.js"]:::frontend
        end

        subgraph "Trivia Category Pages"
            direction TB
            BioPage["app/trivia/biologia/page.js"]:::frontend
            FisicaPage["app/trivia/fisica/page.js"]:::frontend
            QuimicaPage["app/trivia/quimica/page.js"]:::frontend
        end

        subgraph "Shared Components"
            direction TB
            UserAvatar["app/components/UserAvatar.js"]:::frontend
        end

        NextServer -->|"renders"| Entry
        Entry --> Layout
        Layout --> GlobalsCSS
        NextServer --> LoginPage
        NextServer --> RegisterPage
        NextServer --> Dashboard
        NextServer --> BioPage
        NextServer --> FisicaPage
        NextServer --> QuimicaPage

        %% React UI actions
        LoginPage -->|"fetch /api/auth/login"| AuthAPI
        RegisterPage -->|"fetch /api/auth/register"| AuthAPI
        Dashboard -->|"fetch /api/trivia/scores"| TriviaAPI
        Dashboard -->|"fetch /api/trivia/history"| TriviaAPI
        BioPage -->|"fetch /api/trivia/start-trivia"| TriviaAPI
        BioPage -->|"fetch /api/trivia/update-score"| TriviaAPI
    end

    %% Server/API Layer
    subgraph "API Layer"
        direction TB
        subgraph "Auth API"
            direction TB
            AuthAPI["API Routes (auth)"]:::api
            LoginRoute["app/api/auth/login/route.js"]:::api
            RegisterRoute["app/api/auth/register/route.js"]:::api
            AuthAPI --> LoginRoute
            AuthAPI --> RegisterRoute
        end

        subgraph "Trivia API"
            direction TB
            TriviaAPI["API Routes (trivia)"]:::api
            StartTrivia["app/api/trivia/start-trivia/route.js"]:::api
            UpdateScore["app/api/trivia/update-score/route.js"]:::api
            ScoresRoute["app/api/trivia/scores/route.js"]:::api
            HistoryRoute["app/api/trivia/history/route.ts"]:::api
            TriviaAPI --> StartTrivia
            TriviaAPI --> UpdateScore
            TriviaAPI --> ScoresRoute
            TriviaAPI --> HistoryRoute
        end

        %% Utilities & Models
        MongoUtil["app/lib/mongodb.js"]:::util
        UserModel["app/models/User.js"]:::model
        TriviaModel["app/models/Trivia.js"]:::model

        AuthAPI --> MongoUtil
        TriviaAPI --> MongoUtil
        MongoUtil --> UserModel
        MongoUtil --> TriviaModel
        UserModel --> DB
        TriviaModel --> DB
    end

    %% Database
    subgraph "Database"
        DB[(MongoDB)]:::db
    end

    %% Response flow
    AuthAPI -->|"JSON response"| Browser
    TriviaAPI -->|"JSON response"| Browser

    %% Click Events
    click Entry "https://github.com/bradfernando/eduplay/blob/main/app/page.js"
    click Layout "https://github.com/bradfernando/eduplay/blob/main/app/layout.js"
    click GlobalsCSS "https://github.com/bradfernando/eduplay/blob/main/app/globals.css"
    click LoginPage "https://github.com/bradfernando/eduplay/blob/main/app/login/page.js"
    click RegisterPage "https://github.com/bradfernando/eduplay/blob/main/app/register/page.js"
    click Dashboard "https://github.com/bradfernando/eduplay/blob/main/app/dashboard/page.js"
    click BioPage "https://github.com/bradfernando/eduplay/blob/main/app/trivia/biologia/page.js"
    click FisicaPage "https://github.com/bradfernando/eduplay/blob/main/app/trivia/fisica/page.js"
    click QuimicaPage "https://github.com/bradfernando/eduplay/blob/main/app/trivia/quimica/page.js"
    click UserAvatar "https://github.com/bradfernando/eduplay/blob/main/app/components/UserAvatar.js"
    click MongoUtil "https://github.com/bradfernando/eduplay/blob/main/app/lib/mongodb.js"
    click UserModel "https://github.com/bradfernando/eduplay/blob/main/app/models/User.js"
    click TriviaModel "https://github.com/bradfernando/eduplay/blob/main/app/models/Trivia.js"
    click LoginRoute "https://github.com/bradfernando/eduplay/blob/main/app/api/auth/login/route.js"
    click RegisterRoute "https://github.com/bradfernando/eduplay/blob/main/app/api/auth/register/route.js"
    click StartTrivia "https://github.com/bradfernando/eduplay/blob/main/app/api/trivia/start-trivia/route.js"
    click UpdateScore "https://github.com/bradfernando/eduplay/blob/main/app/api/trivia/update-score/route.js"
    click ScoresRoute "https://github.com/bradfernando/eduplay/blob/main/app/api/trivia/scores/route.js"
    click HistoryRoute "https://github.com/bradfernando/eduplay/blob/main/app/api/trivia/history/route.ts"

    %% Styles
    classDef frontend fill:#add8e6,stroke:#000,stroke-width:1px
    classDef api fill:#90ee90,stroke:#000,stroke-width:1px
    classDef db fill:#f4a460,stroke:#000,stroke-width:1px
    classDef util fill:#e6e6fa,stroke:#000,stroke-width:1px
    classDef model fill:#ffb6c1,stroke:#000,stroke-width:1px
```
