Desenvolvimento de Sistema de Referral para Plataforma Sparkhost

Projeto: Sistema de Referral + Mensageria Integrado à Sparkhost (Lodgify + Stays)

Estamos desenvolvendo uma nova funcionalidade dentro da plataforma **Sparkhost**, voltada para anfitriões de hospedagem e negócios locais. O objetivo é criar um sistema integrado de **mensagens, referrals e pagamentos**, conectado às integrações já existentes com **Lodgify** e **Stays**.

O projeto deve ser desenvolvido **dentro da base atual da Sparkhost (Lovable)**.

---

Escopo Geral

Tipos de usuários

* **Host (anfitrião)** – conectado via Lodgify ou Stays
* **Business (negócio local)**
* **Admin (Sparkhost)**

---

## Funcionalidades principais

### 1. Integração com Lodgify e Stays

* Sincronizar propriedades e hóspedes
* Receber eventos (reserva, check-in, check-out)
* Permitir envio de mensagens automáticas

---

### 2. Sistema de mensagens (Email + WhatsApp)

* Envio apenas com consentimento do hóspede
* Templates configuráveis
* Automação por evento (pré-chegada, durante, pós-estadia)
* Integração com provedor de WhatsApp
* Histórico e logs

---

### 3. Sistema de Referral

* Host recomenda negócios locais
* Hóspede recebe link ou QR code
* Business valida o código no checkout
* Business informa valor da venda
* Sistema registra a transação
* Comissão é calculada automaticamente

#### Regra financeira:

* Negócio define o desconto (ex: 10%)
* Hóspede recebe 10% completo
* Dentro desse valor:

  * 3,2% → Host
  * 1,8% → Sparkhost
* O restante é custo do negócio

---

### 4. QR Code / Código de validação

* QR reutilizável
* Código manual alternativo
* Controle de usos
* Registro de validação
* Associação host ↔ business

---

### 5. Wallet interna

#### Host:

* Acumula comissões
* Visualiza saldo
* Solicita saque
* Saque mínimo (ex: R$50)
* Pagamento via Pix
* Aprovação manual

#### Sparkhost:

* Wallet interna administrativa
* Controle de comissões

---

### 6. Cobrança do Business (Pagar.me)

* Modelo: cobrança mensal pós-uso
* Soma de todas as transações validadas
* Pagamento via Pix ou cartão
* Geração automática de cobranças
* Controle de status (pago / pendente / vencido)
* Bloqueio em caso de inadimplência

---

### 7. Auditoria e logs

* Registro completo de ações:

  * validações
  * cobranças
  * ajustes
  * pagamentos
* Histórico imutável
* Acesso administrativo

---

## Requisitos técnicos

* Integração com Pagar.me
* Backend organizado e documentado
* Jobs agendados
* Sistema de permissões
* APIs bem definidas
* Código integrado ao projeto existente (Lovable)
* Banco estruturado
* Ambiente de staging

---

## Entregáveis esperados

* Implementação funcional dentro da Sparkhost
* Banco de dados estruturado
* Fluxos testados
* Documentação básica
* Deploy funcional
* Suporte para ajustes iniciais

---

## Modelo de contratação

* Projeto por marcos (milestones)
* Pagamento por etapa
* Prazo estimado: 4 a 8 semanas
* Possibilidade de trabalho contínuo após entrega

---

## Diferencial do projeto

* Produto real, não MVP experimental
* Integrações reais com parceiros
* Potencial de longo prazo
* Decisões técnicas claras
* Escopo bem definido