# 📦 HS Data Collector - Guia de Instalação

## Bem-vindo! 👋

Este guia mostra como instalar o **HS Data Collector** na sua máquina. O processo é simples e leva apenas alguns minutos.

---

## ✅ Pré-requisitos

- **Windows 7 ou superior** (Windows 10/11 recomendado)
- **.NET 8 Runtime** (será instalado automaticamente se necessário)
- **Acesso à Internet** (para comunicação com a API)
- **Acesso ao seu banco de dados** (MySQL ou SQL Server)
- **Privilégios de Administrador** na máquina

---

## 📋 Informações que você vai precisar

Antes de começar, você deve ter recebido um **email com as seguintes informações**:

```
┌─────────────────────────────────────────────────────┐
│ INFORMAÇÕES DA API                                  │
├─────────────────────────────────────────────────────┤
│ URL da API:          https://...                    │
│ ID do Agente:        123                            │
│ Chave de API:        abc123xyz...                   │
└─────────────────────────────────────────────────────┘

┌─────────────────────────────────────────────────────┐
│ INFORMAÇÕES DO BANCO DE DADOS                       │
├─────────────────────────────────────────────────────┤
│ Tipo:                MySQL / SQL Server             │
│ Host/Servidor:       192.168.1.100                  │
│ Porta:               3306 / 1433                    │
│ Nome do Banco:       seu_banco                      │
│ Usuário:             seu_usuario                    │
│ Senha:               sua_senha                      │
└─────────────────────────────────────────────────────┘
```

**Se você não tem essas informações, entre em contato com o suporte HelloSales.**

---

## 🚀 Passo a Passo da Instalação

### Passo 1: Preparar os arquivos

1. Você deve ter recebido um arquivo chamado `hs-data-collector.zip`
2. **Descompacte** o arquivo em uma pasta (ex: `C:\HS Data Collector`)
3. Você verá uma estrutura assim:

```
hs-data-collector/
├── instalar.bat          ← Clique aqui para instalar!
├── installer.ps1         ← Script de instalação
├── publish/              ← Arquivos da aplicação
├── appsettings.json      ← Configuração
└── ... outros arquivos
```

### Passo 2: Executar o instalador

1. **Clique com botão direito** no arquivo `instalar.bat`
2. Selecione **"Executar como administrador"**
3. Clique em **"Sim"** quando perguntado sobre privilégios

### Passo 3: Preencher as informações

O instalador vai pedir as seguintes informações:

#### **Passo 1 de 4: Configuração da API**

```
URL da API [https://...]: <pressione ENTER ou digite a URL>
ID do Agente [0]: <digite o ID do seu agente>
Chave de API (API Key): <digite sua chave de API>
```

O instalador **validará automaticamente** suas credenciais. Se houver erro, você pode tentar novamente.

#### **Passo 2 de 4: Configuração do Banco de Dados**

```
Selecione o tipo de banco de dados:
1. MySQL
2. SQL Server

Escolha [1]: <digite 1 ou 2>
```

Depois preencha:
```
Host/Servidor do banco de dados [localhost]: <seu servidor>
Porta [3306]: <sua porta>
Nome do banco de dados: <seu banco>
Usuário do banco de dados: <seu usuário>
Senha do banco de dados: <sua senha>
```

O instalador **testará a conexão** automaticamente.

#### **Passo 3 de 4: Localização de Instalação**

```
Caminho de instalação [C:\Program Files\HS Data Collector]: <pressione ENTER>
```

Você pode deixar o padrão ou digitar outro caminho.

#### **Passo 4 de 4: Resumo e Confirmação**

O instalador mostrará um **resumo de tudo** que vai instalar:

```
Resumo das configurações:

API:
  URL: https://...
  ID do Agente: 123

Banco de Dados:
  Tipo: MySQL
  Host: 192.168.1.100
  Porta: 3306
  Base de Dados: seu_banco
  Usuário: seu_usuario

Instalação:
  Caminho: C:\Program Files\HS Data Collector

Deseja prosseguir com a instalação? (S/N): S
```

Verifique se tudo está correto e digite **S** para continuar.

### Passo 4: Aguarde a conclusão

O instalador vai:

1. ✅ Criar o diretório de instalação
2. ✅ Copiar os arquivos da aplicação
3. ✅ Criar o arquivo de configuração
4. ✅ Registrar como Windows Service
5. ✅ Iniciar o serviço automaticamente

Quando terminar, você verá:

```
╔════════════════════════════════════════════════════════════════╗
║ Instalação Concluída!                                          ║
╚════════════════════════════════════════════════════════════════╝

O HS Data Collector foi instalado com sucesso!
```

---

## ✨ Pronto! Agora o que?

Depois da instalação, o agente vai:

1. **Iniciar automaticamente** quando você reiniciar o computador
2. **Conectar à API** a cada 5 minutos
3. **Coletar dados** do seu banco de dados conforme solicitado
4. **Enviar os dados** para a HelloSales

---

## 🔍 Como verificar se está funcionando

### Opção 1: Verificar o Serviço (Mais fácil)

1. Pressione `Windows + R`
2. Digite: `services.msc`
3. Procure por **"HS Data Collector Agent"**
4. Deve estar com status **"Executando"** (verde)

### Opção 2: Verificar os Logs

1. Abra o Explorador de Arquivos
2. Vá para: `C:\Program Files\HS Data Collector\logs\`
3. Abra o arquivo mais recente (ex: `agent-2024-03-07.txt`)

---

## 📞 Precisa de Ajuda?

Se você encontrar problemas, entre em contato com o suporte HelloSales com:
- Mensagem de erro exata
- Seu ID de Agente
- Tipo de banco de dados (MySQL/SQL Server)

---

## 🎉 Parabéns!

Você instalou com sucesso o **HS Data Collector**! 

**Obrigado por usar HS Data Collector!** 💙
