Skip to content
Prime Crown Docs

Módulo 1 - Orçamento Público & Captura de Leads (PublicQuote)

Módulo 1: Orçamento Público & Captura de Leads (PublicQuote)

Section titled “Módulo 1: Orçamento Público & Captura de Leads (PublicQuote)”

O módulo PublicQuote é a porta de entrada de novos clientes para o Prime Crown. Trata-se de um wizard público interativo que calcula estimativas de limpeza residencial com precisão e converte visitantes em leads qualificados no sistema.

🎯 1. Fluxo de Funcionamento do Wizard

Section titled “🎯 1. Fluxo de Funcionamento do Wizard”
sequenceDiagram
    autonumber
    actor Client as Cliente (Web)
    participant Step1 as Passo 1: Endereço & Cobertura
    participant Step2 as Passo 2: Detalhes da Casa
    participant Step3 as Passo 3: Resultado & Frequência
    participant API as /api/leads/quote-request
    participant D1 as Cloudflare D1 (leads table)

    Client->>Step1: Digita Postcode e seleciona endereço
    Step1->>Step2: Valida área de cobertura (ServiceArea)
    Client->>Step2: Seleciona quartos, banheiros e adicionais (Addons)
    Step2->>Step3: Calcula preço e exibe descontos de frequência
    Client->>Step3: Preenche Nome + E-mail/WhatsApp
    Step3->>API: POST /api/leads/quote-request
    API->>D1: INSERT INTO leads (status: NEW) + snapshot
    API-->>Client: Redireciona / Inicia Chat de Suporte

🧮 2. Regras e Fórmulas de Cálculo de Preço

Section titled “🧮 2. Regras e Fórmulas de Cálculo de Preço”

O cálculo de estimativa utiliza a seguinte lógica de formação de preço:

  1. Preço Base do Serviço: $$\text{Custo Base} = \text{Preço Fixo da Categoria} + (\text{Quartos} \times \text{Taxa Quarto}) + (\text{Banheiros} \times \text{Taxa Banheiro})$$

  2. Horas Estimadas: $$\text{Horas} = \text{Horas Base} + (\text{Metragem} \times 0.015)$$

  3. Desconto por Frequência:

    • Semanal (Weekly): 20% de desconto recorrente.
    • Quinzenal (Bi-weekly): 10% de desconto recorrente.
    • Mensal (Monthly) / Avulsa (One-off): Preço padrão sem desconto.

  4. Addons (Serviços Adicionais):

    • Limpeza de Forno, Geladeira, Passadoria de Roupas ou Limpeza de Janelas Internas são somados ao valor total.

🛠️ 3. Arquivos Principais do Módulo

Section titled “🛠️ 3. Arquivos Principais do Módulo”
  • Página Principal: src/pages/PublicQuote/index.tsx
  • Componente de Resultado: src/pages/PublicQuote/StepQuoteResult.tsx
  • Endereço e Cobertura: src/pages/PublicQuote/StepAddressForm.tsx
  • Backend Handler: functions/api/leads/quoteRequest.ts