# Configuração do Google Sheets

Este projeto está configurado para ler dados diretamente do Google Sheets como banco de dados.

## Estrutura do Google Sheets

Cada área (Comercial, Suporte, Financeiro, Retenção) possui seu próprio Google Sheets com as seguintes colunas obrigatórias:

| Coluna | Tipo | Exemplo | Descrição |
|--------|------|---------|-----------|
| Data | Data | 2024-06-11 | Data do atendimento (formato YYYY-MM-DD) |
| Vendedor | Texto | João Silva | Nome do atendente/vendedor |
| Causa | Texto | Dúvida Produto | Motivo do atendimento |
| Cliente | Texto | Maria Santos | Nome do cliente |
| Satisfação | Texto | Satisfeito | "Satisfeito" ou "Insatisfeito" |
| SLA | Texto | Cumprido | "Cumprido" ou "Descumprido" |
| Nota Final | Número | 4.5 | Nota de 0 a 5 |
| Tempo Resposta (min) | Número | 15 | Tempo em minutos |

## Configuração

### 1. Criar os Google Sheets

Para cada área, crie um novo Google Sheets no Google Drive com as colunas acima.

### 2. Atualizar o config em GoogleSheetsService.php

Edite `/src/Services/GoogleSheetsService.php` e atualize os IDs:

```php
private static array $sheetsConfig = [
    'Comercial' => [
        'spreadsheet_id' => '1EOIsS9nTd0ShVyb1v0m3X-Ntu3qgrN0x_psAXjbe6K0',  // ID do seu Sheets
        'sheet_name' => 'Dados Comercial',  // Nome da aba
        'sheet_gid' => '691939062'  // ID da aba (visível na URL)
    ],
    'Suporte' => [...],
    'Financeiro' => [...],
    'Retenção' => [...]
];
```

### 3. Compartilhar os Sheets

**Cada Google Sheets deve estar com acesso público (Anyone with the link)** para que o PHP consiga acessá-lo via API pública.

**Passos:**
1. Abra o Google Sheets
2. Clique em "Compartilhar"
3. Selecione "Qualquer pessoa com o link"
4. Escolha "Visualizador"
5. Copie o link

## Como obter o ID da planilha

A URL de um Google Sheets tem este formato:
```
https://docs.google.com/spreadsheets/d/[SPREADSHEET_ID]/edit?gid=[SHEET_GID]
```

- **SPREADSHEET_ID**: A parte longa entre `/d/` e `/edit`
- **SHEET_GID**: O número após `gid=` (se não houver, é `0`)

## Exemplo de dados

```
Data          | Vendedor       | Causa            | Cliente      | Satisfação  | SLA       | Nota Final | Tempo Resposta (min)
2024-06-11    | João Silva     | Dúvida Produto   | Maria Santos | Satisfeito  | Cumprido  | 4.5        | 12
2024-06-11    | Ana Costa      | Reclamação       | Pedro Lima   | Satisfeito  | Cumprido  | 5.0        | 8
2024-06-10    | João Silva     | Sugestão         | Carlos Oliveira | Insatisfeito | Descumprido | 3.0 | 25
```

## Como usar

1. A dashboard carrega os dados automaticamente ao acessar a página
2. Os filtros (datas, vendedor, causa) funcionam em tempo real
3. O botão "Planilha" na navbar leva direto ao Google Sheets para edição
4. Os dados são lidos cada vez que a página carrega (sem cache)

## Notas Importantes

- O acesso é **público e somente leitura** via API
- Os dados não são sincronizados em tempo real, mas recarregados a cada page load
- Mudanças no Google Sheets aparecem na dashboard após refresh
- Nomes das colunas **devem ser exatamente como especificado** (case-sensitive)
- Colunas vazias são ignoradas