# šŸ“‹ Passo a Passo - Configuração Completa ## āœ… Passo 1: Configurar VAPID Keys ### 1.1 Configurar no Convex (Backend) **Opção A: Via Dashboard (Recomendado)** 1. Acesse https://dashboard.convex.dev 2. Selecione seu projeto 3. VĆ” em **Settings** > **Environment Variables** 4. Adicione as seguintes variĆ”veis: ``` VAPID_PUBLIC_KEY=BDerX0lK_hBCLpC7EbuxoJb2EJ7bcCLaHWxkNumVbvrx9w0MmJduHxJOP3WBwBP-SpQGcueMOyHCv7LFK3KnQks VAPID_PRIVATE_KEY=KWkJLMxCuCPQQiRXIJEt06G4pTdW0FaUN_vMyY02sc4 FRONTEND_URL=http://localhost:5173 ``` **Opção B: Via CLI** Execute do diretório raiz do projeto: ```powershell cd packages/backend npx convex env set VAPID_PUBLIC_KEY "BDerX0lK_hBCLpC7EbuxoJb2EJ7bcCLaHWxkNumVbvrx9w0MmJduHxJOP3WBwBP-SpQGcueMOyHCv7LFK3KnQks" npx convex env set VAPID_PRIVATE_KEY "KWkJLMxCuCPQQiRXIJEt06G4pTdW0FaUN_vMyY02sc4" npx convex env set FRONTEND_URL "http://localhost:5173" ``` **Opção C: Usar Script AutomĆ”tico** Execute na raiz do projeto: ```powershell .\scripts\configurar-push-notifications.ps1 ``` ### 1.2 Configurar no Frontend Crie o arquivo `apps/web/.env` com: ```env VITE_VAPID_PUBLIC_KEY=BDerX0lK_hBCLpC7EbuxoJb2EJ7bcCLaHWxkNumVbvrx9w0MmJduHxJOP3WBwBP-SpQGcueMOyHCv7LFK3KnQks ``` **Importante**: Reinicie o servidor frontend após criar/modificar o `.env` ## āœ… Passo 2: Configurar FRONTEND_URL A variĆ”vel `FRONTEND_URL` jĆ” foi configurada no Passo 1.1. Ela Ć© usada nos templates de email para gerar links de volta ao sistema. **Para Desenvolvimento:** ``` FRONTEND_URL=http://localhost:5173 ``` **Para Produção (quando fizer deploy):** ``` FRONTEND_URL=https://seu-dominio.com ``` ## āœ… Passo 3: Testar Funcionalidades ### 3.1 Verificar Configuração Inicial 1. **Inicie o Convex** (se nĆ£o estiver rodando): ```bash cd packages/backend bun run dev ``` 2. **Inicie o Frontend** (se nĆ£o estiver rodando): ```bash cd apps/web bun run dev ``` 3. **Verifique as variĆ”veis de ambiente**: - No Convex Dashboard: Settings > Environment Variables - No Frontend: Verifique se `apps/web/.env` existe ### 3.2 Testar Push Notifications 1. Abra `http://localhost:5173` no navegador 2. FaƧa login no sistema 3. Abra DevTools (F12) > **Application** > **Service Workers** 4. āœ… Verifique se `sw.js` estĆ” registrado 5. āœ… Verifique se a permissĆ£o de notificaƧƵes foi solicitada ### 3.3 Testar Chat Completo Siga o guia completo em `GUIA_TESTE_PUSH_NOTIFICATIONS.md` para testar: - āœ… Push notifications - āœ… Edição de mensagens - āœ… Soft delete - āœ… Respostas encadeadas - āœ… Preview de links - āœ… Busca full-text ## šŸ” Verificação RĆ”pida Execute estes comandos para verificar: ### Verificar VariĆ”veis no Convex: ```bash cd packages/backend npx convex env list ``` Deve mostrar: - `VAPID_PUBLIC_KEY` - `VAPID_PRIVATE_KEY` - `FRONTEND_URL` ### Verificar Frontend: ```bash cd apps/web # Verifique se o arquivo .env existe cat .env ``` ## šŸ› Troubleshooting ### Problema: VariĆ”veis nĆ£o aparecem no Convex **Solução**: - Certifique-se de estar no projeto correto no dashboard - Reinicie o servidor Convex após configurar - Use `npx convex env list` para verificar ### Problema: Frontend nĆ£o encontra VAPID_PUBLIC_KEY **Solução**: - Verifique se o arquivo `.env` estĆ” em `apps/web/.env` - Verifique se a variĆ”vel comeƧa com `VITE_` - Reinicie o servidor frontend - Limpe o cache do navegador ### Problema: Service Worker nĆ£o registra **Solução**: - Verifique se `apps/web/static/sw.js` existe - Abra DevTools > Application > Service Workers - Clique em "Unregister" e recarregue a pĆ”gina - Verifique o console para erros ## šŸ“ Checklist Final - [ ] VAPID keys configuradas no Convex - [ ] FRONTEND_URL configurada no Convex - [ ] VITE_VAPID_PUBLIC_KEY no `.env` do frontend - [ ] Convex rodando - [ ] Frontend rodando - [ ] Service Worker registrado - [ ] PermissĆ£o de notificaƧƵes concedida - [ ] Push notifications funcionando - [ ] Todas as funcionalidades testadas ## šŸŽ‰ Pronto! Após completar os 3 passos, o sistema estarĆ” totalmente configurado e pronto para uso!