# aiperizhenishova/bill-splitter architecture

> Architecture diagram of the GitHub repository aiperizhenishova/bill-splitter, 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/aiperizhenishova/bill-splitter
- Repository: https://github.com/aiperizhenishova/bill-splitter

## Overview

This monorepo implements a bill-splitting application: users or guests create a session, add dishes and prices, share it with participants, collect selections, and review per-person totals. The Vue frontend presents these flows; its session widgets call the NestJS API, whose service coordinates session, participant, dish, and selection records. Authentication, QR uploads, and session lifecycle management are distinct capabilities. The graph reflects shown controller/service calls and README evidence (none was provided); unsampled frontend/API wiring is omitted where it cannot be verified.

Main entry points: [`frontend/src/shared/api/instance.ts`](https://github.com/aiperizhenishova/bill-splitter/blob/master/frontend/src/shared/api/instance.ts) (HTTP API client), [`frontend/src/app/providers/router.ts`](https://github.com/aiperizhenishova/bill-splitter/blob/master/frontend/src/app/providers/router.ts) (Vue app and routes), [`backend/src/sessions/sessions.controller.ts`](https://github.com/aiperizhenishova/bill-splitter/blob/master/backend/src/sessions/sessions.controller.ts) (Session endpoints), [`backend/src/sessions/sessions.service.ts`](https://github.com/aiperizhenishova/bill-splitter/blob/master/backend/src/sessions/sessions.service.ts) (Session workflows)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Frontend experience"]
  node_web_app["Vue app and routes<br/>[router.ts]"]
  node_session_list["Session list<br/>[useSessionList.ts]"]
  node_create_session["Create session UI"]
  node_guest_session["Guest session UI<br/>[useGuestSession.ts]"]
  node_manage_session["Session management UI"]
  node_join_ui["Join and selection UI<br/>[useParticipant.ts]"]
  node_auth_ui["Authentication UI<br/>[useAuth.ts]"]
  node_dish_ui["Dish management UI<br/>[useDishes.ts]"]
  node_summary_ui["Session summary UI"]
  node_share_ui["Share link<br/>[useShareLink.ts]"]
  node_qr_upload_ui["QR upload UI<br/>[index.vue]"]
  node_api["HTTP API client<br/>[instance.ts]"]
end

subgraph group_backend["Session backend"]
  node_sessions_controller["Session endpoints"]
  node_sessions_service["Session workflows"]
  node_dish_controller["Standalone dish endpoints"]
  node_dish_service["Standalone dish service<br/>[dishes.service.ts]"]
end

subgraph group_identity["Identity and access"]
  node_auth_controller["Auth endpoints<br/>[auth.controller.ts]"]
  node_auth_service["Auth service<br/>[auth.service.ts]"]
  node_auth_guard["JWT access guard<br/>[jwt-auth.guard.ts]"]
  node_participant_guard["Participant token guard"]
  node_guest_guard["Guest or JWT guard"]
  node_optional_guard["Optional JWT guard"]
end

subgraph group_storage["Persistence and uploads"]
  node_session_store[("Session records<br/>[session.entity.ts]")]
  node_participant_store[("Participant records")]
  node_selection_store[("Selection records")]
  node_session_dish_store[("Session dish records")]
  node_dish_store[("Dish records<br/>[dish.entity.ts]")]
  node_user_store[("User records<br/>[user.entity.ts]")]
  node_qr_storage["QR image upload<br/>[s3.service.ts]"]
end

node_owner(("Owner or guest"))
node_participant_actor(("Participant"))

node_owner -.->|"uses"| node_web_app
node_participant_actor -.->|"uses"| node_web_app
node_web_app -.->|"presents"| node_create_session
node_web_app -.->|"presents"| node_session_list
node_web_app -.->|"presents"| node_guest_session
node_web_app -.->|"presents"| node_manage_session
node_web_app -.->|"presents"| node_join_ui
node_web_app -.->|"presents"| node_auth_ui
node_create_session -.->|"calls"| node_api
node_guest_session -.->|"calls"| node_api
node_manage_session -.->|"calls"| node_api
node_join_ui -.->|"calls"| node_api
node_auth_ui -.->|"calls"| node_api
node_dish_ui -.->|"calls"| node_api
node_summary_ui -.->|"calls"| node_api
node_share_ui -.->|"calls"| node_api
node_qr_upload_ui -.->|"uploads"| node_api
node_api -.->|"HTTP requests"| node_sessions_controller
node_api -.->|"HTTP requests"| node_auth_controller
node_sessions_controller -->|"delegates"| node_sessions_service
node_sessions_controller -->|"guards selection"| node_participant_guard
node_sessions_controller -->|"guards owner routes"| node_guest_guard
node_sessions_controller -->|"guards creation"| node_optional_guard
node_sessions_controller -->|"guards listing"| node_auth_guard
node_auth_controller -->|"delegates"| node_auth_service
node_auth_controller -->|"guards profile"| node_auth_guard
node_sessions_service -->|"reads and writes"| node_session_store
node_sessions_service -->|"reads and writes"| node_participant_store
node_sessions_service -->|"reads and writes"| node_selection_store
node_sessions_service -->|"reads and writes"| node_dish_store
node_sessions_service -->|"uploads image"| node_qr_storage
node_auth_service -->|"reads and writes"| node_user_store
node_dish_controller -->|"delegates"| node_dish_service

click node_web_app "https://github.com/aiperizhenishova/bill-splitter/blob/master/frontend/src/app/providers/router.ts"
click node_session_list "https://github.com/aiperizhenishova/bill-splitter/blob/master/frontend/src/widgets/session-list/model/useSessionList.ts"
click node_create_session "https://github.com/aiperizhenishova/bill-splitter/blob/master/frontend/src/widgets/create-session-form/model/useCreateSessionForm.ts"
click node_guest_session "https://github.com/aiperizhenishova/bill-splitter/blob/master/frontend/src/widgets/guest-session/model/useGuestSession.ts"
click node_manage_session "https://github.com/aiperizhenishova/bill-splitter/blob/master/frontend/src/widgets/session-manage/model/useSessionManage.ts"
click node_join_ui "https://github.com/aiperizhenishova/bill-splitter/blob/master/frontend/src/features/join-session/model/useParticipant.ts"
click node_auth_ui "https://github.com/aiperizhenishova/bill-splitter/blob/master/frontend/src/entities/user/model/useAuth.ts"
click node_dish_ui "https://github.com/aiperizhenishova/bill-splitter/blob/master/frontend/src/features/manage-dishes/model/useDishes.ts"
click node_summary_ui "https://github.com/aiperizhenishova/bill-splitter/blob/master/frontend/src/entities/session/model/useSessionSummary.ts"
click node_share_ui "https://github.com/aiperizhenishova/bill-splitter/blob/master/frontend/src/features/share-link/model/useShareLink.ts"
click node_qr_upload_ui "https://github.com/aiperizhenishova/bill-splitter/blob/master/frontend/src/widgets/qr-upload/index.vue"
click node_api "https://github.com/aiperizhenishova/bill-splitter/blob/master/frontend/src/shared/api/instance.ts"
click node_auth_controller "https://github.com/aiperizhenishova/bill-splitter/blob/master/backend/src/auth/auth.controller.ts"
click node_auth_service "https://github.com/aiperizhenishova/bill-splitter/blob/master/backend/src/auth/auth.service.ts"
click node_auth_guard "https://github.com/aiperizhenishova/bill-splitter/blob/master/backend/src/auth/jwt-auth.guard.ts"
click node_sessions_controller "https://github.com/aiperizhenishova/bill-splitter/blob/master/backend/src/sessions/sessions.controller.ts"
click node_sessions_service "https://github.com/aiperizhenishova/bill-splitter/blob/master/backend/src/sessions/sessions.service.ts"
click node_dish_controller "https://github.com/aiperizhenishova/bill-splitter/blob/master/backend/src/dishes/dishes.controller.ts"
click node_dish_service "https://github.com/aiperizhenishova/bill-splitter/blob/master/backend/src/dishes/dishes.service.ts"
click node_participant_guard "https://github.com/aiperizhenishova/bill-splitter/blob/master/backend/src/sessions/guards/participant-token.guard.ts"
click node_guest_guard "https://github.com/aiperizhenishova/bill-splitter/blob/master/backend/src/auth/guest-or-jwt.guard.ts"
click node_optional_guard "https://github.com/aiperizhenishova/bill-splitter/blob/master/backend/src/auth/optional-jwt-auth.guard.ts"
click node_session_store "https://github.com/aiperizhenishova/bill-splitter/blob/master/backend/src/sessions/session.entity.ts"
click node_participant_store "https://github.com/aiperizhenishova/bill-splitter/blob/master/backend/src/sessions/participant.entity.ts"
click node_selection_store "https://github.com/aiperizhenishova/bill-splitter/blob/master/backend/src/sessions/selection.entity.ts"
click node_session_dish_store "https://github.com/aiperizhenishova/bill-splitter/blob/master/backend/src/sessions/session-dish.entity.ts"
click node_dish_store "https://github.com/aiperizhenishova/bill-splitter/blob/master/backend/src/dishes/dish.entity.ts"
click node_user_store "https://github.com/aiperizhenishova/bill-splitter/blob/master/backend/src/user/user.entity.ts"
click node_qr_storage "https://github.com/aiperizhenishova/bill-splitter/blob/master/backend/src/qr-code/s3.service.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_web_app,node_session_list,node_create_session,node_guest_session,node_manage_session,node_join_ui,node_auth_ui,node_dish_ui,node_summary_ui,node_share_ui,node_qr_upload_ui,node_api toneBlue
class node_sessions_controller,node_sessions_service,node_dish_controller,node_dish_service toneAmber
class node_auth_controller,node_auth_service,node_auth_guard,node_participant_guard,node_guest_guard,node_optional_guard toneMint
class node_session_store,node_participant_store,node_selection_store,node_session_dish_store,node_dish_store,node_user_store,node_qr_storage toneRose
class node_owner,node_participant_actor toneIndigo
```

## Components

### Frontend experience

- [Vue app and routes](https://github.com/aiperizhenishova/bill-splitter/blob/master/frontend/src/app/providers/router.ts): `frontend/src/app/providers/router.ts`
- [Session list](https://github.com/aiperizhenishova/bill-splitter/blob/master/frontend/src/widgets/session-list/model/useSessionList.ts): `frontend/src/widgets/session-list/model/useSessionList.ts`
- [Create session UI](https://github.com/aiperizhenishova/bill-splitter/blob/master/frontend/src/widgets/create-session-form/model/useCreateSessionForm.ts): `frontend/src/widgets/create-session-form/model/useCreateSessionForm.ts`
- [Guest session UI](https://github.com/aiperizhenishova/bill-splitter/blob/master/frontend/src/widgets/guest-session/model/useGuestSession.ts): `frontend/src/widgets/guest-session/model/useGuestSession.ts`
- [Session management UI](https://github.com/aiperizhenishova/bill-splitter/blob/master/frontend/src/widgets/session-manage/model/useSessionManage.ts): `frontend/src/widgets/session-manage/model/useSessionManage.ts`
- [Join and selection UI](https://github.com/aiperizhenishova/bill-splitter/blob/master/frontend/src/features/join-session/model/useParticipant.ts): `frontend/src/features/join-session/model/useParticipant.ts`
- [Authentication UI](https://github.com/aiperizhenishova/bill-splitter/blob/master/frontend/src/entities/user/model/useAuth.ts): `frontend/src/entities/user/model/useAuth.ts`
- [Dish management UI](https://github.com/aiperizhenishova/bill-splitter/blob/master/frontend/src/features/manage-dishes/model/useDishes.ts): `frontend/src/features/manage-dishes/model/useDishes.ts`
- [Session summary UI](https://github.com/aiperizhenishova/bill-splitter/blob/master/frontend/src/entities/session/model/useSessionSummary.ts): `frontend/src/entities/session/model/useSessionSummary.ts`
- [Share link](https://github.com/aiperizhenishova/bill-splitter/blob/master/frontend/src/features/share-link/model/useShareLink.ts): `frontend/src/features/share-link/model/useShareLink.ts`
- [QR upload UI](https://github.com/aiperizhenishova/bill-splitter/blob/master/frontend/src/widgets/qr-upload/index.vue): `frontend/src/widgets/qr-upload/index.vue`
- [HTTP API client](https://github.com/aiperizhenishova/bill-splitter/blob/master/frontend/src/shared/api/instance.ts): `frontend/src/shared/api/instance.ts`

### Session backend

- [Session endpoints](https://github.com/aiperizhenishova/bill-splitter/blob/master/backend/src/sessions/sessions.controller.ts): `backend/src/sessions/sessions.controller.ts`
- [Session workflows](https://github.com/aiperizhenishova/bill-splitter/blob/master/backend/src/sessions/sessions.service.ts): `backend/src/sessions/sessions.service.ts`
- [Standalone dish endpoints](https://github.com/aiperizhenishova/bill-splitter/blob/master/backend/src/dishes/dishes.controller.ts): `backend/src/dishes/dishes.controller.ts`
- [Standalone dish service](https://github.com/aiperizhenishova/bill-splitter/blob/master/backend/src/dishes/dishes.service.ts): `backend/src/dishes/dishes.service.ts`

### Identity and access

- [Auth endpoints](https://github.com/aiperizhenishova/bill-splitter/blob/master/backend/src/auth/auth.controller.ts): `backend/src/auth/auth.controller.ts`
- [Auth service](https://github.com/aiperizhenishova/bill-splitter/blob/master/backend/src/auth/auth.service.ts): `backend/src/auth/auth.service.ts`
- [JWT access guard](https://github.com/aiperizhenishova/bill-splitter/blob/master/backend/src/auth/jwt-auth.guard.ts): `backend/src/auth/jwt-auth.guard.ts`
- [Participant token guard](https://github.com/aiperizhenishova/bill-splitter/blob/master/backend/src/sessions/guards/participant-token.guard.ts): `backend/src/sessions/guards/participant-token.guard.ts`
- [Guest or JWT guard](https://github.com/aiperizhenishova/bill-splitter/blob/master/backend/src/auth/guest-or-jwt.guard.ts): `backend/src/auth/guest-or-jwt.guard.ts`
- [Optional JWT guard](https://github.com/aiperizhenishova/bill-splitter/blob/master/backend/src/auth/optional-jwt-auth.guard.ts): `backend/src/auth/optional-jwt-auth.guard.ts`

### Persistence and uploads

- [Session records](https://github.com/aiperizhenishova/bill-splitter/blob/master/backend/src/sessions/session.entity.ts): `backend/src/sessions/session.entity.ts`
- [Participant records](https://github.com/aiperizhenishova/bill-splitter/blob/master/backend/src/sessions/participant.entity.ts): `backend/src/sessions/participant.entity.ts`
- [Selection records](https://github.com/aiperizhenishova/bill-splitter/blob/master/backend/src/sessions/selection.entity.ts): `backend/src/sessions/selection.entity.ts`
- [Session dish records](https://github.com/aiperizhenishova/bill-splitter/blob/master/backend/src/sessions/session-dish.entity.ts): `backend/src/sessions/session-dish.entity.ts`
- [Dish records](https://github.com/aiperizhenishova/bill-splitter/blob/master/backend/src/dishes/dish.entity.ts): `backend/src/dishes/dish.entity.ts`
- [User records](https://github.com/aiperizhenishova/bill-splitter/blob/master/backend/src/user/user.entity.ts): `backend/src/user/user.entity.ts`
- [QR image upload](https://github.com/aiperizhenishova/bill-splitter/blob/master/backend/src/qr-code/s3.service.ts): `backend/src/qr-code/s3.service.ts`

### Other components

- **Owner or guest**
- **Participant**

## Connections

- Owner or guest → Vue app and routes: uses
- Participant → Vue app and routes: uses
- Vue app and routes → Create session UI: presents
- Vue app and routes → Session list: presents
- Vue app and routes → Guest session UI: presents
- Vue app and routes → Session management UI: presents
- Vue app and routes → Join and selection UI: presents
- Vue app and routes → Authentication UI: presents
- Create session UI → HTTP API client: calls
- Guest session UI → HTTP API client: calls
- Session management UI → HTTP API client: calls
- Join and selection UI → HTTP API client: calls
- Authentication UI → HTTP API client: calls
- Dish management UI → HTTP API client: calls
- Session summary UI → HTTP API client: calls
- Share link → HTTP API client: calls
- QR upload UI → HTTP API client: uploads
- HTTP API client → Session endpoints: HTTP requests
- HTTP API client → Auth endpoints: HTTP requests
- Session endpoints → Session workflows: delegates (evidence: `backend/src/sessions/sessions.controller.ts`)
- Session endpoints → Participant token guard: guards selection (evidence: `backend/src/sessions/sessions.controller.ts`)
- Session endpoints → Guest or JWT guard: guards owner routes (evidence: `backend/src/sessions/sessions.controller.ts`)
- Session endpoints → Optional JWT guard: guards creation (evidence: `backend/src/sessions/sessions.controller.ts`)
- Session endpoints → JWT access guard: guards listing (evidence: `backend/src/sessions/sessions.controller.ts`)
- Auth endpoints → Auth service: delegates (evidence: `backend/src/auth/auth.controller.ts`)
- Auth endpoints → JWT access guard: guards profile (evidence: `backend/src/auth/auth.controller.ts`)
- Session workflows → Session records: reads and writes (evidence: `backend/src/sessions/sessions.service.ts`)
- Session workflows → Participant records: reads and writes (evidence: `backend/src/sessions/sessions.service.ts`)
- Session workflows → Selection records: reads and writes (evidence: `backend/src/sessions/sessions.service.ts`)
- Session workflows → Dish records: reads and writes (evidence: `backend/src/sessions/sessions.service.ts`)
- Session workflows → QR image upload: uploads image (evidence: `backend/src/sessions/sessions.service.ts`)
- Auth service → User records: reads and writes (evidence: `backend/src/auth/auth.service.ts`)
- Standalone dish endpoints → Standalone dish service: delegates (evidence: `backend/src/dishes/dishes.controller.ts`)
