# GitHub + Deploy Automático — Guia Completo

Configura o fluxo:

```
PC (Claude Code)  →  git push  →  GitHub  →  HostGator atualiza automaticamente
```

Tempo estimado: **30–40 minutos** na primeira vez.

---

## Visão geral da arquitetura

```
┌─────────────────────────────────────────────────────────────────┐
│  Sua máquina                                                     │
│  $ git push origin main                                          │
└──────────────────────────────┬──────────────────────────────────┘
                               │ HTTPS
                               ▼
┌─────────────────────────────────────────────────────────────────┐
│  GitHub (repo privado)                                           │
│  → Recebe o push                                                 │
│  → Dispara GitHub Actions                                        │
│     └─ usa SSH_PRIVATE_KEY para conectar no HostGator            │
└──────────────────────────────┬──────────────────────────────────┘
                               │ SSH (porta 2222)
                               │ usando a chave de deploy
                               ▼
┌─────────────────────────────────────────────────────────────────┐
│  HostGator                                                       │
│  → git fetch origin main  (autentica via Deploy Key)            │
│  → git reset --hard origin/main                                  │
│  → composer install --no-dev                                     │
│  → chmod uploads/ logs/                                          │
└─────────────────────────────────────────────────────────────────┘
```

**Dois pares de chaves SSH:**

| Chave | De → Para | Finalidade |
|-------|-----------|------------|
| **Actions Key** | GitHub Actions → HostGator | Permite que o Actions execute comandos no servidor |
| **Deploy Key** | HostGator → GitHub | Permite que o servidor faça `git pull` do repositório privado |

---

## Passo 1 — Criar o repositório no GitHub

