Administração do Sistema

Dashboard

A tela inicial do sistema exibe widgets configuráveis com KPIs do portfólio:

• Total de aplicações cadastradas
• Assessments por status (Draft, In Progress, Completed, Approved)
• Scores médios de readiness do portfólio
• Planos de migração por fase
• Riscos bloqueantes abertos
• Distribuição de estratégias recomendadas

Os widgets podem ser reordenados arrastando e soltando, e resetados ao layout padrão.

Catálogo de Tecnologias

Acesse Settings → Technology Catalog (requer catalog.view). O catálogo centraliza o inventário de tecnologias reconhecidas pelo sistema:

• Linguagens de programação
• Frameworks e runtimes
• Bancos de dados
• Message brokers
• Web servers
• Ferramentas de infraestrutura

Cada tecnologia tem: nome, vendor, categoria, descrição, se é stateful e compatibilidade com Kubernetes. Administradores podem adicionar novas tecnologias ao catálogo (requer catalog.manage).

Logs de Auditoria

Acesse Settings → Audit Logs (requer audit.view). Todos os eventos de criação, edição e exclusão são registrados automaticamente via Spatie ActivityLog.

Cada log contém:

• Usuário que executou a ação
• Modelo afetado e ID do registro
• Evento: created, updated, deleted
• Valores anteriores e novos (diff)
• Timestamp
• IP e user agent

Comandos Artisan úteis

# Limpar cache da aplicação
php artisan cache:clear
php artisan config:clear
php artisan view:clear
php artisan route:clear

# Recompilar assets (produção)
npm run build

# Verificar status do sistema
php artisan about

# Processar fila manualmente
php artisan queue:work --once

# Ver jobs pendentes na fila
php artisan queue:monitor database:default

# Reprocessar jobs falhados
php artisan queue:retry all

# Listar rotas
php artisan route:list

Probes de saúde

O sistema expõe endpoints compatíveis com Kubernetes para monitoramento:

GET /healthz   → 200 OK se a aplicação está viva
GET /readyz    → 200 OK se banco e dependências estão acessíveis
GET /metrics   → métricas (requer token de autenticação)

Configure no seu cluster Kubernetes / OKD:

livenessProbe:
  httpGet:
    path: /healthz
    port: 8080
  initialDelaySeconds: 30
  periodSeconds: 10

readinessProbe:
  httpGet:
    path: /readyz
    port: 8080
  initialDelaySeconds: 15
  periodSeconds: 5

Manutenção do banco

# Rodar migrations
php artisan migrate

# Rollback da última migration
php artisan migrate:rollback

# Status das migrations
php artisan migrate:status

# Seed de dados iniciais
php artisan db:seed

# Seed de um seeder específico
php artisan db:seed --class=AssessmentTemplateSeeder

Configuração de sessão e cache

Driver	Recomendação
Desenvolvimento	SESSION_DRIVER=file, CACHE_STORE=file
Produção (Docker)	SESSION_DRIVER=redis, CACHE_STORE=redis
Produção (sem Redis)	SESSION_DRIVER=database, CACHE_STORE=database

Backup e recuperação

# Dump do banco PostgreSQL
pg_dump -h localhost -U tainux tainux > backup_$(date +%Y%m%d).sql

# Restore
psql -h localhost -U tainux tainux < backup_20240315.sql

# Backup dos arquivos de relatório
tar -czf reports_$(date +%Y%m%d).tar.gz storage/app/reports/

Atualização do sistema

1. Ative o modo de manutenção

   php artisan down --secret="seu-token-de-bypass"

2. Faça pull da nova versão

   git pull origin main

3. Instale dependências e rode migrations

   composer install --no-dev --optimize-autoloader
   php artisan migrate --force
   npm run build

4. Limpe o cache e saia do modo de manutenção

   php artisan cache:clear
   php artisan config:cache
   php artisan route:cache
   php artisan view:cache
   php artisan up

Logs da aplicação

# Ver logs em tempo real (desenvolvimento)
php artisan pail

# Logs no Docker
docker compose logs -f web
docker compose logs -f worker

# Arquivo de log
tail -f storage/logs/laravel.log

Suporte

Para suporte técnico, entre em contato com a equipe TAINUX:

• E-mail: suporte@tainux.io
• Site: tainux.io
• GitHub: github.com/tainux