A JORNADA DO TENANT

0

Pre-requisitos

Infraestrutura compartilhada

🏗️

O que ja existe antes

Recursos compartilhados entre todos os 120+ tenants

Adicionar um tenant NAO cria nenhum destes recursos. Sao todos compartilhados.

Recurso	Tecnologia	Isolamento
Banco de Dados	PostgreSQL (RDS)	Contexto logico no app
Cache / Filas	Redis (ElastiCache)	Prefixado por tenant
Load Balancer	ALB + Nginx	Regex de subdomain
Autenticacao	Cognito	Atributo custom tenant
Busca	Typesense	Collections por tenant
Certificado	ACM Wildcard	*.vitrinepro.app.br
IA	vtp-ai-engine (Cloud Run)	CORS regex + JWT
Video	vtp-video-processor	Webhook callbacks

▼ clique para ver o diagrama ▲ recolher

INFRAESTRUTURA COMPARTILHADA (provisionada uma vez) ┌──────────────────────────────────────────────────────────────┐ │ ALB ─► Nginx ─► PHP-FPM (vtp-webservices, Laravel 12) │ │ │ │ RDS PostgreSQL Redis Cognito Typesense │ │ vtp-ai-engine (FastAPI, GCP Cloud Run) │ │ vtp-video-processor (Laravel, webhook-based) │ │ firebasecloud (Cloud Functions centrais) │ └──────────────────────────────────────────────────────────────┘ ▼ ▼ ▼ Tenant A Tenant B Tenant N (recursos (recursos (recursos dedicados) dedicados) dedicados)

1

O Formulario

~5 minutos

📋

Criar tenant no Filament

admin.vitrinepro.app.br

vtp-admin

O operador acessa o painel Filament e preenche o formulario do novo cliente:

Nome

Aprovacao Agil

Subdominio

aprovacaoagil

TV Domain

aprovacaoagil.vitrinepro.tv.br

Dominio Proprio (opcional)

app.aprovacaoagil.com.br

Domain

aprovacaoagil.vitrinepro.app.br

▸ auto-derivado do subdominio

Database

edm_aprovacaoagil

▸ auto-derivado do subdominio

CREATED

▼ ver arquivos envolvidos ▲ recolher

            CreateCustomer.php
// Mutates form data before creation
$data['domain'] = $data['subdomain'] . '.vitrinepro.app.br';
$data['database'] = 'edm_' . $data['subdomain'];
$data['installed_at'] = now();
$data['status'] = CustomerStatus::CREATED;
          

2

A Orquestracao

~30-45 minutos (duas trilhas em paralelo)

⚡

O botao Deploy e pressionado

CustomerDeployJob → DoDeployAction

vtp-admin vtp-webservices

O operador clica Deploy. Duas trilhas disparam em paralelo:

Trilha A — Backend (SSH → EC2)

SSH para o servidor de producao executa deployanewdomain.sh:

artisan domain:add registra dominio no Gecche/Multidomain
artisan config:clear limpa cache de config
artisan command:newdomain inicializa Config (singleton) com defaults
artisan migrate --domain=... roda 276 migrations
artisan db:seed --domain=... admin padrao + estrutura demo
Copia .env para ~/envs/env-prd/
Gera config Nginx (server block com regex)
Gera config Supervisor (queue worker)
Cache de config e rotas do Laravel
Upload para S3 + trigger CodePipeline

Trilha B — CDN + DNS (AWS SDK)

CreateCloudFrontAndDnsAction provisiona toda a camada estatica:

🪣 S3 Paths ×3

🌐 CloudFront ×3

🔗 DNS Records 5-6

3 CloudFront distributions:

• PWA: {tenant}.vitrinepro.app.br

• Painel: painel-{tenant}.vitrinepro.app.br

• Cast: {tenant}.vitrinepro.tv.br

▼ ver como funciona o roteamento ▲ recolher

O tenant e identificado pelo subdominio. Nginx extrai o slug e o passa como header HTTP. Nenhuma mudanca de config no webservices e necessaria apos este passo.

            nginx.conf
server_name ~^api-(?<tenant>.+)\.vitrinepro\.app\.br$;
...
fastcgi_param HTTP_X_TENANT $tenant;
          

            DoDeployAction.php
