215 lines
4.8 KiB
Markdown
215 lines
4.8 KiB
Markdown
# ✅ 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! 🚀
|
|
|