# MLazy Engine

**MLazy Engine** is an automated YouTube video generation, editing, and publishing backend engine.

---

## 📐 Entity-Relationship (ER) Diagram

```mermaid
erDiagram
    USERS ||--o{ TOPIC_QUEUE : "has queued topics"
    USERS ||--o{ STORIES : "creates scripts"
    USERS ||--o{ VIDEO_JOBS : "owns rendering jobs"
    USERS ||--o{ YOUTUBE_UPLOADS : "manages uploads"
    USERS ||--o{ STYLE_PROFILES : "saves channel styles"

    STORIES ||--o{ VIDEO_JOBS : "triggers render"
    VIDEO_JOBS ||--|| YOUTUBE_UPLOADS : "publishes to"

    USERS {
        string id PK
        string google_id UK
        string email UK
        string full_name
        string avatar_url
        string plan "free | pro"
        boolean style_clone_unlocked
        datetime created_at
    }

    TOPIC_QUEUE {
        string id PK
        string user_id FK
        string topic
        string status "pending | processing | completed"
        datetime created_at
    }

    STORIES {
        string id PK
        string user_id FK
        string topic
        string title
        string description
        json tags
        json scenes
        json style_profile
        string status "draft | approved | rendering | completed"
        datetime created_at
    }

    VIDEO_JOBS {
        string id PK
        string story_id FK
        string user_id FK
        string status "queued | rendering | merging | completed | failed"
        string local_video_path
        float duration_seconds
        string error_message
        datetime created_at
        datetime updated_at
    }

    YOUTUBE_UPLOADS {
        string id PK
        string job_id FK
        string user_id FK
        string youtube_video_id
        string youtube_url
        string privacy_status "public | private | unlisted"
        string status "pending | uploading | published | failed"
        datetime uploaded_at
    }

    STYLE_PROFILES {
        string id PK
        string user_id FK
        string channel_name
        string channel_url
        json style_dna
        datetime created_at
    }

ASCII Schema Representation

┌────────────────────────────────────────────────────────┐
│                        USERS                           │
├────────────────────────────────────────────────────────┤
│ PK  id                     String(36) UUID             │
│ UK  google_id              String(255)                 │
│ UK  email                  String(255)                 │
│     full_name              String(255)                 │
│     avatar_url             Text                        │
│     plan                   String(50) DEFAULT 'free'   │
│     style_clone_unlocked   Boolean DEFAULT False       │
│     created_at             DateTime (UTC)              │
└───────────┬───────────────────┬───────────────────┬────┘
            │ 1                 │ 1                 │ 1
            │                   │                   │
            │ N                 │ N                 │ N
┌───────────┴───────────┐ ┌─────┴─────────────┐ ┌───┴───────────────────┐
│      TOPIC_QUEUE      │ │      STORIES      │ │    STYLE_PROFILES     │
├───────────────────────┤ ├───────────────────┤ ├───────────────────────┤
│ PK id       String(36)│ │ PK id   String(36)│ │ PK id       String(36)│
│ FK user_id  String(36)│ │ FK user_id Str(36)│ │ FK user_id  String(36)│
│    topic    Text      │ │    topicText      │ │    channel_name Str   │
│    status   String    │ │    scenes JSON    │ │    style_dna JSON     │
└───────────────────────┘ └─────────┬─────────┘ └───────────────────────┘
                                    │ 1
                                    │
                                    │ N
                          ┌─────────┴─────────┐
                          │    VIDEO_JOBS     │
                          ├───────────────────┤
                          │ PK id   String(36)│
                          │ FK story_id Str(36│
                          │ FK user_id Str(36)│
                          │    status String  │
                          │    path   Text    │
                          └─────────┬─────────┘
                                    │ 1
                                    │
                                    │ 1
                          ┌─────────┴─────────┐
                          │  YOUTUBE_UPLOADS  │
                          ├───────────────────┤
                          │ PK id   String(36)│
                          │ FK job_id Str(36) │
                          │ FK user_id Str(36)│
                          │    youtube_url Text│
                          │    status String  │
                          └───────────────────┘

🛠️ Package Modules