# ✅ INSTRUÇÕES CORRETAS - Convex Local (Não Cloud!)

**IMPORTANTE:** Este projeto usa **Convex Local** (rodando no seu computador), não o Convex Cloud!

---

## 🎯 RESUMO - O QUE VOCÊ PRECISA FAZER

Você tem **2 opções simples**:

### **OPÇÃO 1: Script Automático (Mais Fácil) ⭐ RECOMENDADO**

```powershell
# Execute este comando:
cd packages\backend
.\CRIAR_ENV.bat
```

O script vai:
- ✅ Criar o arquivo `.env` automaticamente
- ✅ Adicionar as variáveis necessárias
- ✅ Configurar o `.gitignore`
- ✅ Mostrar próximos passos

**Tempo:** 30 segundos

---

### **OPÇÃO 2: Manual (Mais Controle)**

#### **Passo 1: Criar arquivo `.env`**

Crie o arquivo `packages/backend/.env` com este conteúdo:

```env
# Segurança Better Auth
BETTER_AUTH_SECRET=+Nfg4jTxPv1giF5MlmyYTxpU/VkS3QaDOvgSWd+QmbY=

# URL da aplicação
SITE_URL=http://localhost:5173
```

#### **Passo 2: Reiniciar servidores**

```powershell
# Terminal 1 - Convex
cd packages\backend
bunx convex dev

# Terminal 2 - Web (em outro terminal)
cd apps\web
bun run dev
```

**Tempo:** 2 minutos

---

## 📊 ANTES E DEPOIS

### ❌ ANTES (agora - com erros):
```
[ERROR] You are using the default secret. 
Please set `BETTER_AUTH_SECRET` in your environment variables
[WARN] Better Auth baseURL is undefined
```

### ✅ DEPOIS (após configurar):
```
✔ Convex dev server running
✔ Functions ready!
```

---

## 🔍 POR QUE MINHA PRIMEIRA INSTRUÇÃO ESTAVA ERRADA

### ❌ Instrução Errada (ignorar!):
- Pedia para configurar no "Convex Dashboard" online
- Isso só funciona para projetos no **Convex Cloud**
- Seu projeto roda **localmente**

### ✅ Instrução Correta (seguir!):
- Criar arquivo `.env` no seu computador
- O arquivo fica em `packages/backend/.env`
- Convex Local lê automaticamente este arquivo

---

## 📁 ESTRUTURA CORRETA

```
sgse-app/
└── packages/
    └── backend/
        ├── convex/
        │   ├── auth.ts       ✅ (já preparado)
        │   └── ...
        ├── .env              ✅ (você vai criar)
        ├── .gitignore        ✅ (já existe)
        └── CRIAR_ENV.bat     ✅ (script criado)
```

---

## 🚀 COMEÇAR AGORA (GUIA RÁPIDO)

### **Método Rápido (30 segundos):**

1. Abra PowerShell
2. Execute:
   ```powershell
   cd "C:\Users\Deyvison\OneDrive\Desktop\Secretária de Esportes\Tecnologia da Informação\SGSE\sgse-app\packages\backend"
   .\CRIAR_ENV.bat
   ```
3. Siga as instruções na tela
4. Pronto! ✅

---

## 🔒 SEGURANÇA

### **Para Desenvolvimento (agora):**
✅ Use o secret gerado: `+Nfg4jTxPv1giF5MlmyYTxpU/VkS3QaDOvgSWd+QmbY=`

### **Para Produção (futuro):**
⚠️ Você **DEVE** gerar um **NOVO** secret diferente!

**Como gerar novo secret:**
```powershell
$bytes = New-Object byte[] 32
(New-Object Security.Cryptography.RNGCryptoServiceProvider).GetBytes($bytes)
[Convert]::ToBase64String($bytes)
```

---

## ✅ CHECKLIST RÁPIDO

- [ ] Executei `CRIAR_ENV.bat` OU criei `.env` manualmente
- [ ] Arquivo `.env` está em `packages/backend/`
- [ ] Reiniciei o Convex (`bunx convex dev`)
- [ ] Reiniciei o Web (`bun run dev` em outro terminal)
- [ ] Mensagens de erro pararam ✅

---

## 🆘 PROBLEMAS?

### **"Erro persiste após criar .env"**
1. Pare o Convex completamente (Ctrl+C)
2. Aguarde 5 segundos
3. Inicie novamente

### **"Não encontro o arquivo .env"**
- Ele começa com ponto (`.env`)
- Pode estar oculto no Windows
- Verifique em: `packages/backend/.env`

### **"Script não executa"**
```powershell
# Se der erro de permissão, tente:
Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass
.\CRIAR_ENV.bat
```

---

## 📞 PRÓXIMOS PASSOS

### **Agora:**
1. Execute `CRIAR_ENV.bat` ou crie `.env` manualmente
2. Reinicie os servidores
3. Verifique que erros pararam

### **Quando for para produção:**
1. Gere novo secret para produção
2. Crie `.env` no servidor com valores de produção
3. Configure `SITE_URL` com URL real

---

## 📚 ARQUIVOS DE REFERÊNCIA

| Arquivo | Quando Usar |
|---------|-------------|
| `INSTRUCOES_CORRETAS.md` | **ESTE ARQUIVO** - Comece aqui! |
| `CONFIGURAR_LOCAL.md` | Guia detalhado passo a passo |
| `packages/backend/CRIAR_ENV.bat` | Script automático |

**❌ IGNORE ESTES (instruções antigas para Cloud):**
- `CONFIGURAR_AGORA.md` (instruções para Convex Cloud)
- `PASSO_A_PASSO_CONFIGURACAO.md` (instruções para Convex Cloud)

---

## 🎉 RESUMO FINAL

**O que houve:**
- Primeira instrução assumiu Convex Cloud (errado)
- Seu projeto usa Convex Local (correto)
- Solução mudou de "Dashboard online" para "arquivo .env local"

**O que fazer:**
1. Execute `CRIAR_ENV.bat` (30 segundos)
2. Reinicie servidores (1 minuto)
3. Pronto! Sistema seguro ✅

---

**Tempo total:** 2 minutos  
**Dificuldade:** ⭐ Muito Fácil  
**Status:** Pronto para executar agora! 🚀