$ssh = "ssh ubuntu@127.0.01 -i "
  . resource_path(self::PEM_KEY_MAIN)
  . " 'cd vtp-webservices && sh deployanewdomain.sh "
  . $customer->subdomain . " "
  . $customer->tv_domain . " \""
  . $customer->name . "\"'";
          

CREATED IN_DEPLOY READY

Apos 5 min, ReadyNewDomainJob faz polling no health check. Quando responde 200: status READY, email enviado, Slack notificado.

3

Projeto Firebase

~5 minutos

🔥

Criar projeto Firebase

Um projeto por tenant — isolamento total

firebasecloud

          firebase CLI
firebase projects:create "vtp-aprovacaoagil" \
  --display-name "EDM aprovacaoagil"

gcloud firebase projects:addfirebase "vtp-aprovacaoagil"
        

Habilitar no console:

☑ Authentication (Email/Password + Google)

☑ Analytics

☑ Crashlytics

☑ Cloud Messaging (FCM)

▼ ver artefatos gerados ▲ recolher

O projeto central (ed-demo-c2bf6) hospeda Cloud Functions compartilhadas (Sophia chatbot, banners, Slack bot). Projetos per-tenant isolam dados de analytics, push e crash.

Artefatos gerados:

📦 google-services.json → Android

📦 GoogleService-Info.plist → iOS

📦 Config web → PWA e Painel

4

Deploy do Painel

~10-20 minutos

⚙️

Build + Deploy do vtp-painel

Angular 19 SPA — painel admin do tenant

vtp-painel

O painel que a equipe do tenant usa para gerenciar conteudo, usuarios e configuracoes.

          environment.prod.ts
export const environment = {
  production: true,
  appname: 'Aprovacao Agil',
  urlbase: 'https://api-aprovacaoagil.vitrinepro.app.br/api/v1/admin/',
  domain: 'aprovacaoagil',
  googleKey: 'NOT_CONFIGURED'
};
        

▼ ver pipeline de deploy ▲ recolher

Gerar environment: python3 painel-generator.py --tenant aprovacaoagil
Build Angular: ng build --configuration aprovacaoagil
Upload para S3: aws s3 sync dist/ s3://painel-aprovacaoagil/
Invalidar CloudFront: aws cloudfront create-invalidation --paths "/*"

Resultado: https://painel-aprovacaoagil.vitrinepro.app.br no ar.

5

Deploy da PWA

~10-20 minutos

📱

Build + Deploy da vtp-pwa

Angular 19 — 1438 arquivos — 133 tenants

vtp-pwa

O app que os clientes finais do tenant utilizam. Mesmo padrao de build do painel, com configs adicionais:

          environment.prod.ts
export const environment = {
  production: true,
  appname: 'Aprovacao Agil',
  urlbase: 'https://api-aprovacaoagil.vitrinepro.app.br/api/v1/app/',
  oneSignalAppID: 'a36bd40b-058f-...',
  PSPDFKitKey: '...'
};
        

▼ detalhes ▲ recolher

133 diretorios de tenant existem em src/projects/. Cada um com environment.ts, environment.prod.ts e settings.ts (feature flags como PDF reader).

Resultado: https://aprovacaoagil.vitrinepro.app.br no ar.

6

App Android

Build pipeline

🤖

Flavor no vtp-android

Kotlin + Jetpack Compose — 120 flavors × 5 APIs

vtp-android

Um novo flavor e adicionado ao flavors.json (3.972 linhas, 120 client flavors):

          flavors.json
{
  "name": "aprovacaoagil",
  "dimension": "client",
  "enabled": true,
  "applicationIdSuffix": ".aprovacaoagil",
  "zeplinID": "628fb994...",
  "bitriseID": "1e6b709a...",
  "buildConfigFields": [{
    "fieldName": "BASE_URL",
    "fieldValue": "\"https://api-aprovacaoagil.vitrinepro.app.br/api/v1/\""
  }]
}
        

▼ ver pipeline completa ▲ recolher

Assets: python android_res.py --update-full aprovacaoagil (Zeplin → drawable)
Build: ./gradlew packageAprovacaoagilProdReleaseUniversalApk
Upload: ./gradlew appDistributionUploadAprovacaoagilProdRelease
Publicacao no Google Play Store

