# skbroadcast/studiohub architecture

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

- Interactive diagram: https://gitdiagram.com/skbroadcast/studiohub
- Repository: https://github.com/skbroadcast/studiohub

## Overview

StudioHub matches event studios with freelance photographers and videographers, then supports booking and coordination. The principal flow is studio event creation, freelancer availability and skill matching, application or direct invitation, and studio confirmation; confirmed dates are protected against double-booking. The root `app.py` is documented as the single-file Flask backend, with templates and browser JavaScript for the interface. The README also documents messaging, saved items, profiles, payments, reviews, and administration. Nested copies are represented as alternate app trees; their relationship to the root deployment is not established by the excerpts.

Main entry points: [`app.py`](https://github.com/skbroadcast/studiohub/blob/main/app.py) (Flask web app), [`static/app.js`](https://github.com/skbroadcast/studiohub/blob/main/static/app.js) (Availability calendar), [`static/icons/app.py`](https://github.com/skbroadcast/studiohub/blob/main/static/icons/app.py) (Icons app copy), [`studiohub/app.py`](https://github.com/skbroadcast/studiohub/blob/main/studiohub/app.py) (StudioHub app copy)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_core["Matching and bookings"]
  node_web["Flask web app<br/>[app.py]"]
  node_pages["Web pages"]
  node_calendar["Availability calendar<br/>[app.js]"]
  node_availability["Availability management<br/>[app.py]"]
  node_event_matching["Events and matching<br/>[app.py]"]
  node_booking["Applications and booking<br/>[app.py]"]
end

subgraph group_profiles["People and discovery"]
  node_accounts["Accounts and profiles<br/>[app.py]"]
  node_creator_search["Creator discovery<br/>[app.py]"]
  node_portfolio_reviews["Portfolios and reviews<br/>[app.py]"]
  node_favorites["Saved creators and events<br/>[app.py]"]
end

subgraph group_coordination["Coordination features"]
  node_messaging["Messages and notifications<br/>[app.py]"]
  node_schedule_notes["Schedule notes<br/>[app.py]"]
  node_payments["UPI advances<br/>[app.py]"]
end

subgraph group_operations["Administration and storage"]
  node_admin["Admin panel<br/>[app.py]"]
  node_data[("Application database<br/>[app.py]")]
end

subgraph group_variants["Alternate app trees"]
  node_icon_app["Icons app copy<br/>[app.py]"]
  node_icon_js["Icons UI copy<br/>[app.js]"]
  node_studiohub_app["StudioHub app copy<br/>[app.py]"]
  node_studiohub_js["StudioHub UI copy<br/>[app.js]"]
end

node_studios(("Studios"))
node_freelancers(("Freelancers"))

node_studios -->|"create events"| node_web
node_freelancers -->|"set availability"| node_web
node_web -->|"renders pages"| node_pages
node_calendar -->|"updates dates"| node_web
node_web -->|"manages dates"| node_availability
node_web -->|"matches skills"| node_event_matching
node_event_matching -->|"supports applications"| node_booking
node_studios -->|"confirms crew"| node_booking
node_web -->|"handles registration"| node_accounts
node_freelancers -->|"browse creators"| node_creator_search
node_studios -->|"view and rate"| node_portfolio_reviews
node_web -->|"supports saving"| node_favorites
node_web -->|"handles chats"| node_messaging
node_web -->|"records notes"| node_schedule_notes
node_web -->|"tracks advances"| node_payments
node_web -->|"provides administration"| node_admin
node_web -->|"reads and writes"| node_data
node_icon_app -.->|"uses database"| node_data
node_studiohub_app -.->|"uses database"| node_data

click node_web "https://github.com/skbroadcast/studiohub/blob/main/app.py"
click node_pages "https://github.com/skbroadcast/studiohub/tree/main/templates"
click node_calendar "https://github.com/skbroadcast/studiohub/blob/main/static/app.js"
click node_availability "https://github.com/skbroadcast/studiohub/blob/main/app.py"
click node_event_matching "https://github.com/skbroadcast/studiohub/blob/main/app.py"
click node_booking "https://github.com/skbroadcast/studiohub/blob/main/app.py"
click node_accounts "https://github.com/skbroadcast/studiohub/blob/main/app.py"
click node_creator_search "https://github.com/skbroadcast/studiohub/blob/main/app.py"
click node_portfolio_reviews "https://github.com/skbroadcast/studiohub/blob/main/app.py"
click node_favorites "https://github.com/skbroadcast/studiohub/blob/main/app.py"
click node_messaging "https://github.com/skbroadcast/studiohub/blob/main/app.py"
click node_schedule_notes "https://github.com/skbroadcast/studiohub/blob/main/app.py"
click node_payments "https://github.com/skbroadcast/studiohub/blob/main/app.py"
click node_admin "https://github.com/skbroadcast/studiohub/blob/main/app.py"
click node_data "https://github.com/skbroadcast/studiohub/blob/main/app.py"
click node_icon_app "https://github.com/skbroadcast/studiohub/blob/main/static/icons/app.py"
click node_icon_js "https://github.com/skbroadcast/studiohub/blob/main/static/icons/static/app.js"
click node_studiohub_app "https://github.com/skbroadcast/studiohub/blob/main/studiohub/app.py"
click node_studiohub_js "https://github.com/skbroadcast/studiohub/blob/main/studiohub/static/app.js"

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,node_pages,node_calendar,node_availability,node_event_matching,node_booking toneBlue
class node_accounts,node_creator_search,node_portfolio_reviews,node_favorites toneAmber
class node_messaging,node_schedule_notes,node_payments toneMint
class node_admin,node_data toneRose
class node_icon_app,node_icon_js,node_studiohub_app,node_studiohub_js,node_studios,node_freelancers toneIndigo
```

## Components

### Matching and bookings

- [Flask web app](https://github.com/skbroadcast/studiohub/blob/main/app.py): `app.py`
- [Web pages](https://github.com/skbroadcast/studiohub/tree/main/templates): `templates`
- [Availability calendar](https://github.com/skbroadcast/studiohub/blob/main/static/app.js): `static/app.js`
- [Availability management](https://github.com/skbroadcast/studiohub/blob/main/app.py): `app.py`
- [Events and matching](https://github.com/skbroadcast/studiohub/blob/main/app.py): `app.py`
- [Applications and booking](https://github.com/skbroadcast/studiohub/blob/main/app.py): `app.py`

### People and discovery

- [Accounts and profiles](https://github.com/skbroadcast/studiohub/blob/main/app.py): `app.py`
- [Creator discovery](https://github.com/skbroadcast/studiohub/blob/main/app.py): `app.py`
- [Portfolios and reviews](https://github.com/skbroadcast/studiohub/blob/main/app.py): `app.py`
- [Saved creators and events](https://github.com/skbroadcast/studiohub/blob/main/app.py): `app.py`

### Coordination features

- [Messages and notifications](https://github.com/skbroadcast/studiohub/blob/main/app.py): `app.py`
- [Schedule notes](https://github.com/skbroadcast/studiohub/blob/main/app.py): `app.py`
- [UPI advances](https://github.com/skbroadcast/studiohub/blob/main/app.py): `app.py`

### Administration and storage

- [Admin panel](https://github.com/skbroadcast/studiohub/blob/main/app.py): `app.py`
- [Application database](https://github.com/skbroadcast/studiohub/blob/main/app.py): `app.py`

### Alternate app trees

- [Icons app copy](https://github.com/skbroadcast/studiohub/blob/main/static/icons/app.py): `static/icons/app.py`
- [Icons UI copy](https://github.com/skbroadcast/studiohub/blob/main/static/icons/static/app.js): `static/icons/static/app.js`
- [StudioHub app copy](https://github.com/skbroadcast/studiohub/blob/main/studiohub/app.py): `studiohub/app.py`
- [StudioHub UI copy](https://github.com/skbroadcast/studiohub/blob/main/studiohub/static/app.js): `studiohub/static/app.js`

### Other components

- **Studios**
- **Freelancers**

## Connections

- Studios → Flask web app: create events (evidence: `README.md`)
- Freelancers → Flask web app: set availability (evidence: `README.md`)
- Flask web app → Web pages: renders pages (evidence: `README.md`)
- Availability calendar → Flask web app: updates dates (evidence: `static/app.js`)
- Flask web app → Availability management: manages dates (evidence: `README.md`)
- Flask web app → Events and matching: matches skills (evidence: `README.md`)
- Events and matching → Applications and booking: supports applications (evidence: `README.md`)
- Studios → Applications and booking: confirms crew (evidence: `README.md`)
- Flask web app → Accounts and profiles: handles registration (evidence: `README.md`)
- Freelancers → Creator discovery: browse creators (evidence: `README.md`)
- Studios → Portfolios and reviews: view and rate (evidence: `README.md`)
- Flask web app → Saved creators and events: supports saving (evidence: `README.md`)
- Flask web app → Messages and notifications: handles chats (evidence: `README.md`)
- Flask web app → Schedule notes: records notes (evidence: `README.md`)
- Flask web app → UPI advances: tracks advances (evidence: `README.md`)
- Flask web app → Admin panel: provides administration (evidence: `README.md`)
- Flask web app → Application database: reads and writes (evidence: `README.md`)
- Icons app copy → Application database: uses database
- StudioHub app copy → Application database: uses database
