ZN Hotel · Macapá · 70 quartos · abertura maio/2027 · rascunho 20/10/2026
Sistema do Hotel
Escopo, recursos e prazo, para validarmos juntos antes de falar com o hotel.
→ o escopo cresceu. Vamos decidir juntos o tamanho.
De onde partimos
O pedido era um sistema gerencial. A operação real pede mais.
O que o hotel pediu (16–19/10)
- Reservas e disponibilidade
- Check-in e check-out
- Financeiro e faturamento
- Governança (limpeza)
- Relacionamento com o hóspede
- Comercial: tarifas, pacotes, canais
- Relatórios gerenciais
O que a pesquisa mostrou que também é obrigatório
- Ficha do hóspede no Ministério do Turismo
- Nota fiscal com a reforma tributária
- Quartos acessíveis reserváveis
- Booking só via channel manager
- Contingência se a internet cair
- Plantão: hotel não para
- Manutenção, contratos e serviços
Obralivre · Sistema do Hotel · rascunho para validação
A decisão de arquitetura
Um sistema próprio, num lugar só.
Um sistema, uma conta
Dono sem experiência em hotelaria não pode ficar no meio de dois ou três sistemas, cada um com o seu suporte.
Não dá pra “mascarar”
Os sistemas de mercado bloqueiam ser abertos dentro de outro (testado: Cloudbeds, HotelGestão, Pousari).
Sob medida
Feito do jeito da operação deles, com os dados do hotel e sem licença de terceiro.
Alternativa descartada: sistema pronto + uma camada nossa por cima. Resolveria mais rápido, mas o hotel ficaria com dois sistemas.
Obralivre · Sistema do Hotel · rascunho para validação
Escopo para a abertura · 16 blocos
O que precisa estar pronto no primeiro hóspede.
Cadastros
Quartos, tipos, serviços
Reservas
Mapa visual, sem venda dupla
Check-in / out
Pré-check-in no celular
Ficha do hóspede
FNRH · obrigatório
Financeiro
Conta, caixa, fechamento
Nota fiscal
NFS-e + IBS/CBS · obrigatório
Pagamentos
PIX, cartão, link
Governança
Limpeza no celular
Manutenção
Ordem de serviço, bloqueio
Hóspedes
Histórico, preferências
Tarifas
Temporadas, pacotes, grupos
Site + reserva
Venda direta, acessível
Booking / Expedia
Via channel manager
Relatórios
Ocupação, diária, receita
Restaurante / bar
Consumo na conta · novo
Sala de eventos
Agenda e cobrança · novo
Em verde: exigência legal. Com borda: entrou com as respostas do hotel (20/10). Mais usuários, perfis e auditoria (LGPD).
Obralivre · Sistema do Hotel · rascunho para validação
Depois da abertura · e o que não entra
Fase 2 tem data. O resto fica de fora.
Fase 2 · até 90 dias depois
- Gestão de contratos (empresas e fornecedores)
- Sugestão de tarifa por ocupação
- Fechadura eletrônica (depende da marca)
Restaurante/bar e sala de eventos foram para a abertura (hotel confirmou em 20/10).
Fora do escopo
- CRM, marketing, WhatsApp com IA
- Automação de quarto, TV, energia, câmeras
- Contabilidade completa, RH, folha
- App nas lojas (roda no navegador)
- Várias propriedades
Obralivre · Sistema do Hotel · rascunho para validação
Como tudo se conecta
O ecossistema do sistema.
Onde reservam
Site do hotel
Booking / Expedia
Balcão e telefone
Na nuvem, no Brasil
Reservas
Recepção
Financeiro
Governança
Manutenção
Comercial
Hóspedes
Relatórios
Banco · fila de reenvio · backup · monitoramento
Serviços externos
FNRH
NFS-e
PIX e cartão
No hotel
2 PCs recepção
Celulares
2 links + nobreak
Rede separada
Obralivre · Sistema do Hotel · rascunho para validação
Protótipo · 1/3
Mapa de reservas.
Quartos × dias, com cor por canal (site, Booking, balcão). Quarto em manutenção aparece bloqueado. Clicar num dia já ocupado avisa que não dá pra vender duas vezes.
Protótipo navegável · dados fictícios · sem backend
Protótipo · 2/3
Check-in.
Mostra o que já está pronto (pré-check-in, política aceita, garantia, quarto limpo). Hóspede menor sem responsável vinculado bloqueia o check-in. Ao confirmar, a ficha vai sozinha para a FNRH.
Protótipo navegável · dados fictícios · sem backend
Protótipo · 3/3
Governança no celular e painel do dono.
Camareira começa e libera o quarto pelo celular; a recepção vê na hora.
Ocupação, diária média, receita por quarto e comissão que ficou no caixa.
Protótipo navegável · dados fictícios · sem backend · também tem conta do hóspede e manutenção
Recursos · pessoas
Quem faz o quê.
| Papel | Quem | Dedicação |
|---|---|---|
| Arquitetura e desenvolvimento | Alessandro (Obralivre) | ~200 h/mês, nov/26 → abr/27 |
| Relação com o hotel, levantamento da operação, comercial | Junior | [a definir] |
| Validar protótipo e testar | Dono ou gerente do hotel | ~4 h/semana |
| Plantão depois da abertura | [a definir] | Sobreaviso noites e fins de semana |
| Regime tributário e nota fiscal | Contador do hotel | Pontual (Fase 0 e 2) |
| Política de cancelamento, LGPD, Wi-Fi | Advogado do hotel | Pontual |
~1.000 h em 5 meses = 1 pessoa dedicada em tempo integral. Implantação e treino presenciais em Macapá.
Obralivre · Sistema do Hotel · rascunho para validação
Estimativa de esforço
~1.000 horas até a abertura.
Mais ~100 h na Fase 2. Desenvolvimento com Claude Code, teste incluído. O protótipo da Fase 0 confirma o número.
| Bloco | Horas |
|---|---|
| Definição e protótipo | 40 |
| Operação (cadastros, reservas, check-in, governança, manutenção, hóspedes, usuários) | 240 |
| Financeiro e pagamentos | 120 |
| Obrigações legais (FNRH, nota fiscal) | 96 |
| Vendas (tarifas, site, Booking) | 160 |
| Restaurante/bar + sala de eventos (novo) | 88 |
| Relatórios | 48 |
| Infra e contingência | 32 |
| Testes, treinamento, abertura | 64 |
| Gestão do projeto (12%) | 107 |
| Total até a abertura | ~1.000 |
Obralivre · Sistema do Hotel · rascunho para validação
Cronograma · nov/2026 → maio/2027
Cabe na abertura de maio, se começar em novembro.
0 · Definição e protótipo
nov
1 · Operação + restaurante + eventos
nov → jan
2 · Obrigações legais
fev
3 · Vendas e números
mar
4 · Testes e treino em Macapá
abr
Abertura do hotel
maio/2027
Folga curta, com dezembro e janeiro no meio. O hotel precisa ter CNPJ, Cadastur, inscrição municipal e certificado A1 até fevereiro para homologar ficha e nota. Fase 2 (contratos, fechadura) até 90 dias depois.
Obralivre · Sistema do Hotel · rascunho para validação
Riscos
O que pode dar errado, e o plano.
| Risco | Como tratamos |
|---|---|
| Hotel abre antes de 4–5 meses | Sistema provisório no início e migração sem parar |
| Hotel não para: suporte 24 h | Plantão definido e cobrado na sustentação |
| Reforma tributária muda de novo | Nota fiscal via API que acompanha as mudanças |
| O escopo crescer de novo | Protótipo aprovado na Fase 0 congela o que entra |
| Uma pessoa só desenvolvendo | Prazo estica se dividir frentes. Avaliar dev de apoio |
| Internet do hotel cair | 2 links, nobreak, relatório de contingência a cada hora |
Obralivre · Sistema do Hotel · rascunho para validação
Recursos · infraestrutura
O que precisa existir para o sistema rodar.
Na nuvem (Obralivre cuida)
- Sistema e banco com dados no Brasil
- Fila que reenvia ficha, nota e Booking
- Backup diário em outro provedor
- Monitoramento com alerta
- Channel manager e emissor de nota
No hotel (o hotel providencia)
- 2 links de internet + nobreak
- Rede dos hóspedes separada
- Wi-Fi em todos os andares
- 2 PCs na recepção, celulares da governança
- Maquininha do mesmo gateway
Documentos até fevereiro: Cadastur, chave da FNRH, inscrição municipal, certificado A1, conta no gateway, contas no Booking e na Expedia.
Obralivre · Sistema do Hotel · rascunho para validação
Investimento · sistema próprio · por valor-hora
O valor-hora decide o preço.
| Valor-hora | Só o necessário (~810 h) | Recomendado (~1.000 h) | Fase 2 (~100 h) |
|---|---|---|---|
| R$ 200 | R$ 162 mil | R$ 200 mil | R$ 20 mil |
| R$ 250 | R$ 203 mil | R$ 250 mil | R$ 25 mil |
| R$ 275 | R$ 223 mil | R$ 275 mil | R$ 28 mil |
Régua de mercado
Oracle OPERA: R$ 20–50 mil de implantação + R$ 3,5–7 mil/mês.
Sistema pronto nacional: R$ 200–350/mês + módulos.
Mais os custos mensais de manutenção (servidor, backup, serviços de terceiros, sustentação e plantão), em levantamento, e as viagens a Macapá. Divisão Obralivre × Junior a definir.
Obralivre · Sistema do Hotel · rascunho para validação
Para decidirmos juntos
Antes de falar com o hotel.
1 · Tamanho do escopo
~1.000 h com restaurante, eventos e Booking. Algo pode ficar para depois?
2 · Começar em novembro
Abertura em maio/2027: sem início em nov, o prazo aperta.
3 · Orçamento do hotel
Única pergunta sem resposta. Reunião com Alyssa e Francisco.
4 · Preço e parceria
Valor-hora (R$ 200 a 275), modelo da oferta e divisão Obralivre × Junior.
5 · Plantão
Quem atende o hotel à noite e no fim de semana?
6 · Próximo passo
Protótipo das telas para levar ao hotel.
Obralivre · Sistema do Hotel · rascunho para validação
Anexo A · PRD · 1/3 · Operação
Requisitos da operação do hotel.
| Módulo | Requisitos principais |
|---|---|
| Cadastros | Tipos de quarto, 70 quartos com andar e status, quarto acessível, serviços do hotel com preço |
| Reservas | Mapa visual por dia; individual, grupo e empresa; trava contra venda dupla; confirmação por e-mail; política de cancelamento aceita na reserva |
| Check-in / out | Pré-check-in pelo celular; ficha FNRH automática com reenvio; menor só com responsável e autorização; check-out com conta, pagamento e nota |
| Governança | Status do quarto (sujo, limpando, limpo, inspecionado, bloqueado); lista do dia no celular com foto; liberação aparece na hora para a recepção |
| Manutenção | Ordem de serviço com prioridade e prazo; bloqueio automático do quarto; histórico; preventiva programada |
| Hóspedes | Perfil com histórico e preferências; perfil de empresa com hóspedes vinculados |
Fonte: PRD v0.2 (RF-01 a RF-28) · Obralivre · rascunho para validação
Anexo A · PRD · 2/3 · Gestão e vendas
Requisitos de financeiro, vendas e gestão.
| Módulo | Requisitos principais |
|---|---|
| Financeiro | Conta do hóspede com diárias, serviços e consumos; dividir e transferir conta; caixa por turno; fechamento do dia; contas a receber de empresas |
| Nota fiscal | NFS-e Nacional com IBS/CBS; diária separada de alimentação e bebidas; exportação para o contador |
| Pagamentos | PIX com baixa automática, cartão e link; cartão tokenizado no gateway (sistema nunca guarda o número) |
| Comercial | Tarifas por temporada e plano; pacotes e grupos; site com reserva direta e quarto acessível; Booking e Expedia via channel manager |
| Relatórios | Ocupação, diária média, RevPAR; direto × Booking × balcão com comissão em R$; próximos 30 dias; painel no celular |
| Usuários | Perfis (dono, recepção, governança, manutenção, contador); trilha de auditoria; verificação em duas etapas para o dono |
Fonte: PRD v0.2 (RF-14 a RF-46) · Fase 2: contratos, restaurante/bar, sugestão de tarifa, fechadura
Anexo A · PRD · 3/3 · Lei e qualidade
Obrigações legais e requisitos de qualidade.
| Obrigação | Base |
|---|---|
| Ficha do hóspede digital | Portaria MTur 41/2025 |
| Menor só com responsável | ECA, art. 82 |
| NFS-e + IBS/CBS | LC 214/2025 |
| Cadastur antes de vender | Lei 11.771, art. 22 |
| Quartos acessíveis reserváveis | Dec. 9.296/2018 |
| Cancelamento informado e aceito | Código do Consumidor |
| Dados de hóspede protegidos | LGPD |
| Cartão sem número guardado | PCI-DSS |
| Guarda fiscal ≥ 5 anos | CTN |
Qualidade
- No ar ≥ 99,9%
- Contingência se a internet cair
- Backup diário, restauração testada
- Mapa de 70 quartos em menos de 1 s
- Celular simples com 4G
- Dados do hotel, exportáveis
⚠️ Não usar “4 estrelas”: não há selo oficial hoje.
Fonte: PRD v0.2 (RL-01 a RL-09, seção 6) · ME/EPP pode ter regra própria de acessibilidade
Anexo B · Estimativa de esforço detalhada
Horas por item, com teste incluído.
| Item | h |
|---|---|
| Definição + protótipo | 40 |
| Cadastros | 24 |
| Reservas + mapa + trava | 80 |
| Check-in / out | 32 |
| FNRH + homologação | 48 |
| Conta, caixa, fechamento | 80 |
| Pagamentos (gateway) | 40 |
| NFS-e + IBS/CBS + homolog. | 48 |
| Governança no celular | 32 |
| Item | h |
|---|---|
| Manutenção | 24 |
| Hóspedes | 16 |
| Tarifas, pacotes, grupos | 40 |
| Site com reserva direta | 56 |
| Channel manager | 64 |
| Relatórios + painel | 48 |
| Usuários, auditoria, 2FA | 32 |
| Infra, backup, contingência | 32 |
| Testes, treino, manuais | 64 |
800 h + restaurante/bar 56 + sala de eventos 32 + gestão 12% (107 h) = ~1.000 h. Fase 2: contratos 40 · tarifa 24 · fechadura 40 = ~100 h.
Fonte: Estimativa_Esforco.md · atualizado com as respostas do hotel (20/10)
Anexo C · Infraestrutura · 1/2 · Nuvem
Onde o sistema roda (Obralivre cuida).
| Componente | Requisito |
|---|---|
| Aplicação web | HTTPS, atualização sem tirar do ar |
| Banco de dados | Dados no Brasil, volta a qualquer minuto dos últimos 7 dias |
| Fila de integrações | Reenvio automático (FNRH, nota, Booking) |
| Arquivos | Criptografados, acesso por perfil |
| Domínio do hotel autenticado | |
| Monitoramento | Erro + disponibilidade, alerta no celular |
Regras
- Produção + homologação separadas
- Backup diário em outro provedor, 30 dias
- Perda máxima: 5 min de dados
- Volta ao ar em até 4 h
- Relatório de contingência a cada hora
Fonte: Requisitos_Infraestrutura.md
Anexo C · Infraestrutura · 2/2 · No hotel
O que o hotel compra e providencia.
| Item | Quantidade |
|---|---|
| Links de internet com troca automática | 2 (operadoras diferentes) |
| Nobreak (recepção e rede) | 2 |
| PC da recepção | 2 |
| Impressora laser | 1 |
| Roteador + Wi-Fi em todos os andares | conforme a planta |
| Celulares da governança | 3–4 |
| Maquininha do mesmo gateway | 1–2 |
Documentos e contas
- Cadastur ativo
- Chave da API da FNRH
- Inscrição municipal
- Certificado digital A1
- Regime tributário (contador)
- Conta no gateway
- Booking e Expedia
- Domínio + e-mail
Rede dos hóspedes separada da administração. Fechadura eletrônica: escolher marca com integração.
Fonte: Requisitos_Infraestrutura.md