Diagramas de Sequência & Fluxos Críticos

Diagramas de Sequência & Fluxos Críticos

Esta seção reúne os diagramas de sequência das principais jornadas do usuário e integrações de sistema no Prime Crown.

---

🎯 1. Orçamento, lead e confirmação administrativa

sequenceDiagram
    autonumber
    actor Client as Visitante / Lead
    actor Manager as Gestor
    participant Quote as StepQuoteResult (PublicQuote)
    participant API as /api/leads/chat-initiate
    participant Queue as Quotes
    participant D1 as Cloudflare D1
    participant Evo as Evolution API (WhatsApp)

    Client->>Quote: Finaliza Orçamento & digita WhatsApp
    Quote->>API: POST /api/leads/chat-initiate
    API->>D1: UPSERT lead + canal + lead_quote OPEN
    Note over API,D1: Sem client e sem service_request
    API->>Evo: Envia Mensagem de Boas-Vindas com Detalhes do Orçamento
    Evo-->>Client: Recebe mensagem no WhatsApp pessoal
    Manager->>Queue: Define preço, entidade fiscal e horário
    Queue->>D1: Confirma lead_quote
    D1->>D1: Cria/reutiliza client + cria service_request
    D1->>D1: Reponta auth_account LEAD para CLIENT

---

💳 2. Ciclo de Faturamento & Disparo de Cobrança

sequenceDiagram
    autonumber
    actor Admin as Gerente / Sistema
    participant Billing as BillingHub (React UI)
    participant API as /api/atomic/invoices
    participant D1 as Cloudflare D1
    participant Email as Resend API (Transacional)

    Admin->>Billing: Seleciona limpezas concluídas e clica "Gerar Fatura"
    Billing->>API: POST /api/atomic/invoices (status: ISSUED)
    API->>D1: INSERT INTO invoices
    API->>Email: Envia PDF da Fatura por E-mail
    Email-->>Admin: Confirmação de envio