# skannan1209/myapp architecture

> Architecture diagram of the GitHub repository skannan1209/myapp, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-02-27). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/skannan1209/myapp
- Repository: https://github.com/skannan1209/myapp

## Overview

This is a **3-component microservices-style system** for **efficiently transferring and displaying a large JSON dataset (~10MB)** end-to-end with explicit focus on:
- **Backend-to-backend streaming + connection pooling** (Client App → Data Service)
- **Frontend timeout/cancellation + large payload parsing/rendering** (React)

The architecture is intentionally “linear” and should be drawn as such:
**React Frontend (5173) → Client App / Gateway (8080) → Data Service (8081)**

##### User / Browser
- Interacts with React app served by Vite dev server (during dev) or static hosting (future).
##### Frontend (React/Vite) – Port 5173
- Calls `Client App` via HTTP
- Shows cancellation/timeout at UI layer (AbortController)
##### Client App (Spring Boot) – Port 8080
- Exposes endpoint: `/fetch-remote-data` (from README)
- Uses **Apache HttpClient 5** with:
- `PoolingHttpClientConnectionManager` (200 total / 50 per route)
- Timeout ~5s, read timeout ~30s
- Calls Data Service over HTTP
##### Data Service (Spring Boot) – Port 8081
- Exposes endpoint: `/data`
- Generates ~50,000 items
- Uses **StreamingResponseBody** to stream JSON

- Frontend → Client App: `GET /fetch-remote-data` (large payload)
- Client App → Data Service: `GET /data` (streamed; pooled connections)
- Data Service → Client App: **streaming response** (chunked/stream)

- **Timeout/cancellation boundary**
- UI timeout: AbortController cancels fetch (15s default per README)
- Backend timeouts: connect/read timeouts to avoid thread starvation
- **Performance/memory strategy**
- StreamingResponseBody avoids building full JSON in heap
- Connection pooling prevents connection churn under concurrency

##### Data Service internals (`data-service/src/main/java/dataservice`)
- **DataController**
- endpoint `/data`
- returns `StreamingResponseBody`
- **DataLoader**
- creates/generates dataset (50k items)
- **BigItemRepository**
- source of items (even if in-memory/mock; label it “Repository / Data source abstraction”)
- **BigItem (Domain model)**

Data flow inside service:
`HTTP request → DataController → (Repository/DataLoader) → StreamingResponseBody writes JSON → HTTP response stream`

##### Client App internals (`app/src/main/java/myapp`)
- **ClientController**
- endpoint `/fetch-remote-data`
- **ClientConfig**
- HttpClient5 bean(s), pooling manager, timeouts
- **Apache HttpClient 5**
- As a “library component” connected to Data Service

Data flow:
`Frontend request → ClientController → Apache HttpClient5 (pooled) → Data Service → response forwarded back`

##### Frontend internals (`frontend/src`)
- **App.jsx UI**
- triggers request, displays metrics (time + size)
- timeout simulator
- **Network Layer**
- `fetch()` + AbortController wrapper
- (Optional) **Renderer**
- large list rendering concerns (virtualization not indicated in tree; don’t invent it—just label “Large list rendering”)

Data flow:
`User action → fetch wrapper (AbortController) → GET Client App → parse JSON → render list + metrics`

- **Gateway/Intermediary pattern**: `app/` behaves like an API gateway / BFF-lite (even if minimal).
- **Streaming response**: `data-service` uses streaming to reduce memory pressure.
- **Connection pooling**: `app` uses pooled HTTP connections to backend service.
- **Timeouts at multiple layers**:
- Client (browser) cancellation
- Server-to-server timeouts

- 3 services + browser + ports + main endpoints + payload size
- Break out each Spring Boot service into Controller/Config/Repository/Loader
- Break out frontend into UI + fetch/AbortController

This gives you both “what runs where” and “how it’s implemented,” without overcomplicating a single canvas.

