# matt-fontes/sendscriptwhatsapp architecture

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

- Interactive diagram: https://gitdiagram.com/matt-fontes/sendscriptwhatsapp
- Repository: https://github.com/matt-fontes/sendscriptwhatsapp

## Overview

##### Tipo e propósito do projeto (pelo file tree + README)
Este projeto **não é uma aplicação web/server** nem um “sistema” clássico com múltiplos serviços. É um **repositório de scripts JavaScript** para serem **colados e executados no console do navegador** enquanto o usuário está no **WhatsApp Web**, com o objetivo de **enviar automaticamente, em sequência, o texto completo** do script do **Shrek** ou do **Bee Movie** para um chat (amigo/grupo).

**Arquitetura dominante:** automação client-side “injetada” (user-driven) em uma página existente (WhatsApp Web).
**Componentes do repo:** somente dois scripts + README de instruções.

##### O que o file tree diz sobre a arquitetura
**Top-level:**
- `shrekSendScript.js`
- `beeMovieSendScript.js`
- `README.md`

Isso indica:
- Não há backend, build, dependências, testes, nem empacotamento.
- O comportamento do “sistema” está todo **dentro de cada arquivo `.js`**.
- A interação principal é com o **DOM/objetos JS** do WhatsApp Web (ou com a área de input) e eventos de teclado/click.

##### O que o README acrescenta (fluxo operacional real)
O README define o “pipeline” do usuário:
##### Script passa a enviar mensagens automaticamente.

**Isso é essencial para o diagrama**, porque o “gatilho” do sistema é humano (usuário) e o ambiente é o browser + WhatsApp Web.

##### 4a) Identifique os componentes principais (blocos do diagrama)
Para ser fiel ao projeto, seus blocos devem refletir **ambiente**, **ator**, **script**, e **alvos**:

##### Usuário
- Ações: copiar/colar, permitir colagem, iniciar execução.

##### Browser (Chrome/Firefox) + DevTools Console
- Onde o script é injetado e executado.
- Inclua a etapa “allow pasting” como um “gate”/restrição do ambiente (Chrome).

##### WhatsApp Web (Aplicação Web)
- Página/SPA do WhatsApp rodando no browser.
- Contém os elementos de UI: caixa de mensagem, botão enviar, chat aberto.

##### Send Script (um dos arquivos)
- `shrekSendScript.js` **ou** `beeMovieSendScript.js`
- Dentro dele, você pode representar subcomponentes lógicos (mesmo que sejam funções soltas):
- **Fonte do texto** (string/array/linhas do script do filme)
- **Scheduler/Loop** (envio em intervalos para evitar travar/limites)
- **Inserção no input** (setar valor/innerText/dispatch events)
- **Ação de envio** (simular Enter/click no botão enviar)

##### WhatsApp Backend (Serviço remoto do WhatsApp)
- Mesmo não estando no repo, é parte do fluxo real: mensagens saem do browser para o backend do WhatsApp.

##### Destinatário (Contato/Grupo)
- Recebe as mensagens.

**Observação:** embora o repositório tenha poucos arquivos, o diagrama “de sistema” fica mais preciso quando você inclui o **contexto externo** (WhatsApp Web + backend), porque é aí que os efeitos acontecem.

##### 4b) Determine relações e interações (setas / data flow)
O que você precisa mostrar com setas direcionais:

##### Usuário → GitHub/Arquivo .js
- “Copia conteúdo do script”
##### Usuário → DevTools Console
- “allow pasting” (se Chrome) e “cola + executa”
##### DevTools Console → Runtime JS da página (WhatsApp Web)
- “injeta/executa JS no contexto da aba”
##### Script JS → DOM/UI do WhatsApp Web
- “escreve na caixa de texto”
- “dispara eventos (keydown/enter) ou clica em enviar”
##### WhatsApp Web → WhatsApp Backend
- “envia mensagens via rede”
##### WhatsApp Backend → Destinatário
- “entrega mensagens”

Se quiser detalhar o “miolo”, desenhe também o loop:
- **Texto do filme → (segmentação/linhas) → fila → scheduler → envio repetido**

