# burakuray/cizgi-kacis-oyunu architecture

> Architecture diagram of the GitHub repository burakuray/cizgi-kacis-oyunu, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/burakuray/cizgi-kacis-oyunu
- Repository: https://github.com/burakuray/cizgi-kacis-oyunu

## Overview

This workspace contains several independent products rather than one end-to-end application: the Çizgi Kaçış mobile game, an Express API, a component-preview sandbox, and shared runtime libraries. The game’s intended player journey spans play, progression, story, map, journal, and leaderboard features; its implementation excerpts show game rules, artwork, and progression logic, but not the screen wiring. The API’s middleware-to-route wiring and the preview app’s entry point are visible. No README was provided, so undocumented relationships are omitted; dashed edges mark unverified user entry points.

Main entry points: [`artifacts/api-server/src/app.ts`](https://github.com/burakuray/cizgi-kacis-oyunu/blob/main/artifacts/api-server/src/app.ts) (HTTP Application), [`artifacts/api-server/src/routes/index.ts`](https://github.com/burakuray/cizgi-kacis-oyunu/blob/main/artifacts/api-server/src/routes/index.ts) (API Routes), [`artifacts/mockup-sandbox/src/main.tsx`](https://github.com/burakuray/cizgi-kacis-oyunu/blob/main/artifacts/mockup-sandbox/src/main.tsx) (Web Entry), [`artifacts/mockup-sandbox/src/App.tsx`](https://github.com/burakuray/cizgi-kacis-oyunu/blob/main/artifacts/mockup-sandbox/src/App.tsx) (Preview App)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_game["Çizgi Kaçış Game"]
  node_gameplay["Game Screen<br/>[index.tsx]"]
  node_rules["Game Rules<br/>[game-logic.ts]"]
  node_boardart["Board Artwork<br/>[boardArt.ts]"]
  node_boardview["Board Renderer<br/>[BoardArt.tsx]"]
  node_progress["Progression Rules<br/>[progress.ts]"]
  node_story["Story Data<br/>[story.ts]"]
  node_progressstore["Progress Storage<br/>[progressStore.ts]"]
  node_map["Level Map<br/>[map.tsx]"]
  node_journal["Story Journal<br/>[journal.tsx]"]
  node_leaderboard["Leaderboard<br/>[leaderboard.tsx]"]
end

subgraph group_api["API Service"]
  node_apiapp["HTTP Application<br/>[app.ts]"]
  node_router["API Routes<br/>[index.ts]"]
  node_health["Health Route<br/>[health.ts]"]
  node_logger["Request Logger<br/>[logger.ts]"]
end

subgraph group_preview["Component Preview"]
  node_webentry["Web Entry<br/>[main.tsx]"]
  node_previewapp["Preview App<br/>[App.tsx]"]
  node_plugin["Discovery Plugin"]
end

subgraph group_shared["Shared Libraries"]
  node_fetch["HTTP Fetch<br/>[custom-fetch.ts]"]
  node_db[("Database Client<br/>[index.ts]")]
end

node_player(("Player"))
node_apiuser(("API Caller"))
node_previewuser(("Canvas User"))

node_player -.->|"plays"| node_gameplay
node_boardart -->|"imports types"| node_rules
node_progress -->|"imports rules"| node_story
node_apiuser -.->|"sends requests"| node_apiapp
node_apiapp -->|"mounts routes"| node_router
node_apiapp -->|"configures logging"| node_logger
node_router -->|"registers route"| node_health
node_previewuser -.->|"opens preview"| node_webentry
node_webentry -->|"renders"| node_previewapp
node_plugin -->|"generates component registry"| node_previewapp

click node_gameplay "https://github.com/burakuray/cizgi-kacis-oyunu/blob/main/artifacts/cizgi-kacis/app/index.tsx"
click node_rules "https://github.com/burakuray/cizgi-kacis-oyunu/blob/main/artifacts/cizgi-kacis/game-logic.ts"
click node_boardart "https://github.com/burakuray/cizgi-kacis-oyunu/blob/main/artifacts/cizgi-kacis/lib/boardArt.ts"
click node_boardview "https://github.com/burakuray/cizgi-kacis-oyunu/blob/main/artifacts/cizgi-kacis/components/BoardArt.tsx"
click node_progress "https://github.com/burakuray/cizgi-kacis-oyunu/blob/main/artifacts/cizgi-kacis/lib/progress.ts"
click node_story "https://github.com/burakuray/cizgi-kacis-oyunu/blob/main/artifacts/cizgi-kacis/lib/story.ts"
click node_progressstore "https://github.com/burakuray/cizgi-kacis-oyunu/blob/main/artifacts/cizgi-kacis/lib/progressStore.ts"
click node_map "https://github.com/burakuray/cizgi-kacis-oyunu/blob/main/artifacts/cizgi-kacis/app/map.tsx"
click node_journal "https://github.com/burakuray/cizgi-kacis-oyunu/blob/main/artifacts/cizgi-kacis/app/journal.tsx"
click node_leaderboard "https://github.com/burakuray/cizgi-kacis-oyunu/blob/main/artifacts/cizgi-kacis/app/leaderboard.tsx"
click node_apiapp "https://github.com/burakuray/cizgi-kacis-oyunu/blob/main/artifacts/api-server/src/app.ts"
click node_router "https://github.com/burakuray/cizgi-kacis-oyunu/blob/main/artifacts/api-server/src/routes/index.ts"
click node_health "https://github.com/burakuray/cizgi-kacis-oyunu/blob/main/artifacts/api-server/src/routes/health.ts"
click node_logger "https://github.com/burakuray/cizgi-kacis-oyunu/blob/main/artifacts/api-server/src/lib/logger.ts"
click node_webentry "https://github.com/burakuray/cizgi-kacis-oyunu/blob/main/artifacts/mockup-sandbox/src/main.tsx"
click node_previewapp "https://github.com/burakuray/cizgi-kacis-oyunu/blob/main/artifacts/mockup-sandbox/src/App.tsx"
click node_plugin "https://github.com/burakuray/cizgi-kacis-oyunu/blob/main/artifacts/mockup-sandbox/mockupPreviewPlugin.ts"
click node_fetch "https://github.com/burakuray/cizgi-kacis-oyunu/blob/main/lib/api-client-react/src/custom-fetch.ts"
click node_db "https://github.com/burakuray/cizgi-kacis-oyunu/blob/main/lib/db/src/index.ts"

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_gameplay,node_rules,node_boardart,node_boardview,node_progress,node_story,node_progressstore,node_map,node_journal,node_leaderboard,node_previewuser toneBlue
class node_apiapp,node_router,node_health,node_logger toneAmber
class node_webentry,node_previewapp,node_plugin,node_apiuser toneMint
class node_fetch,node_db toneRose
class node_player toneIndigo
```

## Components

### Çizgi Kaçış Game

- [Game Screen](https://github.com/burakuray/cizgi-kacis-oyunu/blob/main/artifacts/cizgi-kacis/app/index.tsx): `artifacts/cizgi-kacis/app/index.tsx`
- [Game Rules](https://github.com/burakuray/cizgi-kacis-oyunu/blob/main/artifacts/cizgi-kacis/game-logic.ts): `artifacts/cizgi-kacis/game-logic.ts`
- [Board Artwork](https://github.com/burakuray/cizgi-kacis-oyunu/blob/main/artifacts/cizgi-kacis/lib/boardArt.ts): `artifacts/cizgi-kacis/lib/boardArt.ts`
- [Board Renderer](https://github.com/burakuray/cizgi-kacis-oyunu/blob/main/artifacts/cizgi-kacis/components/BoardArt.tsx): `artifacts/cizgi-kacis/components/BoardArt.tsx`
- [Progression Rules](https://github.com/burakuray/cizgi-kacis-oyunu/blob/main/artifacts/cizgi-kacis/lib/progress.ts): `artifacts/cizgi-kacis/lib/progress.ts`
- [Story Data](https://github.com/burakuray/cizgi-kacis-oyunu/blob/main/artifacts/cizgi-kacis/lib/story.ts): `artifacts/cizgi-kacis/lib/story.ts`
- [Progress Storage](https://github.com/burakuray/cizgi-kacis-oyunu/blob/main/artifacts/cizgi-kacis/lib/progressStore.ts): `artifacts/cizgi-kacis/lib/progressStore.ts`
- [Level Map](https://github.com/burakuray/cizgi-kacis-oyunu/blob/main/artifacts/cizgi-kacis/app/map.tsx): `artifacts/cizgi-kacis/app/map.tsx`
- [Story Journal](https://github.com/burakuray/cizgi-kacis-oyunu/blob/main/artifacts/cizgi-kacis/app/journal.tsx): `artifacts/cizgi-kacis/app/journal.tsx`
- [Leaderboard](https://github.com/burakuray/cizgi-kacis-oyunu/blob/main/artifacts/cizgi-kacis/app/leaderboard.tsx): `artifacts/cizgi-kacis/app/leaderboard.tsx`

### API Service

- [HTTP Application](https://github.com/burakuray/cizgi-kacis-oyunu/blob/main/artifacts/api-server/src/app.ts): `artifacts/api-server/src/app.ts`
- [API Routes](https://github.com/burakuray/cizgi-kacis-oyunu/blob/main/artifacts/api-server/src/routes/index.ts): `artifacts/api-server/src/routes/index.ts`
- [Health Route](https://github.com/burakuray/cizgi-kacis-oyunu/blob/main/artifacts/api-server/src/routes/health.ts): `artifacts/api-server/src/routes/health.ts`
- [Request Logger](https://github.com/burakuray/cizgi-kacis-oyunu/blob/main/artifacts/api-server/src/lib/logger.ts): `artifacts/api-server/src/lib/logger.ts`

### Component Preview

- [Web Entry](https://github.com/burakuray/cizgi-kacis-oyunu/blob/main/artifacts/mockup-sandbox/src/main.tsx): `artifacts/mockup-sandbox/src/main.tsx`
- [Preview App](https://github.com/burakuray/cizgi-kacis-oyunu/blob/main/artifacts/mockup-sandbox/src/App.tsx): `artifacts/mockup-sandbox/src/App.tsx`
- [Discovery Plugin](https://github.com/burakuray/cizgi-kacis-oyunu/blob/main/artifacts/mockup-sandbox/mockupPreviewPlugin.ts): `artifacts/mockup-sandbox/mockupPreviewPlugin.ts`

### Shared Libraries

- [HTTP Fetch](https://github.com/burakuray/cizgi-kacis-oyunu/blob/main/lib/api-client-react/src/custom-fetch.ts): `lib/api-client-react/src/custom-fetch.ts`
- [Database Client](https://github.com/burakuray/cizgi-kacis-oyunu/blob/main/lib/db/src/index.ts): `lib/db/src/index.ts`

### Other components

- **Player**
- **API Caller**
- **Canvas User**

## Connections

- Player → Game Screen: plays
- Board Artwork → Game Rules: imports types (evidence: `artifacts/cizgi-kacis/lib/boardArt.ts`)
- Progression Rules → Story Data: imports rules (evidence: `artifacts/cizgi-kacis/lib/progress.ts`)
- API Caller → HTTP Application: sends requests
- HTTP Application → API Routes: mounts routes (evidence: `artifacts/api-server/src/app.ts`)
- HTTP Application → Request Logger: configures logging (evidence: `artifacts/api-server/src/app.ts`)
- API Routes → Health Route: registers route (evidence: `artifacts/api-server/src/routes/index.ts`)
- Canvas User → Web Entry: opens preview
- Web Entry → Preview App: renders (evidence: `artifacts/mockup-sandbox/src/main.tsx`)
- Discovery Plugin → Preview App: generates component registry (evidence: `artifacts/mockup-sandbox/mockupPreviewPlugin.ts`)
