# dhetchaiyakrith24/merrumi-cartoon architecture

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

- Interactive diagram: https://gitdiagram.com/dhetchaiyakrith24/merrumi-cartoon
- Repository: https://github.com/dhetchaiyakrith24/merrumi-cartoon

## Overview

Merrumi is a children’s cartoon production project, not a single runtime application. Its documented workflow moves from script and storyboard through an owner-approved, credit-bounded generation plan, Higgsfield video creation, local editing and sound/color work, owner review, and 16:9/9:16 delivery. The repository also retains publishing materials and story-led Shorts editing/QA tools. README statements establish the production flow; sampled scripts show specific local editing and QA behavior, but do not expose the full production orchestration or all integrations.

Main entry points: [`docs`](https://github.com/dhetchaiyakrith24/merrumi-cartoon/tree/main/docs) (Approved credit plan), [`Cartoon/edits`](https://github.com/dhetchaiyakrith24/merrumi-cartoon/tree/main/Cartoon/edits) (Edit, sound, color), [`Friday cartoon`](https://github.com/dhetchaiyakrith24/merrumi-cartoon/tree/main/Friday%20cartoon) (Owner review), [`Cartoon/Video work`](https://github.com/dhetchaiyakrith24/merrumi-cartoon/tree/main/Cartoon/Video%20work) (16:9 and 9:16 exports)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_planning["Story and planning"]
  node_stories["Scripts and storyboards"]
  node_production_plan["Approved credit plan"]
end

subgraph group_generation["Video generation"]
  node_higgsfield{{"Higgsfield"}}
  node_generated_video[("Generated source video")]
end

subgraph group_postproduction["Local post-production"]
  node_local_edit["Edit, sound, color"]
  node_shorts_batch["Story Shorts batch"]
  node_shorts_tools["Shorts frame tools"]
  node_shorts_qa["Shorts QA<br/>[qa_shorts_story.py]"]
end

subgraph group_delivery["Review and delivery"]
  node_review["Owner review"]
  node_deliverables[("16:9 and 9:16 exports")]
  node_publishing["Publishing pack"]
end

node_owner(("Owner"))

node_stories -->|"inform plan"| node_production_plan
node_owner -->|"approves credits"| node_production_plan
node_production_plan -->|"authorizes generation"| node_higgsfield
node_higgsfield -->|"creates video"| node_generated_video
node_generated_video -->|"provides footage"| node_local_edit
node_local_edit -->|"prepares for review"| node_review
node_owner -->|"views and listens"| node_review
node_review -->|"approves export"| node_deliverables
node_local_edit -->|"exports formats"| node_deliverables
node_owner -->|"sets credit ceiling"| node_production_plan
node_shorts_qa -->|"imports frames"| node_shorts_tools
node_shorts_batch -.->|"shares inspection"| node_shorts_tools
node_shorts_batch -.->|"renders Shorts"| node_deliverables
node_owner -.->|"prepares posts"| node_publishing

click node_stories "https://github.com/dhetchaiyakrith24/merrumi-cartoon/tree/main/Cartoon/stories"
click node_production_plan "https://github.com/dhetchaiyakrith24/merrumi-cartoon/tree/main/docs"
click node_generated_video "https://github.com/dhetchaiyakrith24/merrumi-cartoon/tree/main/Cartoon/All%20generated%20videos"
click node_local_edit "https://github.com/dhetchaiyakrith24/merrumi-cartoon/tree/main/Cartoon/edits"
click node_shorts_batch "https://github.com/dhetchaiyakrith24/merrumi-cartoon/blob/main/Cartoon/archive/20260921-video-format-folders-204659/edits/render_shorts_story_batch.py"
click node_shorts_tools "https://github.com/dhetchaiyakrith24/merrumi-cartoon/blob/main/Cartoon/edits/shorts_story_tools.py"
click node_shorts_qa "https://github.com/dhetchaiyakrith24/merrumi-cartoon/blob/main/Cartoon/edits/qa_shorts_story.py"
click node_review "https://github.com/dhetchaiyakrith24/merrumi-cartoon/tree/main/Friday%20cartoon"
click node_deliverables "https://github.com/dhetchaiyakrith24/merrumi-cartoon/tree/main/Cartoon/Video%20work"
click node_publishing "https://github.com/dhetchaiyakrith24/merrumi-cartoon/tree/main/Cartoon/Publishing"

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_stories,node_production_plan toneBlue
class node_higgsfield,node_generated_video toneAmber
class node_local_edit,node_shorts_batch,node_shorts_tools,node_shorts_qa toneMint
class node_review,node_deliverables,node_publishing toneRose
class node_owner toneIndigo
```

## Components

### Story and planning

- [Scripts and storyboards](https://github.com/dhetchaiyakrith24/merrumi-cartoon/tree/main/Cartoon/stories): `Cartoon/stories`
- [Approved credit plan](https://github.com/dhetchaiyakrith24/merrumi-cartoon/tree/main/docs): `docs`

### Video generation

- **Higgsfield**
- [Generated source video](https://github.com/dhetchaiyakrith24/merrumi-cartoon/tree/main/Cartoon/All%20generated%20videos): `Cartoon/All generated videos`

### Local post-production

- [Edit, sound, color](https://github.com/dhetchaiyakrith24/merrumi-cartoon/tree/main/Cartoon/edits): `Cartoon/edits`
- [Story Shorts batch](https://github.com/dhetchaiyakrith24/merrumi-cartoon/blob/main/Cartoon/archive/20260921-video-format-folders-204659/edits/render_shorts_story_batch.py): `Cartoon/archive/20260921-video-format-folders-204659/edits/render_shorts_story_batch.py`
- [Shorts frame tools](https://github.com/dhetchaiyakrith24/merrumi-cartoon/blob/main/Cartoon/edits/shorts_story_tools.py): `Cartoon/edits/shorts_story_tools.py`
- [Shorts QA](https://github.com/dhetchaiyakrith24/merrumi-cartoon/blob/main/Cartoon/edits/qa_shorts_story.py): `Cartoon/edits/qa_shorts_story.py`

### Review and delivery

- [Owner review](https://github.com/dhetchaiyakrith24/merrumi-cartoon/tree/main/Friday%20cartoon): `Friday cartoon`
- [16:9 and 9:16 exports](https://github.com/dhetchaiyakrith24/merrumi-cartoon/tree/main/Cartoon/Video%20work): `Cartoon/Video work`
- [Publishing pack](https://github.com/dhetchaiyakrith24/merrumi-cartoon/tree/main/Cartoon/Publishing): `Cartoon/Publishing`

### Other components

- **Owner**

## Connections

- Scripts and storyboards → Approved credit plan: inform plan (evidence: `README.md`)
- Owner → Approved credit plan: approves credits (evidence: `README.md`)
- Approved credit plan → Higgsfield: authorizes generation (evidence: `README.md`)
- Higgsfield → Generated source video: creates video (evidence: `README.md`)
- Generated source video → Edit, sound, color: provides footage (evidence: `README.md`)
- Edit, sound, color → Owner review: prepares for review (evidence: `README.md`)
- Owner → Owner review: views and listens (evidence: `README.md`)
- Owner review → 16:9 and 9:16 exports: approves export (evidence: `README.md`)
- Edit, sound, color → 16:9 and 9:16 exports: exports formats (evidence: `README.md`)
- Owner → Approved credit plan: sets credit ceiling (evidence: `README.md`)
- Shorts QA → Shorts frame tools: imports frames (evidence: `Cartoon/edits/qa_shorts_story.py`)
- Story Shorts batch → Shorts frame tools: shares inspection
- Story Shorts batch → 16:9 and 9:16 exports: renders Shorts
- Owner → Publishing pack: prepares posts