# glaybyonest/booking-system-reverseflow architecture

> Architecture diagram of the GitHub repository glaybyonest/booking-system-reverseflow, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-30). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/glaybyonest/booking-system-reverseflow
- Repository: https://github.com/glaybyonest/booking-system-reverseflow

## Overview

ReserveFlow combines a public event-discovery catalog (including Moscow-only imported events) with an internal seat-booking and mock-payment product. The main customer journey is event discovery, session/seat selection, timed hold, checkout/payment, and booking history; a separate admin path manages hall/session layouts and imported-event promotion/sync. The graph reflects documented capabilities, but source excerpts do not expose most router wiring or all integrations, so uncertain links are omitted.

Main entry points: [`backend/internal/app/app.go`](https://github.com/glaybyonest/booking-system-reverseflow/blob/main/backend/internal/app/app.go) (Backend API), [`frontend/src/app`](https://github.com/glaybyonest/booking-system-reverseflow/tree/main/frontend/src/app) (Next.js app), [`backend/internal/infrastructure/db/postgres.go`](https://github.com/glaybyonest/booking-system-reverseflow/blob/main/backend/internal/infrastructure/db/postgres.go) (PostgreSQL), [`frontend/src/app/api/backend/[...path]/route.ts`](https://github.com/glaybyonest/booking-system-reverseflow/blob/main/frontend/src/app/api/backend/%5B...path%5D/route.ts) (Backend proxy)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web experience"]
  node_frontend["Next.js app"]
  node_discovery["Event discovery<br/>[event-list.tsx]"]
  node_eventmap["Events map"]
  node_sessions["Session listing<br/>[session-list.tsx]"]
  node_seatselect["Seat selection<br/>[seat-selection.tsx]"]
  node_checkout["Checkout"]
  node_history["Booking history"]
  node_adminlayout["Layout editor<br/>[layout-editor.tsx]"]
  node_authui["Authentication UI<br/>[login-form.tsx]"]
  node_webproxy["Backend proxy<br/>[route.ts]"]
end

subgraph group_booking["Booking domain"]
  node_sessionservice["Session service<br/>[service.go]"]
  node_seatservice["Seat inventory<br/>[service.go]"]
  node_bookingservice["Booking and holds<br/>[service.go]"]
  node_paymentservice["Mock payments<br/>[service.go]"]
  node_layoutservice["Layout management<br/>[layouts.go]"]
end

subgraph group_catalog["Events and sync"]
  node_eventservice["Event service<br/>[service.go]"]
  node_integrations["External event sync<br/>[service.go]"]
  node_afishaseed["Afisha importer<br/>[main.go]"]
end

subgraph group_platform["Platform services"]
  node_api["Backend API<br/>[app.go]"]
  node_auth["Identity service<br/>[service.go]"]
  node_notificationservice["Notifications<br/>[service.go]"]
  node_worker["Sync worker<br/>[main.go]"]
  node_postgres[("PostgreSQL<br/>[postgres.go]")]
  node_redis[("Redis cache<br/>[client.go]")]
end

node_visitor(("Customer"))
node_admin(("Administrator"))
node_providers["KudaGo / Timepad"]

node_visitor -->|"browses"| node_frontend
node_admin -->|"manages"| node_frontend
node_frontend -->|"renders"| node_discovery
node_frontend -->|"renders"| node_eventmap
node_frontend -.->|"renders"| node_sessions
node_frontend -.->|"renders"| node_seatselect
node_frontend -->|"renders"| node_checkout
node_frontend -->|"renders"| node_history
node_frontend -.->|"renders"| node_adminlayout
node_frontend -->|"renders"| node_authui
node_discovery -.->|"requests"| node_webproxy
node_eventmap -.->|"requests"| node_webproxy
node_sessions -.->|"requests"| node_webproxy
node_seatselect -.->|"requests"| node_webproxy
node_checkout -.->|"requests"| node_webproxy
node_history -.->|"requests"| node_webproxy
node_authui -.->|"authenticates"| node_webproxy
node_webproxy -->|"forwards"| node_api
node_visitor -.->|"calls API"| node_api
node_api -.->|"dispatches"| node_auth
node_api -.->|"dispatches"| node_eventservice
node_api -.->|"dispatches"| node_sessionservice
node_api -.->|"dispatches"| node_seatservice
node_api -.->|"dispatches"| node_bookingservice
node_api -.->|"dispatches"| node_paymentservice
node_api -.->|"dispatches"| node_notificationservice
node_api -.->|"dispatches"| node_integrations
node_api -.->|"dispatches"| node_layoutservice
node_bookingservice -->|"caches holds"| node_redis
node_paymentservice -->|"caches replay"| node_redis
node_worker -.->|"runs sync"| node_integrations
node_integrations -->|"imports events"| node_providers
node_admin -->|"requests sync"| node_integrations
node_admin -->|"promotes events"| node_eventservice
node_afishaseed -->|"imports records"| node_postgres
node_eventservice -.->|"reads/writes"| node_postgres
node_sessionservice -.->|"reads/writes"| node_postgres
node_seatservice -.->|"reads/writes"| node_postgres
node_bookingservice -.->|"reads/writes"| node_postgres
node_paymentservice -.->|"reads/writes"| node_postgres
node_auth -.->|"reads/writes"| node_postgres
node_notificationservice -.->|"reads/writes"| node_postgres
node_integrations -.->|"reads/writes"| node_postgres
node_layoutservice -.->|"reads/writes"| node_postgres

click node_frontend "https://github.com/glaybyonest/booking-system-reverseflow/tree/main/frontend/src/app"
click node_discovery "https://github.com/glaybyonest/booking-system-reverseflow/blob/main/frontend/src/features/event-list/event-list.tsx"
click node_eventmap "https://github.com/glaybyonest/booking-system-reverseflow/blob/main/frontend/src/features/events-map/events-map-page.tsx"
click node_sessions "https://github.com/glaybyonest/booking-system-reverseflow/blob/main/frontend/src/features/session-list/session-list.tsx"
click node_seatselect "https://github.com/glaybyonest/booking-system-reverseflow/blob/main/frontend/src/features/seat-selection/seat-selection.tsx"
click node_checkout "https://github.com/glaybyonest/booking-system-reverseflow/blob/main/frontend/src/features/booking-checkout/checkout-client.tsx"
click node_history "https://github.com/glaybyonest/booking-system-reverseflow/blob/main/frontend/src/features/booking-history/booking-history.tsx"
click node_adminlayout "https://github.com/glaybyonest/booking-system-reverseflow/blob/main/frontend/src/features/admin-layout/layout-editor.tsx"
click node_authui "https://github.com/glaybyonest/booking-system-reverseflow/blob/main/frontend/src/features/auth/login-form.tsx"
click node_webproxy "https://github.com/glaybyonest/booking-system-reverseflow/blob/main/frontend/src/app/api/backend/%5B...path%5D/route.ts"
click node_api "https://github.com/glaybyonest/booking-system-reverseflow/blob/main/backend/internal/app/app.go"
click node_auth "https://github.com/glaybyonest/booking-system-reverseflow/blob/main/backend/internal/modules/auth/application/service.go"
click node_eventservice "https://github.com/glaybyonest/booking-system-reverseflow/blob/main/backend/internal/modules/events/application/service.go"
click node_sessionservice "https://github.com/glaybyonest/booking-system-reverseflow/blob/main/backend/internal/modules/sessions/application/service.go"
click node_seatservice "https://github.com/glaybyonest/booking-system-reverseflow/blob/main/backend/internal/modules/seats/application/service.go"
click node_bookingservice "https://github.com/glaybyonest/booking-system-reverseflow/blob/main/backend/internal/modules/bookings/application/service.go"
click node_paymentservice "https://github.com/glaybyonest/booking-system-reverseflow/blob/main/backend/internal/modules/payments/application/service.go"
click node_notificationservice "https://github.com/glaybyonest/booking-system-reverseflow/blob/main/backend/internal/modules/notifications/application/service.go"
click node_integrations "https://github.com/glaybyonest/booking-system-reverseflow/blob/main/backend/internal/modules/integrations/application/service.go"
click node_layoutservice "https://github.com/glaybyonest/booking-system-reverseflow/blob/main/backend/internal/modules/integrations/application/layouts.go"
click node_worker "https://github.com/glaybyonest/booking-system-reverseflow/blob/main/backend/cmd/worker/main.go"
click node_postgres "https://github.com/glaybyonest/booking-system-reverseflow/blob/main/backend/internal/infrastructure/db/postgres.go"
click node_redis "https://github.com/glaybyonest/booking-system-reverseflow/blob/main/backend/internal/infrastructure/redis/client.go"
click node_afishaseed "https://github.com/glaybyonest/booking-system-reverseflow/blob/main/backend/cmd/seed-afisha/main.go"

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_frontend,node_discovery,node_eventmap,node_sessions,node_seatselect,node_checkout,node_history,node_adminlayout,node_authui,node_webproxy toneBlue
class node_sessionservice,node_seatservice,node_bookingservice,node_paymentservice,node_layoutservice toneAmber
class node_eventservice,node_integrations,node_afishaseed toneMint
class node_api,node_auth,node_notificationservice,node_worker,node_postgres,node_redis toneRose
class node_visitor,node_admin,node_providers toneIndigo
```

## Components

### Web experience

- [Next.js app](https://github.com/glaybyonest/booking-system-reverseflow/tree/main/frontend/src/app): `frontend/src/app`
- [Event discovery](https://github.com/glaybyonest/booking-system-reverseflow/blob/main/frontend/src/features/event-list/event-list.tsx): `frontend/src/features/event-list/event-list.tsx`
- [Events map](https://github.com/glaybyonest/booking-system-reverseflow/blob/main/frontend/src/features/events-map/events-map-page.tsx): `frontend/src/features/events-map/events-map-page.tsx`
- [Session listing](https://github.com/glaybyonest/booking-system-reverseflow/blob/main/frontend/src/features/session-list/session-list.tsx): `frontend/src/features/session-list/session-list.tsx`
- [Seat selection](https://github.com/glaybyonest/booking-system-reverseflow/blob/main/frontend/src/features/seat-selection/seat-selection.tsx): `frontend/src/features/seat-selection/seat-selection.tsx`
- [Checkout](https://github.com/glaybyonest/booking-system-reverseflow/blob/main/frontend/src/features/booking-checkout/checkout-client.tsx): `frontend/src/features/booking-checkout/checkout-client.tsx`
- [Booking history](https://github.com/glaybyonest/booking-system-reverseflow/blob/main/frontend/src/features/booking-history/booking-history.tsx): `frontend/src/features/booking-history/booking-history.tsx`
- [Layout editor](https://github.com/glaybyonest/booking-system-reverseflow/blob/main/frontend/src/features/admin-layout/layout-editor.tsx): `frontend/src/features/admin-layout/layout-editor.tsx`
- [Authentication UI](https://github.com/glaybyonest/booking-system-reverseflow/blob/main/frontend/src/features/auth/login-form.tsx): `frontend/src/features/auth/login-form.tsx`
- [Backend proxy](https://github.com/glaybyonest/booking-system-reverseflow/blob/main/frontend/src/app/api/backend/%5B...path%5D/route.ts): `frontend/src/app/api/backend/[...path]/route.ts`

### Booking domain

- [Session service](https://github.com/glaybyonest/booking-system-reverseflow/blob/main/backend/internal/modules/sessions/application/service.go): `backend/internal/modules/sessions/application/service.go`
- [Seat inventory](https://github.com/glaybyonest/booking-system-reverseflow/blob/main/backend/internal/modules/seats/application/service.go): `backend/internal/modules/seats/application/service.go`
- [Booking and holds](https://github.com/glaybyonest/booking-system-reverseflow/blob/main/backend/internal/modules/bookings/application/service.go): `backend/internal/modules/bookings/application/service.go`
- [Mock payments](https://github.com/glaybyonest/booking-system-reverseflow/blob/main/backend/internal/modules/payments/application/service.go): `backend/internal/modules/payments/application/service.go`
- [Layout management](https://github.com/glaybyonest/booking-system-reverseflow/blob/main/backend/internal/modules/integrations/application/layouts.go): `backend/internal/modules/integrations/application/layouts.go`

### Events and sync

- [Event service](https://github.com/glaybyonest/booking-system-reverseflow/blob/main/backend/internal/modules/events/application/service.go): `backend/internal/modules/events/application/service.go`
- [External event sync](https://github.com/glaybyonest/booking-system-reverseflow/blob/main/backend/internal/modules/integrations/application/service.go): `backend/internal/modules/integrations/application/service.go`
- [Afisha importer](https://github.com/glaybyonest/booking-system-reverseflow/blob/main/backend/cmd/seed-afisha/main.go): `backend/cmd/seed-afisha/main.go`

### Platform services

- [Backend API](https://github.com/glaybyonest/booking-system-reverseflow/blob/main/backend/internal/app/app.go): `backend/internal/app/app.go`
- [Identity service](https://github.com/glaybyonest/booking-system-reverseflow/blob/main/backend/internal/modules/auth/application/service.go): `backend/internal/modules/auth/application/service.go`
- [Notifications](https://github.com/glaybyonest/booking-system-reverseflow/blob/main/backend/internal/modules/notifications/application/service.go): `backend/internal/modules/notifications/application/service.go`
- [Sync worker](https://github.com/glaybyonest/booking-system-reverseflow/blob/main/backend/cmd/worker/main.go): `backend/cmd/worker/main.go`
- [PostgreSQL](https://github.com/glaybyonest/booking-system-reverseflow/blob/main/backend/internal/infrastructure/db/postgres.go): `backend/internal/infrastructure/db/postgres.go`
- [Redis cache](https://github.com/glaybyonest/booking-system-reverseflow/blob/main/backend/internal/infrastructure/redis/client.go): `backend/internal/infrastructure/redis/client.go`

### Other components

- **Customer**
- **Administrator**
- **KudaGo / Timepad**

## Connections

- Customer → Next.js app: browses
- Administrator → Next.js app: manages
- Next.js app → Event discovery: renders (evidence: `frontend/src/app/events/page.tsx`)
- Next.js app → Events map: renders
- Next.js app → Session listing: renders
- Next.js app → Seat selection: renders
- Next.js app → Checkout: renders
- Next.js app → Booking history: renders (evidence: `frontend/src/app/bookings/page.tsx`)
- Next.js app → Layout editor: renders
- Next.js app → Authentication UI: renders (evidence: `frontend/src/app/login/page.tsx`)
- Event discovery → Backend proxy: requests
- Events map → Backend proxy: requests
- Session listing → Backend proxy: requests
- Seat selection → Backend proxy: requests
- Checkout → Backend proxy: requests
- Booking history → Backend proxy: requests
- Authentication UI → Backend proxy: authenticates
- Backend proxy → Backend API: forwards (evidence: `frontend/src/app/api/backend/[...path]/route.ts`)
- Customer → Backend API: calls API
- Backend API → Identity service: dispatches
- Backend API → Event service: dispatches
- Backend API → Session service: dispatches
- Backend API → Seat inventory: dispatches
- Backend API → Booking and holds: dispatches
- Backend API → Mock payments: dispatches
- Backend API → Notifications: dispatches
- Backend API → External event sync: dispatches
- Backend API → Layout management: dispatches
- Booking and holds → Redis cache: caches holds (evidence: `backend/internal/modules/bookings/application/service.go`)
- Mock payments → Redis cache: caches replay (evidence: `backend/internal/modules/payments/application/service.go`)
- Sync worker → External event sync: runs sync
- External event sync → KudaGo / Timepad: imports events
- Administrator → External event sync: requests sync
- Administrator → Event service: promotes events
- Afisha importer → PostgreSQL: imports records (evidence: `backend/cmd/seed-afisha/main.go`)
- Event service → PostgreSQL: reads/writes
- Session service → PostgreSQL: reads/writes
- Seat inventory → PostgreSQL: reads/writes
- Booking and holds → PostgreSQL: reads/writes
- Mock payments → PostgreSQL: reads/writes
- Identity service → PostgreSQL: reads/writes
- Notifications → PostgreSQL: reads/writes
- External event sync → PostgreSQL: reads/writes
- Layout management → PostgreSQL: reads/writes