- `data-service/.../DataController.java` → “DataController (/data, StreamingResponseBody)”
- `data-service/.../DataLoader.java` → “Mock Data Generator/Loader (50k items)”
- `data-service/.../BigItemRepository.java` → “Repository (in-memory/mock abstraction)”
- `app/.../ClientController.java` → “ClientController (/fetch-remote-data)”
- `app/.../ClientConfig.java` → “HttpClient5 Config (pooling + timeouts)”
- `frontend/src/App.jsx` → “UI + Metrics + Timeout simulator”

## Diagram (Mermaid)

```mermaid
flowchart TD
  %% =========================
  %% Level 1: System / Deployment
  %% =========================
  subgraph "Level 1 — Runtime / Deployment (Linear data path)"
    direction TB

    U["User (Browser)"]:::external

    subgraph "Frontend — React + Vite"
      direction TB
      Vite["Vite Dev Server :5173"]:::dev
      FE["React Frontend (SPA)"]:::service
      Abort["Timeout/Cancellation<br/>AbortController (~15s)"]:::concern
      Parse["Large JSON parse + render<br/>(~10MB, 50k items)"]:::concern
      Vite -->|"serves"| FE
      FE -->|"uses"| Abort
      FE -->|"parses/renders"| Parse
    end

    subgraph "Client App — Spring Boot (Gateway/BFF-lite) :8080"
      direction TB
      APP["Client App / Gateway Service"]:::service
      Pool["Connection pooling + timeouts<br/>Apache HttpClient 5<br/>Pooling(200/50), connect~5s, read~30s"]:::concern
      APP -->|"enforces"| Pool
    end

    subgraph "Data Service — Spring Boot :8081"
      direction TB
      DS["Data Service (Large JSON Producer)"]:::service
      Stream["Streaming response<br/>StreamingResponseBody<br/>(avoids full JSON in heap)"]:::concern
      DS -->|"implements"| Stream
    end

    U -->|"interacts"| FE
    FE -->|"HTTP GET /fetch-remote-data"| APP
    APP -->|"HTTP GET /data (pooled conn)"| DS
    DS -->|"HTTP 200 streamed JSON (chunked/stream)"| APP
    APP -->|"HTTP 200 large JSON (~10MB)"| FE
  end

  %% =========================
  %% Level 2: Component / Implementation
  %% =========================
  subgraph "Level 2 — Internal Components (per service)"
    direction TB

    %% ---- Frontend internals
    subgraph "Frontend internals (frontend/src)"
      direction TB
      FE_App["App.jsx<br/>UI + metrics + timeout simulator"]:::module
      FE_Main["main.jsx<br/>React bootstrap"]:::module
      FE_Net["Network layer<br/>fetch() + AbortController"]:::module
      FE_Render["Render path<br/>display list + metrics"]:::module

      FE_Main -->|"mounts"| FE_App
      FE_App -->|"calls"| FE_Net
      FE_Net -->|"returns JSON"| FE_App
      FE_App -->|"renders"| FE_Render
    end

    %% ---- Client App internals
    subgraph "Client App internals (app/src/main/java/myapp)"
      direction TB
      CA_Entry["ClientApplication.java<br/>Spring Boot entrypoint"]:::module
      CA_Controller["ClientController.java<br/>GET /fetch-remote-data"]:::module
      CA_Config["ClientConfig.java<br/>HttpClient 5 config<br/>pooling + timeouts"]:::module
      CA_HC["Apache HttpClient 5<br/>(library)"]:::library

      CA_Entry -->|"wires"| CA_Controller
      CA_Entry -->|"wires"| CA_Config
      CA_Config -->|"builds"| CA_HC
      CA_Controller -->|"uses"| CA_HC
    end

    %% ---- Data Service internals
    subgraph "Data Service internals (data-service/src/main/java/dataservice)"
      direction TB
      DS_Entry["DataServiceApplication.java<br/>Spring Boot entrypoint"]:::module
      DS_Controller["DataController.java<br/>GET /data<br/>StreamingResponseBody"]:::module
      DS_Loader["DataLoader.java<br/>mock data generator/loader<br/>(~50k items)"]:::module
      DS_Repo["BigItemRepository.java<br/>Repository abstraction<br/>(in-memory/mock)"]:::module
      DS_Model["BigItem.java<br/>Domain model"]:::module

      DS_Entry -->|"wires"| DS_Controller
      DS_Loader -->|"populates"| DS_Repo
      DS_Repo -->|"stores/returns"| DS_Model
      DS_Controller -->|"reads items from"| DS_Repo
      DS_Controller -->|"streams JSON via"| DS_Model
    end

    %% ---- Cross-service call mapping at component level
    FE_Net -->|"HTTP GET /fetch-remote-data"| CA_Controller
    CA_HC -->|"HTTP GET /data"| DS_Controller
    DS_Controller -->|"streamed JSON response"| CA_HC
    CA_Controller -->|"large JSON response"| FE_Net
  end

  %% =========================
  %% Build / Orchestration (dev/build lane)
  %% =========================
  subgraph "Build / Orchestration (repo-level)"
    direction TB
    Gradle["Gradle multi-module build<br/>settings.gradle"]:::build
    NodeTool["Node toolchain<br/>package.json"]:::build
    ViteCfg["Vite config<br/>vite.config.js"]:::build

    Gradle -->|"builds"| APP
    Gradle -->|"builds"| DS
    NodeTool -->|"drives"| Vite
    ViteCfg -->|"configures"| Vite
  end

  %% =========================
  %% Click events (from component mapping)
  %% =========================
  click DS_Entry "https://github.com/skannan1209/myapp/blob/main/data-service/src/main/java/dataservice/DataServiceApplication.java"
  click DS_Controller "https://github.com/skannan1209/myapp/blob/main/data-service/src/main/java/dataservice/DataController.java"
  click DS_Model "https://github.com/skannan1209/myapp/blob/main/data-service/src/main/java/dataservice/BigItem.java"
  click DS_Repo "https://github.com/skannan1209/myapp/blob/main/data-service/src/main/java/dataservice/BigItemRepository.java"
  click DS_Loader "https://github.com/skannan1209/myapp/blob/main/data-service/src/main/java/dataservice/DataLoader.java"
  click DS "https://github.com/skannan1209/myapp/blob/main/data-service/src/main/resources/application.properties"

  click CA_Entry "https://github.com/skannan1209/myapp/blob/main/app/src/main/java/myapp/ClientApplication.java"
  click CA_Controller "https://github.com/skannan1209/myapp/blob/main/app/src/main/java/myapp/ClientController.java"
  click CA_Config "https://github.com/skannan1209/myapp/blob/main/app/src/main/java/myapp/ClientConfig.java"
  click APP "https://github.com/skannan1209/myapp/blob/main/app/src/main/resources/application.properties"

  click FE "https://github.com/skannan1209/myapp/tree/main/frontend/"
  click FE_App "https://github.com/skannan1209/myapp/blob/main/frontend/src/App.jsx"
  click FE_Main "https://github.com/skannan1209/myapp/blob/main/frontend/src/main.jsx"
  click ViteCfg "https://github.com/skannan1209/myapp/blob/main/frontend/vite.config.js"
  click NodeTool "https://github.com/skannan1209/myapp/blob/main/frontend/package.json"
  click Gradle "https://github.com/skannan1209/myapp/blob/main/settings.gradle"

  %% =========================
  %% Styles
  %% =========================
  classDef external fill:#E5E7EB,stroke:#6B7280,stroke-width:1px,color:#111827
  classDef service fill:#DBEAFE,stroke:#2563EB,stroke-width:1.5px,color:#0B1B3A
  classDef module fill:#EDE9FE,stroke:#6D28D9,stroke-width:1.2px,color:#1F1147
  classDef concern fill:#FFEDD5,stroke:#F97316,stroke-width:1.2px,color:#3B1D00
  classDef dev fill:#F3F4F6,stroke:#9CA3AF,stroke-dasharray:4 3,stroke-width:1.2px,color:#111827
  classDef library fill:#ECFDF5,stroke:#10B981,stroke-width:1.2px,color:#052B1E
  classDef build fill:#F1F5F9,stroke:#64748B,stroke-width:1.2px,color:#0F172A
```
