Hub 360 Bug Tracker

Stack Tecnologica

Estrutura de Arquivos

hub360-bugs/
-- Paginas
  src/app/page.tsx              # Redirect -> /login
  src/app/login/page.tsx        # Tela de login
  src/app/dashboard/page.tsx    # Dashboard principal
  src/app/report/[slug]/page.tsx # Form publico de report

-- API Routes
  src/app/api/auth/route.ts          # Autenticacao
  src/app/api/bugs/route.ts          # Listar / criar bugs
  src/app/api/bugs/[id]/route.ts     # Detalhe / atualizar bug
  src/app/api/bugs/[id]/notes/route.ts # Notas internas
  src/app/api/upload/route.ts        # Upload de arquivos

-- Componentes
  src/components/BugDrawer.tsx    # Drawer de detalhes
  src/components/StatusBadge.tsx  # Badge de status
  src/components/SeverityBadge.tsx # Badge de severidade

-- Libs
  src/lib/auth.ts              # Helpers de auth (client)
  src/lib/supabase-browser.ts  # Client Supabase (browser)
  src/lib/supabase-server.ts   # Client Supabase (server)
  src/lib/utils.ts             # Utilitarios
  src/types/index.ts           # Tipos TypeScript

-- Database
  setup-db.sql                 # Schema SQL completo
  seed.mjs                     # Dados de seed
  supabase/config.toml         # Config Supabase CLI

-- Testes
  tests/app.spec.ts            # 64 testes Playwright
  playwright.config.ts         # Config Playwright

Login

Tela de autenticacao para membros da equipe. Valida credenciais via Supabase Auth e armazena sessao no localStorage.

Credenciais de Teste

Fluxo

Dashboard

Painel principal autenticado para visualizacao e gestao de bugs. Requer login.

Funcionalidades

Status Disponiveis

Severidades

Formulario de Report

Formulario publico acessivel via /report/[slug]. Qualquer usuario pode reportar bugs sem precisar de login.

Campos do Formulario

Recursos

• Auto-save no localStorage a cada 500ms
• Deteccao automatica de dispositivo (Android, iOS, Desktop)
• Protecao contra duplicatas (idempotency key com janela de 5min)
• Rate limiting: 10 envios por hora por IP
• Tela de sucesso com numero do bug

Projetos de Teste

API Reference

Todas as rotas de API estao em /api/*. Rotas autenticadas requerem header Authorization: Bearer <token>.

{
  "email": "admin@hub360.com.br",
  "password": "Hub360@2025"
}

{
  "success": true,
  "session": {
    "access_token": "eyJhbGci...",
    "refresh_token": "...",
    "expires_at": 1234567890
  },
  "user": {
    "id": "uuid",
    "email": "admin@hub360.com.br",
    "team_member": { /* TeamMember object */ }
  }
}

{
  "bugs": [
    {
      "id": "uuid",
      "number": 1,
      "title": "Botao nao responde",
      "status": "new",
      "severity": "critical",
      "created_at": "2025-03-18T...",
      "project": { "name": "AZ-IB" },
      "assignee": { "name": "Ana Souza" }
    }
  ],
  "total": 50,
  "page": 1,
  "page_size": 30,
  "total_pages": 2
}

{
  "project_slug": "az-ib",
  "title": "Botao de login nao funciona",
  "where_found": "Tela de login > Botao Entrar",
  "steps_taken": "Abri o app, digitei email...",
  "expected_behavior": "Login bem-sucedido",
  "actual_behavior": "Nada acontece",
  "severity": "high",
  "device_info": "Samsung Galaxy A34 / Android 14",
  "reporter_name": "Joao",
  "reporter_email": "joao@email.com",
  "attachment_paths": [
    { "path": "az-ib/123-foto.png", "name": "foto.png", "type": "image/png", "size": 102400 }
  ]
}

{
  "success": true,
  "bug": { "id": "uuid", "number": 42 },
  "duplicate": false
}

{
  "id": "uuid",
  "number": 1,
  "title": "Botao nao responde",
  "status": "new",
  "severity": "critical",
  "version": 2,
  "where_found": "...",
  "steps_taken": "...",
  "expected_behavior": "...",
  "actual_behavior": "...",
  "project": { "name": "AZ-IB" },
  "assignee": { "name": "Ana Souza" },
  "attachments": [{ "file_name": "foto.png", "url": "https://signed..." }],
  "notes": [{ "content": "Investigando...", "author": {} }],
  "audit_log": [{ "action": "status_changed", "old_value": "new", "new_value": "analyzing" }]
}

{
  "status": "analyzing",
  "assigned_to": "uuid-do-membro",
  "version": 2  // para optimistic locking
}

{
  "content": "Investigando o problema. Parece ser memory leak."
}

{
  "success": true,
  "note": {
    "id": "uuid",
    "content": "Investigando o problema...",
    "author": { "name": "Ana Souza" }
  }
}

Banco de Dados

PostgreSQL via Supabase com Row Level Security, triggers automaticos e indices otimizados.

Seguranca

Fluxo de Autenticacao

Cada requisicao autenticada envia Authorization: Bearer <access_token>. O server valida via supabase.auth.getUser(token).

Rate Limiting

• 10 submissoes por hora por IP
• Rastreado por IP + endpoint na tabela rate_limits
• Auto-limpeza de registros com mais de 1 hora
• Retorna 429 Too Many Requests quando excedido

Protecao Anti-Duplicata

• Hash gerado com: project_id + titulo + passos + IP + janela de 5 minutos
• Constraint UNIQUE na coluna idempotency_key
• Retorna o bug existente se duplicata detectada

Optimistic Locking

• Campo version em cada bug
• PATCH envia version atual do cliente
• Se versao no banco diferir, retorna 409 Conflict
• Incrementa automaticamente via trigger

Headers de Seguranca

Testes

64 testes E2E com Playwright cobrindo toda a aplicacao.

Cobertura

Dados de Seed

O script seed.mjs popula o banco com dados de teste realistas.

Usuarios

Projetos

Inclui 12 bugs de exemplo com severidades e status variados, e 4 notas internas de amostra.

Variaveis de Ambiente

Crie um arquivo .env.local na raiz do projeto:

NEXT_PUBLIC_SUPABASE_URL=https://seu-projeto.supabase.co
NEXT_PUBLIC_SUPABASE_ANON_KEY=eyJhbGci...
SUPABASE_SERVICE_ROLE_KEY=eyJhbGci...