# opragopa/interactivefoodmenu architecture

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

## Overview

«Меню в наличии» is a venue menu-management product spanning an Android staff app, a web staff cabinet, TV displays, an operator hub, and a self-hosted API backed by Appwrite. Staff authenticate, manage categories and dishes, change availability, and import CSV; the display presents the resulting menu and venue settings. Android also supports menu-photo OCR. The README documents both clients using the API rather than Appwrite directly. Several web and backend relationships are evidenced by excerpts; unsampled feature wiring is omitted where it cannot be verified.

Main entry points: [`backend-api/src/server.ts`](https://github.com/opragopa/interactivefoodmenu/blob/main/backend-api/src/server.ts) (HTTP server), [`web-display/src/App.tsx`](https://github.com/opragopa/interactivefoodmenu/blob/main/web-display/src/App.tsx) (Staff and display routing), [`android/src/main/java/ru/interactivefoodmenu/staff/MenuViewModel.kt`](https://github.com/opragopa/interactivefoodmenu/blob/main/android/src/main/java/ru/interactivefoodmenu/staff/MenuViewModel.kt) (Menu workflow), [`backend-api/src/routes.ts`](https://github.com/opragopa/interactivefoodmenu/blob/main/backend-api/src/routes.ts) (Auth and menu routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_android["Android staff app"]
  node_android_ui["Staff interface<br/>[MenuApp.kt]"]
  node_android_vm["Menu workflow<br/>[MenuViewModel.kt]"]
  node_android_repo["Menu repository<br/>[MenuRepository.kt]"]
  node_csv_parser["CSV parser<br/>[CsvMenuParser.kt]"]
  node_ocr_parser["Photo OCR parser<br/>[MenuOcrParser.kt]"]
  node_validation["Menu validation<br/>[Validation.kt]"]
end

subgraph group_web["Web clients"]
  node_web_app["Staff and display routing<br/>[App.tsx]"]
  node_web_api["API client<br/>[api.ts]"]
  node_web_csv["CSV import<br/>[csv.ts]"]
  node_hub["Operator hub<br/>[BackendHub.tsx]"]
  node_display["TV menu display<br/>[DisplayScreen.tsx]"]
  node_pagination["Display layout<br/>[paginate.ts]"]
end

subgraph group_backend["Backend API"]
  node_backend_server["HTTP server<br/>[server.ts]"]
  node_routes["Auth and menu routes<br/>[routes.ts]"]
  node_security["Session security<br/>[security.ts]"]
  node_legacy["Legacy TV renderer<br/>[legacyDisplay.ts]"]
end

subgraph group_data["Menu and storage"]
  node_schema["Data schema<br/>[schema.ts]"]
  node_appwrite[("Appwrite tables and files<br/>[appwrite.ts]")]
end

node_staff(("Staff member"))
node_tv(("TV viewer"))

node_staff -->|"uses"| node_android_ui
node_android_ui -->|"delegates to"| node_android_vm
node_android_vm -->|"invokes"| node_android_repo
node_android_vm -->|"parses CSV with"| node_csv_parser
node_csv_parser -->|"validates with"| node_validation
node_android_vm -->|"parses OCR with"| node_ocr_parser
node_android_repo -->|"sends API requests"| node_backend_server
node_web_app -->|"requests data through"| node_web_api
node_web_app -->|"parses imports with"| node_web_csv
node_web_app -->|"routes to"| node_hub
node_web_app -->|"renders"| node_display
node_display -->|"lays out menu with"| node_pagination
node_tv -->|"views"| node_display
node_web_api -->|"sends API requests"| node_backend_server
node_backend_server -->|"mounts"| node_routes
node_backend_server -->|"checks readiness using"| node_schema
node_backend_server -->|"creates services with"| node_appwrite
node_routes -->|"reads and writes"| node_appwrite
node_routes -->|"verifies sessions with"| node_security
node_routes -->|"renders legacy display with"| node_legacy
node_appwrite -.->|"uses configured schema"| node_schema

click node_android_ui "https://github.com/opragopa/interactivefoodmenu/blob/main/android/src/main/java/ru/interactivefoodmenu/staff/ui/MenuApp.kt"
click node_android_vm "https://github.com/opragopa/interactivefoodmenu/blob/main/android/src/main/java/ru/interactivefoodmenu/staff/MenuViewModel.kt"
click node_android_repo "https://github.com/opragopa/interactivefoodmenu/blob/main/android/src/main/java/ru/interactivefoodmenu/staff/data/MenuRepository.kt"
click node_csv_parser "https://github.com/opragopa/interactivefoodmenu/blob/main/android/src/main/java/ru/interactivefoodmenu/staff/model/CsvMenuParser.kt"
click node_ocr_parser "https://github.com/opragopa/interactivefoodmenu/blob/main/android/src/main/java/ru/interactivefoodmenu/staff/model/MenuOcrParser.kt"
click node_validation "https://github.com/opragopa/interactivefoodmenu/blob/main/android/src/main/java/ru/interactivefoodmenu/staff/model/Validation.kt"
click node_web_app "https://github.com/opragopa/interactivefoodmenu/blob/main/web-display/src/App.tsx"
click node_web_api "https://github.com/opragopa/interactivefoodmenu/blob/main/web-display/src/api.ts"
click node_web_csv "https://github.com/opragopa/interactivefoodmenu/blob/main/web-display/src/csv.ts"
click node_hub "https://github.com/opragopa/interactivefoodmenu/blob/main/web-display/src/BackendHub.tsx"
click node_display "https://github.com/opragopa/interactivefoodmenu/blob/main/web-display/src/DisplayScreen.tsx"
click node_pagination "https://github.com/opragopa/interactivefoodmenu/blob/main/web-display/src/paginate.ts"
click node_backend_server "https://github.com/opragopa/interactivefoodmenu/blob/main/backend-api/src/server.ts"
click node_routes "https://github.com/opragopa/interactivefoodmenu/blob/main/backend-api/src/routes.ts"
click node_security "https://github.com/opragopa/interactivefoodmenu/blob/main/backend-api/src/security.ts"
click node_legacy "https://github.com/opragopa/interactivefoodmenu/blob/main/backend-api/src/legacyDisplay.ts"
click node_schema "https://github.com/opragopa/interactivefoodmenu/blob/main/backend-api/src/schema.ts"
click node_appwrite "https://github.com/opragopa/interactivefoodmenu/blob/main/backend-api/src/appwrite.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_android_ui,node_android_vm,node_android_repo,node_csv_parser,node_ocr_parser,node_validation,node_tv toneBlue
class node_web_app,node_web_api,node_web_csv,node_hub,node_display,node_pagination toneAmber
class node_backend_server,node_routes,node_security,node_legacy toneMint
class node_schema,node_appwrite toneRose
class node_staff toneIndigo
```

## Components

### Android staff app

- [Staff interface](https://github.com/opragopa/interactivefoodmenu/blob/main/android/src/main/java/ru/interactivefoodmenu/staff/ui/MenuApp.kt): `android/src/main/java/ru/interactivefoodmenu/staff/ui/MenuApp.kt`
- [Menu workflow](https://github.com/opragopa/interactivefoodmenu/blob/main/android/src/main/java/ru/interactivefoodmenu/staff/MenuViewModel.kt): `android/src/main/java/ru/interactivefoodmenu/staff/MenuViewModel.kt`
- [Menu repository](https://github.com/opragopa/interactivefoodmenu/blob/main/android/src/main/java/ru/interactivefoodmenu/staff/data/MenuRepository.kt): `android/src/main/java/ru/interactivefoodmenu/staff/data/MenuRepository.kt`
- [CSV parser](https://github.com/opragopa/interactivefoodmenu/blob/main/android/src/main/java/ru/interactivefoodmenu/staff/model/CsvMenuParser.kt): `android/src/main/java/ru/interactivefoodmenu/staff/model/CsvMenuParser.kt`
- [Photo OCR parser](https://github.com/opragopa/interactivefoodmenu/blob/main/android/src/main/java/ru/interactivefoodmenu/staff/model/MenuOcrParser.kt): `android/src/main/java/ru/interactivefoodmenu/staff/model/MenuOcrParser.kt`
- [Menu validation](https://github.com/opragopa/interactivefoodmenu/blob/main/android/src/main/java/ru/interactivefoodmenu/staff/model/Validation.kt): `android/src/main/java/ru/interactivefoodmenu/staff/model/Validation.kt`

### Web clients

- [Staff and display routing](https://github.com/opragopa/interactivefoodmenu/blob/main/web-display/src/App.tsx): `web-display/src/App.tsx`
- [API client](https://github.com/opragopa/interactivefoodmenu/blob/main/web-display/src/api.ts): `web-display/src/api.ts`
- [CSV import](https://github.com/opragopa/interactivefoodmenu/blob/main/web-display/src/csv.ts): `web-display/src/csv.ts`
- [Operator hub](https://github.com/opragopa/interactivefoodmenu/blob/main/web-display/src/BackendHub.tsx): `web-display/src/BackendHub.tsx`
- [TV menu display](https://github.com/opragopa/interactivefoodmenu/blob/main/web-display/src/DisplayScreen.tsx): `web-display/src/DisplayScreen.tsx`
- [Display layout](https://github.com/opragopa/interactivefoodmenu/blob/main/web-display/src/paginate.ts): `web-display/src/paginate.ts`

### Backend API

- [HTTP server](https://github.com/opragopa/interactivefoodmenu/blob/main/backend-api/src/server.ts): `backend-api/src/server.ts`
- [Auth and menu routes](https://github.com/opragopa/interactivefoodmenu/blob/main/backend-api/src/routes.ts): `backend-api/src/routes.ts`
- [Session security](https://github.com/opragopa/interactivefoodmenu/blob/main/backend-api/src/security.ts): `backend-api/src/security.ts`
- [Legacy TV renderer](https://github.com/opragopa/interactivefoodmenu/blob/main/backend-api/src/legacyDisplay.ts): `backend-api/src/legacyDisplay.ts`

### Menu and storage

- [Data schema](https://github.com/opragopa/interactivefoodmenu/blob/main/backend-api/src/schema.ts): `backend-api/src/schema.ts`
- [Appwrite tables and files](https://github.com/opragopa/interactivefoodmenu/blob/main/backend-api/src/appwrite.ts): `backend-api/src/appwrite.ts`

### Other components

- **Staff member**
- **TV viewer**

## Connections

- Staff member → Staff interface: uses (evidence: `README.md`)
- Staff interface → Menu workflow: delegates to (evidence: `android/src/main/java/ru/interactivefoodmenu/staff/ui/MenuApp.kt`)
- Menu workflow → Menu repository: invokes (evidence: `android/src/main/java/ru/interactivefoodmenu/staff/MenuViewModel.kt`)
- Menu workflow → CSV parser: parses CSV with (evidence: `android/src/main/java/ru/interactivefoodmenu/staff/MenuViewModel.kt`)
- CSV parser → Menu validation: validates with (evidence: `android/src/main/java/ru/interactivefoodmenu/staff/model/CsvMenuParser.kt`)
- Menu workflow → Photo OCR parser: parses OCR with (evidence: `android/src/main/java/ru/interactivefoodmenu/staff/MenuViewModel.kt`)
- Menu repository → HTTP server: sends API requests (evidence: `README.md`)
- Staff and display routing → API client: requests data through (evidence: `web-display/src/App.tsx`)
- Staff and display routing → CSV import: parses imports with (evidence: `web-display/src/App.tsx`)
- Staff and display routing → Operator hub: routes to (evidence: `web-display/src/App.tsx`)
- Staff and display routing → TV menu display: renders (evidence: `web-display/src/App.tsx`)
- TV menu display → Display layout: lays out menu with (evidence: `web-display/src/DisplayScreen.tsx`)
- TV viewer → TV menu display: views (evidence: `README.md`)
- API client → HTTP server: sends API requests (evidence: `README.md`)
- HTTP server → Auth and menu routes: mounts (evidence: `backend-api/src/server.ts`)
- HTTP server → Data schema: checks readiness using (evidence: `backend-api/src/server.ts`)
- HTTP server → Appwrite tables and files: creates services with (evidence: `backend-api/src/server.ts`)
- Auth and menu routes → Appwrite tables and files: reads and writes (evidence: `backend-api/src/routes.ts`)
- Auth and menu routes → Session security: verifies sessions with (evidence: `backend-api/src/routes.ts`)
- Auth and menu routes → Legacy TV renderer: renders legacy display with (evidence: `backend-api/src/routes.ts`)
- Appwrite tables and files → Data schema: uses configured schema (evidence: `backend-api/src/schema.ts`)