##### 4c) Padrões/decisões arquiteturais relevantes
Mesmo simples, há princípios que valem representar:

- **Injeção manual via console** (não é extensão, não é userscript manager; depende do usuário)
- **Automação por manipulação de UI** (o script não usa API oficial; interage com elementos/inputs)
- **Dependência forte do DOM do WhatsApp Web** (frágil a mudanças de UI/seletores/comportamento)
- **Rate/Timing control** (provável uso de `setInterval`/`setTimeout` para cadenciar envios)
- **Execução local, sem persistência** (nenhum estado em servidor; tudo efêmero na aba)

##### 4d) Tecnologias e “bibliotecas”
- **JavaScript puro** (sem libs no repo)
- **Browser DOM APIs / Events**
- **WhatsApp Web** (plataforma alvo)
- **DevTools Console** (mecanismo de injeção)

##### Como “tailorar” o diagrama para este tipo de projeto (script/tool)
Este projeto se encaixa melhor como **open-source tool / automação** do que como app full-stack.

Então, no diagrama:
- Foque no **ponto de integração**: “Script roda dentro da aba do WhatsApp Web”.
- Mostre claramente o **ator humano** (inicia o fluxo) e a **restrição do ambiente** (`allow pasting`).
- Mostre a automação como um **loop controlado por tempo** (para não parecer “um único envio”).

Sugestão de dois níveis de diagrama (recomendado para ficar “bem detalhado” sem confundir):

- Usuário, Browser/Console, WhatsApp Web, WhatsApp Backend, Destinatário.

- Componentes lógicos do script (Text Source / Parser / Queue / Scheduler / UI Injector / Sender).

##### Labels claros
- Nomeie os nós com termos do repo e do ambiente:
- `shrekSendScript.js` / `beeMovieSendScript.js`
- “DevTools Console (Chrome)”
- “WhatsApp Web (DOM + UI)”
- “WhatsApp Backend (External)”
- “Contato/Grupo”

##### Setas e direções
- Use setas unidirecionais para:
- controle (usuário inicia)
- execução (console injeta)
- dados (texto do filme vira mensagens)
- rede (web app → backend → recipient)

##### Cores/formas (padronize)
- **Azul (interno do repo):** os scripts
- **Cinza (ambiente do cliente):** Browser, DevTools, WhatsApp Web UI
- **Laranja/vermelho (externo/terceiros):** WhatsApp Backend, Destinatário
- Formas:
- Retângulos = componentes
- Cilindro (se quiser) = “backend/serviço” (mesmo que não seja DB)
- Notas/Callouts = restrições (“Chrome block paste → allow pasting”)

##### Detalhes finais que aumentam muito a “acurácia”
- Indique explicitamente que o script depende de:
- **chat aberto** no WhatsApp Web
- **foco na caixa de mensagem** (muitas automações dependem disso)
- Adicione uma nota: “Pode quebrar com mudanças no WhatsApp Web/seletores”.
- Se o script tiver delays, represente como “intervalo (ms)” no Scheduler (mesmo que você não saiba o valor exato, desenhe o conceito).

