# kennylimz/anime-character-guessr architecture

> Architecture diagram of the GitHub repository kennylimz/anime-character-guessr, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-04-24). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/kennylimz/anime-character-guessr
- Repository: https://github.com/kennylimz/anime-character-guessr

## Overview

##### Project Type & Purpose
- This is a full-stack web application: a React-based frontend (“client_v3”), two Node.js/Express backends (“server_v3” for game logic, “data_server” for serving static JSON data), plus an Nginx reverse proxy and MongoDB.
- Purpose: let users guess an anime character, get feedback on closeness, track guesses, and display related info.

##### File-Structure Breakdown
Top-level:
– client_v3/…: React (Vite) single-page app, serves UI, assets, uses Axios, anime.js for animations.
– server_v3/…: Express game server, handles API endpoints, stores user games & guesses, connects to MongoDB.
– data_server/…: lightweight Express static server, hosts processed JSON (character tags, mappings) for fast lookup.
– nginx/: custom Nginx config acting as reverse proxy / load balancer.
– docker-compose.yml: defines multi-container setup (frontend, game server, data server, MongoDB, Nginx).

##### Key README Insights
- Local dev: each service runs on its own port via npm run dev.
- Dockerized: environment variables set domain, ports, Mongo URI, AES_SECRET, then `docker-compose up`.

## Diagram (Mermaid)

```mermaid
flowchart TB
    subgraph "Docker Network"
        direction TB
        Nginx["Nginx Reverse Proxy\nPort: 80"]:::proxy
        Game["Game Server\nExpress API\nPort: 3001"]:::backend
        Data["Data Server\nStatic JSON\nPort: 3002"]:::backend
        DB["MongoDB\nPort: 27017"]:::database
    end

    Browser["Browser/Client (React SPA)"]:::frontend
    Bangumi["External API (Bangumi)"]:::external
    DockerCompose["Docker Compose"]:::infrastructure

    Browser -->|"HTTP/HTTPS"| Nginx
    Nginx -->|"Serve static assets"| Browser
    Browser -->|"GET /api/guess\nPOST /api/user"| Nginx
    Nginx -->|"Proxy /api/game"| Game
    Nginx -->|"Proxy /api/data"| Data
    Game -->|"DB queries\nMONGODB_URI"| DB
    Game -->|"GET /api/tags"| Data
    Bangumi -->|"Nightly batch update"| Data
    DockerCompose -->|"orchestrates containers"| Nginx
    DockerCompose -->|"orchestrates containers"| Game
    DockerCompose -->|"orchestrates containers"| Data
    DockerCompose -->|"orchestrates containers"| DB

    click Browser "https://github.com/kennylimz/anime-character-guessr/tree/main/client_v3/"
    click Nginx "https://github.com/kennylimz/anime-character-guessr/blob/main/nginx/nginx.conf"
    click Game "https://github.com/kennylimz/anime-character-guessr/blob/main/server_v3/server.js"
    click Data "https://github.com/kennylimz/anime-character-guessr/blob/main/data_server/server.js"
    click Bangumi "https://github.com/kennylimz/anime-character-guessr/blob/main/data_server/data/process.ipynb"
    click DockerCompose "https://github.com/kennylimz/anime-character-guessr/blob/main/docker-compose.yml"

    classDef frontend fill:#AEDFF7,stroke:#036;
    classDef proxy fill:#DFF7AE,stroke:#360;
    classDef backend fill:#AEE7AE,stroke:#080;
    classDef database fill:#FAD290,stroke:#F80;
    classDef external fill:#CCCCCC,stroke:#888;
    classDef infrastructure fill:#E3DAF8,stroke:#620;
```
