# gvlax/memory-card-game-backend architecture

> Architecture diagram of the GitHub repository gvlax/memory-card-game-backend, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-19). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/gvlax/memory-card-game-backend
- Repository: https://github.com/gvlax/memory-card-game-backend

## Overview

This is a REST backend for a memory-card game. A client request reaches the HTTP server and Express app, then the versioned router dispatches card requests to a forwarding controller or score requests to handlers that read or create score records. Score operations pass through a small DB API to a NeDB file store; card requests are proxied to an external cards API. Startup connects the datastore before starting the server. The README documents the REST backend but gives no further behavior details; edges reflect the shown calls and routing.

Main entry points: [`services/router.js`](https://github.com/gvlax/memory-card-game-backend/blob/master/services/router.js) (Versioned router), [`bin/web-server.js`](https://github.com/gvlax/memory-card-game-backend/blob/master/bin/web-server.js) (HTTP server), [`services/datastore.js`](https://github.com/gvlax/memory-card-game-backend/blob/master/services/datastore.js) (Datastore), [`index.js`](https://github.com/gvlax/memory-card-game-backend/blob/master/index.js) (Startup orchestration)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Server runtime"]
  node_webserver["HTTP server<br/>[web-server.js]"]
  node_app["Express app<br/>[app.js]"]
  node_startup["Startup orchestration<br/>[index.js]"]
end

subgraph group_api["API handling"]
  node_router["Versioned router<br/>[router.js]"]
  node_cards["Cards proxy<br/>[cards.js]"]
  node_scorecontroller["Score handlers<br/>[scores.js]"]
end

subgraph group_scores["Score storage"]
  node_scoreapi["Scores DB API<br/>[scores.js]"]
  node_datastore["Datastore<br/>[datastore.js]"]
  node_scoredb[("Scores file<br/>[scores.db]")]
end

subgraph group_integrations["External systems"]
  node_cardservice["Cards API"]
end

node_client(("API client"))

node_client -->|"sends HTTP"| node_webserver
node_webserver -->|"serves requests"| node_app
node_app -->|"mounts routes"| node_router
node_router -->|"routes cards"| node_cards
node_router -->|"routes scores"| node_scorecontroller
node_cards -->|"forwards request"| node_cardservice
node_scorecontroller -->|"reads or creates"| node_scoreapi
node_scoreapi -->|"delegates operations"| node_datastore
node_datastore -->|"reads and writes"| node_scoredb
node_startup -->|"connects first"| node_datastore
node_startup -->|"starts server"| node_webserver

click node_webserver "https://github.com/gvlax/memory-card-game-backend/blob/master/bin/web-server.js"
click node_app "https://github.com/gvlax/memory-card-game-backend/blob/master/app.js"
click node_router "https://github.com/gvlax/memory-card-game-backend/blob/master/services/router.js"
click node_cards "https://github.com/gvlax/memory-card-game-backend/blob/master/controllers/cards.js"
click node_scorecontroller "https://github.com/gvlax/memory-card-game-backend/blob/master/controllers/scores.js"
click node_scoreapi "https://github.com/gvlax/memory-card-game-backend/blob/master/dbapi/scores.js"
click node_datastore "https://github.com/gvlax/memory-card-game-backend/blob/master/services/datastore.js"
click node_scoredb "https://github.com/gvlax/memory-card-game-backend/blob/master/scores.db"
click node_startup "https://github.com/gvlax/memory-card-game-backend/blob/master/index.js"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_webserver,node_app,node_startup,node_client toneBlue
class node_router,node_cards,node_scorecontroller toneAmber
class node_scoreapi,node_datastore,node_scoredb toneMint
class node_cardservice toneRose
```

## Components

### Server runtime

- [HTTP server](https://github.com/gvlax/memory-card-game-backend/blob/master/bin/web-server.js): `bin/web-server.js`
- [Express app](https://github.com/gvlax/memory-card-game-backend/blob/master/app.js): `app.js`
- [Startup orchestration](https://github.com/gvlax/memory-card-game-backend/blob/master/index.js): `index.js`

### API handling

- [Versioned router](https://github.com/gvlax/memory-card-game-backend/blob/master/services/router.js): `services/router.js`
- [Cards proxy](https://github.com/gvlax/memory-card-game-backend/blob/master/controllers/cards.js): `controllers/cards.js`
- [Score handlers](https://github.com/gvlax/memory-card-game-backend/blob/master/controllers/scores.js): `controllers/scores.js`

### Score storage

- [Scores DB API](https://github.com/gvlax/memory-card-game-backend/blob/master/dbapi/scores.js): `dbapi/scores.js`
- [Datastore](https://github.com/gvlax/memory-card-game-backend/blob/master/services/datastore.js): `services/datastore.js`
- [Scores file](https://github.com/gvlax/memory-card-game-backend/blob/master/scores.db): `scores.db`

### External systems

- **Cards API**

### Other components

- **API client**

## Connections

- API client → HTTP server: sends HTTP (evidence: `bin/web-server.js`)
- HTTP server → Express app: serves requests (evidence: `bin/web-server.js`)
- Express app → Versioned router: mounts routes (evidence: `app.js`)
- Versioned router → Cards proxy: routes cards (evidence: `services/router.js`)
- Versioned router → Score handlers: routes scores (evidence: `services/router.js`)
- Cards proxy → Cards API: forwards request (evidence: `controllers/cards.js`)
- Score handlers → Scores DB API: reads or creates (evidence: `controllers/scores.js`)
- Scores DB API → Datastore: delegates operations (evidence: `dbapi/scores.js`)
- Datastore → Scores file: reads and writes (evidence: `services/datastore.js`)
- Startup orchestration → Datastore: connects first (evidence: `index.js`)
- Startup orchestration → HTTP server: starts server (evidence: `index.js`)
