# Changelog

Todas as alterações notáveis neste projecto serão documentadas neste ficheiro.

## [2.0.0] - 2026-02-04

### Added

#### API Node.js/Express Completa
- ✅ Servidor Express em `/api/server.ts`
- ✅ Connection pool MySQL em `/api/db.ts`
- ✅ Proxy Vite configurado (`/api` → `http://localhost:3001`)

#### Serviços
- ✅ **Google Calendar API** (`/api/services/calendar.ts`)
  - Integração com calendários pessoal e profissional
  - Eventos de hoje e da semana
  - OAuth2 configurado com refresh token

- ✅ **Dashboard Queries** (`/api/services/dashboard.ts`)
  - Tasks: urgente, alta prioridade, vencidas, em testes, esta semana
  - Monday Mood (tag especial #67)
  - Tickets abertos
  - Leads: contactar, followup, proposta
  - Projectos activos
  - Timesheet semanal (staff_id=1)
  - Billing 360 (clientes com horas facturadas vs entregues)
  - Pipeline completo (leads, estimates, proposals)

- ✅ **Monitoring Queries** (`/api/services/monitoring.ts`)
  - Query à tabela `tbl_eal_monitoring`
  - Summary por categoria
  - Status geral (ok/warning/critical)

#### Endpoints
- ✅ `GET /api/dashboard` - Dashboard completo
- ✅ `GET /api/monitor` - Monitorização de sistemas
- ✅ `GET /api/health` - Health check

#### Frontend
- ✅ `App.tsx` actualizado para usar `/api/dashboard` (linha 425)
- ✅ Fallback para dados mock em caso de erro (desenvolvimento)

#### Infraestrutura
- ✅ Scripts npm:
  - `npm run dev` - Vite + API em paralelo (concurrently)
  - `npm run dev:api` - API apenas (tsx watch)
  - `npm run dev:ui` - Vite apenas
  - `npm start` - Produção (serve API + static build)

#### Dependências Adicionadas
- `express` ^4.19.2
- `cors` ^2.8.5
- `mysql2` ^3.11.5
- `googleapis` ^144.0.0
- `concurrently` ^9.1.2 (dev)
- `tsx` ^4.19.2 (dev)
- `@types/express` ^5.0.0 (dev)
- `@types/cors` ^2.8.17 (dev)

#### Documentação
- ✅ `api/README.md` - Documentação completa da API
- ✅ `.env.example` - Template de configuração

### Changed

- Título da tarefa #1556: "Dashboard Descomplicar - Dados Reais e API"
- `vite.config.ts` - Adicionado proxy para `/api`
- `package.json` - Nome alterado para `dash-descomplicar`

### Migrated

Toda a lógica do PHP (`plan-eal.descomplicar.pt`) migrada para TypeScript:

#### De `index.php`:
- ✅ Google Calendar API (pessoal + profissional)
- ✅ Todas as queries à BD Desk CRM
- ✅ Billing 360 (horas facturadas vs entregues)
- ✅ Pipeline de vendas
- ✅ Cálculo de timesheet semanal
- ✅ Monday Mood (tarefas com tag especial)

#### De `monitor.php`:
- ✅ Query à `tbl_eal_monitoring`
- ✅ Organização por categoria
- ✅ Cálculo de status geral

### Technical Notes

#### Semana: Segunda a Domingo
- Função `getWeekRange()` calcula início da semana (segunda-feira)
- Timesheet usa UNIX timestamp para compatibilidade com dados antigos

#### Billing 360
- Calcula horas entregues de `tbltaskstimers`
- Compara com horas facturadas de `billing_360_invoices`
- Status: `credit` (>5h crédito), `debt` (<-5h débito), `ok` (entre -5 e +5)

#### Pipeline
- Agrega leads por fase (`tblleads_status`)
- Inclui estimates (status 2=Enviado, 3=Visto)
- Inclui proposals (status 4)
- Valor total calculado em SQL

#### Performance
- Queries em paralelo com `Promise.all()`
- Connection pool MySQL (10 conexões)
- Vite proxy em dev (zero CORS issues)

### Pending

- [ ] Sistema de autenticação (JWT ou sessões)
- [ ] Deploy em produção (EasyPanel)
- [ ] Configurar variáveis de ambiente em produção
- [ ] Testar Google Calendar OAuth refresh

### Breaking Changes

- ❌ PHP backend descontinuado (`plan-eal.descomplicar.pt` será apagado)
- ✅ Nova API Node.js/Express em `/api`
- ✅ React dashboard em `dash.descomplicar.pt`

---

## [1.0.0] - 2026-02-03

### Added
- Dashboard React inicial com Vite + TypeScript
- UI com Tailwind CSS 4 + Framer Motion
- Design system: Glassmorphism + Bento Grid
- Componentes: HeroStat, GlassCard, ProgressRing, Sparkline
- Dados mock para demonstração
- Autenticação Authentik (OIDC) configurada
- Deploy EasyPanel em `dash.descomplicar.pt`

### Note
Versão inicial com dados mock. API implementada na v2.0.0.