ForgeLogs

Sistema geral de logging estruturado que captura logs de UI/UX e outros tipos de problemas, permitindo que IAs analisem e resolvam problemas antes de irem para produção.

Características

• Logs de UI/UX: Elementos, dimensões, posições, cores, estilos, problemas visuais
• Logs de Performance: Tempos de renderização, carregamento, interações
• Logs de Erros: JavaScript errors, React errors, network errors
• Logs de Acessibilidade: Problemas de a11y, contraste, navegação por teclado
• Logs de Segurança: Problemas de segurança detectados
• Logs Customizados: Qualquer tipo de log estruturado
• Dashboard: Interface web para visualização de logs por categoria
• Análise com IA: Identificação automática de padrões e sugestões

Instalação

./setup.sh
./start.sh

Uso

React

import { useForgeLogs } from '@forgelogs/react';

function App() {
  useForgeLogs({
    applicationId: 'my-app',
    enabled: true,
    logTypes: ['ui', 'error', 'performance'],
    backendUrl: 'http://localhost:8002'
  });
  
  return <YourApp />;
}

Vanilla JavaScript

import { ForgeLogs } from '@forgelogs/vanilla';

const logger = new ForgeLogs({
  applicationId: 'my-app',
  backendUrl: 'http://localhost:8002'
});

logger.log('ui_snapshot', { /* data */ });

Dashboard

O ForgeLogs inclui um dashboard web para visualização de logs:

cd frontend
npm install
npm run dev

Acesse http://localhost:3002

Funcionalidades do Dashboard

• Dashboard: Visão geral com métricas e logs recentes
• Lista de Logs: Visualização completa com filtros por categoria, severidade, tipo
• Detalhes do Log: Visualização detalhada de cada log
• Analytics: Gráficos e análise com IA

Documentação

• Documentação Completa
• Guia de Integração
• Melhores Práticas
• Avaliação do Projeto

API

A API está disponível em http://localhost:8002/api/docs (Swagger UI)

Endpoints Principais

• GET /api/logs - Listar logs com filtros
• POST /api/logs - Criar log
• GET /api/logs/ui-issues - Listar problemas de UI
• GET /api/analytics - Estatísticas agregadas
• GET /api/analytics/ai-analysis - Análise com IA
• GET /api/health - Health check

Licença

MIT