# kiruthik2006/studio_champ architecture

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

## Overview

Studio Champ is an event-photo discovery platform: users register face vectors and family-circle members, then search event photos for matching people; administrators manage events and bulk photo indexing. The React client also exposes guided capture, vector-quality reporting, multi-person filters, and cloud-photo workflows. Flask routes coordinate recognition, metadata, file storage, and ORM records. The graph includes documented capabilities whose implementation was not sampled; dashed links mark cloud integrations whose runtime wiring is not evidenced in the excerpts.

Main entry points: [`backend/routes/photos.py`](https://github.com/kiruthik2006/studio_champ/blob/main/backend/routes/photos.py) (Photo discovery routes), [`backend/routes/admin.py`](https://github.com/kiruthik2006/studio_champ/blob/main/backend/routes/admin.py) (Admin routes), [`backend/app.py`](https://github.com/kiruthik2006/studio_champ/blob/main/backend/app.py) (Flask API), [`frontend-react/src/App.jsx`](https://github.com/kiruthik2006/studio_champ/blob/main/frontend-react/src/App.jsx) (Application routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web application"]
  node_app["Application routes<br/>[App.jsx]"]
  node_dashboard["Discovery dashboard<br/>[DashboardPage.jsx]"]
  node_adminui["Admin console"]
  node_ingestionui["Cloud ingestion"]
  node_authstate["Session state<br/>[AuthContext.jsx]"]
  node_api["API client<br/>[client.js]"]
  node_photoapi["Photo API module<br/>[photos.js]"]
  node_adminapi["Admin API module<br/>[admin.js]"]
  node_authapi["Auth API module<br/>[auth.js]"]
end

subgraph group_identity["Identity and discovery"]
  node_authroutes["Authentication routes<br/>[auth.py]"]
  node_photoroutes["Photo discovery routes<br/>[photos.py]"]
  node_recognition["Face recognition"]
  node_capture["Face capture and quality"]
end

subgraph group_media["Photo ingestion"]
  node_metadata["Image metadata<br/>[image_metadata.py]"]
  node_storage["Photo file storage<br/>[storage.py]"]
  node_photosexport["Google Photos export"]
end

subgraph group_operations["Administration"]
  node_adminroutes["Admin routes<br/>[admin.py]"]
end

subgraph group_persistence["Persistence"]
  node_models["Domain records<br/>[__init__.py]"]
  node_database[("SQL database<br/>[__init__.py]")]
  node_appserver["Flask API<br/>[app.py]"]
end

node_attendee(("Attendee"))
node_administrator(("Administrator"))
node_drive["Google Drive"]

node_attendee -->|"opens"| node_app
node_administrator -->|"opens"| node_app
node_app -->|"routes to"| node_dashboard
node_app -->|"routes to"| node_adminui
node_app -->|"routes to"| node_ingestionui
node_dashboard -->|"requests photos"| node_photoapi
node_dashboard -->|"requests profile"| node_authapi
node_adminui -->|"requests admin data"| node_adminapi
node_authstate -->|"calls"| node_authapi
node_authstate -->|"manages tokens"| node_api
node_photoapi -->|"uses"| node_api
node_adminapi -->|"uses"| node_api
node_authapi -->|"uses"| node_api
node_api -->|"sends requests"| node_appserver
node_appserver -->|"registers"| node_authroutes
node_appserver -->|"registers"| node_photoroutes
node_appserver -->|"registers"| node_adminroutes
node_authroutes -->|"reads and writes"| node_models
node_photoroutes -->|"reads and writes"| node_models
node_photoroutes -->|"uses matching"| node_recognition
node_photoroutes -->|"stores images"| node_storage
node_photoroutes -->|"extracts metadata"| node_metadata
node_adminroutes -->|"manages records"| node_models
node_adminroutes -->|"uses indexing"| node_recognition
node_adminroutes -->|"stores uploads"| node_storage
node_adminroutes -->|"normalizes images"| node_metadata
node_appserver -->|"creates schema"| node_database
node_models -->|"defines ORM records"| node_database
node_capture -.->|"submits captures"| node_photoroutes
node_ingestionui -.->|"uses export flow"| node_photosexport
node_ingestionui -.->|"syncs photos"| node_drive
node_dashboard -.->|"offers cloud sync"| node_drive

click node_app "https://github.com/kiruthik2006/studio_champ/blob/main/frontend-react/src/App.jsx"
click node_dashboard "https://github.com/kiruthik2006/studio_champ/blob/main/frontend-react/src/pages/DashboardPage.jsx"
click node_adminui "https://github.com/kiruthik2006/studio_champ/blob/main/frontend-react/src/pages/AdminDashboardPage.jsx"
click node_ingestionui "https://github.com/kiruthik2006/studio_champ/blob/main/frontend-react/src/pages/CloudPhotosIngestionPage.jsx"
click node_authstate "https://github.com/kiruthik2006/studio_champ/blob/main/frontend-react/src/context/AuthContext.jsx"
click node_api "https://github.com/kiruthik2006/studio_champ/blob/main/frontend-react/src/api/client.js"
click node_photoapi "https://github.com/kiruthik2006/studio_champ/blob/main/frontend-react/src/api/photos.js"
click node_adminapi "https://github.com/kiruthik2006/studio_champ/blob/main/frontend-react/src/api/admin.js"
click node_authapi "https://github.com/kiruthik2006/studio_champ/blob/main/frontend-react/src/api/auth.js"
click node_authroutes "https://github.com/kiruthik2006/studio_champ/blob/main/backend/routes/auth.py"
click node_photoroutes "https://github.com/kiruthik2006/studio_champ/blob/main/backend/routes/photos.py"
click node_recognition "https://github.com/kiruthik2006/studio_champ/blob/main/backend/services/face_recognition.py"
click node_capture "https://github.com/kiruthik2006/studio_champ/blob/main/frontend-react/src/components/dashboard/GuidedCaptureJourneyModal.jsx"
click node_adminroutes "https://github.com/kiruthik2006/studio_champ/blob/main/backend/routes/admin.py"
click node_metadata "https://github.com/kiruthik2006/studio_champ/blob/main/backend/utils/image_metadata.py"
click node_storage "https://github.com/kiruthik2006/studio_champ/blob/main/backend/utils/storage.py"
click node_models "https://github.com/kiruthik2006/studio_champ/blob/main/backend/models/__init__.py"
click node_database "https://github.com/kiruthik2006/studio_champ/blob/main/backend/models/__init__.py"
click node_appserver "https://github.com/kiruthik2006/studio_champ/blob/main/backend/app.py"
click node_photosexport "https://github.com/kiruthik2006/studio_champ/blob/main/frontend-react/src/services/googlePhotosExporter.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_app,node_dashboard,node_adminui,node_ingestionui,node_authstate,node_api,node_photoapi,node_adminapi,node_authapi toneBlue
class node_authroutes,node_photoroutes,node_recognition,node_capture toneAmber
class node_metadata,node_storage,node_photosexport toneMint
class node_adminroutes toneRose
class node_models,node_database,node_appserver,node_attendee,node_administrator,node_drive toneIndigo
```

## Components

### Web application

- [Application routes](https://github.com/kiruthik2006/studio_champ/blob/main/frontend-react/src/App.jsx): `frontend-react/src/App.jsx`
- [Discovery dashboard](https://github.com/kiruthik2006/studio_champ/blob/main/frontend-react/src/pages/DashboardPage.jsx): `frontend-react/src/pages/DashboardPage.jsx`
- [Admin console](https://github.com/kiruthik2006/studio_champ/blob/main/frontend-react/src/pages/AdminDashboardPage.jsx): `frontend-react/src/pages/AdminDashboardPage.jsx`
- [Cloud ingestion](https://github.com/kiruthik2006/studio_champ/blob/main/frontend-react/src/pages/CloudPhotosIngestionPage.jsx): `frontend-react/src/pages/CloudPhotosIngestionPage.jsx`
- [Session state](https://github.com/kiruthik2006/studio_champ/blob/main/frontend-react/src/context/AuthContext.jsx): `frontend-react/src/context/AuthContext.jsx`
- [API client](https://github.com/kiruthik2006/studio_champ/blob/main/frontend-react/src/api/client.js): `frontend-react/src/api/client.js`
- [Photo API module](https://github.com/kiruthik2006/studio_champ/blob/main/frontend-react/src/api/photos.js): `frontend-react/src/api/photos.js`
- [Admin API module](https://github.com/kiruthik2006/studio_champ/blob/main/frontend-react/src/api/admin.js): `frontend-react/src/api/admin.js`
- [Auth API module](https://github.com/kiruthik2006/studio_champ/blob/main/frontend-react/src/api/auth.js): `frontend-react/src/api/auth.js`

### Identity and discovery

- [Authentication routes](https://github.com/kiruthik2006/studio_champ/blob/main/backend/routes/auth.py): `backend/routes/auth.py`
- [Photo discovery routes](https://github.com/kiruthik2006/studio_champ/blob/main/backend/routes/photos.py): `backend/routes/photos.py`
- [Face recognition](https://github.com/kiruthik2006/studio_champ/blob/main/backend/services/face_recognition.py): `backend/services/face_recognition.py`
- [Face capture and quality](https://github.com/kiruthik2006/studio_champ/blob/main/frontend-react/src/components/dashboard/GuidedCaptureJourneyModal.jsx): `frontend-react/src/components/dashboard/GuidedCaptureJourneyModal.jsx`

### Photo ingestion

- [Image metadata](https://github.com/kiruthik2006/studio_champ/blob/main/backend/utils/image_metadata.py): `backend/utils/image_metadata.py`
- [Photo file storage](https://github.com/kiruthik2006/studio_champ/blob/main/backend/utils/storage.py): `backend/utils/storage.py`
- [Google Photos export](https://github.com/kiruthik2006/studio_champ/blob/main/frontend-react/src/services/googlePhotosExporter.js): `frontend-react/src/services/googlePhotosExporter.js`

### Administration

- [Admin routes](https://github.com/kiruthik2006/studio_champ/blob/main/backend/routes/admin.py): `backend/routes/admin.py`

### Persistence

- [Domain records](https://github.com/kiruthik2006/studio_champ/blob/main/backend/models/__init__.py): `backend/models/__init__.py`
- [SQL database](https://github.com/kiruthik2006/studio_champ/blob/main/backend/models/__init__.py): `backend/models/__init__.py`
- [Flask API](https://github.com/kiruthik2006/studio_champ/blob/main/backend/app.py): `backend/app.py`

### Other components

- **Attendee**
- **Administrator**
- **Google Drive**

## Connections

- Attendee → Application routes: opens (evidence: `frontend-react/src/App.jsx`)
- Administrator → Application routes: opens (evidence: `frontend-react/src/App.jsx`)
- Application routes → Discovery dashboard: routes to (evidence: `frontend-react/src/App.jsx`)
- Application routes → Admin console: routes to (evidence: `frontend-react/src/App.jsx`)
- Application routes → Cloud ingestion: routes to (evidence: `frontend-react/src/App.jsx`)
- Discovery dashboard → Photo API module: requests photos (evidence: `frontend-react/src/pages/DashboardPage.jsx`)
- Discovery dashboard → Auth API module: requests profile (evidence: `frontend-react/src/pages/DashboardPage.jsx`)
- Admin console → Admin API module: requests admin data (evidence: `frontend-react/src/pages/AdminDashboardPage.jsx`)
- Session state → Auth API module: calls (evidence: `frontend-react/src/context/AuthContext.jsx`)
- Session state → API client: manages tokens (evidence: `frontend-react/src/context/AuthContext.jsx`)
- Photo API module → API client: uses (evidence: `frontend-react/src/api/photos.js`)
- Admin API module → API client: uses (evidence: `frontend-react/src/api/admin.js`)
- Auth API module → API client: uses (evidence: `frontend-react/src/api/auth.js`)
- API client → Flask API: sends requests (evidence: `frontend-react/src/api/client.js`)
- Flask API → Authentication routes: registers (evidence: `backend/app.py`)
- Flask API → Photo discovery routes: registers (evidence: `backend/app.py`)
- Flask API → Admin routes: registers (evidence: `backend/app.py`)
- Authentication routes → Domain records: reads and writes (evidence: `backend/routes/auth.py`)
- Photo discovery routes → Domain records: reads and writes (evidence: `backend/routes/photos.py`)
- Photo discovery routes → Face recognition: uses matching (evidence: `backend/routes/photos.py`)
- Photo discovery routes → Photo file storage: stores images (evidence: `backend/routes/photos.py`)
- Photo discovery routes → Image metadata: extracts metadata (evidence: `backend/routes/photos.py`)
- Admin routes → Domain records: manages records (evidence: `backend/routes/admin.py`)
- Admin routes → Face recognition: uses indexing (evidence: `backend/routes/admin.py`)
- Admin routes → Photo file storage: stores uploads (evidence: `backend/routes/admin.py`)
- Admin routes → Image metadata: normalizes images (evidence: `backend/routes/admin.py`)
- Flask API → SQL database: creates schema (evidence: `backend/app.py`)
- Domain records → SQL database: defines ORM records (evidence: `backend/models/__init__.py`)
- Face capture and quality → Photo discovery routes: submits captures
- Cloud ingestion → Google Photos export: uses export flow
- Cloud ingestion → Google Drive: syncs photos
- Discovery dashboard → Google Drive: offers cloud sync
