# washingtonolv/gerador-etiquetas architecture

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

- Interactive diagram: https://gitdiagram.com/washingtonolv/gerador-etiquetas
- Repository: https://github.com/washingtonolv/gerador-etiquetas

## Overview

Gerador de Etiquetas D&D é uma aplicação web para editar etiquetas promocionais, organizar modelos e preparar impressão A4. O fluxo principal parte do usuário escolhendo um modelo e preenchendo etiquetas no runtime legado, com prévia e impressão; o README também documenta importação CSV, backups JSON, armazenamento local, variantes e PWA. O shell moderno reporta o estado de carregamento do runtime, enquanto módulos modernos oferecem downloads de CSV e PowerPoint. As relações do editor principal e seus estágios internos não foram amostrados; o grafo limita essas conexões ao que o README documenta.

Main entry points: [`support.js`](https://github.com/washingtonolv/gerador-etiquetas/blob/main/support.js) (Runtime editor), [`src/modules/downloads.ts`](https://github.com/washingtonolv/gerador-etiquetas/blob/main/src/modules/downloads.ts) (Módulo downloads), [`src/main.ts`](https://github.com/washingtonolv/gerador-etiquetas/blob/main/src/main.ts) (Inicialização moderna), [`cartao-agradecimento.js`](https://github.com/washingtonolv/gerador-etiquetas/blob/main/cartao-agradecimento.js) (Cartões WhatsApp)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_g_ui["Edição e impressão"]
  node_legacy["Runtime editor<br/>[support.js]"]
  node_editorux["Validação UX<br/>[editor-ux.js]"]
  node_variants["Variantes editor<br/>[variants.js]"]
  node_localdata[("Dados locais")]
  node_csvimport["Importação CSV<br/>[support.js]"]
  node_backup["Backup JSON<br/>[support.js]"]
  node_preview["Prévia etiquetas<br/>[support.js]"]
  node_print["Impressão A4<br/>[support.js]"]
  node_thanks["Cartões WhatsApp"]
end

subgraph group_g_modern["Camada moderna"]
  node_entry["Inicialização moderna<br/>[main.ts]"]
  node_shell["Shell e status<br/>[dd-app-shell.ts]"]
end

subgraph group_g_download["Downloads de campanha"]
  node_downloads["Módulo downloads<br/>[downloads.ts]"]
  node_worker["Montagem PowerPoint<br/>[pptx.worker.ts]"]
  node_csvtemplate["Modelo CSV<br/>[downloads.ts]"]
end

subgraph group_g_assets["Modelos e artefatos"]
  node_parts["Partes BLITZ<br/>[part-01.bin]"]
  node_templates["Artes e modelos"]
  node_pptx["PowerPoint BLITZ<br/>[BLITZ-A5-web.pptx]"]
end

node_user(("Usuário"))

node_user -->|"edita etiquetas"| node_legacy
node_legacy -->|"importa CSV"| node_csvimport
node_legacy -->|"exporta restaura"| node_backup
node_legacy -->|"salva localmente"| node_localdata
node_legacy -->|"gera prévia"| node_preview
node_legacy -->|"prepara impressão"| node_print
node_legacy -->|"usa modelos"| node_templates
node_user -->|"edita cartões"| node_thanks
node_thanks -->|"salva cartões"| node_localdata
node_thanks -->|"imprime cartões"| node_print
node_legacy -.->|"valida campos"| node_editorux
node_legacy -.->|"aplica variante"| node_variants
node_entry -->|"registra shell"| node_shell
node_entry -->|"carrega runtime"| node_legacy
node_entry -->|"expõe downloads"| node_downloads
node_downloads -->|"envia solicitação"| node_worker
node_worker -->|"busca partes"| node_parts
node_downloads -->|"salva resultado"| node_pptx
node_downloads -->|"gera modelo"| node_csvtemplate

click node_legacy "https://github.com/washingtonolv/gerador-etiquetas/blob/main/support.js"
click node_editorux "https://github.com/washingtonolv/gerador-etiquetas/blob/main/editor-ux.js"
click node_variants "https://github.com/washingtonolv/gerador-etiquetas/blob/main/variants.js"
click node_csvimport "https://github.com/washingtonolv/gerador-etiquetas/blob/main/support.js"
click node_backup "https://github.com/washingtonolv/gerador-etiquetas/blob/main/support.js"
click node_preview "https://github.com/washingtonolv/gerador-etiquetas/blob/main/support.js"
click node_print "https://github.com/washingtonolv/gerador-etiquetas/blob/main/support.js"
click node_thanks "https://github.com/washingtonolv/gerador-etiquetas/blob/main/cartao-agradecimento.js"
click node_entry "https://github.com/washingtonolv/gerador-etiquetas/blob/main/src/main.ts"
click node_shell "https://github.com/washingtonolv/gerador-etiquetas/blob/main/src/shell/dd-app-shell.ts"
click node_downloads "https://github.com/washingtonolv/gerador-etiquetas/blob/main/src/modules/downloads.ts"
click node_worker "https://github.com/washingtonolv/gerador-etiquetas/blob/main/src/workers/pptx.worker.ts"
click node_parts "https://github.com/washingtonolv/gerador-etiquetas/blob/main/uploads/blitz-a5-parts/part-01.bin"
click node_templates "https://github.com/washingtonolv/gerador-etiquetas/tree/main/assets"
click node_pptx "https://github.com/washingtonolv/gerador-etiquetas/blob/main/uploads/BLITZ-A5-web.pptx"
click node_csvtemplate "https://github.com/washingtonolv/gerador-etiquetas/blob/main/src/modules/downloads.ts"

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_legacy,node_editorux,node_variants,node_localdata,node_csvimport,node_backup,node_preview,node_print,node_thanks toneBlue
class node_entry,node_shell toneAmber
class node_downloads,node_worker,node_csvtemplate toneMint
class node_parts,node_templates,node_pptx toneRose
class node_user toneIndigo
```

## Components

### Edição e impressão

- [Runtime editor](https://github.com/washingtonolv/gerador-etiquetas/blob/main/support.js): `support.js`
- [Validação UX](https://github.com/washingtonolv/gerador-etiquetas/blob/main/editor-ux.js): `editor-ux.js`
- [Variantes editor](https://github.com/washingtonolv/gerador-etiquetas/blob/main/variants.js): `variants.js`
- **Dados locais**
- [Importação CSV](https://github.com/washingtonolv/gerador-etiquetas/blob/main/support.js): `support.js`
- [Backup JSON](https://github.com/washingtonolv/gerador-etiquetas/blob/main/support.js): `support.js`
- [Prévia etiquetas](https://github.com/washingtonolv/gerador-etiquetas/blob/main/support.js): `support.js`
- [Impressão A4](https://github.com/washingtonolv/gerador-etiquetas/blob/main/support.js): `support.js`
- [Cartões WhatsApp](https://github.com/washingtonolv/gerador-etiquetas/blob/main/cartao-agradecimento.js): `cartao-agradecimento.js`

### Camada moderna

- [Inicialização moderna](https://github.com/washingtonolv/gerador-etiquetas/blob/main/src/main.ts): `src/main.ts`
- [Shell e status](https://github.com/washingtonolv/gerador-etiquetas/blob/main/src/shell/dd-app-shell.ts): `src/shell/dd-app-shell.ts`

### Downloads de campanha

- [Módulo downloads](https://github.com/washingtonolv/gerador-etiquetas/blob/main/src/modules/downloads.ts): `src/modules/downloads.ts`
- [Montagem PowerPoint](https://github.com/washingtonolv/gerador-etiquetas/blob/main/src/workers/pptx.worker.ts): `src/workers/pptx.worker.ts`
- [Modelo CSV](https://github.com/washingtonolv/gerador-etiquetas/blob/main/src/modules/downloads.ts): `src/modules/downloads.ts`

### Modelos e artefatos

- [Partes BLITZ](https://github.com/washingtonolv/gerador-etiquetas/blob/main/uploads/blitz-a5-parts/part-01.bin): `uploads/blitz-a5-parts/part-01.bin`
- [Artes e modelos](https://github.com/washingtonolv/gerador-etiquetas/tree/main/assets): `assets`
- [PowerPoint BLITZ](https://github.com/washingtonolv/gerador-etiquetas/blob/main/uploads/BLITZ-A5-web.pptx): `uploads/BLITZ-A5-web.pptx`

### Other components

- **Usuário**

## Connections

- Usuário → Runtime editor: edita etiquetas (evidence: `README.md`)
- Runtime editor → Importação CSV: importa CSV (evidence: `README.md`)
- Runtime editor → Backup JSON: exporta restaura (evidence: `README.md`)
- Runtime editor → Dados locais: salva localmente (evidence: `README.md`)
- Runtime editor → Prévia etiquetas: gera prévia (evidence: `README.md`)
- Runtime editor → Impressão A4: prepara impressão (evidence: `README.md`)
- Runtime editor → Artes e modelos: usa modelos (evidence: `README.md`)
- Usuário → Cartões WhatsApp: edita cartões (evidence: `cartao-agradecimento.js`)
- Cartões WhatsApp → Dados locais: salva cartões (evidence: `cartao-agradecimento.js`)
- Cartões WhatsApp → Impressão A4: imprime cartões (evidence: `cartao-agradecimento.js`)
- Runtime editor → Validação UX: valida campos
- Runtime editor → Variantes editor: aplica variante
- Inicialização moderna → Shell e status: registra shell (evidence: `src/main.ts`)
- Inicialização moderna → Runtime editor: carrega runtime (evidence: `src/main.ts`)
- Inicialização moderna → Módulo downloads: expõe downloads (evidence: `src/main.ts`)
- Módulo downloads → Montagem PowerPoint: envia solicitação (evidence: `src/modules/downloads.ts`)
- Montagem PowerPoint → Partes BLITZ: busca partes (evidence: `src/workers/pptx.worker.ts`)
- Módulo downloads → PowerPoint BLITZ: salva resultado (evidence: `src/modules/downloads.ts`)
- Módulo downloads → Modelo CSV: gera modelo (evidence: `src/modules/downloads.ts`)
