Capítulo 48 — Implantação e Onboarding de Tenants

Requisição aprovada
  │
  ├─ Dia 1-2: Provisionamento automatizado
  │
  ├─ Dia 3-5: Testes de integração + validação
  │
  ├─ Dia 6-10: Staging com dados de teste
  │
  ├─ Dia 11-14: Treinamento e documentação
  │
  ├─ Dia 15: Go-live para produção
  │
  └─ Dia 16-45: Suporte intensivo (on-call)

Requisição aprovada
  │
  ├─ Criar tenant no IAM
  │
  ├─ Criar namespace Kubernetes
  │
  ├─ Provisionar banco de dados (schema + credenciais)
  │
  ├─ Provisionar storage (buckets, quotas)
  │
  ├─ Criar coleção de vector store
  │
  ├─ Configurar network policies (isolamento)
  │
  ├─ Configurar RBAC (perfis iniciais)
  │
  ├─ Registrar tenant em service discovery
  │
  └─ Notificar conclusão

# tenants/org-a/main.tf
module "tenant" {
  source = "../../modules/tenant"
  
  tenant_id = "org-a"
  tenant_name = "Secretaria de Educação"
  
  namespace = "tenant-org-a"
  
  database = {
    storage = "100Gi"
    backup_retention = 30
  }
  
  quotas = {
    cpu = "10"
    memory = "20Gi"
    storage = "500Gi"
  }
  
  modules = ["solicitacoes", "agendamentos", "documentos"]
}

# .github/workflows/tenant-onboarding.yml
name: Tenant Onboarding

on:
  workflow_dispatch:
    inputs:
      tenant_id:
        description: 'Tenant ID'
        required: true

jobs:
  provision:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      
      - name: Terraform Plan
        run: |
          terraform -chdir=tenants/${{ inputs.tenant_id }} plan -out=tfplan
      
      - name: Terraform Apply
        run: |
          terraform -chdir=tenants/${{ inputs.tenant_id }} apply tfplan
      
      - name: Validate Tenant
        run: |
          ./scripts/validate-tenant.sh ${{ inputs.tenant_id }}
      
      - name: Notify Success
        run: |
          curl -X POST $WEBHOOK_URL -d '{"tenant": "${{ inputs.tenant_id }}", "status": "provisioned"}'

# scripts/create-initial-users.sh
#!/bin/bash

TENANT_ID=$1

# Criar usuários administrativos
kubectl exec -it tenant-admin-$TENANT_ID -- \
  python manage.py create_user \
    --username "admin@$TENANT_ID" \
    --role "TENANT_ADMIN" \
    --send-invite

# Criar usuários operacionais
kubectl exec -it tenant-admin-$TENANT_ID -- \
  python manage.py bulk_create_users \
    --file ./users-$TENANT_ID.csv \
    --role "OPERATOR" \
    --send-invite

# scripts/validate-tenant.sh
#!/bin/bash

TENANT_ID=$1
ENDPOINT="https://api.platform/tenants/$TENANT_ID"

echo "1. Verificando conectividade..."
curl -f $ENDPOINT/health || exit 1

echo "2. Verificando isolamento de dados..."
curl -f $ENDPOINT/api/solicitacoes \
  -H "Authorization: Bearer $TOKEN_ORG_B" \
  && exit 1 # Deve falhar para outro tenant

echo "3. Verificando integrações..."
curl -f $ENDPOINT/integrations/sei/health || exit 1

echo "4. Verificando storage..."
curl -f -X POST $ENDPOINT/documents/test \
  -F "file=@test.pdf" || exit 1

echo "5. Verificando IA..."
curl -f -X POST $ENDPOINT/ai/chat \
  -d '{"message": "Teste"}' || exit 1

echo "Validação concluída com sucesso!"

# tenants/org-a/staging-values.yaml
environment: staging
replicas: 2 # produção tem 3+

database:
  pool_size: 10 # menor que produção
  
  # Dados de teste
  seed_services: 20
  seed_requests: 500
  seed_users: 50

-- scripts/seed-staging.sql
INSERT INTO services (tenant_id, name, description) VALUES
  ('org-a', 'Matrícula Escolar', 'Processo de matrícula em escolas públicas'),
  ('org-a', 'Licença Escolar', 'Solicitação de licença médica'),
  ('org-a', 'Transferência Escolar', 'Transferência entre escolas');

INSERT INTO requests (tenant_id, service_id, citizen_id, status, created_at) VALUES
  ('org-a', 1, 'citizen-001', 'SUBMITTED', NOW() - INTERVAL 5 DAY),
  ('org-a', 2, 'citizen-002', 'APPROVED', NOW() - INTERVAL 2 DAY),
  ('org-a', 3, 'citizen-003', 'REJECTED', NOW() - INTERVAL 1 DAY);

Dia 1: Visão geral (2h)
  - Contexto: por que a plataforma, alinhamento com políticas
  - Visão geral de funcionalidades
  - Segurança e privacidade

Dia 2: Jornada do cidadão (3h)
  - Portal web
  - Aplicativo mobile
  - Integração com GOV.BR

Dia 3: Jornada do operador (3h)
  - Painel de gestão
  - Atendimento, complementação, conclusão
  - Relatórios e analytics

Dia 4: Suporte e troubleshooting (2h)
  - Contatos de suporte
  - Escalação
  - Health checks básicos

# Plataforma de Relacionamento Digital — Guia da Secretaria de Educação

## Serviços Disponíveis

1. **Matrícula Escolar** — cidadão solicita matrícula em escola pública
2. **Licença Escolar** — solicitação de licença médica
3. **Transferência Escolar** — transferência entre unidades

## Contatos

- **Suporte técnico**: suporte@plataforma.gov.br, (31) 3999-9999
- **Gestor de Projeto**: gerente@educacao.mg.gov.br
- **Escalação**: escalacao@plataforma.gov.br

T-0: Último backup de staging
T+0: Deploy em produção (blue-green ou canary)
T+5min: Smoke tests
T+15min: Monitoramento ativo
T+1h: Liberação de acesso para primeiros usuários (10%)
T+4h: Aumento gradual para 50% dos usuários
T+8h: 100% dos usuários com monitoramento intensivo
T+24h: Validação de sucesso, celebração

# monitoring/tenant-health.yaml
alerts:
  - name: error_rate_high
    condition: error_rate > 1%
    action: page_oncall
  
  - name: database_connection_pool_high
    condition: pool_usage > 80%
    action: page_oncall
  
  - name: backup_failed
    condition: last_backup > 24h
    action: email_team

#!/bin/bash
# runbook-onboarding.sh

TENANT_ID=$1
TENANT_NAME=$2

set -e

echo "=== Onboarding de Tenant ==="

# 1. Validar pré-requisitos
echo "1. Validando pré-requisitos..."
./scripts/validate-prereqs.sh $TENANT_ID

# 2. Provisionar
echo "2. Provisionando infraestrutura..."
terraform -chdir=tenants/$TENANT_ID apply -auto-approve

# 3. Validar provisionamento
echo "3. Validando provisionamento..."
./scripts/validate-tenant.sh $TENANT_ID

# 4. Configurar
echo "4. Configurando tenant..."
./scripts/configure-tenant.sh $TENANT_ID "$TENANT_NAME"

# 5. Testes
echo "5. Executando testes..."
./scripts/run-tests.sh $TENANT_ID

# 6. Notificar
echo "6. Notificando conclusão..."
curl -X POST $WEBHOOK_URL \
  -d "{\"tenant\": \"$TENANT_ID\", \"status\": \"onboarded\"}"

echo "=== Onboarding concluído com sucesso! ==="