Plataforma multi-tenant, página pública e embed

O FIRO é multi-tenant nativo. Cada negócio é um Tenant com:

• Slug único — identificador legível por URL (ex.: "salao-maria").
• Domínio — usa slug.firo.pt automaticamente, ou custom_domain via CNAME.
• Settings JSON — atributos de configuração extensíveis sem migração.

Separação de dados

• Middleware tenant.active resolve o tenant a partir do domínio em cada request.
• Global Scope TenantScope filtra automaticamente queries Eloquent por tenant_id.
• Models como bookings, serviços, staff, transações são tenant-scoped.
• Customer e magic links são globais (por design — ver artigo de Clientes).

Cada tenant pode usar um de dois modos:

Subdomínio firo.pt (default)

Após criar a conta, o tenant fica imediatamente acessível em {slug}.firo.pt. Zero configuração técnica.

Custom domain (Pro+)

Com domínio próprio (ex.: marcacoes.salaomaria.pt):

• O tenant aponta um CNAME para o destino do FIRO.
• O FIRO regista o hostname em Cloudflare SaaS.
• SSL é emitido e renovado automaticamente.
• O estado é tracked em cloudflare_hostname_id e cloudflare_ssl_status.

Resultado: o link que o cliente vê é marcacoes.salaomaria.pt, não salaomaria.firo.pt. Para muitos negócios, é o detalhe que torna o produto vendável.

Cada tenant pode adaptar a aparência da página pública:

• Logo (logo_path).
• Imagem de cabeçalho (header_image_path).
• Cor primária e secundária com hex.
• Descrição pública em texto livre/markdown.
• Testemunhos em JSON (rotativos no público).

Localização e contactos

• Endereço com latitude/longitude para mostrar em mapa.
• Telefone de contacto.
• NIF para faturação interna.

A landing pública (LandingController) apresenta:

• Logo e foto de cabeçalho.
• Descrição do negócio.
• Lista de serviços por categoria com preços.
• Profissionais visíveis com fotos.
• Mapa Google da localização.
• Testemunhos.
• Botão "Marcar Agora" sempre acessível.

Fluxo de marcação público

1. Selecciona serviço (filtrado por categoria).
2. Selecciona profissional (se aplicável) ou recurso.
3. Selecciona data e hora a partir dos slots disponíveis.
4. Adiciona participantes/extras se relevantes.
5. Insere dados pessoais (nome, contacto, NIF opcional).
6. Aplica cupão se tiver.
7. Vê o preview de preço.
8. Confirma — marcação criada como pendente ou confirmada (consoante a configuração do tenant).

Para tenants que já têm um website e querem manter o tráfego lá, o FIRO disponibiliza um widget embed:

• Rota dedicada /embed/marcacoes com middleware allow.embed que permite CORS para iframe.
• Página de sucesso /embed/booking/success isolada.
• Visual mais limpo, sem header/footer da página pública completa.

O cliente final vê o widget directamente no site do tenant. As marcações ficam no FIRO.

Cada tenant tem três páginas de políticas customizáveis:

• Política de Privacidade (privacy_policy_text).
• Política de Cookies (cookies_policy_text).
• Política de Reservas (booking_policy_text).

Servidas em /politicas/privacidade, /politicas/cookies e /politicas/reservas no domínio do tenant. Há valores default razoáveis se nada for preenchido.

BookingSource permite registar de onde vêm as marcações:

• Google Search.
• Instagram.
• WhatsApp.
• Recomendação de cliente.
• Walk-in.

Cada origem é editável e ordenável. Útil para perceber atribuição de marketing — qual canal está mesmo a trazer clientes vs. qual está só a custar dinheiro.

O backoffice é o painel onde a equipa do negócio opera tudo. Acesso por magic link em /backoffice/login. Inclui:

• Dashboard com estatísticas (marcações hoje, receita).
• Calendário com vista por staff/dia/semana, drag-and-drop, filtros.
• Marcações com CRUD completo, aprovação, check-in.
• Serviços, categorias, add-ons, recursos.
• Equipa com horários, ausências, permissões.
• Clientes com listagem, importação, exportação.
• Promoções e transações.
• Configurações de notificações, branding, IVA, políticas.
• Suporte com tickets de clientes.