# otniel113/animeconnections architecture

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

- Interactive diagram: https://gitdiagram.com/otniel113/animeconnections
- Repository: https://github.com/otniel113/animeconnections

## Overview

##### Jenis & tujuan proyek
Dari file tree dan README, ini adalah **static web game (front-end only)** yang di-deploy ke **Netlify**. Tidak terlihat backend/service layer (tidak ada server code, package manager, atau API client). Game “Connections” versi anime: user mengelompokkan item, dengan fitur **dark theme**, **retry**, **new game**, dan **hint**.

##### Analisis struktur file (mapping ke komponen arsitektur)
Top-level:
- `index.html` → **UI shell**, entry point DOM, tempat load CSS/JS.
- `styles.css` → **styling & theming** (termasuk dark theme).
- `script.js` → **seluruh logic aplikasi**: state game, event handlers, render/update DOM, hint, new game, retry, scoring/validation (asumsi umum).
- `data/gameData.json` → **data source lokal**: bank puzzle/words/kelompok.
- `robots.txt` + `google31b29fd4ff366284.html` → **SEO / site verification** (bukan core runtime game, tapi bagian dari deployment web).
- `data/` → folder aset data.

Tidak ada `src/` atau modul; ini cenderung **single-bundle JS** (satu file script) tanpa build step.

- **Dark Theme** → toggling tema via CSS class + state di JS (mungkin localStorage).
- **Unlimited / New Game** → pemilihan puzzle acak/berikutnya dari `gameData.json`, reset state.
- **Retry** → reload puzzle yang sama, reset state saja (tanpa ganti puzzle).
- **Hint** → algoritma memilih 4 item yang pasti beda grup, lalu highlight di UI.

##### Identifikasi komponen utama (Level-1 / C4 “Container-ish”)
Untuk project static seperti ini, pisahkan menjadi:
##### Client App (HTML/CSS/JS) di dalam browser, yang bisa kamu pecah lagi
- UI Layer (DOM)
- Game Logic / State Manager (di `script.js`)
- Data Loader (fetch/parse `data/gameData.json`)
- Theme Manager (dark/light)
- Hint Engine (bagian logic)
##### Static Data Store: `data/gameData.json` (secara teknis file statik yang di-fetch)

Tambahan non-runtime tapi layak ditaruh sebagai catatan:
- `robots.txt` & `google...html` → “SEO / verification artifacts”.

Alur utama saat user main:
- User → Browser UI: click/tap/select items
- Browser JS (`script.js`) → DOM: render board, update highlight, show result
- Browser JS → Fetch `data/gameData.json` (HTTP GET dari Netlify) → parse JSON → in-memory puzzle set
- Game Logic ↔ UI: loop event-driven (input → validate → update state → render)
- Theme toggle: UI event → Theme Manager → update CSS class / variables
- New Game / Retry: UI event → Game State reset → UI rerender
- Hint: UI event → Hint Engine reads current state + solution mapping → UI highlight

Kalau kamu ingin lebih “principal-level accurate”, bedakan panah:

##### Pattern desain yang relevan
Karena ini front-end tanpa framework yang terlihat:
- **Event-driven UI** (DOM events memicu logic)
- **Stateful single-page** (meski bukan SPA framework, tetap single page yang update DOM)
- **Data-driven rendering** (board dibentuk dari JSON + state)
- Potensial separation of concerns (walau satu file): “render”, “state”, “rules/validation”, “hint”

##### Sertakan teknologi penting
- HTML/CSS/Vanilla JavaScript
- Netlify static hosting
- JSON static dataset
- Browser APIs: DOM, Fetch (kemungkinan), LocalStorage (kemungkinan untuk theme)

- “Netlify Static Hosting”
- “index.html (UI Shell)”
- “script.js (Game Logic + State + Rendering)”
- “styles.css (Theme & Layout)”
- “data/gameData.json (Puzzle Dataset)”
- “HTTP GET /index.html, /styles.css, /script.js”
- “HTTP GET /data/gameData.json”
- “DOM Events (click/select/submit/hint/new game/retry)”
- “Render/update DOM”
- Kotak biru: runtime components (Browser app parts)
- Kotak abu: static assets (HTML/CSS/JS/JSON)
- Kotak hijau: infrastructure (Netlify/CDN)