1. Acesse [github.com](https://github.com) → **New repository**
2. Preencha:
   - **Repository name:** `vf-portal`
   - **Visibility:** `Private` ✅ (obrigatório — contém estrutura sensível)
   - **Initialize repository:** deixe **desmarcado** (você vai fazer o push do código local)
3. Clique em **Create repository**
4. Copie a URL SSH do repositório: `git@github.com:SEU_USUARIO/vf-portal.git`

---

## Passo 2 — Gerar a chave de Deploy (HostGator → GitHub)

Esta chave permite que o HostGator faça `git pull` do seu repositório privado.
Gere-a **diretamente no HostGator via SSH**.

### 2.1 Conectar no HostGator via SSH

```bash
# No seu PC — terminal local
ssh mikafo61@mikafolica.com.br
# Digite a senha quando solicitado
```

> Se não conseguir via terminal, use cPanel → **Terminal** (aba lateral esquerda no cPanel).

### 2.2 Gerar a chave no servidor

```bash
# No HostGator (já conectado via SSH)
ssh-keygen -t ed25519 -f ~/.ssh/github_deploy -N "" -C "vfportal-hostgator-deploy"
```

Isso cria dois arquivos:
- `~/.ssh/github_deploy` → chave **privada** (fica no servidor, nunca sai)
- `~/.ssh/github_deploy.pub` → chave **pública** (vai para o GitHub)

### 2.3 Copiar a chave pública

```bash
cat ~/.ssh/github_deploy.pub
```

Copie o conteúdo completo (começa com `ssh-ed25519 AAAA...`).

### 2.4 Adicionar a Deploy Key no GitHub

1. No GitHub → repositório `vf-portal` → **Settings** → **Deploy keys**
2. Clique em **Add deploy key**
3. **Title:** `HostGator Production`
4. **Key:** cole a chave pública copiada acima
5. **Allow write access:** deixe **desmarcado** (somente leitura é suficiente)
6. Clique em **Add key**

### 2.5 Configurar o SSH no HostGator para usar essa chave com o GitHub

```bash
# Ainda no HostGator via SSH
cat >> ~/.ssh/config << 'EOF'
Host github.com
    HostName github.com
    User git
    IdentityFile ~/.ssh/github_deploy
    StrictHostKeyChecking no
EOF

chmod 600 ~/.ssh/config
```

### 2.6 Testar a conexão HostGator → GitHub

```bash
ssh -T git@github.com
# Resposta esperada:
# Hi SEU_USUARIO/vf-portal! You've successfully authenticated, but GitHub does not provide shell access.
```

---

## Passo 3 — Fazer o primeiro push do código

Execute **no seu PC**, dentro da pasta `vf-portal`:

```bash
cd C:/users/ferna/projetos/vf-portal

# Inicializar o repositório Git
git init
git branch -M main

# Adicionar o remote (use a URL SSH do repositório criado no Passo 1)
git remote add origin git@github.com:SEU_USUARIO/vf-portal.git

# Adicionar todos os arquivos (o .gitignore já exclui .env, vendor/, uploads/, logs/*)
git add .

# Verificar o que vai ser commitado (opcional, mas recomendado na primeira vez)
git status

# Criar o primeiro commit
git commit -m "chore: initial commit — VF Portal com SSO, RBAC e apps"

# Enviar para o GitHub
git push -u origin main
```

> **Pré-requisito:** sua máquina precisa estar autenticada no GitHub.
> Se não estiver, configure com:
> ```bash
> # Opção A: GitHub CLI (mais simples)
> gh auth login
>
> # Opção B: SSH key no GitHub
> # Gere uma chave no PC: ssh-keygen -t ed25519 -C "seu@email.com"
> # Adicione em: GitHub → Settings → SSH and GPG keys → New SSH key
> ```

---

## Passo 4 — Clonar o repositório no HostGator

Após o primeiro push, clone o repositório no servidor (substitua pela sua URL):

```bash
# No HostGator via SSH
cd /home2/mikafo61/public_html

git clone git@github.com:SEU_USUARIO/vf-portal.git vf-portal

# Verificar que o clone funcionou
ls vf-portal/
```

> Se você já fez upload manual dos arquivos, inicialize o git no lugar:
> ```bash
> cd /home2/mikafo61/public_html/vf-portal
> git init
> git remote add origin git@github.com:SEU_USUARIO/vf-portal.git
> git fetch origin main
> git reset --hard origin/main
> ```

---

## Passo 5 — Gerar a chave de Actions (GitHub → HostGator)

Esta chave permite que o GitHub Actions faça SSH no HostGator.
Gere-a **no seu PC** (não no servidor).

### 5.1 Gerar a chave

```bash
# No seu PC — terminal local (fora da pasta do projeto)
cd ~
ssh-keygen -t ed25519 -f github_actions_key -N "" -C "github-actions-vfportal"
```

Isso cria:
- `~/github_actions_key` → chave **privada** (vai para o GitHub Secrets)
- `~/github_actions_key.pub` → chave **pública** (vai para o HostGator)

### 5.2 Adicionar a chave pública no HostGator

```bash
# Copie o conteúdo da chave pública
cat ~/github_actions_key.pub
```

Cole no HostGator:

```bash
# No HostGator via SSH
echo "COLE_O_CONTEUDO_DA_CHAVE_PUBLICA_AQUI" >> ~/.ssh/authorized_keys
chmod 600 ~/.ssh/authorized_keys
```

> **Alternativa via cPanel:** cPanel → **SSH Access** → **Manage SSH Keys** →
> **Import Key** → cole a chave pública → **Import**.
> Depois clique em **Manage** ao lado da chave e **Authorize**.

### 5.3 Copiar o conteúdo da chave privada

```bash
cat ~/github_actions_key
# Copie TUDO, incluindo as linhas -----BEGIN... e -----END...
```

---

## Passo 6 — Configurar os Secrets no GitHub

Os Secrets são variáveis criptografadas que o GitHub Actions usa durante o deploy.

Acesse: GitHub → repositório `vf-portal` → **Settings** → **Secrets and variables** → **Actions** → **New repository secret**

Adicione os seguintes secrets:

| Secret | Valor | Como obter |
|--------|-------|------------|
| `SSH_HOST` | `mikafolica.com.br` | Domínio ou IP do servidor |
| `SSH_USER` | `mikafo61` | Seu usuário cPanel |
| `SSH_PORT` | `22` | Porta SSH (padrão HostGator é 22) |
| `SSH_PRIVATE_KEY` | Conteúdo de `~/github_actions_key` | Passo 5.3 acima |

**Como adicionar cada secret:**
1. Clique em **New repository secret**
2. **Name:** nome exato da tabela acima (ex: `SSH_HOST`)
3. **Secret:** valor correspondente
4. Clique em **Add secret**

> **Descobrir a porta SSH do HostGator:**
> cPanel → **SSH Access** → a porta aparece nas instruções de conexão.
> Se não aparecer, tente 22. Alguns planos usam 2222 — teste com:
> `ssh -p 2222 mikafo61@mikafolica.com.br`

---

## Passo 7 — Testar o deploy automático

### 7.1 Trigger manual (primeiro teste)

1. GitHub → repositório `vf-portal` → aba **Actions**
2. No menu lateral esquerdo, clique em **🚀 Deploy VF Portal**
3. Clique em **Run workflow** → **Run workflow** (botão verde)
4. Acompanhe a execução em tempo real

**O que deve acontecer:**
- Step "🚀 Deploy via SSH" executa em 30–60 segundos
- Logs mostram o commit hash e "✅ Deploy concluído com sucesso!"
- O sumário do workflow exibe a tabela com commit, autor e data

### 7.2 Testar o fluxo completo

```bash
# No seu PC, dentro de vf-portal/
# Faça uma mudança pequena em qualquer arquivo
echo "# teste" >> README.md

git add README.md
git commit -m "test: verificando deploy automático"
git push
```

1. Vá para GitHub → **Actions**
2. Veja o workflow sendo disparado automaticamente
3. Aguarde ~60 segundos
4. Confirme que o arquivo mudou no HostGator:
   ```bash
   # No HostGator via SSH
   cat /home2/mikafo61/public_html/vf-portal/README.md
   # Deve mostrar "# teste" no final
   ```

### 7.3 Verificar logs de deploy

No GitHub Actions, cada execução mostra:
- **Status:** ✅ ou ❌
- **Logs completos** por step (clique no step para expandir)
- **Sumário** com commit, autor, data e link

---

## Rotina diária de desenvolvimento

Após a configuração, o fluxo de trabalho é:

```bash
# 1. Desenvolver normalmente (Claude Code modifica os arquivos)

# 2. Ver o que mudou
git status
git diff

# 3. Commitar as mudanças
git add .
git commit -m "feat: descrição do que foi feito"

# 4. Enviar — deploy acontece automaticamente em ~60s
git push
```

### Boas práticas de commit

```bash
# Tipos de commit (use o prefixo adequado)
git commit -m "feat: nova funcionalidade no painel Emil"
git commit -m "fix: corrige SQL injection em salvar_motivo.php"
git commit -m "chore: atualiza migration 008"
git commit -m "style: redesign dashboard Mika"
git commit -m "refactor: separa auth.php em funções menores"
git commit -m "docs: atualiza DEPLOY_HOSTGATOR.md"
```

---

## Troubleshooting

### Deploy falha com "Permission denied (publickey)"

```
# O GitHub Actions não consegue conectar no HostGator
```

**Verificar:**
```bash
# No HostGator
cat ~/.ssh/authorized_keys
# A chave pública de ~/github_actions_key.pub deve estar aqui

chmod 700 ~/.ssh
chmod 600 ~/.ssh/authorized_keys
```

---

### Deploy falha com "git: command not found"

O Git não está no PATH do usuário SSH.

```bash
# No HostGator, verificar onde está o git
which git
# Provavelmente: /usr/bin/git ou /usr/local/bin/git

# Se não encontrar, use o caminho completo no deploy.yml:
# Troque "git fetch origin main" por "/usr/bin/git fetch origin main"
```

---

### Deploy falha com "ssh -T git@github.com" retornando erro

A Deploy Key não foi configurada corretamente.

```bash
# No HostGator, testar com verbose
ssh -vT git@github.com 2>&1 | grep -E "(identity|auth|success|denied)"

# Verificar se a chave certa está sendo usada
cat ~/.ssh/config
# Deve mostrar IdentityFile ~/.ssh/github_deploy
```

---

### "Host key verification failed"

```bash
# No HostGator, adicionar o GitHub ao known_hosts
ssh-keyscan github.com >> ~/.ssh/known_hosts
chmod 644 ~/.ssh/known_hosts
```

---

### "composer: command not found" no deploy

```bash
# No HostGator, encontrar o Composer
which composer
# ou
ls ~/composer.phar

# Se for ~/composer.phar, edite o deploy.yml:
# Troque "composer install ..." por "php ~/composer.phar install ..."
```

---

### Porta SSH do HostGator diferente de 22

```bash
# Teste com porta 2222 (comum em alguns planos HostGator)
ssh -p 2222 mikafo61@mikafolica.com.br

# Se funcionar, mude o secret SSH_PORT para 2222
```

---

## Configuração opcional: notificação Discord

Para receber notificações de deploy no Discord:

1. Discord → Configurações do servidor → Integrações → Webhooks → Novo Webhook
2. Copie a URL do webhook
3. GitHub → Settings → Secrets → New secret:
   - **Name:** `DISCORD_WEBHOOK`
   - **Secret:** URL copiada
4. No `deploy.yml`, descomente o step "Notificar Discord"

---

## Referência rápida

```bash
# ── No seu PC ──────────────────────────────────────────────────────
git status                          # Ver arquivos modificados
git log --oneline -10               # Ver últimos commits
git push                            # Deploy automático

# ── No HostGator (via SSH) ─────────────────────────────────────────
cd /home2/mikafo61/public_html/vf-portal
git log --oneline -5                # Ver commits no servidor
git status                          # Confirmar que está limpo
tail -20 ../logs/error_log          # Logs de erro do Apache

# ── No GitHub ──────────────────────────────────────────────────────
# Acompanhar deploys:  repo → Actions
# Ver secrets:         repo → Settings → Secrets and variables → Actions
# Deploy Keys:         repo → Settings → Deploy keys
```
