# 🎯 Como Usar seu Gitea com o Cursor

Seu repositório Gitea funciona **exatamente como GitHub** com o Cursor!

---

## 📋 Pré-requisitos

1. ✅ Gitea configurado (você já tem!)
2. ✅ Conta de usuário criada no Gitea
3. ✅ Cursor instalado no seu computador

---

## 🚀 Método 1: Clone via HTTPS (Mais Fácil)

### Passo 1: Criar repositório no Gitea

1. Acesse: `https://meurepositorio.com`
2. Faça login
3. Clique no **"+"** (canto superior direito)
4. Selecione **"New Repository"**
5. Preencha:
   - Nome: `meu-projeto`
   - Descrição: (opcional)
   - Privado ou Público
6. Clique em **"Create Repository"**

### Passo 2: Clonar no Cursor

**No Cursor:**

1. Pressione `Ctrl+Shift+P` (ou `Cmd+Shift+P` no Mac)
2. Digite: `Git: Clone`
3. Cole a URL: `https://meurepositorio.com/seuusuario/meu-projeto.git`
4. Escolha a pasta onde clonar
5. Digite seu **usuário** e **senha** do Gitea

Pronto! Seu repositório está clonado e pronto para usar no Cursor! 🎉

### Comandos Git no Cursor

Depois de clonar, você pode usar Git normalmente:

- **Commit**: `Ctrl+Shift+G` → Digite mensagem → Clique no ✓
- **Push**: Clique nos `...` → `Push`
- **Pull**: Clique nos `...` → `Pull`
- **Criar Branch**: Canto inferior esquerdo → Clique no nome da branch

---

## 🔐 Método 2: Clone via SSH (Recomendado para Uso Frequente)

Mais seguro e não precisa digitar senha toda vez!

### Passo 1: Gerar chave SSH (se ainda não tem)

**No seu computador:**

```bash
# Linux/Mac/Windows (Git Bash)
ssh-keygen -t ed25519 -C "seu-email@example.com"

# Pressione Enter para aceitar o local padrão
# Pressione Enter para senha vazia (ou defina uma)
```

### Passo 2: Copiar a chave pública

```bash
# Linux/Mac
cat ~/.ssh/id_ed25519.pub

# Windows (PowerShell)
type $env:USERPROFILE\.ssh\id_ed25519.pub

# Windows (Git Bash)
cat ~/.ssh/id_ed25519.pub
```

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

### Passo 3: Adicionar no Gitea

1. Acesse: `https://meurepositorio.com`
2. Faça login
3. Clique no **avatar** (canto superior direito) → **Settings**
4. No menu lateral: **SSH / GPG Keys**
5. Clique em **Add Key**
6. Cole a chave pública
7. Dê um nome (ex: "Meu Computador")
8. Clique em **Add Key**

### Passo 4: Clonar via SSH

**No Cursor:**

1. Pressione `Ctrl+Shift+P` (ou `Cmd+Shift+P`)
2. Digite: `Git: Clone`
3. Cole a URL SSH: `ssh://git@meurepositorio.com:222/seuusuario/meu-projeto.git`
   
   ⚠️ **Importante**: Note a porta **222** (não é 22!)

4. Escolha a pasta
5. Não vai pedir senha! 🎉

---

## 📦 Método 3: Publicar Projeto Existente do Cursor

Você já tem um projeto no Cursor e quer colocar no Gitea?

### Passo 1: Criar repositório vazio no Gitea

1. Acesse o Gitea
2. Crie um novo repositório
3. **Importante**: NÃO marque "Initialize repository"
4. Copie a URL que aparecer

### Passo 2: No Cursor