- Data puzzle berasal dari `data/gameData.json` via request statik.
- Semua fitur (hint/new game/retry/theme) ditempatkan sebagai sub-komponen logic di browser.
- Netlify muncul sebagai delivery/infrastructure, bukan sebagai compute backend.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Actors
    U["User (Player)"]:::actor

    %% Infrastructure / Delivery
    subgraph "Delivery Layer"
        N["Netlify Static Hosting / CDN"]:::infra

        subgraph "Deployed Static Assets"
            H["index.html (UI Shell)"]:::asset
            C["styles.css (Styling + Dark Theme)"]:::asset
            J["script.js (Client App Logic)"]:::asset
            D["data/gameData.json (Puzzle Dataset)"]:::data
            DIR["data/ (Static Data Directory)"]:::asset
            R["robots.txt (SEO / Crawling Rules)"]:::asset2
            G["google31b29fd4ff366284.html (Site Verification)"]:::asset2
            M["readme.md (Documentation)"]:::asset2
        end
    end

    %% Browser Runtime (Client-side only)
    subgraph "Browser Runtime (Client-side App)"
        B["Browser"]:::runtime

        subgraph "Client App (Vanilla JS + DOM)"
            UI["UI Layer (DOM Elements + Board UI)"]:::frontend
            EV["Event Handlers (click/select/submit)"]:::frontend
            GL["Game State + Rules (validate groups, scoring)"]:::logic
            NG["New Game (select puzzle, reset state)"]:::logic
            RT["Retry (reset state, same puzzle)"]:::logic
            HE["Hint Engine (choose items, highlight)"]:::logic
            TM["Theme Manager (dark/light toggle)"]:::logic
            DL["Data Loader (fetch + parse JSON)"]:::logic
            ST["In-Memory State (current puzzle + selections)"]:::state
            API["Browser APIs (DOM, Fetch, LocalStorage*)"]:::runtime
        end
    end

    %% Primary flows: load app
    U -->|"navigate"| B
    B -->|"HTTP_GET_/index.html"| N
    N -->|"serve_index.html"| H
    B -->|"HTTP_GET_/styles.css"| N
    N -->|"serve_styles.css"| C
    B -->|"HTTP_GET_/script.js"| N
    N -->|"serve_script.js"| J
    B -->|"HTTP_GET_/data/gameData.json"| N
    N -->|"serve_gameData.json"| D

    %% Runtime wiring inside browser
    H -->|"loads"| C
    H -->|"loads"| J

    J -->|"binds_events"| EV
    EV -->|"updates"| GL
    GL <-->|"reads/writes"| ST
    GL -->|"render/update_DOM"| UI

    %% Data loading
    J -->|"init_load"| DL
    DL -->|"uses_Fetch"| API
    DL -->|"parse_JSON"| D
    DL -->|"populate_puzzles"| ST
    ST -->|"data_driven_render"| UI

    %% Feature flows
    U -->|"DOM_events_select/submit"| EV
    EV -->|"validate_selection"| GL
    GL -->|"highlight/feedback"| UI

    U -->|"click_NewGame"| EV
    EV -->|"reset_and_next_puzzle"| NG
    NG -->|"update_state"| ST
    NG -->|"rerender"| UI

    U -->|"click_Retry"| EV
    EV -->|"reset_same_puzzle"| RT
    RT -->|"update_state"| ST
    RT -->|"rerender"| UI

    U -->|"click_Hint"| EV
    EV -->|"request_hint"| HE
    HE -->|"reads_state_solution"| ST
    HE -->|"highlight_items"| UI

    U -->|"toggle_Theme"| EV
    EV -->|"switch_theme"| TM
    TM -->|"update_CSS_class/vars"| UI
    TM -->|"optional_persist"| API

    %% Non-runtime artifacts (served but not part of gameplay loop)
    N -.->|"serve_SEO_artifacts"| R
    N -.->|"serve_verification"| G

    %% Click events (from component_mapping)
    click H "https://github.com/otniel113/animeconnections/blob/main/index.html"
    click C "https://github.com/otniel113/animeconnections/blob/main/styles.css"
    click J "https://github.com/otniel113/animeconnections/blob/main/script.js"
    click D "https://github.com/otniel113/animeconnections/blob/main/data/gameData.json"
    click DIR "https://github.com/otniel113/animeconnections/tree/main/data/"
    click R "https://github.com/otniel113/animeconnections/blob/main/robots.txt"
    click G "https://github.com/otniel113/animeconnections/blob/main/google31b29fd4ff366284.html"
    click M "https://github.com/otniel113/animeconnections/blob/main/readme.md"

    %% Styles
    classDef actor fill:#FFF3CD,stroke:#B08900,stroke-width:2px,color:#3A2B00;
    classDef infra fill:#D1FAE5,stroke:#0F766E,stroke-width:2px,color:#064E3B;
    classDef asset fill:#E5E7EB,stroke:#6B7280,stroke-width:1.5px,color:#111827;
    classDef asset2 fill:#F3F4F6,stroke:#9CA3AF,stroke-width:1.5px,color:#111827;
    classDef data fill:#E0F2FE,stroke:#0284C7,stroke-width:2px,color:#0C4A6E;
    classDef runtime fill:#DBEAFE,stroke:#2563EB,stroke-width:2px,color:#1E3A8A;
    classDef frontend fill:#BFDBFE,stroke:#1D4ED8,stroke-width:2px,color:#0B1F5E;
    classDef logic fill:#C7D2FE,stroke:#4F46E5,stroke-width:2px,color:#1E1B4B;
    classDef state fill:#FCE7F3,stroke:#BE185D,stroke-width:2px,color:#4A044E;
```
