# varadha24/robobooth architecture

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

- Interactive diagram: https://gitdiagram.com/varadha24/robobooth
- Repository: https://github.com/varadha24/robobooth

## Overview

Robotic Photobooth coordinates a user-facing recording flow with Android capture, relay hardware, and video processing, then connects session details and the finished video to WhatsApp and an admin dashboard. The excerpts show `main.py` handling capture and processing, while `newmain.py` and `wamain.py` provide overlapping Flask portal implementations backed by shared SQLite models. The README documents Doosan motion as part of the capture experience, but its control implementation is not present in the excerpts; that connection is therefore shown as unverified.

Main entry points: [`platform-tools-latest-windows/platform-tools/newmain.py`](https://github.com/varadha24/robobooth/blob/main/platform-tools-latest-windows/platform-tools/newmain.py) (Session portal), [`platform-tools-latest-windows/platform-tools/main.py`](https://github.com/varadha24/robobooth/blob/main/platform-tools-latest-windows/platform-tools/main.py) (Capture API), [`platform-tools-latest-windows/platform-tools/templates/index.html`](https://github.com/varadha24/robobooth/blob/main/platform-tools-latest-windows/platform-tools/templates/index.html) (Recording page), [`platform-tools-latest-windows/platform-tools/templates/admin_dashboard.html`](https://github.com/varadha24/robobooth/blob/main/platform-tools-latest-windows/platform-tools/templates/admin_dashboard.html) (Admin dashboard)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_capture["Capture and processing"]
  node_capture_api["Capture API<br/>[main.py]"]
  node_video_transfer["Video transfer<br/>[main.py]"]
  node_video_processing["Slow-mo and branding<br/>[main.py]"]
end

subgraph group_portal["Session and messaging"]
  node_portal["Session portal<br/>[newmain.py]"]
  node_alternate_portal["Alternate portal<br/>[wamain.py]"]
end

subgraph group_persistence["Session records"]
  node_session_store[("Session database<br/>[database.py]")]
end

subgraph group_interfaces["User interfaces"]
  node_recording_ui["Recording page<br/>[index.html]"]
  node_admin_ui["Admin dashboard"]
  node_login_ui["Admin login page<br/>[admin_login.html]"]
end

node_visitor(("Photobooth visitor"))
node_operator(("Admin"))
node_camera["Android camera"]
node_relay["Arduino relay"]
node_robot["Doosan cobot"]
node_whatsapp["WhatsApp Cloud API"]

node_visitor -->|"opens"| node_recording_ui
node_recording_ui -.->|"requests capture"| node_capture_api
node_capture_api -->|"starts recording"| node_camera
node_capture_api -->|"switches relay"| node_relay
node_robot -.->|"coordinates motion"| node_camera
node_capture_api -->|"starts processing"| node_video_transfer
node_video_transfer -->|"pulls recording"| node_camera
node_video_transfer -->|"processes video"| node_video_processing
node_video_processing -->|"posts video path"| node_portal
node_visitor -.->|"messages"| node_portal
node_portal -->|"sends messages and video"| node_whatsapp
node_portal -->|"creates and updates sessions"| node_session_store
node_alternate_portal -->|"creates and queries sessions"| node_session_store
node_operator -.->|"opens"| node_login_ui
node_operator -.->|"views sessions"| node_admin_ui
node_admin_ui -.->|"uses admin routes"| node_portal
node_login_ui -.->|"uses login route"| node_portal

click node_capture_api "https://github.com/varadha24/robobooth/blob/main/platform-tools-latest-windows/platform-tools/main.py"
click node_relay "https://github.com/varadha24/robobooth/blob/main/platform-tools-latest-windows/platform-tools/ArduinoRelayCode/ArduinoRelayCode.ino"
click node_video_transfer "https://github.com/varadha24/robobooth/blob/main/platform-tools-latest-windows/platform-tools/main.py"
click node_video_processing "https://github.com/varadha24/robobooth/blob/main/platform-tools-latest-windows/platform-tools/main.py"
click node_recording_ui "https://github.com/varadha24/robobooth/blob/main/platform-tools-latest-windows/platform-tools/templates/index.html"
click node_portal "https://github.com/varadha24/robobooth/blob/main/platform-tools-latest-windows/platform-tools/newmain.py"
click node_alternate_portal "https://github.com/varadha24/robobooth/blob/main/platform-tools-latest-windows/platform-tools/wamain.py"
click node_session_store "https://github.com/varadha24/robobooth/blob/main/platform-tools-latest-windows/platform-tools/database.py"
click node_admin_ui "https://github.com/varadha24/robobooth/blob/main/platform-tools-latest-windows/platform-tools/templates/admin_dashboard.html"
click node_login_ui "https://github.com/varadha24/robobooth/blob/main/platform-tools-latest-windows/platform-tools/templates/admin_login.html"

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_capture_api,node_video_transfer,node_video_processing toneBlue
class node_portal,node_alternate_portal toneAmber
class node_session_store,node_whatsapp toneMint
class node_recording_ui,node_admin_ui,node_login_ui toneRose
class node_visitor,node_operator,node_camera,node_robot toneIndigo
class node_relay toneTeal
```

## Components

### Capture and processing

- [Capture API](https://github.com/varadha24/robobooth/blob/main/platform-tools-latest-windows/platform-tools/main.py): `platform-tools-latest-windows/platform-tools/main.py`
- [Video transfer](https://github.com/varadha24/robobooth/blob/main/platform-tools-latest-windows/platform-tools/main.py): `platform-tools-latest-windows/platform-tools/main.py`
- [Slow-mo and branding](https://github.com/varadha24/robobooth/blob/main/platform-tools-latest-windows/platform-tools/main.py): `platform-tools-latest-windows/platform-tools/main.py`

### Session and messaging

- [Session portal](https://github.com/varadha24/robobooth/blob/main/platform-tools-latest-windows/platform-tools/newmain.py): `platform-tools-latest-windows/platform-tools/newmain.py`
- [Alternate portal](https://github.com/varadha24/robobooth/blob/main/platform-tools-latest-windows/platform-tools/wamain.py): `platform-tools-latest-windows/platform-tools/wamain.py`

### Session records

- [Session database](https://github.com/varadha24/robobooth/blob/main/platform-tools-latest-windows/platform-tools/database.py): `platform-tools-latest-windows/platform-tools/database.py`

### User interfaces

- [Recording page](https://github.com/varadha24/robobooth/blob/main/platform-tools-latest-windows/platform-tools/templates/index.html): `platform-tools-latest-windows/platform-tools/templates/index.html`
- [Admin dashboard](https://github.com/varadha24/robobooth/blob/main/platform-tools-latest-windows/platform-tools/templates/admin_dashboard.html): `platform-tools-latest-windows/platform-tools/templates/admin_dashboard.html`
- [Admin login page](https://github.com/varadha24/robobooth/blob/main/platform-tools-latest-windows/platform-tools/templates/admin_login.html): `platform-tools-latest-windows/platform-tools/templates/admin_login.html`

### Other components

- **Photobooth visitor**
- **Admin**
- **Android camera**
- [Arduino relay](https://github.com/varadha24/robobooth/blob/main/platform-tools-latest-windows/platform-tools/ArduinoRelayCode/ArduinoRelayCode.ino): `platform-tools-latest-windows/platform-tools/ArduinoRelayCode/ArduinoRelayCode.ino`
- **Doosan cobot**
- **WhatsApp Cloud API**

## Connections

- Photobooth visitor → Recording page: opens
- Recording page → Capture API: requests capture
- Capture API → Android camera: starts recording (evidence: `platform-tools-latest-windows/platform-tools/main.py`)
- Capture API → Arduino relay: switches relay (evidence: `platform-tools-latest-windows/platform-tools/main.py`)
- Doosan cobot → Android camera: coordinates motion
- Capture API → Video transfer: starts processing (evidence: `platform-tools-latest-windows/platform-tools/main.py`)
- Video transfer → Android camera: pulls recording (evidence: `platform-tools-latest-windows/platform-tools/main.py`)
- Video transfer → Slow-mo and branding: processes video (evidence: `platform-tools-latest-windows/platform-tools/main.py`)
- Slow-mo and branding → Session portal: posts video path (evidence: `platform-tools-latest-windows/platform-tools/main.py`)
- Photobooth visitor → Session portal: messages
- Session portal → WhatsApp Cloud API: sends messages and video (evidence: `platform-tools-latest-windows/platform-tools/newmain.py`)
- Session portal → Session database: creates and updates sessions (evidence: `platform-tools-latest-windows/platform-tools/newmain.py`)
- Alternate portal → Session database: creates and queries sessions (evidence: `platform-tools-latest-windows/platform-tools/wamain.py`)
- Admin → Admin login page: opens
- Admin → Admin dashboard: views sessions
- Admin dashboard → Session portal: uses admin routes
- Admin login page → Session portal: uses login route
