# patelheer27/qoneqt-ai-content-studio architecture

> Architecture diagram of the GitHub repository patelheer27/qoneqt-ai-content-studio, 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/patelheer27/qoneqt-ai-content-studio
- Repository: https://github.com/patelheer27/qoneqt-ai-content-studio

## Overview

Qoneqt AI Content Studio turns a creator’s topic and production choices into a structured short-video plan, rendered vertical MP4, preview, and simulated publish action. The main workflow runs from the Dashboard through project APIs and asynchronous pipeline orchestration, then returns status and video for preview or history. Planning, scene records, and rendering are distinct backend stages; the frontend also exposes project history and publishing. The graph reflects the excerpts and README; some UI wiring and backend subsystems are supported only by SOURCE INDEX references or documentation.

Main entry points: [`frontend/src/services/api.js`](https://github.com/patelheer27/qoneqt-ai-content-studio/blob/main/frontend/src/services/api.js) (API Client), [`backend/app/services/pipeline_service.py`](https://github.com/patelheer27/qoneqt-ai-content-studio/blob/main/backend/app/services/pipeline_service.py) (Pipeline Orchestrator), [`frontend/src/pages/Dashboard.jsx`](https://github.com/patelheer27/qoneqt-ai-content-studio/blob/main/frontend/src/pages/Dashboard.jsx) (Dashboard), [`backend/app/models/scene.py`](https://github.com/patelheer27/qoneqt-ai-content-studio/blob/main/backend/app/models/scene.py) (Scene Model)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Creator Studio UI"]
  node_app["App Shell<br/>[App.jsx]"]
  node_dashboard["Dashboard<br/>[Dashboard.jsx]"]
  node_history["Project History"]
  node_planview["Content Plan View"]
  node_tracker["Pipeline Tracker"]
  node_preview["Video Preview"]
  node_publishui["Publish Modal<br/>[PublishModal.jsx]"]
end

subgraph group_api["Project API"]
  node_api_client["API Client<br/>[api.js]"]
  node_project_routes["Project Routes<br/>[projects.py]"]
  node_health["Health Route<br/>[health.py]"]
end

subgraph group_planning["Content Planning"]
  node_pipeline["Pipeline Orchestrator"]
  node_llm["Plan Generator<br/>[llm_service.py]"]
  node_plan_schema["Plan Schemas<br/>[llm.py]"]
  node_scene_service["Scene Builder<br/>[scene_service.py]"]
  node_script_service["Script Service<br/>[script_service.py]"]
end

subgraph group_production["Video Production"]
  node_video["Video Renderer<br/>[video_service.py]"]
  node_media["Media Service<br/>[media_service.py]"]
  node_voice["Voice Service<br/>[voice_service.py]"]
  node_image_gen["Image Generator<br/>[image_gen.py]"]
  node_subtitles["Subtitle Formatter<br/>[subtitles.py]"]
end

subgraph group_storage["Project Storage"]
  node_db_session["Database Session<br/>[session.py]"]
  node_project_model["Project Model<br/>[project.py]"]
  node_scene_model["Scene Model<br/>[scene.py]"]
  node_sqlite[("SQLite Database")]
end

node_creator(("Creator"))
node_json2video["JSON2Video Cloud"]

node_creator -->|"enters topic"| node_dashboard
node_app -->|"shows"| node_dashboard
node_app -->|"shows"| node_history
node_app -->|"opens"| node_publishui
node_dashboard -->|"renders"| node_planview
node_dashboard -->|"renders"| node_tracker
node_dashboard -->|"renders"| node_preview
node_dashboard -->|"requests generation"| node_api_client
node_app -->|"polls status"| node_api_client
node_history -.->|"loads projects"| node_api_client
node_preview -.->|"requests video"| node_api_client
node_api_client -->|"calls project API"| node_project_routes
node_api_client -->|"calls health API"| node_health
node_project_routes -->|"schedules generation"| node_pipeline
node_pipeline -->|"generates plan"| node_llm
node_llm -->|"validates plan"| node_plan_schema
node_pipeline -->|"creates scenes"| node_scene_service
node_scene_service -->|"creates records"| node_scene_model
node_scene_service -->|"reads scene items"| node_plan_schema
node_pipeline -->|"composes video"| node_video
node_video -->|"submits render"| node_json2video
node_video -->|"reads scenes"| node_scene_model
node_pipeline -->|"updates project"| node_project_model
node_pipeline -->|"opens session"| node_db_session
node_project_routes -->|"queries projects"| node_project_model
node_project_routes -->|"reads scenes"| node_scene_model
node_db_session -->|"connects"| node_sqlite
node_media -->|"uses"| node_image_gen
node_voice -->|"uses scene data"| node_scene_model
node_media -->|"uses scene data"| node_scene_model
node_publishui -.->|"publishes project"| node_api_client
node_script_service -.->|"supports scripting"| node_llm
node_subtitles -.->|"caption integration"| node_video

click node_app "https://github.com/patelheer27/qoneqt-ai-content-studio/blob/main/frontend/src/App.jsx"
click node_dashboard "https://github.com/patelheer27/qoneqt-ai-content-studio/blob/main/frontend/src/pages/Dashboard.jsx"
click node_history "https://github.com/patelheer27/qoneqt-ai-content-studio/blob/main/frontend/src/pages/ProjectsHistory.jsx"
click node_planview "https://github.com/patelheer27/qoneqt-ai-content-studio/blob/main/frontend/src/components/ContentPlanView.jsx"
click node_tracker "https://github.com/patelheer27/qoneqt-ai-content-studio/blob/main/frontend/src/components/PipelineTracker.jsx"
click node_preview "https://github.com/patelheer27/qoneqt-ai-content-studio/blob/main/frontend/src/components/VideoPreviewCard.jsx"
click node_publishui "https://github.com/patelheer27/qoneqt-ai-content-studio/blob/main/frontend/src/components/PublishModal.jsx"
click node_api_client "https://github.com/patelheer27/qoneqt-ai-content-studio/blob/main/frontend/src/services/api.js"
click node_project_routes "https://github.com/patelheer27/qoneqt-ai-content-studio/blob/main/backend/app/routes/projects.py"
click node_health "https://github.com/patelheer27/qoneqt-ai-content-studio/blob/main/backend/app/routes/health.py"
click node_pipeline "https://github.com/patelheer27/qoneqt-ai-content-studio/blob/main/backend/app/services/pipeline_service.py"
click node_llm "https://github.com/patelheer27/qoneqt-ai-content-studio/blob/main/backend/app/services/llm_service.py"
click node_plan_schema "https://github.com/patelheer27/qoneqt-ai-content-studio/blob/main/backend/app/schemas/llm.py"
click node_scene_service "https://github.com/patelheer27/qoneqt-ai-content-studio/blob/main/backend/app/services/scene_service.py"
click node_script_service "https://github.com/patelheer27/qoneqt-ai-content-studio/blob/main/backend/app/services/script_service.py"
click node_video "https://github.com/patelheer27/qoneqt-ai-content-studio/blob/main/backend/app/services/video_service.py"
click node_media "https://github.com/patelheer27/qoneqt-ai-content-studio/blob/main/backend/app/services/media_service.py"
click node_voice "https://github.com/patelheer27/qoneqt-ai-content-studio/blob/main/backend/app/services/voice_service.py"
click node_image_gen "https://github.com/patelheer27/qoneqt-ai-content-studio/blob/main/backend/app/utils/image_gen.py"
click node_subtitles "https://github.com/patelheer27/qoneqt-ai-content-studio/blob/main/backend/app/utils/subtitles.py"
click node_db_session "https://github.com/patelheer27/qoneqt-ai-content-studio/blob/main/backend/app/database/session.py"
click node_project_model "https://github.com/patelheer27/qoneqt-ai-content-studio/blob/main/backend/app/models/project.py"
click node_scene_model "https://github.com/patelheer27/qoneqt-ai-content-studio/blob/main/backend/app/models/scene.py"

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_history,node_planview,node_tracker,node_preview,node_publishui toneBlue
class node_api_client,node_project_routes,node_health toneAmber
class node_pipeline,node_llm,node_plan_schema,node_scene_service,node_script_service toneMint
class node_video,node_media,node_voice,node_image_gen,node_subtitles toneRose
class node_db_session,node_project_model,node_scene_model,node_sqlite,node_creator,node_json2video toneIndigo
```

## Components

### Creator Studio UI

- [App Shell](https://github.com/patelheer27/qoneqt-ai-content-studio/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Dashboard](https://github.com/patelheer27/qoneqt-ai-content-studio/blob/main/frontend/src/pages/Dashboard.jsx): `frontend/src/pages/Dashboard.jsx`
- [Project History](https://github.com/patelheer27/qoneqt-ai-content-studio/blob/main/frontend/src/pages/ProjectsHistory.jsx): `frontend/src/pages/ProjectsHistory.jsx`
- [Content Plan View](https://github.com/patelheer27/qoneqt-ai-content-studio/blob/main/frontend/src/components/ContentPlanView.jsx): `frontend/src/components/ContentPlanView.jsx`
- [Pipeline Tracker](https://github.com/patelheer27/qoneqt-ai-content-studio/blob/main/frontend/src/components/PipelineTracker.jsx): `frontend/src/components/PipelineTracker.jsx`
- [Video Preview](https://github.com/patelheer27/qoneqt-ai-content-studio/blob/main/frontend/src/components/VideoPreviewCard.jsx): `frontend/src/components/VideoPreviewCard.jsx`
- [Publish Modal](https://github.com/patelheer27/qoneqt-ai-content-studio/blob/main/frontend/src/components/PublishModal.jsx): `frontend/src/components/PublishModal.jsx`

### Project API

- [API Client](https://github.com/patelheer27/qoneqt-ai-content-studio/blob/main/frontend/src/services/api.js): `frontend/src/services/api.js`
- [Project Routes](https://github.com/patelheer27/qoneqt-ai-content-studio/blob/main/backend/app/routes/projects.py): `backend/app/routes/projects.py`
- [Health Route](https://github.com/patelheer27/qoneqt-ai-content-studio/blob/main/backend/app/routes/health.py): `backend/app/routes/health.py`

### Content Planning

- [Pipeline Orchestrator](https://github.com/patelheer27/qoneqt-ai-content-studio/blob/main/backend/app/services/pipeline_service.py): `backend/app/services/pipeline_service.py`
- [Plan Generator](https://github.com/patelheer27/qoneqt-ai-content-studio/blob/main/backend/app/services/llm_service.py): `backend/app/services/llm_service.py`
- [Plan Schemas](https://github.com/patelheer27/qoneqt-ai-content-studio/blob/main/backend/app/schemas/llm.py): `backend/app/schemas/llm.py`
- [Scene Builder](https://github.com/patelheer27/qoneqt-ai-content-studio/blob/main/backend/app/services/scene_service.py): `backend/app/services/scene_service.py`
- [Script Service](https://github.com/patelheer27/qoneqt-ai-content-studio/blob/main/backend/app/services/script_service.py): `backend/app/services/script_service.py`

### Video Production

- [Video Renderer](https://github.com/patelheer27/qoneqt-ai-content-studio/blob/main/backend/app/services/video_service.py): `backend/app/services/video_service.py`
- [Media Service](https://github.com/patelheer27/qoneqt-ai-content-studio/blob/main/backend/app/services/media_service.py): `backend/app/services/media_service.py`
- [Voice Service](https://github.com/patelheer27/qoneqt-ai-content-studio/blob/main/backend/app/services/voice_service.py): `backend/app/services/voice_service.py`
- [Image Generator](https://github.com/patelheer27/qoneqt-ai-content-studio/blob/main/backend/app/utils/image_gen.py): `backend/app/utils/image_gen.py`
- [Subtitle Formatter](https://github.com/patelheer27/qoneqt-ai-content-studio/blob/main/backend/app/utils/subtitles.py): `backend/app/utils/subtitles.py`

### Project Storage

- [Database Session](https://github.com/patelheer27/qoneqt-ai-content-studio/blob/main/backend/app/database/session.py): `backend/app/database/session.py`
- [Project Model](https://github.com/patelheer27/qoneqt-ai-content-studio/blob/main/backend/app/models/project.py): `backend/app/models/project.py`
- [Scene Model](https://github.com/patelheer27/qoneqt-ai-content-studio/blob/main/backend/app/models/scene.py): `backend/app/models/scene.py`
- **SQLite Database**

### Other components

- **Creator**
- **JSON2Video Cloud**

## Connections

- Creator → Dashboard: enters topic (evidence: `README.md`)
- App Shell → Dashboard: shows (evidence: `frontend/src/App.jsx`)
- App Shell → Project History: shows (evidence: `frontend/src/App.jsx`)
- App Shell → Publish Modal: opens (evidence: `frontend/src/App.jsx`)
- Dashboard → Content Plan View: renders (evidence: `frontend/src/pages/Dashboard.jsx`)
- Dashboard → Pipeline Tracker: renders (evidence: `frontend/src/pages/Dashboard.jsx`)
- Dashboard → Video Preview: renders (evidence: `frontend/src/pages/Dashboard.jsx`)
- Dashboard → API Client: requests generation (evidence: `frontend/src/App.jsx`)
- App Shell → API Client: polls status (evidence: `frontend/src/App.jsx`)
- Project History → API Client: loads projects
- Video Preview → API Client: requests video
- API Client → Project Routes: calls project API (evidence: `README.md`)
- API Client → Health Route: calls health API (evidence: `README.md`)
- Project Routes → Pipeline Orchestrator: schedules generation (evidence: `backend/app/routes/projects.py`)
- Pipeline Orchestrator → Plan Generator: generates plan (evidence: `backend/app/services/pipeline_service.py`)
- Plan Generator → Plan Schemas: validates plan (evidence: `backend/app/services/llm_service.py`)
- Pipeline Orchestrator → Scene Builder: creates scenes (evidence: `backend/app/services/pipeline_service.py`)
- Scene Builder → Scene Model: creates records (evidence: `backend/app/services/scene_service.py`)
- Scene Builder → Plan Schemas: reads scene items (evidence: `backend/app/services/scene_service.py`)
- Pipeline Orchestrator → Video Renderer: composes video (evidence: `backend/app/services/pipeline_service.py`)
- Video Renderer → JSON2Video Cloud: submits render (evidence: `backend/app/services/video_service.py`)
- Video Renderer → Scene Model: reads scenes (evidence: `backend/app/services/video_service.py`)
- Pipeline Orchestrator → Project Model: updates project (evidence: `backend/app/services/pipeline_service.py`)
- Pipeline Orchestrator → Database Session: opens session (evidence: `backend/app/services/pipeline_service.py`)
- Project Routes → Project Model: queries projects (evidence: `backend/app/routes/projects.py`)
- Project Routes → Scene Model: reads scenes (evidence: `backend/app/routes/projects.py`)
- Database Session → SQLite Database: connects (evidence: `backend/app/database/session.py`)
- Media Service → Image Generator: uses (evidence: `backend/app/services/media_service.py`)
- Voice Service → Scene Model: uses scene data (evidence: `backend/app/services/voice_service.py`)
- Media Service → Scene Model: uses scene data (evidence: `backend/app/services/media_service.py`)
- Publish Modal → API Client: publishes project
- Script Service → Plan Generator: supports scripting
- Subtitle Formatter → Video Renderer: caption integration
