Git + GitHub

Guia de apresentação para equipe Webinar 45 min 2 partes

O que é Git 5 min

Git é um sistema de controle de versão distribuído — um software que rastreia todas as mudanças feitas em um conjunto de arquivos ao longo do tempo, permitindo voltar a qualquer versão anterior e colaborar com outras pessoas sem sobrescrever o trabalho de ninguém.

A origem — 2005

O problema que Git resolve

Distribuído vs Centralizado

Como o versionamento realmente funciona 5 min

A maioria dos VCS armazena diferenças (diffs) entre versões. Git funciona de forma radicalmente diferente: armazena snapshots completos do projeto a cada commit.

Snapshots vs Diffs

SHA-1 — Endereçamento por conteúdo

Cada objeto no Git tem um identificador único: o hash SHA-1 do seu conteúdo. Isso significa que dois arquivos com conteúdo idêntico sempre terão o mesmo hash — Git os armazena apenas uma vez (deduplicação automática). Se o hash bate, o conteúdo é garantidamente idêntico.

copy# Git calcula SHA-1 de cada objeto antes de armazenar
echo "hello" | git hash-object --stdin
# → ce013625030ba8dba906f756967f9e9ca394464a

# Cada commit, tree e blob tem um SHA único
git log --oneline
# a3f9c2e feat: adiciona autenticação
# 7b14d01 fix: corrige validação de email
# 9a2c88f chore: setup inicial do projeto

Modelo de Objetos do Git 5 min

Git é, na essência, um banco de dados de chave-valor endereçado por conteúdo. Armazena quatro tipos de objeto — juntos, eles representam todo o histórico do projeto.

Estrutura de Armazenamento 5 min

Git divide o trabalho em três zonas distintas. Entender onde cada mudança está é fundamental para usar Git com precisão.

Ciclo de vida de um arquivo

copy# Ver estado atual
git status

# Adicionar arquivo específico ao stage
git add src/auth.js

# Adicionar partes específicas de um arquivo (interativo)
git add -p src/auth.js

# Ver o que está staged (será commitado)
git diff --staged

# Ver o que está modificado mas ainda não staged
git diff

# Criar o commit
git commit -m "feat: adiciona autenticação JWT"

# Atalho: add + commit de todos os rastreados
git commit -am "fix: corrige validação de email"

Ciclo de Vida do Código 6 min

Branch — um ponteiro leve

Um branch no Git é apenas um arquivo de texto contendo 41 bytes — o SHA-1 do commit que ele aponta. Criar um branch é instantâneo e não duplica nada. HEAD é um ponteiro especial que indica qual branch está ativo no momento.

copy# Criar e mudar para novo branch
git switch -c feature/autenticacao     # Git 2.23+ (recomendado)
git checkout -b feature/autenticacao   # forma clássica

# Ver todos os branches
git branch -a

# Visualizar o grafo de commits
git log --oneline --decorate --graph --all

Commit — snapshot identificado

Um commit é uma fotografia completa do projeto naquele momento, identificada por um SHA-1 único. Contém: referência à tree raiz (o diretório do projeto), referência ao(s) commit(s) pai(s) — formando a cadeia de histórico — autor, timestamp e mensagem.

Cadeia de pais — o que é o histórico

Todo commit aponta para o commit anterior (seu "pai"). Essa cadeia é o histórico. Git não guarda diffs — guarda snapshots. Diff é calculado comparando o snapshot do commit com o snapshot do pai.

copyA ← B ← C ← D  (HEAD)
# D tem pai C · C tem pai B · B tem pai A
# A não tem pai → primeiro commit do repo

Merge commit tem 2 pais. O objeto armazena ambas as referências SHA:

copytree  abc123
parent f1e2d3    ← pai 1 (branch atual)
parent 9a8b7c    ← pai 2 (branch mergeada)

# git log --graph mostra:
* D (merge)  — pai1=B, pai2=C
|\
| * C  — pai=A
* | B  — pai=A
|/
* A

Durante conflitos de merge, Git disponibiliza as três versões:

copygit show :1:arquivo  # ancestral comum (base)
git show :2:arquivo  # versão pai 1
git show :3:arquivo  # versão pai 2

copy# Boas mensagens de commit (Conventional Commits)
git commit -m "feat: adiciona login com Google OAuth"
git commit -m "fix: corrige timeout na chamada de API"
git commit -m "docs: atualiza README com instruções de setup"
git commit -m "refactor: extrai lógica de validação para helper"

# Ver detalhes de um commit
git show a3f9c2e

# Histórico com estatísticas
git log --stat --oneline

Merge — integrando branches

Git tem duas estratégias principais de merge, dependendo da situação:

main:     A ─ B ─ C
feature:          C ─ D ─ E
# após merge → main aponta para E

main:    A ─ B ─ C ─────── M
feature:         └─ D ─ E ─┘

Conflitos de merge

Quando dois branches modificam as mesmas linhas do mesmo arquivo, Git não sabe qual versão preservar e pausa o processo com marcadores de conflito:

copy<<<<<<< HEAD (sua versão)
  return user.authenticate(token)
=======
  return user.validateToken(token, options)
