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
Prazo de Entrega: Não estabelecido