# esqi-meazza/doorprize-pindad-client architecture

> Architecture diagram of the GitHub repository esqi-meazza/doorprize-pindad-client, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/esqi-meazza/doorprize-pindad-client
- Repository: https://github.com/esqi-meazza/doorprize-pindad-client

## Overview

Doorprize Client is a React frontend for participant check-in, live doorprize displays, and event administration. Participants enter through the landing page; operators use protected admin screens to manage the event, participants, prizes, groups, winners, and settings, with a dedicated projector view. Shared authentication state and reusable controls support these screens, while the backend and Socket.IO provide external services. The README documents the major capabilities; sampled source confirms route wiring, participant CRUD, and the socket client. Other screen-to-service details are not fully evidenced in the excerpts.

Main entry points: [`src/routes/AppRoutes.jsx`](https://github.com/esqi-meazza/doorprize-pindad-client/blob/main/src/routes/AppRoutes.jsx) (Route registry), [`src/pages/admin/Peserta.jsx`](https://github.com/esqi-meazza/doorprize-pindad-client/blob/main/src/pages/admin/Peserta.jsx) (Participant management), [`src/context/AuthContext.jsx`](https://github.com/esqi-meazza/doorprize-pindad-client/blob/main/src/context/AuthContext.jsx) (Session and auth), [`src/config/socket.js`](https://github.com/esqi-meazza/doorprize-pindad-client/blob/main/src/config/socket.js) (Socket client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Entry and routing"]
  node_app["App shell<br/>[App.jsx]"]
  node_routes["Route registry<br/>[AppRoutes.jsx]"]
  node_guard["Auth guard<br/>[ProtectedRoute.jsx]"]
  node_landing["Participant check-in<br/>[LandingPage.jsx]"]
end

subgraph group_admin["Event administration"]
  node_adminlayout["Admin layout<br/>[AdminLayout.jsx]"]
  node_login["Admin login<br/>[Login.jsx]"]
  node_dashboard["Dashboard<br/>[Dashboard.jsx]"]
  node_event["Event management<br/>[MainEvent.jsx]"]
  node_participants["Participant management<br/>[Peserta.jsx]"]
  node_winners["Winner management<br/>[Pemenang.jsx]"]
  node_prizes["Prize management<br/>[Hadiah.jsx]"]
  node_groups["Prize groups<br/>[KelompokHadiah.jsx]"]
  node_settings["Event settings<br/>[Setting.jsx]"]
end

subgraph group_live["Live displays"]
  node_projector["Projector view"]
  node_display["Public live display<br/>[index.jsx]"]
end

subgraph group_shared["Shared application layer"]
  node_auth["Session and auth<br/>[AuthContext.jsx]"]
  node_storage[("Browser storage")]
  node_socket["Socket client<br/>[socket.js]"]
  node_controls["Common controls"]
  node_ui["UI components"]
  node_hooks["UI state hooks"]
end

node_participant(("Participant"))
node_operator(("Event operator"))
node_backend["Application backend"]

node_participant -->|"checks in"| node_landing
node_operator -->|"signs in"| node_login
node_app -->|"renders"| node_routes
node_routes -->|"routes to"| node_landing
node_routes -->|"routes to"| node_display
node_routes -->|"routes to"| node_login
node_routes -->|"protects routes"| node_guard
node_guard -->|"checks session"| node_auth
node_routes -->|"wraps admin"| node_adminlayout
node_routes -->|"routes to"| node_dashboard
node_routes -->|"routes to"| node_event
node_routes -->|"routes to"| node_participants
node_routes -->|"routes to"| node_winners
node_routes -->|"routes to"| node_prizes
node_routes -->|"routes to"| node_groups
node_routes -->|"routes to"| node_settings
node_routes -->|"routes to"| node_projector
node_auth -->|"reads and writes"| node_storage
node_participants -->|"CRUD requests"| node_backend
node_participants -->|"uses auth headers"| node_auth
node_landing -.->|"submits check-in"| node_backend
node_socket -->|"connects realtime"| node_backend
node_display -.->|"uses live updates"| node_socket
node_projector -.->|"uses live updates"| node_socket
node_dashboard -.->|"uses live updates"| node_socket
node_adminlayout -->|"uses confirmation"| node_controls
node_controls -->|"dialog uses"| node_ui
node_participants -->|"uses controls"| node_controls
node_participants -->|"uses components"| node_ui
node_participants -->|"uses state hooks"| node_hooks
node_login -->|"updates session"| node_auth

click node_app "https://github.com/esqi-meazza/doorprize-pindad-client/blob/main/src/App.jsx"
click node_routes "https://github.com/esqi-meazza/doorprize-pindad-client/blob/main/src/routes/AppRoutes.jsx"
click node_guard "https://github.com/esqi-meazza/doorprize-pindad-client/blob/main/src/routes/ProtectedRoute.jsx"
click node_landing "https://github.com/esqi-meazza/doorprize-pindad-client/blob/main/src/pages/public/LandingPage.jsx"
click node_auth "https://github.com/esqi-meazza/doorprize-pindad-client/blob/main/src/context/AuthContext.jsx"
click node_adminlayout "https://github.com/esqi-meazza/doorprize-pindad-client/blob/main/src/layouts/AdminLayout.jsx"
click node_login "https://github.com/esqi-meazza/doorprize-pindad-client/blob/main/src/pages/admin/Login.jsx"
click node_dashboard "https://github.com/esqi-meazza/doorprize-pindad-client/blob/main/src/pages/admin/Dashboard.jsx"
click node_event "https://github.com/esqi-meazza/doorprize-pindad-client/blob/main/src/pages/admin/MainEvent.jsx"
click node_participants "https://github.com/esqi-meazza/doorprize-pindad-client/blob/main/src/pages/admin/Peserta.jsx"
click node_winners "https://github.com/esqi-meazza/doorprize-pindad-client/blob/main/src/pages/admin/Pemenang.jsx"
click node_prizes "https://github.com/esqi-meazza/doorprize-pindad-client/blob/main/src/pages/admin/Hadiah.jsx"
click node_groups "https://github.com/esqi-meazza/doorprize-pindad-client/blob/main/src/pages/admin/KelompokHadiah.jsx"
click node_settings "https://github.com/esqi-meazza/doorprize-pindad-client/blob/main/src/pages/admin/Setting.jsx"
click node_projector "https://github.com/esqi-meazza/doorprize-pindad-client/blob/main/src/pages/admin/ProjectorDisplay.jsx"
click node_display "https://github.com/esqi-meazza/doorprize-pindad-client/blob/main/src/pages/public/display/index.jsx"
click node_socket "https://github.com/esqi-meazza/doorprize-pindad-client/blob/main/src/config/socket.js"
click node_controls "https://github.com/esqi-meazza/doorprize-pindad-client/tree/main/src/components/common"
click node_ui "https://github.com/esqi-meazza/doorprize-pindad-client/tree/main/src/components/ui"
click node_hooks "https://github.com/esqi-meazza/doorprize-pindad-client/tree/main/src/hooks"

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_app,node_routes,node_guard,node_landing toneBlue
class node_adminlayout,node_login,node_dashboard,node_event,node_participants,node_winners,node_prizes,node_groups,node_settings toneAmber
class node_projector,node_display toneMint
class node_auth,node_storage,node_socket,node_controls,node_ui,node_hooks toneRose
class node_participant,node_operator,node_backend toneIndigo
```

## Components

### Entry and routing

- [App shell](https://github.com/esqi-meazza/doorprize-pindad-client/blob/main/src/App.jsx): `src/App.jsx`
- [Route registry](https://github.com/esqi-meazza/doorprize-pindad-client/blob/main/src/routes/AppRoutes.jsx): `src/routes/AppRoutes.jsx`
- [Auth guard](https://github.com/esqi-meazza/doorprize-pindad-client/blob/main/src/routes/ProtectedRoute.jsx): `src/routes/ProtectedRoute.jsx`
- [Participant check-in](https://github.com/esqi-meazza/doorprize-pindad-client/blob/main/src/pages/public/LandingPage.jsx): `src/pages/public/LandingPage.jsx`

### Event administration

- [Admin layout](https://github.com/esqi-meazza/doorprize-pindad-client/blob/main/src/layouts/AdminLayout.jsx): `src/layouts/AdminLayout.jsx`
- [Admin login](https://github.com/esqi-meazza/doorprize-pindad-client/blob/main/src/pages/admin/Login.jsx): `src/pages/admin/Login.jsx`
- [Dashboard](https://github.com/esqi-meazza/doorprize-pindad-client/blob/main/src/pages/admin/Dashboard.jsx): `src/pages/admin/Dashboard.jsx`
- [Event management](https://github.com/esqi-meazza/doorprize-pindad-client/blob/main/src/pages/admin/MainEvent.jsx): `src/pages/admin/MainEvent.jsx`
- [Participant management](https://github.com/esqi-meazza/doorprize-pindad-client/blob/main/src/pages/admin/Peserta.jsx): `src/pages/admin/Peserta.jsx`
- [Winner management](https://github.com/esqi-meazza/doorprize-pindad-client/blob/main/src/pages/admin/Pemenang.jsx): `src/pages/admin/Pemenang.jsx`
- [Prize management](https://github.com/esqi-meazza/doorprize-pindad-client/blob/main/src/pages/admin/Hadiah.jsx): `src/pages/admin/Hadiah.jsx`
- [Prize groups](https://github.com/esqi-meazza/doorprize-pindad-client/blob/main/src/pages/admin/KelompokHadiah.jsx): `src/pages/admin/KelompokHadiah.jsx`
- [Event settings](https://github.com/esqi-meazza/doorprize-pindad-client/blob/main/src/pages/admin/Setting.jsx): `src/pages/admin/Setting.jsx`

### Live displays

- [Projector view](https://github.com/esqi-meazza/doorprize-pindad-client/blob/main/src/pages/admin/ProjectorDisplay.jsx): `src/pages/admin/ProjectorDisplay.jsx`
- [Public live display](https://github.com/esqi-meazza/doorprize-pindad-client/blob/main/src/pages/public/display/index.jsx): `src/pages/public/display/index.jsx`

### Shared application layer

- [Session and auth](https://github.com/esqi-meazza/doorprize-pindad-client/blob/main/src/context/AuthContext.jsx): `src/context/AuthContext.jsx`
- **Browser storage**
- [Socket client](https://github.com/esqi-meazza/doorprize-pindad-client/blob/main/src/config/socket.js): `src/config/socket.js`
- [Common controls](https://github.com/esqi-meazza/doorprize-pindad-client/tree/main/src/components/common): `src/components/common`
- [UI components](https://github.com/esqi-meazza/doorprize-pindad-client/tree/main/src/components/ui): `src/components/ui`
- [UI state hooks](https://github.com/esqi-meazza/doorprize-pindad-client/tree/main/src/hooks): `src/hooks`

### Other components

- **Participant**
- **Event operator**
- **Application backend**

## Connections

- Participant → Participant check-in: checks in
- Event operator → Admin login: signs in
- App shell → Route registry: renders (evidence: `src/App.jsx`)
- Route registry → Participant check-in: routes to (evidence: `src/routes/AppRoutes.jsx`)
- Route registry → Public live display: routes to (evidence: `src/routes/AppRoutes.jsx`)
- Route registry → Admin login: routes to (evidence: `src/routes/AppRoutes.jsx`)
- Route registry → Auth guard: protects routes (evidence: `src/routes/AppRoutes.jsx`)
- Auth guard → Session and auth: checks session (evidence: `src/routes/ProtectedRoute.jsx`)
- Route registry → Admin layout: wraps admin (evidence: `src/routes/AppRoutes.jsx`)
- Route registry → Dashboard: routes to (evidence: `src/routes/AppRoutes.jsx`)
- Route registry → Event management: routes to (evidence: `src/routes/AppRoutes.jsx`)
- Route registry → Participant management: routes to (evidence: `src/routes/AppRoutes.jsx`)
- Route registry → Winner management: routes to (evidence: `src/routes/AppRoutes.jsx`)
- Route registry → Prize management: routes to (evidence: `src/routes/AppRoutes.jsx`)
- Route registry → Prize groups: routes to (evidence: `src/routes/AppRoutes.jsx`)
- Route registry → Event settings: routes to (evidence: `src/routes/AppRoutes.jsx`)
- Route registry → Projector view: routes to (evidence: `src/routes/AppRoutes.jsx`)
- Session and auth → Browser storage: reads and writes (evidence: `src/context/AuthContext.jsx`)
- Participant management → Application backend: CRUD requests (evidence: `src/pages/admin/Peserta.jsx`)
- Participant management → Session and auth: uses auth headers (evidence: `src/pages/admin/Peserta.jsx`)
- Participant check-in → Application backend: submits check-in
- Socket client → Application backend: connects realtime (evidence: `src/config/socket.js`)
- Public live display → Socket client: uses live updates (evidence: `src/pages/public/display/index.jsx`)
- Projector view → Socket client: uses live updates (evidence: `src/pages/admin/ProjectorDisplay.jsx`)
- Dashboard → Socket client: uses live updates (evidence: `src/pages/admin/Dashboard.jsx`)
- Admin layout → Common controls: uses confirmation (evidence: `src/layouts/AdminLayout.jsx`)
- Common controls → UI components: dialog uses (evidence: `src/components/common/ConfirmDialog.jsx`)
- Participant management → Common controls: uses controls (evidence: `src/pages/admin/Peserta.jsx`)
- Participant management → UI components: uses components (evidence: `src/pages/admin/Peserta.jsx`)
- Participant management → UI state hooks: uses state hooks (evidence: `src/pages/admin/Peserta.jsx`)
- Admin login → Session and auth: updates session (evidence: `src/pages/admin/Login.jsx`)