Abra o terminal integrado (`Ctrl+``) e execute:

```bash
# Inicializar Git (se ainda não tem)
git init

# Adicionar seus arquivos
git add .

# Primeiro commit
git commit -m "Primeiro commit"

# Adicionar o remote do Gitea
git remote add origin https://meurepositorio.com/seuusuario/meu-projeto.git

# OU via SSH:
git remote add origin ssh://git@meurepositorio.com:222/seuusuario/meu-projeto.git

# Push para o Gitea
git push -u origin master
```

Digite usuário e senha quando solicitado (se HTTPS).

---

## 🔄 Workflow Diário no Cursor

### Fazer mudanças e enviar:

1. **Edite arquivos** normalmente no Cursor
2. **Ver mudanças**: `Ctrl+Shift+G`
3. **Stage arquivos**: Clique no `+` ao lado dos arquivos
4. **Commit**: Digite mensagem e clique no ✓
5. **Push**: Clique nos `...` → `Push`

### Baixar mudanças do servidor:

1. Clique nos `...` → `Pull`

### Criar branch:

1. Canto inferior esquerdo → Nome da branch
2. `+ Create new branch...`
3. Digite o nome
4. Push: `...` → `Publish Branch`

---

## ⚙️ Configurações Úteis no Cursor

### Salvar credenciais (HTTPS)

Para não digitar senha toda vez:

```bash
# Linux/Mac
git config --global credential.helper store

# Windows
git config --global credential.helper wincred
```

Na primeira vez que fizer push/pull, digite usuário e senha.
Depois disso, ficará salvo!

### Configurar Git

```bash
# Seu nome
git config --global user.name "Seu Nome"

# Seu email
git config --global user.email "seu-email@example.com"
```

---

## 🎨 Extensões Úteis do Cursor para Git

O Cursor já vem com Git integrado, mas você pode instalar:

- **GitLens**: Visualização avançada de histórico
- **Git Graph**: Ver árvore de commits visual
- **Git History**: Ver histórico de arquivos

---

## 🔍 Troubleshooting

### ❌ "Could not resolve host"

**Problema**: DNS não resolve `meurepositorio.com`

**Solução**: Aguarde propagação DNS ou adicione no arquivo hosts:

```bash
# Linux/Mac: /etc/hosts
# Windows: C:\Windows\System32\drivers\etc\hosts

187.102.179.100 meurepositorio.com
```

### ❌ "SSL certificate problem"

**Problema**: Certificado SSL não confiável

**Solução temporária** (apenas para teste):
```bash
git config --global http.sslVerify false
```

**Solução correta**: Aguarde certificado SSL ser reconhecido ou importe o certificado.

### ❌ "Connection timeout" (SSH)

**Problema**: Porta SSH não acessível

**Lembre-se**: O Gitea usa porta **222**, não 22!

URL SSH correta:
```
ssh://git@meurepositorio.com:222/usuario/repo.git
```

### ❌ "Permission denied (publickey)"

**Problema**: Chave SSH não configurada

**Solução**: 
1. Verifique se a chave está no Gitea (Settings → SSH Keys)
2. Teste conexão: `ssh -p 222 git@meurepositorio.com`

---

## 📚 URLs do Seu Gitea

### Clone HTTPS:
```
https://meurepositorio.com/seuusuario/seurepositorio.git
```

### Clone SSH:
```
ssh://git@meurepositorio.com:222/seuusuario/seurepositorio.git
```

### Web:
```
https://meurepositorio.com
```

---

## 🎯 Exemplo Completo: Criar e Usar Repositório

```bash
# 1. Criar pasta do projeto
mkdir meu-projeto
cd meu-projeto

# 2. Inicializar Git
git init

# 3. Criar arquivo
echo "# Meu Projeto" > README.md

# 4. Primeiro commit
git add .
git commit -m "Initial commit"

# 5. Conectar com Gitea (criar repo vazio lá primeiro!)
git remote add origin https://meurepositorio.com/seuusuario/meu-projeto.git

# 6. Push
git push -u origin master

# 7. Abrir no Cursor
code .
```

Pronto! Agora você pode trabalhar normalmente no Cursor! 🚀

---

## 💡 Dicas Profissionais

1. **Use SSH**: Mais seguro e rápido
2. **Commits frequentes**: Pequenos e descritivos
3. **Branches**: Use branches para features
4. **Pull antes de Push**: Evita conflitos
5. **.gitignore**: Não commite arquivos desnecessários
6. **Backup**: Seu Gitea é o backup, mas faça backup do servidor também!

---

## 🎉 Vantagens do Seu Gitea Privado

✅ **Privacidade total**: Seus códigos não saem do seu servidor  
✅ **Sem limites**: Repos ilimitados, tamanho ilimitado  
✅ **Controle total**: Você decide as regras  
✅ **Grátis**: Sem mensalidades  
✅ **Rápido**: Na sua rede local  

---

**Seu repositório Git privado está pronto para ser usado com o Cursor!** 🚀