# 📊 Como Acessar os Relatórios de Viagens

## 🚀 Formas de Acesso

### 1. **Pelo Dashboard Principal** (`dashboard.html`)
- Na seção **"Ações Rápidas"**
- Clique no card **"Relatórios"** (ícone de gráfico amarelo)
- Será redirecionado para `relatorios-viagens.html`

### 2. **Pelo Menu Lateral** (`index.html`)
- No menu lateral esquerdo
- Clique em **"Relatórios de Viagens"** (ícone de gráfico)
- Acesso direto à tela completa

### 3. **Pela Tela de Cadastros** (`cadastros.html`)
- No menu superior
- Botão verde **"Relatórios"** (ícone de linha)
- Acesso rápido sem voltar ao dashboard

### 4. **Acesso Direto via URL**
```
http://seudominio.com/backend-php/admin/relatorios-viagens.html
```

### 5. **Versão de Teste/Demo**
```
http://seudominio.com/backend-php/admin/teste-relatorios.html
```

### 6. **Versão Offline (Emergência)**
```
http://seudominio.com/backend-php/admin/relatorios-viagens-offline.html
```
> ⚡ **Funciona mesmo sem internet** - Dados simulados localmente

## 🎯 URLs das APIs

### 🚀 APIs Principais (Recomendadas - Sem Autenticação):
```
GET /backend-php/api/relatorios/viagens-simples.php
GET /backend-php/api/relatorios/opcoes-filtros-simples.php
GET /backend-php/api/relatorios/teste-conexao.php
```

### 🔐 APIs Completas (Com Autenticação):
```
GET /backend-php/api/relatorios/viagens.php
GET /backend-php/api/relatorios/opcoes-filtros.php
```

**Parâmetros disponíveis:**
- `periodo` - hoje, semana, mes, trimestre, ano
- `data_inicio` - YYYY-MM-DD
- `data_fim` - YYYY-MM-DD
- `tecnico_id` - ID do técnico
- `veiculo_id` - ID do veículo
- `status` - em_andamento, finalizada
- `cliente` - Nome do cliente (busca parcial)
- `agrupamento` - hora, dia, semana, mes

## 🔑 Requisitos de Acesso

- ✅ **Autenticação obrigatória** (Admin ou Supervisor)
- ✅ **Navegador moderno** (Chrome, Firefox, Safari, Edge)
- ✅ **JavaScript habilitado**
- ✅ **Conexão com internet** (para CDNs do Bootstrap e Chart.js)

## 📱 Compatibilidade

- ✅ **Desktop** - Experiência completa
- ✅ **Tablet** - Layout responsivo
- ✅ **Mobile** - Gráficos adaptados

## 🛠️ Funcionalidades Disponíveis

### Navegação:
- [x] **Botão Voltar** - Retorna à página anterior ou dashboard
- [x] Links de acesso rápido em múltiplas telas

### Filtros:
- [x] Período predefinido
- [x] Datas personalizadas
- [x] Filtro por técnico
- [x] Filtro por veículo
- [x] Filtro por status
- [x] Busca por cliente

### Visualizações:
- [x] Cards de estatísticas
- [x] Gráfico de linha (viagens por período)
- [x] Gráfico de pizza (status)
- [x] Gráfico de barras (top técnicos)
- [x] Gráfico de barras (KM por veículo)
- [x] Tabela completa de viagens
- [x] Cards de performance dos técnicos

### Exportação:
- [ ] Excel (em desenvolvimento)
- [ ] PDF (em desenvolvimento)

## 🎨 Interface

A tela utiliza:
- **Bootstrap 5** - Framework CSS
- **Font Awesome 6** - Ícones
- **Chart.js** - Gráficos interativos
- **Gradientes modernos** - Visual atrativo
- **Responsividade** - Mobile-friendly

## 🔄 Atualização em Tempo Real

Os dados são carregados via API e podem ser atualizados:
- Automaticamente ao aplicar filtros
- Manualmente com botão "Atualizar"
- Reagindo a mudanças nos filtros

---

## 📋 Exemplo de Uso

1. Acesse `dashboard.html`
2. Clique em "Relatórios" (card amarelo)
3. Use os filtros para personalizar a consulta
4. Visualize gráficos e estatísticas
5. Analise a lista detalhada de viagens
6. Compare performance dos técnicos

**🎯 A tela está 100% funcional e pronta para uso!** 
