flowchart TD
    subgraph Clientes["Clientes MCP Autorizados"]
        AG["AntiGravity IDE"]
        CC["Claude Code"]
        CX["Codex"]
    end

    subgraph Remoto["Acesso Remoto Operacional"]
        TG["Operador via Telegram<br/>(Smartphone / Web)"]
        TGAPI["Telegram Bot API<br/>(Nuvem)"]
    end

    subgraph HostWindows["Estação de Trabalho Windows 10"]
        subgraph Entrada["Camada de Entrada"]
            STDIO["Servidor MCP<br/>(Transporte stdio)"]
            TGBOT["Worker Telegram<br/>(Long Polling de Saída)"]
        end

        subgraph Nucleo["Núcleo de Controle & Segurança"]
            SEC["Guarda de Diretório<br/>(Safe Storage Root)"]
            QUEUE["Fila Serializada & Estado<br/>(SQLite em modo WAL)"]
        end

        subgraph Automação["Camada de Automação"]
            ADAPT["Adaptador COM CorelDRAW<br/>(pywin32 / Watchdog 60s)"]
            APP["CorelDRAW 2023<br/>(Processo Nativo)"]
        end

        subgraph Disco["Armazenamento Local (data/)"]
            JOBS["Jobs & Metadados"]
            PREVIEWS["Prévias PNG (7 dias)"]
            ARTIFACTS["Mestres .CDR & PDFs Finais"]
        end
    end

    AG -->|stdio| STDIO
    CC -->|stdio| STDIO
    CX -->|stdio| STDIO

    TG <--> TGAPI
    TGBOT <-->|HTTPS getUpdates| TGAPI

    STDIO --> SEC
    TGBOT --> SEC
    SEC --> QUEUE
    QUEUE --> ADAPT
    ADAPT --> APP

    ADAPT --> PREVIEWS
    ADAPT --> ARTIFACTS
    QUEUE --> JOBS

# 1. Clonar o repositório no Windows
cd C:\
git clone https://github.com/caumodascdp-bot/mcp-corel.git
cd C:\mcp-corel

# 2. Criar e ativar o ambiente virtual Python 3.11+
python -m venv .venv
.\.venv\Scripts\Activate.ps1

# 3. Criar seu arquivo de ambiente local a partir do exemplo
copy .env.example .env
notepad .env

mcp-corel/
├── .env.example                     # Modelo seguro de variáveis de ambiente
├── pyproject.toml                   # Configuração e dependências do projeto Python
├── RELATORIO_E_PROXIMOS_PASSOS_WINDOWS.md # Guia prático para a máquina alvo
├── docs/                            # Especificações, manuais, arquitetura e ADRs
│   ├── SPEC.md                      # Requisitos funcionais e não-funcionais numerados
│   ├── ARCHITECTURE.md              # Diagramas e detalhes da arquitetura em camadas
│   ├── THREAT_MODEL.md              # Matriz STRIDE e controles de segurança
│   ├── dicionario-logs.md           # Dicionário de logs em português
│   └── decisions/                   # Registros de Decisão de Arquitetura (ADR-001 a ADR-005)
├── agents/                          # 11 Agentes de IA com papéis e restrições individuais
├── skills/                          # 10 Habilidades operacionais padronizadas (SOPs)
├── contracts/                       # Contratos de ferramentas e schemas JSON
│   ├── artwork-brief.schema.json    # Schema JSON Draft-07 para briefings de arte
│   └── artifact-manifest.schema.json# Schema JSON Draft-07 para manifesto de entrega
├── templates/                       # Modelos de leiaute (flyer, redes sociais, etiquetas, print)
├── src/mcp_corel/                   # Pacote Python (módulos planejados)
├── tests/                           # Suítes de testes (unitários, integração, segurança e aceitação)
├── data/                            # Pastas seguras de armazenamento de dados (jobs, prévias, artefatos)
└── logs/                            # Diretório para registros de auditoria