Infraestrutura - Servidor, Cache, Filas, Logs

Resumo

Centro de operações técnicas da plataforma. Painel exclusivo do super-admin com acesso a cache, filas, cron jobs, logs, backups, banco de dados, pool de conexões, proxies, pipeline de assets, gateway de API, scheduler, smoke tests, diagnósticos, health checks, feature flags de infra, comparação de tenants e centro de operações.

Para quem é (papel/role)

• super-admin - acesso exclusivo. Tenant-admin não acessa.
• platform-staff - com role de infra dedicado.

O que você pode fazer

Dashboard e health

• Dashboard infra: CPU, memória, disco, requisições, uptime.
• Health checks globais.
• Operations center: painel consolidado de incidentes.

Cache

• Visualizar uso de cache (memória, arquivo, APCu, Redis).
• Flush: limpa cache geral ou por chave.
• Warm: pré-popula cache crítico.
• Smart cache: estratégias de invalidação.
• Estratégia de cache por área.

Filas (queues)

• Queue dashboard: filas ativas, jobs pendentes, jobs falhos.
• Retry / purge jobs.
• Failed jobs inspector.

Cron / Scheduler

• Listar cron jobs: registry centralizado.
• Toggle, criar, excluir job.
• Health e histórico por job.

Logs

• Canais: app, error, security, audit, query, queue.
• Filtro por tenant/usuário/data.
• Exportação.

Backups

• Agendamento de backup.
• Restore controlado.

Database

• Status de conexões, tamanho, queries lentas.
• Query performance analyzer.
• Suggest indexes.
• Connection pool (kill connection).

Proxies

• Configuração de proxies internos.

Serviços e orquestração

• Service orchestration.
• API gateway interno.
• Webhook pipeline.
• Asset pipeline.
• Batch processing / data compression / cleanup.

Diagnóstico

• Smoke tests por plugin/rota.
• Debug tools.
• Errors inspector.
• Tests runner.

Features e qualidade

• Feature flags de infra (com auditoria).
• Quality checks.

Comparações

• Tenant comparison / tenant resources.
• Whitelabel studio (clone, export).

AI

• AI providers (administração operacional).
• AI assistant interno.

Traduções

• Gestão de traduções do sistema.

Como acessar

1. /admin.
2. Settings → Infraestrutura ou /admin/settings/infrastructure.

Tutoriais

Limpar cache de um tenant específico

1. /admin/settings/infrastructure/cache.
2. Informe a chave (tenant:{id}:*).
3. Clique em Flush.

Matar uma conexão travada no banco

1. /admin/settings/infrastructure/database.
2. Localize a conexão em Connection pool.
3. Clique em Kill connection.

Reprocessar um job falho

1. /admin/settings/infrastructure/queue-dashboard.
2. Filtre por Failed.
3. Selecione o job e clique em Retry.

Rodar smoke test após deploy

1. /admin/settings/infrastructure/smoke-test.
2. Clique em Rodar tudo.
3. Verifique resultados por plugin.

Agendar backup diário

1. /admin/settings/infrastructure/backups.
2. Crie agendamento diário às 03:00 UTC.
3. Destino: storage interno ou S3 (quando configurado).

Integrações

• Observabilidade - logs/métricas alimentam alertas (observability-logs-metricas.md).
• Compliance - backups entram em política de retenção (compliance-lgpd.md).
• Platform feature flags - flags de infra são auditadas (platform-feature-flags.md).
• External APIs - credenciais para backup remoto (external-apis-chaves-globais.md).

Perguntas frequentes

Flush de cache derruba o sistema? Não. Apenas reduz performance momentaneamente até reaquecer.

Posso restaurar backup parcial? Sim, por tabela ou por tenant, conforme ferramenta.

Smoke test é suficiente para validar deploy? Cobre rotas principais. Recomenda-se complementar com testes manuais.

Logs ficam quanto tempo? Conforme política de retenção por canal (tipicamente 30-90 dias).

Queue usa Redis? Suporta Redis quando disponível; fallback em banco (core_jobs).

Cron é registrado onde? Em CronRegistry. Plugins devem seguir o padrão CronController.

Posso pausar um cron temporariamente? Sim, toggle no scheduler.

Kill connection é seguro? Sim para conexões travadas; transações em andamento são revertidas.

Limitações, políticas e avisos

• Apenas super-admin acessa este painel.
• Alterações em infra são auditadas.
• Restore de backup é operação de alto risco - requer confirmação dupla.
• Flush de cache global em horário de pico pode causar latência.

Relacionados

• observability-logs-metrics.md
• platform-feature-flags.md
• compliance-lgpd.md
• external-apis-global-keys.md