Files
DashDescomplicar/api
Emanuel Almeida 36a26dac53 security: complete Fase 3 - all medium-severity vulnerabilities fixed
MEDIUM-SEVERITY FIXES (Fase 3 complete):

1. Mock Data em Produção (Vulnerabilidade 3.2) 
   - Mock data apenas em desenvolvimento (import.meta.env.DEV)
   - Produção mostra erro claro com retry button
   - Estado de erro com UI profissional

2. Connection Pool Timeouts (Vulnerabilidade 3.3) 
   - JÁ CORRIGIDO em commit anterior (20c16ab)
   - connectTimeout: 10s, acquireTimeout: 15s, timeout: 30s

3. Tipo 'any' em Catch Blocks (Vulnerabilidade 3.4) 
   - TODOS os ficheiros corrigidos (10/10)
   - catch (error: unknown) em vez de catch (error)
   - Type guards: error instanceof Error
   - Mensagens seguras sem vazamento de stack trace
   - Ficheiros: routes/*.ts, services/*.ts, middleware/validation.ts

4. APIs Sem Autenticação Backend (Vulnerabilidade 3.5) 
   - JÁ IMPLEMENTADO em commit anterior (f175682)
   - OIDC opcional via OIDC_ENABLED=true

5. Algoritmos SSH Legacy (Vulnerabilidade 3.6) 
   - Adicionados: curve25519-sha256, curve25519-sha256@libssh.org
   - Removidos: diffie-hellman-group14-sha1 (legacy)
   - Removidos: diffie-hellman-group1-sha1 (INSEGURO)
   - Apenas SHA256+ algorithms mantidos

6. Configuração OIDC (Vulnerabilidade 3.1) 
   - JÁ IMPLEMENTADO em commit anterior (f175682)
   - OIDC completamente funcional (opcional)

FILES CHANGED:
- src/App.tsx - Error state + mock data apenas em dev
- api/routes/*.ts - Tipos unknown em todos os catch blocks
- api/services/*.ts - Tipos unknown em todos os catch blocks
- api/middleware/validation.ts - Tipo correto (error.issues)
- api/services/server-metrics.ts - Algoritmos SSH modernos

BUILD STATUS:
- TypeScript:  PASSED
- npm run build:  SUCCESS
- npm audit:  0 vulnerabilities

PROGRESS:
- Phase 1 (Critical): 3/3  COMPLETE
- Phase 2 (High): 6/6  COMPLETE
- Phase 3 (Medium): 6/6  COMPLETE
- Phase 4 (Low): 0/5 - Next

Related: AUDIT-REPORT.md vulnerabilities 3.1, 3.2, 3.3, 3.4, 3.5, 3.6

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-02-14 04:20:37 +00:00
..

Dashboard Descomplicar API

API Node.js/Express com queries diretas à BD Desk CRM.

Estrutura

api/
├── server.ts          # Express server
├── db.ts              # MySQL connection pool
├── services/
│   ├── calendar.ts    # Google Calendar API
│   ├── dashboard.ts   # Dashboard queries
│   └── monitoring.ts  # Monitoring queries
└── routes/
    ├── dashboard.ts   # GET /api/dashboard
    └── monitor.ts     # GET /api/monitor

Endpoints

GET /api/dashboard

Retorna dados do dashboard principal:

  • Tarefas (urgente, alta, vencidas, testes, semana)
  • Tickets abertos
  • Leads (contactar, followup, proposta)
  • Projectos activos
  • Timesheet semanal
  • Billing 360
  • Pipeline de vendas
  • Eventos Google Calendar (hoje + semana)

GET /api/monitor

Retorna status de monitorização:

  • Servidores (CPU, RAM, Disco)
  • Serviços web
  • Sites WordPress
  • Containers Docker

GET /api/health

Health check endpoint

Setup

  1. Instalar dependências:
npm install
  1. Configurar .env:
cp .env.example .env
# Editar .env com credenciais correctas
  1. Desenvolvimento:
npm run dev       # Vite + API (ambos)
npm run dev:api   # API apenas
npm run dev:ui    # Vite apenas
  1. Produção:
npm run build
npm start

Queries Migradas do PHP

Todas as queries do index.php e monitor.php foram migradas para TypeScript:

  • Tasks (urgente, alta, vencidas, testes, semana, monday mood)
  • Tickets
  • Leads (contactar, followup, proposta)
  • Projectos
  • Timesheet semanal
  • Billing 360
  • Pipeline (leads, estimates, proposals)
  • Google Calendar (eventos pessoais + profissionais)
  • Monitorização (tbl_eal_monitoring)

BD Necessárias

  • ealmeida_desk24 (BD principal Perfex CRM)
  • Tabelas Perfex: tbltasks, tblleads, tblprojects, tbltickets, etc.
  • Tabelas custom: billing_360_clients, billing_360_invoices, tbl_eal_monitoring

Google Calendar API

Credenciais OAuth2 configuradas em services/calendar.ts:

  • Client ID
  • Client Secret
  • Refresh Token

Calendários:

  • primary - Eventos pessoais
  • emanuel@descomplicar.pt - Eventos profissionais