>>>>>>> feature/auth (versão sendo mergeada)

# 1. Editar o arquivo — remover marcadores, escolher (ou combinar) versões
# 2. Marcar como resolvido
git add src/auth.js
# 3. Finalizar o merge
git commit

Merge vs Rebase 4 min

Ambos integram mudanças de um branch em outro. A diferença está em como o histórico é escrito.

main:    A ─ B ─ C ─── M
feature:         └─ D ─┘
# M tem dois pais: C e D

antes:   main: A ─ B ─ C
         feat: B ─ D
após:    main: A ─ B ─ C ─ D'
# D' é D reescrito sobre C

copy# Fluxo típico com rebase (atualizar feature antes do PR)
git switch feature/auth
git fetch origin
git rebase origin/main    # replay dos commits da feature sobre o main atual

# Se conflito:
# 1. resolver conflito
git add arquivo-resolvido
git rebase --continue     # continua para o próximo commit
# ou
git rebase --abort        # desiste do rebase

# Merge final (no GitHub isso vira PR)
git switch main
git merge feature/auth    # agora é fast-forward, sem merge commit

Worktree — múltiplos checkouts 3 min

git worktree permite ter múltiplos diretórios de trabalho ativos ao mesmo tempo, todos conectados ao mesmo repositório Git (.git/). Você pode ter dois branches abertos em diretórios separados, sem stash, sem clonar novamente.

Quando usar

Você está no meio de uma feature. Chega um bug crítico em produção. Sem worktree, precisaria de stash ou de um clone separado:

copy# Criar um worktree para o hotfix em um diretório separado
git worktree add ../hotfix-1234 main

# Agora você tem:
# ~/projeto/          → sua feature em andamento (intacta)
# ~/hotfix-1234/      → branch main, para corrigir o bug

# Depois de corrigir e commitar no hotfix-1234:
git worktree remove ../hotfix-1234

# Listar todos os worktrees ativos
git worktree list

# Criar worktree com branch novo
git worktree add -b fix/login-timeout ../fix-login main

Resumo dos Comandos Principais 3 min

O que é GitHub 3 min

GitHub é uma plataforma de hospedagem de repositórios Git na nuvem, combinada com ferramentas de colaboração, automação e gerenciamento de projeto. É o maior host de código do mundo: mais de 100 milhões de desenvolvedores e mais de 420 milhões de repositórios.

Git resolve o controle de versão local e distribuído. GitHub resolve a camada de colaboração: onde o código vive na nuvem, como pessoas trabalham juntas, como mudanças são revisadas antes de entrar no projeto, como automações são disparadas.

Integração Git ↔ GitHub 3 min

Configurar o remote

copy# Ligar repositório local ao GitHub (novo repo)
git remote add origin git@github.com:usuario/repo.git

# Verificar remotes
git remote -v

# Enviar branch pela primeira vez
git push -u origin main        # -u define upstream (lembra o tracking)

# Próximos pushes nesse branch
git push

# Baixar mudanças sem integrar (recomendado)
git fetch origin
git merge origin/main          # ou: git rebase origin/main

# Atalho: fetch + merge/rebase
git pull --rebase origin main

SSH vs HTTPS

copy# Gerar chave SSH
ssh-keygen -t ed25519 -C "seu@email.com"

# Exibir chave pública (colar no GitHub → Settings → SSH keys)
cat ~/.ssh/id_ed25519.pub

# Testar conexão
ssh -T git@github.com
# → Hi usuario! You've successfully authenticated.

Vantagens da Integração 2 min

Recursos do GitHub 5 min

Branch Protection — configurações principais

CODEOWNERS — exemplo

copy# .github/CODEOWNERS
# Última regra que corresponde tem precedência

*                     @org/equipe-geral        # qualquer arquivo
*.js *.ts             @fulano @ciclana          # arquivos JS/TS
/docs/                @org/equipe-docs          # pasta docs
src/auth/             @org/equipe-seguranca     # autenticação
.github/CODEOWNERS    @org/admin                # o próprio CODEOWNERS

Code Review Workflow 4 min

O workflow de code review no GitHub é construído ao redor dos Pull Requests. É o processo que garante que código seja revisado, discutido e aprovado antes de entrar no branch principal.

Tipos de Review

Estratégias de Merge no PR

GitHub CLI 3 min

gh é a CLI oficial do GitHub. Permite interagir com Issues, PRs, repos e Actions diretamente do terminal, sem abrir o browser.

copy# Instalar (Debian/Ubuntu)
sudo apt install gh

# Autenticar (abre browser)
gh auth login

# Verificar autenticação
gh auth status

Repositórios

Issues

Pull Requests

copy# Fluxo completo com gh CLI
git switch -c feature/nova-autenticacao
# ... commits ...
gh pr create --title "feat: nova autenticação OAuth" \
             --body "Implementa login com Google. Fecha #38." \
             --assignee @me \
             --label "feature"

# Outro desenvolvedor revisa:
gh pr checkout 22
gh pr review 22 --approve --body "LGTM, excelente trabalho"

# Merge após aprovações
gh pr merge 22 --squash --delete-branch