# Manual de Instalação — Aviator Signals

Guia simples para instalar o sistema em um Mac novo. Sem conhecimento técnico obrigatório.

---

## O que você precisa antes

- Um Mac (qualquer modelo com macOS recente)
- Conexão com internet
- Conta ativa em uma casa de apostas que tenha Aviator da Spribe (ex: 7K.bet.br, Betano)
- O arquivo `aviator-signals.zip`

---

## Passo 1 — Descompactar o arquivo

1. Copie `aviator-signals.zip` pro seu Mac (AirDrop, pen drive, Google Drive, WhatsApp Web etc.)
2. **Dê dois cliques** no arquivo ZIP
3. Vai aparecer uma pasta chamada **aviator-signals** no mesmo lugar
4. Recomendação: arraste essa pasta pra sua pasta de **Documentos** ou **Área de Trabalho**

---

## Passo 2 — Abrir o Terminal

1. No seu Mac, aperte **Command (⌘) + Barra de espaço** pra abrir o Spotlight
2. Digite **Terminal** e aperte **Enter**
3. Vai abrir uma janela preta com texto

---

## Passo 3 — Entrar na pasta do sistema

No Terminal, **digite** (ou copie e cole):

```
cd ~/Documents/aviator-signals
```

> Se você colocou a pasta na Área de Trabalho, use: `cd ~/Desktop/aviator-signals`

Aperte **Enter**.

---

## Passo 4 — Rodar a instalação

No Terminal, digite e aperte Enter:

```
./install.sh
```

O que vai acontecer:

- Se for a **primeira vez**, o Mac pode pedir sua **senha de usuário** — é normal, digite a mesma senha que você usa pra desbloquear o Mac (não aparece enquanto digita, é normal)
- O script vai instalar sozinho:
  - **Homebrew** (gerenciador de programas do Mac) — pode demorar uns 3 minutos
  - **Python 3.12** (linguagem que o sistema usa)
  - **Brave Browser** (navegador usado pra acessar o jogo)
  - **Certificado de segurança** (pra conexão local criptografada)

Quando terminar, vai aparecer:

```
=== INSTALACAO CONCLUIDA ===
```

Se algo der errado, copie a mensagem de erro e pede ajuda.

---

## Passo 5 — Ligar o sistema

Ainda no Terminal, na mesma pasta, digite:

```
./start.sh
```

O que vai acontecer:

- **Brave Browser abre automaticamente** na página do 7K Aviator
- Backend do sistema sobe em segundo plano
- Você vê no Terminal a mensagem **"=== TUDO RODANDO ==="**

---

## Passo 6 — Usar pela primeira vez

1. No **Brave** que abriu, faça login normal na casa de apostas (email + senha)
2. Navegue até o Aviator (geralmente em Cassino → Spribe → Aviator)
3. Clique no botão verde **JOGAR**
4. Espere o jogo carregar (o avião aparece na tela)
5. Agora abra em qualquer navegador: **<https://localhost:8766/>**

> Na primeira vez o navegador vai reclamar de "conexão não segura" (por causa do certificado local). Clique em **Avançado** → **Continuar para localhost (não seguro)**. Só precisa fazer isso uma vez.

Pronto, o dashboard está no ar mostrando os dados ao vivo do Aviator.

---

## Passo 7 — Desligar quando acabar

No Terminal, digite:

```
./stop.sh
```

Ou simplesmente feche a janela do Terminal.

---

## Problemas comuns

**"command not found"** quando roda `./install.sh`
→ Você não entrou na pasta correta. Volte ao Passo 3 e confirme que está dentro de `aviator-signals`.

**Brave abre mas fica pedindo pra logar toda vez**
→ Normal. Faça login uma vez; a partir daí o Brave lembra a sessão.

**Dashboard em localhost:8766 não carrega**
→ Rode `./stop.sh` e depois `./start.sh` de novo. Espere uns 10 segundos antes de abrir.

**Preciso que o Mac execute comandos no Brave**
→ Na primeira execução o Mac pede permissão de Acessibilidade. Aceite o popup.
→ Se não aparecer: Preferências do Sistema → Privacidade e Segurança → Acessibilidade → marque Terminal e Brave Browser.

**"No jogo" mas o scanner não pega os crashes**
→ Certifique-se que você clicou em **JOGAR** (o avião vermelho precisa estar visível na tela, não só a página de aposta).

---

## Dia a dia

Depois de instalado, o uso normal é só:

1. Abrir Terminal
2. `cd ~/Documents/aviator-signals`
3. `./start.sh`
4. Logar no Brave (se precisar) → JOGAR
5. Abrir o dashboard e acompanhar
6. No fim: `./stop.sh`

---

## Importante — Aviso legal

- Auto-click viola os Termos de Serviço da maioria das casas de apostas
- O risco de banimento da conta é real; use por sua conta e risco
- Os sinais do sistema são heurísticos e **não-preditivos** — o Aviator é provably-fair, não dá pra prever matematicamente
- Este sistema é para estudo e observação pessoal
