212 lines
6.4 KiB
Markdown
212 lines
6.4 KiB
Markdown
# 🔧 INSTRUÇÕES FINAIS - Sistema de Parcelas
|
||
|
||
## ⚠️ PROBLEMA IDENTIFICADO
|
||
|
||
Mesmo com o banco de dados correto, a interface não está atualizando por causa de **CACHE DO NAVEGADOR**.
|
||
|
||
---
|
||
|
||
## ✅ SOLUÇÃO DEFINITIVA (Passo a Passo)
|
||
|
||
### 1️⃣ **No Navegador - LIMPAR CACHE COMPLETO**
|
||
|
||
**Opção A - Limpar Cache:**
|
||
```
|
||
1. Pressione F12 (Abrir DevTools)
|
||
2. Clique com BOTÃO DIREITO no ícone de atualizar 🔄
|
||
3. Selecione "Esvaziar cache e forçar atualização"
|
||
```
|
||
|
||
**Opção B - Aba Anônima:**
|
||
```
|
||
1. Pressione Ctrl + Shift + N (Chrome)
|
||
2. Abra http://localhost:3000
|
||
3. Teste lá (sem cache)
|
||
```
|
||
|
||
**Opção C - Limpar Manualmente:**
|
||
```
|
||
1. Pressione Ctrl + Shift + Delete
|
||
2. Marque "Imagens e arquivos em cache"
|
||
3. Marque "Dados de sites hospedados"
|
||
4. Clique "Limpar dados"
|
||
5. Feche TODAS as abas do sistema
|
||
6. Abra uma nova aba: http://localhost:3000
|
||
```
|
||
|
||
---
|
||
|
||
### 2️⃣ **Deletar Vendas Antigas**
|
||
|
||
As vendas criadas ANTES de criar a tabela `venda_parcelas` NÃO têm parcelas salvas!
|
||
|
||
```
|
||
1. Delete TODAS as vendas antigas da lista
|
||
2. Crie UMA NOVA venda parcelada (ex: 3x de R$ 150,00)
|
||
3. Esta nova venda SIM terá as parcelas
|
||
```
|
||
|
||
---
|
||
|
||
### 3️⃣ **Verificar se a Data Está Correta AGORA**
|
||
|
||
A função de data foi corrigida para usar o timezone de Brasília.
|
||
|
||
**Data esperada hoje:** 18/10/2025
|
||
|
||
Se ainda mostrar 17/10, é porque:
|
||
- ❌ Navegador está com cache (volte ao passo 1)
|
||
- ❌ Está vendo uma venda antiga (delete e crie nova)
|
||
|
||
---
|
||
|
||
### 4️⃣ **Como Criar Venda de Teste**
|
||
|
||
```
|
||
1. Clique em "Nova Venda"
|
||
2. Selecione um Cliente
|
||
3. Adicione um Produto
|
||
4. Tipo de Pagamento: "Parcelado"
|
||
5. Número de Parcelas: 3
|
||
6. Data 1º Vencimento: 18/11/2025
|
||
7. Salvar
|
||
```
|
||
|
||
**Resultado Esperado:**
|
||
- Data da venda: **18/10/2025** ✅
|
||
- 3 linhas de parcelas na tabela
|
||
- Parcela 1/3: R$ 50,00 - Vence: 18/11/2025
|
||
- Parcela 2/3: R$ 50,00 - Vence: 18/12/2025
|
||
- Parcela 3/3: R$ 50,00 - Vence: 18/01/2026
|
||
- Linha TOTAL: R$ 150,00
|
||
|
||
---
|
||
|
||
## 🔍 DIAGNÓSTICO RÁPIDO
|
||
|
||
**Se ainda não funcionar, faça este teste:**
|
||
|
||
### Teste 1: Verificar se o servidor está recebendo parcelas
|
||
```bash
|
||
# No terminal, execute:
|
||
curl http://localhost:5000/api/vendas | jq '.[0]'
|
||
```
|
||
|
||
Deve mostrar a venda com `tipo_pagamento: "parcelado"` e `parcelas: 3`
|
||
|
||
### Teste 2: Verificar se as parcelas estão no banco
|
||
```bash
|
||
# Pegue o ID da última venda e execute:
|
||
curl http://localhost:5000/api/vendas/SEU_ID_AQUI/parcelas
|
||
```
|
||
|
||
Deve retornar um array com 3 parcelas:
|
||
```json
|
||
[
|
||
{
|
||
"id": "...",
|
||
"numero_parcela": 1,
|
||
"valor": "50.00",
|
||
"data_vencimento": "2025-11-18",
|
||
"status": "pendente"
|
||
},
|
||
...
|
||
]
|
||
```
|
||
|
||
Se retornar `[]` (vazio), as parcelas NÃO foram salvas!
|
||
|
||
---
|
||
|
||
## 🚨 SE AINDA NÃO FUNCIONAR
|
||
|
||
**Possíveis causas:**
|
||
|
||
### 1. Cache Teimoso do Navegador
|
||
**Solução Radical:**
|
||
```
|
||
1. Feche TODAS as abas e janelas do navegador
|
||
2. Abra o Gerenciador de Tarefas
|
||
3. Finalize TODOS os processos do Chrome/Edge
|
||
4. Abra o navegador novamente
|
||
5. Acesse http://localhost:3000
|
||
```
|
||
|
||
### 2. Código não foi recarregado
|
||
**Verificar:**
|
||
```bash
|
||
# No terminal do projeto:
|
||
cd /home/tiago/Downloads/app_estoque/client
|
||
npm start
|
||
```
|
||
|
||
Aguarde aparecer "Compiled successfully!"
|
||
|
||
### 3. Servidor não reiniciou
|
||
**Verificar:**
|
||
```bash
|
||
# Ver logs do servidor:
|
||
ps aux | grep node
|
||
```
|
||
|
||
Deve mostrar o processo rodando.
|
||
|
||
**Reiniciar manualmente:**
|
||
```bash
|
||
pkill -9 -f node
|
||
cd /home/tiago/Downloads/app_estoque
|
||
npm start
|
||
```
|
||
|
||
---
|
||
|
||
## 📸 COMO DEVE FICAR
|
||
|
||
Depois de LIMPAR O CACHE e criar uma NOVA VENDA:
|
||
|
||
```
|
||
┌────────────┬──────────┬─────────┬──────────┬──────────┬─────────┬────────────┬──────────┬────────┐
|
||
│ ID Venda │ Data │ Cliente │ Produtos │ Parcela │ Valor │ Vencimento │ Status │ Ações │
|
||
├────────────┼──────────┼─────────┼──────────┼──────────┼─────────┼────────────┼──────────┼────────┤
|
||
│ │ │ │ │ 1/3 │ R$50,00 │ 18/11/2025 │Em Aberto │ 👁️💳💬 │
|
||
│ VD20251018 │ 18/10/25 │ Cliente │ Produto ├──────────┼─────────┼────────────┼──────────┼────────┤
|
||
│ │ │ │ │ 2/3 │ R$50,00 │ 18/12/2025 │Em Aberto │ 👁️💳💬 │
|
||
│ │ │ │ ├──────────┼─────────┼────────────┼──────────┼────────┤
|
||
│ │ │ │ │ 3/3 │ R$50,00 │ 18/01/2026 │Em Aberto │ 👁️💳💬 │
|
||
├────────────┴──────────┴─────────┴──────────┼──────────┼─────────┼────────────┴──────────┴────────┤
|
||
│ 💰 TOTAL │ │ R$150,00│ │
|
||
└─────────────────────────────────────────────┴──────────┴─────────┴────────────────────────────────┘
|
||
```
|
||
|
||
---
|
||
|
||
## ✅ CHECKLIST FINAL
|
||
|
||
Antes de testar, certifique-se:
|
||
|
||
- [ ] Tabela `venda_parcelas` existe no Supabase ✅
|
||
- [ ] Servidor Node.js reiniciado ✅
|
||
- [ ] Cache do navegador LIMPO (F12 > Botão direito em atualizar > Limpar cache)
|
||
- [ ] Vendas antigas DELETADAS
|
||
- [ ] Nova venda PARCELADA criada
|
||
- [ ] Data do sistema: 18/10/2025
|
||
|
||
---
|
||
|
||
## 💡 DICA IMPORTANTE
|
||
|
||
**O problema mais comum é o CACHE do navegador!**
|
||
|
||
Mesmo que o backend esteja correto, se o JavaScript antigo estiver em cache, a tabela não vai atualizar.
|
||
|
||
**Solução garantida:**
|
||
1. Abra uma **aba anônima** (Ctrl+Shift+N)
|
||
2. Acesse http://localhost:3000
|
||
3. Teste lá primeiro
|
||
|
||
Se funcionar na aba anônima, é 100% problema de cache!
|
||
|
||
---
|
||
|
||
**🚀 Execute os passos acima e me avise o resultado!**
|