# 🎯 Como Criar e Usar seu Primeiro Repositório

## 📦 Passo 1: Criar Repositório no Gitea

1. Acesse: https://meurepositorio.com
2. Faça login com sua conta de administrador
3. Clique no **"+"** (canto superior direito)
4. Selecione **"Novo Repositório"**
5. Preencha:
   - **Nome**: `scripts-servidor` (ou qualquer nome)
   - **Descrição**: `Scripts e configurações do servidor`
   - **Visibilidade**: Privado (recomendado)
   - **Initialize Repository**: ✓ Marque "Initialize repository"
   - **Add .gitignore**: Nenhum (ou escolha se quiser)
   - **Add License**: Nenhum (ou escolha se quiser)
6. Clique em **"Criar Repositório"**

---

## 🔗 Passo 2: Clonar no Cursor (HTTPS)

### No seu computador (onde está o Cursor):

1. Abra o Cursor
2. Pressione `Ctrl+Shift+P` (Windows/Linux) ou `Cmd+Shift+P` (Mac)
3. Digite: `Git: Clone`
4. Cole a URL: `https://meurepositorio.com/seuusuario/scripts-servidor.git`
   (substitua `seuusuario` pelo seu username do Gitea)
5. Escolha uma pasta no seu computador
6. Digite seu **usuário** e **senha** do Gitea quando solicitado
7. Clique em **"Open"** quando perguntar se quer abrir o repositório

**Pronto!** Você está conectado! 🎉

---

## 📝 Passo 3: Fazer seu Primeiro Commit

No Cursor:

1. Crie um arquivo: `README.md`
2. Escreva algo, por exemplo:
   ```markdown
   # Scripts do Servidor
   
   Configurações e scripts do meu servidor
   ```
3. Salve o arquivo (`Ctrl+S`)
4. Abra o painel Git: `Ctrl+Shift+G`
5. Você verá o arquivo `README.md` em "Changes"
6. Clique no **+** ao lado do arquivo (stage)
7. Digite uma mensagem: `"Primeiro commit"`
8. Clique no **✓** (commit)
9. Clique nos **...** → **Push**

**Sucesso!** Seu código está no Gitea! 🚀

---

## 💾 Salvar Credenciais (Não Pedir Senha Toda Vez)

### No terminal do seu computador (onde está o Cursor):

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

# Mac
git config --global credential.helper osxkeychain

# Linux
git config --global credential.helper store
```

Na próxima vez que fizer push/pull, digite usuário e senha UMA VEZ.
Depois disso, ficará salvo automaticamente!

---

## 📚 Repositórios Sugeridos para Organizar

### 1. **scripts-servidor**
   - Scripts de gerenciamento
   - Configurações
   - Backups
   - Tudo que fizemos hoje!

### 2. **projetos-web**
   - Sites e aplicações web
   - Frontend e backend

### 3. **estudos**
   - Códigos de estudo
   - Tutoriais
   - Experimentos

### 4. **automacao**
   - Scripts de automação
   - Cron jobs
   - Monitores

---

## 🔄 Workflow Diário

```bash
# 1. Abrir projeto no Cursor
code /caminho/do/projeto

# 2. Fazer mudanças nos arquivos
# (edite normalmente)

# 3. Ver mudanças
Ctrl+Shift+G

# 4. Stage arquivos
Clique no + ao lado dos arquivos

# 5. Commit
Digite mensagem e clique no ✓

# 6. Push para Gitea
Clique em ... → Push
```

---

## 🎯 Vantagens do Seu Gitea

✅ **Privado**: Ninguém vê seus códigos  
✅ **Ilimitado**: Repos e tamanho sem limites  
✅ **Rápido**: Na sua rede local  
✅ **Seu**: Você controla tudo  
✅ **Grátis**: Sem mensalidades  

---

## 🆘 Problemas Comuns

### ❌ "Authentication failed"
**Solução**: Verifique usuário e senha. No Gitea, vá em Settings → Applications → Generate New Token (e use o token no lugar da senha)

### ❌ "Could not resolve host"
**Solução**: Adicione no arquivo hosts do seu computador:
```
# Windows: C:\Windows\System32\drivers\etc\hosts
# Linux/Mac: /etc/hosts

187.102.179.100 meurepositorio.com
```

### ❌ "SSL certificate problem"
**Solução**: O certificado é válido, mas se der problema:
```bash
git config --global http.sslVerify true
```

---

**Seu Gitea está pronto para usar! Comece criando seu primeiro repositório!** 🚀