# zerenaod-ux/shelfmade-dashboard architecture

> Architecture diagram of the GitHub repository zerenaod-ux/shelfmade-dashboard, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/zerenaod-ux/shelfmade-dashboard
- Repository: https://github.com/zerenaod-ux/shelfmade-dashboard

## Overview

This is an automated studio for producing content across three channels, with a local web interface for reviewing drafts and operating jobs. The main workflow runs from a user request through job management and content generation to rendered drafts; review and publishing are separate capabilities. The README also documents AnimationDoodles production and bounded private-release scheduling. Several subsystems are represented by their exact paths in the tree, but their internal links are omitted where the sampled source does not establish them.

Main entry points: [`server.py`](https://github.com/zerenaod-ux/shelfmade-dashboard/blob/master/server.py) (Studio interface), [`cinematic_pipeline.py`](https://github.com/zerenaod-ux/shelfmade-dashboard/blob/master/cinematic_pipeline.py) (Full-video pipeline), [`worker.py`](https://github.com/zerenaod-ux/shelfmade-dashboard/blob/master/worker.py) (Short generation), [`jobs.py`](https://github.com/zerenaod-ux/shelfmade-dashboard/blob/master/jobs.py) (Job manager)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_control["Studio control"]
  node_server["Studio interface<br/>[server.py]"]
  node_jobs[("Job manager<br/>[jobs.py]")]
  node_status["Generation status"]
  node_daily["Daily planning<br/>[daily_plan.py]"]
end

subgraph group_generation["Content generation"]
  node_shortgen["Short generation<br/>[worker.py]"]
  node_booksummary["Book summaries<br/>[booksummary.py]"]
  node_content["Editorial scripts"]
  node_quality["Creative checks"]
  node_fulljobs["Full-video jobs<br/>[full_jobs.py]"]
end

subgraph group_production["Media production"]
  node_fullpipeline["Full-video pipeline"]
  node_footage["Footage selection"]
  node_voice["Local voice<br/>[local_voice.py]"]
  node_media["Media runtime<br/>[media_runtime.py]"]
  node_doodles["Doodles renderer<br/>[render.py]"]
end

subgraph group_operations["Review and release"]
  node_review["Draft review<br/>[review_decide.py]"]
  node_publisher["Publishing<br/>[publishing.py]"]
  node_release["Private scheduler"]
end

node_owner(("Studio operator"))
node_platforms(("Video platforms"))

node_owner -->|"operates"| node_server
node_server -->|"uses jobs"| node_jobs
node_server -->|"enables runtime"| node_media
node_server -->|"inspects drafts"| node_quality
node_server -->|"uses publishing"| node_publisher
node_daily -->|"plans jobs"| node_jobs
node_status -->|"reads jobs"| node_jobs
node_status -->|"reads plans"| node_daily
node_jobs -->|"tracks status"| node_status
node_shortgen -->|"builds scripts"| node_content
node_shortgen -->|"checks drafts"| node_quality
node_shortgen -->|"checks availability"| node_voice
node_shortgen -->|"commits selection"| node_footage
node_booksummary -->|"invokes generator"| node_shortgen
node_fulljobs -.->|"coordinates builds"| node_fullpipeline
node_fullpipeline -->|"uses scripts"| node_content
node_fullpipeline -->|"selects footage"| node_footage
node_fullpipeline -->|"uses voice"| node_voice
node_fullpipeline -->|"runs media"| node_media
node_doodles -.->|"uses runtime"| node_media
node_owner -->|"reviews drafts"| node_review
node_review -.->|"approves separately"| node_publisher
node_publisher -.->|"publishes"| node_platforms
node_owner -->|"authorizes schedule"| node_release
node_release -->|"schedules releases"| node_platforms

click node_server "https://github.com/zerenaod-ux/shelfmade-dashboard/blob/master/server.py"
click node_jobs "https://github.com/zerenaod-ux/shelfmade-dashboard/blob/master/jobs.py"
click node_status "https://github.com/zerenaod-ux/shelfmade-dashboard/blob/master/generation_status.py"
click node_daily "https://github.com/zerenaod-ux/shelfmade-dashboard/blob/master/daily_plan.py"
click node_shortgen "https://github.com/zerenaod-ux/shelfmade-dashboard/blob/master/worker.py"
click node_booksummary "https://github.com/zerenaod-ux/shelfmade-dashboard/blob/master/generator/booksummary.py"
click node_content "https://github.com/zerenaod-ux/shelfmade-dashboard/blob/master/cinematic_content.py"
click node_quality "https://github.com/zerenaod-ux/shelfmade-dashboard/blob/master/creative_quality.py"
click node_fulljobs "https://github.com/zerenaod-ux/shelfmade-dashboard/blob/master/full_jobs.py"
click node_fullpipeline "https://github.com/zerenaod-ux/shelfmade-dashboard/blob/master/cinematic_pipeline.py"
click node_footage "https://github.com/zerenaod-ux/shelfmade-dashboard/blob/master/footage_director.py"
click node_voice "https://github.com/zerenaod-ux/shelfmade-dashboard/blob/master/local_voice.py"
click node_media "https://github.com/zerenaod-ux/shelfmade-dashboard/blob/master/media_runtime.py"
click node_doodles "https://github.com/zerenaod-ux/shelfmade-dashboard/blob/master/doodles_engine/render.py"
click node_review "https://github.com/zerenaod-ux/shelfmade-dashboard/blob/master/review_decide.py"
click node_publisher "https://github.com/zerenaod-ux/shelfmade-dashboard/blob/master/publishing.py"
click node_release "https://github.com/zerenaod-ux/shelfmade-dashboard/blob/master/mindlore_private_schedule.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_server,node_jobs,node_status,node_daily toneBlue
class node_shortgen,node_booksummary,node_content,node_quality,node_fulljobs toneAmber
class node_fullpipeline,node_footage,node_voice,node_media,node_doodles toneMint
class node_review,node_publisher,node_release toneRose
class node_owner,node_platforms toneIndigo
```

## Components

### Studio control

- [Studio interface](https://github.com/zerenaod-ux/shelfmade-dashboard/blob/master/server.py): `server.py`
- [Job manager](https://github.com/zerenaod-ux/shelfmade-dashboard/blob/master/jobs.py): `jobs.py`
- [Generation status](https://github.com/zerenaod-ux/shelfmade-dashboard/blob/master/generation_status.py): `generation_status.py`
- [Daily planning](https://github.com/zerenaod-ux/shelfmade-dashboard/blob/master/daily_plan.py): `daily_plan.py`

### Content generation

- [Short generation](https://github.com/zerenaod-ux/shelfmade-dashboard/blob/master/worker.py): `worker.py`
- [Book summaries](https://github.com/zerenaod-ux/shelfmade-dashboard/blob/master/generator/booksummary.py): `generator/booksummary.py`
- [Editorial scripts](https://github.com/zerenaod-ux/shelfmade-dashboard/blob/master/cinematic_content.py): `cinematic_content.py`
- [Creative checks](https://github.com/zerenaod-ux/shelfmade-dashboard/blob/master/creative_quality.py): `creative_quality.py`
- [Full-video jobs](https://github.com/zerenaod-ux/shelfmade-dashboard/blob/master/full_jobs.py): `full_jobs.py`

### Media production

- [Full-video pipeline](https://github.com/zerenaod-ux/shelfmade-dashboard/blob/master/cinematic_pipeline.py): `cinematic_pipeline.py`
- [Footage selection](https://github.com/zerenaod-ux/shelfmade-dashboard/blob/master/footage_director.py): `footage_director.py`
- [Local voice](https://github.com/zerenaod-ux/shelfmade-dashboard/blob/master/local_voice.py): `local_voice.py`
- [Media runtime](https://github.com/zerenaod-ux/shelfmade-dashboard/blob/master/media_runtime.py): `media_runtime.py`
- [Doodles renderer](https://github.com/zerenaod-ux/shelfmade-dashboard/blob/master/doodles_engine/render.py): `doodles_engine/render.py`

### Review and release

- [Draft review](https://github.com/zerenaod-ux/shelfmade-dashboard/blob/master/review_decide.py): `review_decide.py`
- [Publishing](https://github.com/zerenaod-ux/shelfmade-dashboard/blob/master/publishing.py): `publishing.py`
- [Private scheduler](https://github.com/zerenaod-ux/shelfmade-dashboard/blob/master/mindlore_private_schedule.py): `mindlore_private_schedule.py`

### Other components

- **Studio operator**
- **Video platforms**

## Connections

- Studio operator → Studio interface: operates (evidence: `README.md`)
- Studio interface → Job manager: uses jobs (evidence: `server.py`)
- Studio interface → Media runtime: enables runtime (evidence: `server.py`)
- Studio interface → Creative checks: inspects drafts (evidence: `server.py`)
- Studio interface → Publishing: uses publishing (evidence: `server.py`)
- Daily planning → Job manager: plans jobs (evidence: `daily_plan.py`)
- Generation status → Job manager: reads jobs (evidence: `generation_status.py`)
- Generation status → Daily planning: reads plans (evidence: `generation_status.py`)
- Job manager → Generation status: tracks status (evidence: `generation_status.py`)
- Short generation → Editorial scripts: builds scripts (evidence: `worker.py`)
- Short generation → Creative checks: checks drafts (evidence: `worker.py`)
- Short generation → Local voice: checks availability (evidence: `worker.py`)
- Short generation → Footage selection: commits selection (evidence: `worker.py`)
- Book summaries → Short generation: invokes generator (evidence: `generator/booksummary.py`)
- Full-video jobs → Full-video pipeline: coordinates builds
- Full-video pipeline → Editorial scripts: uses scripts (evidence: `cinematic_pipeline.py`)
- Full-video pipeline → Footage selection: selects footage (evidence: `cinematic_pipeline.py`)
- Full-video pipeline → Local voice: uses voice (evidence: `cinematic_pipeline.py`)
- Full-video pipeline → Media runtime: runs media (evidence: `cinematic_pipeline.py`)
- Doodles renderer → Media runtime: uses runtime
- Studio operator → Draft review: reviews drafts (evidence: `README.md`)
- Draft review → Publishing: approves separately
- Publishing → Video platforms: publishes
- Studio operator → Private scheduler: authorizes schedule (evidence: `README.md`)
- Private scheduler → Video platforms: schedules releases (evidence: `README.md`)