Se você quiser deixar o diagrama perfeito, abra `shrekSendScript.js` e `beeMovieSendScript.js` e extraia:
- como o texto está armazenado (string única vs array)
- como ele encontra o input (querySelector/XPath)
- como dispara o envio (evento Enter vs click)
- qual política de timing (intervalo fixo, backoff, etc.)
Esses detalhes viram rótulos no diagrama de componentes e tornam a arquitetura “exata”, não apenas conceitual.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% =========================
    %% Actors & External Context
    %% =========================
    U["Usuário"]:::actor

    subgraph "Ambiente do Cliente (Browser)"
        B["Browser (Chrome/Firefox)"]:::client
        DTC["DevTools Console"]:::client
        GATE["Gate: Chrome bloqueia colagem\n(usar comando: allow pasting)"]:::note
        WWEB["WhatsApp Web (SPA)\nDOM + UI (chat aberto, foco no input)"]:::client
        UIIN["Caixa de mensagem (input/textarea/contenteditable)"]:::client
        SENDUI["Ação de envio\n(Enter ou clique em Enviar)"]:::client
    end

    WAB[("WhatsApp Backend\n(Serviço remoto)")]:::external
    R["Destinatário\n(Contato/Grupo)"]:::external

    %% =========================
    %% Repository (Scripts)
    %% =========================
    subgraph "Repositório (Scripts JavaScript)"
        README["README (Instruções)"]:::repo

        subgraph "Send Script (selecionar um)"
            SHREK["shrekSendScript.js"]:::repo
            BEE["beeMovieSendScript.js"]:::repo
        end

        subgraph "Componentes Lógicos do Script (em cada .js)"
            TS["Fonte do texto do filme\n(string/linhas/array)"]:::logic
            SPLIT["Segmentação\n(linhas/trechos)"]:::logic
            Q["Fila/Iterator"]:::logic
            SCH["Scheduler/Loop\n(setTimeout/setInterval)\n(rate control)"]:::logic
            INJ["UI Injector\n(escrever no input + dispatch events)"]:::logic
            TRIG["Send Trigger\n(simular Enter/click)"]:::logic
        end
    end

    %% =========================
    %% Main Flow (Vertical)
    %% =========================
    U -->|"abre_e_lê"| README
    U -->|"copia_script_raw"| SHREK
    U -->|"copia_script_raw"| BEE

    U -->|"abre_devtools"| B
    B -->|"acessa_console"| DTC
    DTC -->|"restrição_colagem"| GATE
    U -->|"digita_allow_pasting"| GATE
    U -->|"cola_e_executa"| DTC

    DTC -->|"injeta_JS_no_contexto_da_aba"| WWEB
    WWEB -->|"executa"| SHREK
    WWEB -->|"executa"| BEE

    %% =========================
    %% Script Internals (Loop)
    %% =========================
    SHREK -->|"contém"| TS
    BEE -->|"contém"| TS

    TS -->|"gera_trechos"| SPLIT
    SPLIT -->|"enfileira"| Q
    Q -->|"itera"| SCH
    SCH -->|"cada_intervalo"| INJ
    INJ -->|"escreve"| UIIN
    INJ -->|"prepara_envio"| TRIG
    TRIG -->|"dispara"| SENDUI
    SENDUI -->|"envia_via_rede"| WAB
    WAB -->|"entrega_mensagens"| R

    %% =========================
    %% Notes / Constraints
    %% =========================
    FRAG["Nota: Dependência forte do DOM/UI do WhatsApp Web\nPode quebrar com mudanças de seletores/comportamento"]:::note
    WWEB -.->|"fragilidade"| FRAG

    FOCUS["Pré-condição: chat correto aberto\n+ foco na caixa de mensagem"]:::note
    U -.->|"garante_precondição"| FOCUS
    FOCUS -.->|"necessário_para"| UIIN

    %% =========================
    %% Click Events (mapped)
    %% =========================
    click README "https://github.com/matt-fontes/sendscriptwhatsapp/blob/main/README.md"
    click SHREK "https://github.com/matt-fontes/sendscriptwhatsapp/blob/main/shrekSendScript.js"
    click BEE "https://github.com/matt-fontes/sendscriptwhatsapp/blob/main/beeMovieSendScript.js"

    %% =========================
    %% Styles
    %% =========================
    classDef repo fill:#1f77b4,stroke:#0b3554,stroke-width:1.5px,color:#ffffff
    classDef client fill:#c7cdd3,stroke:#5b6770,stroke-width:1.2px,color:#111111
    classDef external fill:#ff8f3d,stroke:#8a3b00,stroke-width:1.5px,color:#111111
    classDef actor fill:#2f80ed,stroke:#0b3554,stroke-width:1.5px,color:#ffffff
    classDef logic fill:#6aaed6,stroke:#0b3554,stroke-width:1.2px,color:#081a2b
    classDef note fill:#fff3bf,stroke:#8a6d00,stroke-width:1.2px,color:#332b00,stroke-dasharray: 4 3
```
