Caso de estudo · Miradouro da Penha
Quatro quartos, a infraestrutura de um hotel.
Abriu em agosto de 2026 já com tudo: um site que vende direto em três línguas, uma app que trata do check-in, do SIBA, da fatura e da taxa turística, e uma agente de IA que coordena a limpeza no WhatsApp. Adaptado em semanas da base que já corria no Livin Stays Algarve.
As capturas da app usam dados fictícios — nenhum hóspede, reserva ou valor real. As do site são as páginas públicas.
- Cliente
- Miradouro da Penha, guesthouse de quatro quartos em Faro
- Quem usa
- Hóspedes, gestão e equipa de limpeza
- Em produção
- Desde agosto de 2026
- Tecnologia
- Astro · React · TypeScript · Supabase
-
4
quartos, num último andar com terraço sobre Faro
-
3
línguas no site — português, inglês e espanhol
-
64
reservas desde a abertura
-
1 000+
mensagens aos hóspedes registadas
-
400+
testes automáticos
Números reais da casa em outubro de 2026.
Contexto
O ponto de partida
O Miradouro da Penha são quatro quartos no último andar de um prédio na Penha, acima de Faro, com terraço panorâmico e cozinha partilhada. Uma casa pequena, com uma equipa pequena — e com as mesmas obrigações de um hotel: registo SIBA de cada hóspede estrangeiro, taxa turística municipal, faturação certificada.
Em vez de começar do zero, adaptámos o site e a app que já corriam no Livin Stays Algarve: a mesma base, afinada para uma casa de quatro quartos. A casa abriu em agosto de 2026 já com reservas diretas, check-in online e SIBA automático.
Site
Um site que vende direto.
Quartos com fotografias reais, disponibilidade e preços lidos do channel manager e pagamento no próprio site: 20% de sinal e o resto cobrado automaticamente no dia de entrada, ou tudo de uma vez por Multibanco ou MB WAY.
- Português, inglês e espanhol, com páginas da casa, dos quartos, dos espaços partilhados e da localização
- Códigos promocionais e taxa turística numa linha à parte
- Página para o hóspede gerir a reserva e cancelar com reembolso
- Guia da casa em cinco línguas
- A reserva paga entra sozinha no channel manager e na app
App de operações
O dia da casa, numa app.
O MP-PRO mostra as chegadas, as saídas e quem está em casa, o que precisa de atenção e o mapa dos quartos. Cada reserva tem uma ficha com os hóspedes, o check-in, os pagamentos, as mensagens e o histórico.
- Reservas do Booking.com e do Airbnb sincronizadas de hora a hora
- Pedidos dos hóspedes — entrada cedo, saída tarde — com decisão registada
- Avarias e instruções de acesso por quarto
- Funciona no telemóvel, instalável como app
Hóspedes e conformidade
Do check-in online ao SIBA, sem papel.
O hóspede preenche o check-in online em português, inglês ou espanhol; os boletins SIBA são submetidos pelo serviço web duas vezes por dia; os códigos das portas são enviados às fechaduras inteligentes de cada quarto. Depois da estadia, o pedido de opinião oferece um código de 10% para voltar.
- Formulário de check-in com os dados de cada hóspede e documento
- Quadro SIBA: chegadas dos próximos 7 dias, por submeter e em atraso
- Códigos mensais das fechaduras Nuki e TTLock geridos na app
- Feedback com notas por categoria e códigos de regresso
Finanças
Fatura, comissão e taxa turística sem contas à mão.
A fatura da estadia é emitida no CloudInvoice no dia de entrada, com a taxa turística na sua linha. No fim do mês, a app prepara a declaração da taxa municipal para a Câmara de Faro e o extrato de comissão.
- Faturas, recibos, notas de crédito, sinais e extras
- Auditoria: estadias sem fatura e emissões falhadas
- Declaração da taxa turística com o limite de 7 noites e as isenções
- Extrato de comissão em PDF
Agente de IA
A Ana coordena a limpeza no WhatsApp.
A Ana é a agente de IA da equipa, num servidor próprio. Trabalha no grupo de WhatsApp da limpeza com os dados da app: pergunta se o quarto está pronto, envia o plano de limpeza e o mapa das reservas, e manda ao gestor o relatório do dia às 20:00. Não fala com hóspedes nem envia códigos de portas.
- Sondagens «quarto pronto?» antes de cada chegada
- Plano de limpeza, trocas de roupa e mapa das reservas no grupo
- Pedidos da equipa para aprovar e alertas de bateria das fechaduras
- Acesso próprio e limitado à base de dados; cada escrita fica auditada
Integrações
Ligada aos canais, aos pagamentos e às portas.
-
Avaibook
Channel manager: Booking.com e Airbnb de hora a hora; as reservas do site entram sozinhas.
-
Stripe
Sinal de 20% e saldo cobrado no dia de entrada, Multibanco, MB WAY e reembolsos.
-
CloudInvoice
Faturas, recibos e notas de crédito certificados.
-
SIBA
Boletins de alojamento submetidos pelo serviço web, duas vezes por dia.
-
Nuki e TTLock
Códigos mensais das fechaduras de cada quarto e alertas de bateria.
-
E-mail transacional
Confirmação, check-in online, instruções e feedback em três línguas.
-
WhatsApp
A Ana, agente de IA da equipa de limpeza.
-
Supabase
Postgres com 51 tabelas e 114 políticas de segurança, funções de servidor e 7 tarefas agendadas.
Engenharia
Como está construído
- 01
Site em Astro com páginas estáticas e um servidor Node para as reservas e os pagamentos; app em React e TypeScript instalável como PWA
- 02
A mesma base do Livin Stays Algarve, adaptada a uma casa de quatro quartos — com regras partilhadas verificadas por testes nos dois projetos
- 03
Segurança ao nível da linha em todas as tabelas; a agente tem um perfil próprio e cada escrita dela fica registada
- 04
69 migrações versionadas e mais de 400 testes automáticos
- 05
Contactos dos hóspedes anonimizados automaticamente depois da estadia
Resultado
Uma guesthouse de quatro quartos abriu com reservas diretas, check-in online e SIBA automático desde o primeiro dia.
Próximo passo
Tem uma casa pequena com obrigações de hotel?
Uma conversa de 30 minutos chega para dizermos o que automatizar primeiro, quanto custa e quando fica pronto.