120 flavors × 5 dimensoes de API (prod, verde, white, demo, desenv) = ate 240 combinacoes de build. Deep links via appmagic.link.

7

App iOS

Build pipeline

🍎

White-label no vtp-ios

Swift + Tuist — 118 apps — 462+ variantes

vtp-ios

Um novo diretorio apps/AprovacaoAgil/ e criado com App.swift, Info.plist, entitlements, assets e GoogleService-Info.plist:

          App.swift
final class App: DefaultApp {
  override var appConfig: AppConfig {
    return AppConfig(
      oneSignalId: "a36bd40b-...",
      api: .prod("aprovacaoagil"),
      appStoreId: "1627500874",
      productsConfig: AppProductsConfig(
        netflixSettings: .vertical,
        defaultPreferences: .newHome
      )
    )
  }
}
        

▼ ver pipeline e SPM libs ▲ recolher

Gerar projeto: TUIST_APP_NAME=AprovacaoAgil tuist generate
Build + signing via Fastlane
Upload para App Store Connect
Publicacao na Apple App Store

10 SPM libraries compartilhadas:

• vtp-core-ios (networking, auth, storage)

• vtp-theme-ios (theming dinamico)

• vtp-designsystem-ios (tokens, componentes)

• vtp-serverdrivenui-ios (SDUI)

• vtp-notifications-ios (OneSignal push)

• + 5 mais (media, deeplink, shared, updates, deeplinkfeature)

Bundle ID: br.app.vitrinepro.AprovacaoAgil (com excecoes para tenants com identidades pre-existentes). Cada app tem sua propria Notification Service Extension.

8

Verificacao

~5 minutos

✅

Verificar isolamento

Health checks + teste cross-tenant

          health check
for url in \
  "https://api-aprovacaoagil.vitrinepro.app.br/api/status" \
  "https://painel-aprovacaoagil.vitrinepro.app.br" \
  "https://aprovacaoagil.vitrinepro.app.br"; do
  echo "$url → $(curl -s -o /dev/null -w '%{http_code}' $url)"
done
# Esperado: todos 200
        

▼ ver teste de isolamento ▲ recolher

            isolation test
# Login como usuario do novo tenant
# Tentar acessar recurso de outro tenant
curl -s -H "Authorization: Bearer {JWT_NOVO_TENANT}" \
  https://api-outro-tenant.vitrinepro.app.br/api/products
# Esperado: 401 ou 403 — NUNCA dados do outro tenant
          

✓

O Resultado

Tenant vivo em todas as plataformas

🎉

Tenant provisionado com sucesso

Todos os endpoints no ar

🌐 https://aprovacaoagil.vitrinepro.app.br PWA
⚙️ https://painel-aprovacaoagil.vitrinepro.app.br Painel Admin
🔌 https://api-aprovacaoagil.vitrinepro.app.br API
📺 https://aprovacaoagil.vitrinepro.tv.br SmartTV/Cast
🤖 Google Play Store (white-label APK)
🍎 Apple App Store (white-label .ipa)

120+

Tenants

360+

CloudFront Distros

720+

DNS Records

30-45

Min / Tenant

133

PWA Dirs

120

Android Flavors

118

iOS Apps

120+

Firebase Projects

▼ ver diagrama de arquitetura completo ▲ recolher

COMPARTILHADO (existe uma vez) ┌──────────────────────────────────────────────────────────┐ │ ALB RDS (PostgreSQL) Redis Cognito Typesense │ │ vtp-webservices (roteia por HTTP_X_TENANT) │ │ vtp-ai-engine vtp-video-processor firebasecloud │ └──────────────────────────────────────────────────────────┘ │ │ │ ▼ ▼ ▼ TENANT A TENANT B TENANT N ───────── ───────── ───────── 3x CloudFront 3x CloudFront 3x CloudFront 5-6x DNS 5-6x DNS 5-6x DNS S3 paths S3 paths S3 paths Firebase proj Firebase proj Firebase proj iOS .ipa iOS .ipa iOS .ipa Android .apk Android .apk Android .apk

24 repositorios envolvidos. 10 tocados diretamente no provisionamento.

vtp-admin (orquestra) → vtp-webservices (backend) → firebasecloud (Firebase) → vtp-painel (admin SPA) → vtp-pwa (consumer app) → vtp-android (mobile) → vtp-ios (mobile)

Legenda