PHP 8.3+, Filas Redis com DLQ, Retries & Idempotência
Schema único + Discriminador `tenant_id` + Row-Level Security
100% RGPD/GDPR, Tráfego Ilimitado, vRack Privado
Subdomínio SSL + Website Builder + Social SSO
Fluxo Arquitetural Completo & Orquestração de Eventos
Cadeia assíncrona desacoplada com tolerância a falhas (Saga Pattern / Filas com Retries).
empresa.plataforma.com"]:::recommended --> B{"Roteamento & SSL Edge"}:::decision B -->|⭐ Recomendado| B1["⭐ Cloudflare for SaaS
(Custom Hostnames + SSL Imediato)"]:::recommended B -.-> B2["Caddy / Traefik Reverse Proxy
(Let's Encrypt On-Demand)"]:::default end subgraph INFRA_LAYER["2. INFRAESTRUTURA & HOSPEDAGEM (OVHCLOUD UE)"] B1 --> INFRA["⭐ OVHcloud Public Cloud
(Datacenter UE Gravelines / vRack Privado)"]:::recommended B2 -.-> INFRA INFRA --> VM1["Instâncias Web App
(Nginx + PHP 8.3-FPM)"]:::recommended INFRA --> VM2["⭐ PostgreSQL Managed
(Schema Único + tenant_id + RLS)"]:::recommended INFRA --> VM3["⭐ Redis Managed Cluster
(Queues Horizon + Locks)"]:::recommended end subgraph BACKEND_LAYER["3. CORE BACKEND & WORKERS ASSÍNCRONOS"] VM1 & VM3 --> C["⭐ Laravel 13 + Laravel Horizon
(Event-Driven Architecture & Redis DLQ)"]:::recommended C -.-> C2["Python FastAPI + Celery Workers"]:::default end subgraph PAYMENT_LAYER["4. PAGAMENTOS ASSÍNCRONOS & WEBHOOKS"] C --> D{"Gateway de Checkout"}:::decision D -->|⭐ Recomendado| D1["⭐ Stripe Payment Intents
(MB WAY + Multibanco + Cartões + HMAC)"]:::recommended D -.-> D2["Ifthenpay / EuPago
(Gateways Locais de Portugal)"]:::default end subgraph INVOICING_LAYER["5. FATURAMENTO ELETRÔNICO (UBL / XML / AT)"] D1 & D2 -->|Webhook Confirmado & Idempotente| E{"Emissão Fiscal"}:::decision E -->|⭐ Recomendado| E1["⭐ Moloni REST API
(Certificada AT + ATCUD + UBL 2.1 XML)"]:::recommended E -.-> E2["InvoiceXpress API / Storecove Peppol"]:::default end subgraph THIRD_PARTY_LAYER["6. PROVISIONAMENTO DE APIS DE TERCEIROS (SSO & EMBED)"] E1 & E2 -->|Job Enfileirado via Horizon| F["Async Provisioning Pipeline
(Saga Pattern com Retries)"]:::decision F --> G["⭐ Website Builder: Duda API
(Criação de Site + Token SSO) [Dep. Terceiro]"]:::external F --> H["⭐ Social Scheduler: Ayrshare Embed
(iFrame Seguro + JWT SSO) [Dep. Terceiro]"]:::external F --> I["⭐ Analytics Dashboard: Google PageSpeed + Plausible
(Métricas de Velocidade & Tráfego)"]:::recommended end
Customer Journey: Do Registro → ao Website Ativo
Cadeia automatizada e desacoplada de ponta a ponta (Registration → Payment → E-Invoicing → Third-Party API Provisioning).
Registro & Provisionamento de Subdomínio Síncrono
O business owner preenche o formulário de registro. O backend valida o e-mail/NIF, cria o Tenant e seu tenant_id UUID no PostgreSQL. Imediatamente, uma chamada à API do Cloudflare for SaaS provisiona o hostname empresa.plataforma.com e emite o certificado TLS na borda em segundos.
Pagamento & Webhooks Idempotentes Assíncrono
O Stripe exibe o checkout com MB WAY, Multibanco (referência) ou cartão. Para métodos assíncronos, a autorização chega depois via webhook. O receiver verifica a assinatura HMAC (Stripe-Signature), valida a idempotência e enfileira o evento payment.succeeded no Redis via Horizon.
E-Invoicing Automático (UBL/XML) Saga Step 2
O job Horizon consumidor do evento de pagamento dispara a Moloni REST API. A API cria o documento fiscal com NIF do cliente, aplica a alíquota de IVA correta, gera o ATCUD, o QR Code legal, e produz o PDF + XML UBL 2.1. O XML pode ser enviado à rede europeia Peppol via Storecove para destinatários B2G. O email da fatura é enviado automaticamente ao tenant.
Provisionamento de APIs de Terceiros (SSO) Saga Step 3
O Saga Orchestrator (pipeline de jobs Horizon com retries + DLQ) dispara três provisionamentos em paralelo: (a) Duda API clona um template pré-configurado e gera um token SSO POST /accounts/sso para acesso direto ao editor; (b) Ayrshare gera um JWT para embutir o iFrame de agendamento social no dashboard; (c) PageSpeed + Plausible iniciam jobs de coleta de métricas para o painel one-page. O tenant vê seu site ativo em empresa.plataforma.com com todos os widgets integrados.
tenant_id
Estratégia de Multi-Tenancy: Schema Único com Discriminador + PostgreSQL RLS
Isolamento rigoroso no nível de banco de dados com máxima performance para milhares de clientes.
Todas as tabelas de entidades de negócio contêm a coluna tenant_id UUID NOT NULL com índice B-Tree composto ((tenant_id, id)). O Eloquent ORM aplica scopes globais automáticos em tempo de execução.
O PostgreSQL aplica a política ENABLE ROW LEVEL SECURITY. Em cada requisição ou job, o Laravel injeta a sessão:
SET LOCAL app.current_tenant_id = 'uuid';
Impedindo qualquer vazamento de dados mesmo em caso de erro de query no código.
Bancos ou schemas separados geram um gargalo operacional crítico de migrações DDL (executar migrações em 5.000 schemas trava o deploy) e esgotam o pool de conexões. O schema único com discriminador + RLS é o padrão da indústria para SaaS de alta escala (ex: Stripe, Notion, Shopify).
Estimativa de Escala da Infraestrutura (OVHcloud)
Projeção de dimensionamento de recursos de computação, banco de dados e filas conforme o crescimento de clientes.
| Fase de Escala | Volume de Clientes | Camada Web / API (OVH Compute) | Workers Assíncronos (Horizon) | PostgreSQL Managed (OVH DB) | Redis Managed |
|---|---|---|---|---|---|
| Fase 1: MVP & Lançamento | 1 a 500 Tenants | 1x Instância Public Cloud (4 vCPU, 8GB RAM) | Processos Horizon na mesma VPS (5 a 10 workers) | Essential Node (2 vCPU, 4GB RAM, Storage NVMe) | Instância Redis 1GB (Queues + Cache) |
| Fase 2: Tração & Crescimento | 500 a 5.000 Tenants | 2x Instâncias Public Cloud com Load Balancer gerenciado | 1x Instância dedicada para Horizon Workers (8 vCPU, 16GB RAM) | Business Node (4 vCPU, 16GB RAM) + 1 Read Replica | Cluster Redis Gerenciado 2GB (com Failover) |
| Fase 3: Alta Escala | 5.000 a 50.000+ Tenants | Auto-scaling group de instâncias Web via vRack | Cluster de Workers dedicado escalável horizontalmente | Cluster PostgreSQL High Availability (HA) com PgBouncer Pooler | Cluster Redis Sharded dedicado com replicação |
Análise Técnica & Comparativo Detalhado por Módulo
Explore os detalhes técnicos, modelos de precificação oficial, viabilidade de SSO e dependências de terceiros.
Matriz de Rastreabilidade de Requisitos → Soluções
Mapeamento 1:1 entre cada exigência técnica do briefing e a solução arquitetural recomendada.
| Requisito do Cliente (Bart / Quarzazate) | Solução Arquitetural Recomendada | Aba Detalhada | ✓ |
|---|---|---|---|
| Registration → Provisionamento automático de subdomínio único (tenant.plataforma.com) | Cloudflare for SaaS (Custom Hostnames + Edge SSL) | Multi-Tenancy & DNS | |
| Multi-Tenant: dados estritamente isolados em banco centralizado | PostgreSQL — Schema Único + tenant_id + Row-Level Security (RLS) | PostgreSQL Multi-Tenancy | |
| Payment Gateway + Webhooks assíncronos (autorização atrasada via referências, ex: Multibanco/MB WAY) | Stripe Payment Intents + Webhooks HMAC + Idempotência | Pagamentos (MB WAY) | |
| E-Invoicing automático: UBL/XML estrutura, rede oficial europeia de faturamento | Moloni API (certificada AT + ATCUD + QR Code + XML UBL 2.1) → Storecove/Peppol (para rede Europeia B2G) | Faturamento UBL/XML | |
| Third-Party API Provisioning (SSO): lançar projeto web + acesso direto ao editor via SSO/token | Duda API (White-Label) — clonagem de template + geração de SSO session via POST /accounts/sso | Website Builder & SSO | |
| Social Media Scheduling via iFrame/API seguro | Ayrshare White-Label Embed SDK (iFrame + JWT SSO) | Social Media Scheduler | |
| Analytics API — dashboard one-page: performance técnica + visibilidade busca | Google PageSpeed Insights API + Plausible Analytics API (dashboard unificado) | Analytics Dashboard | |
| Orquestração de eventos com filas/worker e chaining de APIs (Saga Pattern) | Laravel 13 + Laravel Horizon + Redis (DLQ, Retries, Idempotência) | Backend Laravel 13 |
Resumo Executivo da Stack Vencedora
Arquitetura de máxima robustez técnica, conformidade legal europeia e eficiência orçamentária.
Datacenter UE (Gravelines/Estrasburgo), vRack privado, PostgreSQL gerenciado com RLS e tráfego ilimitado sem custos ocultos de egresso.
PHP 8.3+, orquestração de filas com Redis, auto-retries, DLQ e isolamento rigoroso por tenant via RLS no PostgreSQL.
MB WAY / Multibanco com webhooks HMAC seguros, emissão de faturas certificadas pela AT com QR Code, ATCUD e XML UBL 2.1.
Website Builder com SSO transparente por token, agendador social embutido via iFrame e métricas de desempenho em painel único.