Guia de Problemas — EstoqueObras

😱

Adicionei um item e ele sumiu quando recarreguei

O problema mais comum — responsável por 90% das queixas

Crítico

▶

Sintomas

Adiciono um item, aparece na lista, mas ao fechar e abrir o site desaparece
As quantidades voltam aos valores anteriores
O histórico de movimentações some

🔍 O que está acontecendo: O sistema guarda os dados no localStorage do browser. Se você abriu o site de formas diferentes (ficheiro direto vs GitHub Pages vs outro browser), cada um tem o seu próprio localStorage separado. Os dados ficam num e não aparecem no outro.

✅ Como Resolver

1

Verifique se está sempre a abrir da mesma forma

Escolha UMA forma e use sempre essa. Opções:
Opção A — Sempre pelo GitHub Pages: seusite.github.io/index.html
Opção B — Sempre pelo ficheiro local: abrir o index.html no computador
Nunca misture as duas formas — cada uma tem dados separados!

2

Confirme que o script correto está no ficheiro

Abra o index.html num editor de texto (VS Code ou Bloco de Notas). Procure por eo2_estoque. Se encontrar essa palavra, está tudo certo — é o sistema novo com localStorage. Se encontrar JSONBin ou cloudWrite em vez disso, o ficheiro é o antigo — substitua pelo novo que foi gerado.

3

Teste: adicione um item e feche o browser completamente

Feche o browser (não só o separador) → abra de novo → vá ao Estoque. Se o item estiver lá, está resolvido! Se não estiver, verifique o passo 2 — o ficheiro deve ser o correto.

🎨

O site abre em branco ou com erro visual

Tudo preto, sem estilo, ou sem nada na tela

Visual

▶

Sintomas

O site abre mas parece uma página de texto sem formatação
Não há cores, botões ou layout — tudo aparece como texto simples
A página fica completamente branca ou preta sem conteúdo

✅ Como Resolver

1

Verifique se os 3 ficheiros estão na mesma pasta

A causa mais comum de site sem estilo é o styles.css estar noutra pasta. Os 3 ficheiros têm de estar juntos:

📁 sua-pasta/
   ├── index.html
   ├── styles.css      ← OBRIGATÓRIO aqui
   └── problemas.html

Se moveu o index.html para outra pasta, mova os outros 2 junto.

2

No GitHub: verifique se todos os ficheiros foram enviados

Aceda ao seu repositório no GitHub. Veja se existem os 3 ficheiros na raiz: index.html, styles.css e problemas.html. Se o styles.css não estiver lá, faça o upload dele também.

3

Force o reload da página

O browser pode ter guardado uma versão antiga em cache. Prima Ctrl + Shift + R (Windows) ou ⌘ + Shift + R (Mac) para recarregar sem cache. No telemóvel, limpe os dados do site nas definições do browser.

📥

A importação do .json não funcionou

Cliquei em importar, escolhi o ficheiro, mas nada mudou

Partilha

▶

Sintomas

Aparece uma mensagem de erro "Ficheiro inválido"
Nenhuma mensagem aparece e os dados não mudam
Só alguns dados aparecem após a importação

✅ Como Resolver — verifique cada causa

!

Causa A — Ficheiro corrompido ou editado

Se alguém abriu o ficheiro .json no Word ou Bloco de Notas e guardou, pode ter corrompido o formato. Peça ao colega para exportar de novo sem editar o ficheiro.

!

Causa B — Ficheiro .json de uma versão diferente do sistema

O .json deve vir do mesmo sistema. Se tentar importar um ficheiro criado por outro programa, dará erro. O ficheiro exportado deve ter esta estrutura interna:

{"estoque":[...],"obras":[...],"movs":[...],"funcs":[...]}

Abra o ficheiro com o Bloco de Notas e confirme que tem essas 4 palavras no início.

1

Solução: exportar de novo e importar directamente

No computador que tem os dados certos: vá a Compartilhar → Exportar .json. O ficheiro descarrega automaticamente. Não abra o ficheiro, apenas envie-o ao colega. O colega faz Importar .json e seleciona o ficheiro diretamente — sem abrir antes.

⚠️ Atenção: Importar substitui todos os dados actuais. Antes de importar, exporte os seus dados actuais como backup por precaução.

👔

O chefe abriu o link mas os dados são diferentes dos meus

Ele vê dados antigos ou um estoque diferente do que você tem

Partilha

▶

Sintomas

O chefe abre o site e vê itens de exemplo (Cimento, Tijolo, Vergalhão) que você já apagou
Ele vê os dados certos mas com quantidades antigas
Ele não vê nenhum item — o estoque aparece vazio

💡 Por que acontece: O localStorage é individual por browser e por dispositivo. O computador do chefe tem o localStorage dele — que começa com os dados de exemplo. Não existe sincronização automática — é um sistema manual de exportar/importar.

✅ Como Resolver

1

No SEU computador: exporte os dados actuais

Vá a Compartilhar → Exportar .json. Um ficheiro como estoque_2025-07-10.json vai descarregar.

2

Envie o ficheiro ao chefe por WhatsApp ou e-mail

Envie o ficheiro .json como anexo. Não copie o conteúdo — envie o ficheiro completo.

3

O chefe faz a importação

Ele abre o site → vai a Compartilhar → Importar .json → seleciona o ficheiro recebido. Pronto — os dados ficam iguais aos seus!

✅ Dica: Combine com o seu chefe uma hora fixa (por exemplo toda segunda-feira de manhã) para você exportar e ele importar. Assim ele fica sempre atualizado.

📋

Botões de Reservar/Saída não mostram obras ou funcionários

Clico em Reservar, abre o formulário, mas a lista de obras está vazia

Dados

▶

Sintomas

O campo "Obra" no formulário de Reserva está vazio — sem opções
O campo "Funcionário" também está vazio
Consigo abrir o formulário mas não consigo confirmar

🔍 Causa: O formulário de Reserva só mostra obras com status "Ativa". Se não há obras cadastradas, ou todas estão como "Pausada" ou "Concluída", a lista aparece vazia.

✅ Como Resolver

1

Vá à página Obras e verifique os status

Clique em Obras no menu. Verifique se existe pelo menos uma obra com status ✅ Ativa. Se todas estiverem Pausadas ou Concluídas, edite uma e mude para Ativa.

2

Se não há nenhuma obra — cadastre uma

Vá a Obras → ＋ Nova Obra. Preencha o local, responsável e deixe o status como Ativa.

3

Mesmo para Funcionários — verifique se há alguém cadastrado

Vá a Funcionários. Se a lista estiver vazia, vá a ＋ Novo Funcionário e adicione pelo menos um nome.

🚨

Apaguei tudo sem querer — como recuperar?

Limpei o browser, importei o ficheiro errado ou deletei tudo

Urgente

▶

Sintomas

Limpei o histórico do browser e todos os dados sumiram
Importei o ficheiro errado e sobrescrevi os dados corretos
Fiz "reset" ou limpeza no browser

⚠️ Realidade: Se os dados foram apagados do localStorage e não existe um ficheiro .json de backup, não é possível recuperar automaticamente. Por isso a exportação regular é fundamental.

✅ O que tentar

!

Verifique se o chefe tem uma versão recente

Se o chefe já importou um ficheiro .json da sua última exportação, ele pode reenviar esse ficheiro para você importar de volta. Contacte-o imediatamente.

!

Procure ficheiros .json antigos no computador

Abra o gestor de ficheiros e pesquise por estoque_. Os ficheiros exportados têm a data no nome, como estoque_2025-07-01.json. Verifique também a pasta Downloads — podem estar lá.

1

Se não há recuperação — reintroduza os dados manualmente

Infelizmente sem backup não há solução técnica. Reintroduza os itens no Estoque, as Obras e os Funcionários manualmente. A partir de agora, faça exportação semanal.

✅ PREVENÇÃO — Faça isso toda semana:
Segunda-feira de manhã → abra o site → Compartilhar → Exportar .json → guarde o ficheiro numa pasta chamada Backups Estoque. Em 30 segundos você tem um seguro contra qualquer perda.

📱

O site funciona no computador mas não no telemóvel

No telemóvel aparece cortado, sem estilo ou com erro

Dispositivo

▶

Sintomas

A tabela aparece cortada ou ultrapassa o ecrã
Os botões ficam sobrepostos ou inacessíveis
O site carrega mas não tem o estilo visual correto

✅ Como Resolver

1

No telemóvel, use o Chrome ou Edge — evite browsers alternativos

Browsers como UC Browser, Opera Mini ou browser nativo de alguns telemóveis têm limitações no localStorage. Use Google Chrome no Android ou Safari no iPhone.

2

Aceda sempre pelo link do GitHub Pages — não pelo ficheiro local

No telemóvel não consegue abrir um ficheiro local. Use o link do GitHub Pages: seusite.github.io. Se não tem o link, aceda pelo computador e copie o endereço.

3

Gire o telemóvel para horizontal se a tabela estiver cortada

As tabelas têm muitas colunas e ficam melhor em ecrã horizontal (paisagem). Gire o telemóvel ou use num tablet.

💡 Nota importante: Os dados do telemóvel e do computador são separados. Se adicionar algo no telemóvel, não aparece no computador automaticamente — tem de exportar e importar como habitualmente.

🌐

Mudei de browser e perdi tudo

Usava Chrome, passei para Edge (ou Firefox) e o estoque está vazio

Dados

▶

Sintomas

No browser novo o estoque aparece com os dados de exemplo (Cimento, Tijolo…)
Todo o histórico de movimentações sumiu
Tenho de reintroduzir tudo

🔍 Por que acontece: Cada browser tem o seu próprio localStorage completamente separado. Chrome, Edge, Firefox e Safari não partilham dados entre si, mesmo no mesmo computador.

✅ Como Resolver

1

Volte ao browser antigo e exporte os dados

Abra o Chrome (ou o browser que usava antes) → abra o site → Compartilhar → Exportar .json. Guarde o ficheiro.

2

No browser novo, importe o ficheiro

Abra o site no novo browser → Compartilhar → Importar .json → selecione o ficheiro que exportou. Os dados aparecem imediatamente.

3

Escolha UM browser e use sempre esse

A partir de agora, defina um browser principal para o sistema. Recomendamos o Google Chrome por ser o mais estável com localStorage.

🔴

A barra de saldo está sempre vermelha mesmo com stock

Tenho 500 sacos mas a barra mostra vermelho ou "Baixo"

Visual

▶

Sintomas

A barra aparece vermelha mesmo com bastante stock disponível
Aparece o badge "⚠️ Baixo" mas o saldo parece suficiente
O Dashboard mostra alertas de saldo baixo que parecem errados

🔍 Causa: O campo Saldo Mínimo foi configurado com um valor muito alto. Por exemplo, se definiu mínimo = 600 e tem 500 em stock, o sistema considera "baixo" porque está abaixo de 600.

✅ Como Resolver

1

Edite o item e corrija o Saldo Mínimo

Na tabela do Estoque, clique em ✏️ no item com o alerta errado. Veja o campo Saldo Mínimo. Coloque um valor que faça sentido — por exemplo, se tem 500 sacos e só se preocupa quando chegar a 50, coloque 50 nesse campo.

2

Se não quer alertas, coloque 0

Se deixar o Saldo Mínimo como 0, o sistema nunca vai gerar alertas para aquele item. O badge vai aparecer como ✅ OK sempre.

💡 Como funciona o sistema de cores:
🟢 Verde — saldo acima de 50% do total
🟡 Amarelo — saldo entre 20% e 50% do total
🔴 Vermelho — saldo abaixo de 20% do total OU abaixo do mínimo definido

🐙

O GitHub não atualizou o site após subir o ficheiro

Fiz o upload do index.html novo mas o site ainda mostra o antigo

GitHub

▶

Sintomas

Fiz o commit e push mas o site ainda mostra a versão antiga
O GitHub Pages demora a atualizar
O repositório tem o ficheiro novo mas o site não mudou

✅ Como Resolver

1

Aguarde 1 a 3 minutos — o GitHub Pages tem um delay

Após fazer push, o GitHub Pages precisa de tempo para reconstruir o site. Espere 2-3 minutos antes de verificar. É normal — não é erro.

2

Force o reload no browser — Ctrl + Shift + R

O browser pode estar a mostrar a versão em cache. Prima Ctrl + Shift + R para forçar o download da versão nova do servidor.

3

Verifique o estado do deploy no GitHub

No GitHub, vá ao repositório → clique em Actions (menu de topo). Veja se há um deploy a correr (círculo amarelo) ou com erro (círculo vermelho). Se houver erro, clique nele para ver o detalhe.

4

Confirme que o branch correto está configurado no Pages

No repositório → Settings → Pages. Verifique se em "Branch" está selecionado main (ou master) e a pasta / (root). Se estiver diferente, corrija e guarde.

🐌

O site ficou lento ou travou

As páginas demoram a carregar ou os botões não respondem

Performance

▶

Sintomas

O site demora mais de 2 segundos a responder aos cliques
A tabela do Estoque demora a aparecer
O browser fica lento quando o site está aberto

🔍 Causa mais comum: Muitos registos de Movimentações acumulados. O sistema guarda cada saída e reserva individualmente — com milhares de entradas, a tabela pode ficar pesada.

✅ Como Resolver

1

Exporte os dados como arquivo antes de limpar

Compartilhar → Exportar .json. Guarde como backup histórico. Este ficheiro tem todo o historial.

2

Limpe o histórico de movimentações antigas

Abra as Ferramentas de Desenvolvimento do browser (F12) → vá à aba Console → escreva este comando e prima Enter:

localStorage.setItem('eo2_movs', '[]')

Isto apaga apenas o histórico de movimentações, mantendo o estoque, obras e funcionários intatos. Recarregue a página.

3

Para lentidão geral do browser

Feche outros separadores do browser, reinicie o computador, ou use o modo anónimo para testar se é problema do site ou do browser.

🛡️

Dicas preventivas — evite problemas antes de acontecerem

Boas práticas para nunca perder dados nem ter surpresas

Prevenção

▶

📅

Export semanal obrigatório

Todo início de semana: Compartilhar → Exportar .json. Guarde numa pasta "Backups Estoque" com a data. Em caso de perda, você recupera no máximo uma semana de dados.

🌐

Use sempre o mesmo browser

Escolha Google Chrome como browser oficial do sistema. Nunca mude para Edge, Firefox ou Safari no dia a dia — os dados ficam presos em cada um.

🔗

Guarde o link como favorito

Abra seusite.github.io#estoque → prima Ctrl+D → guarde na barra de favoritos. Um clique e está direto no estoque, sem digitar nada.

🚫

Nunca limpe "todos os dados" do browser

Quando limpar o histórico do browser, desmarque a opção "Dados do site" ou "localStorage". Só apague histórico de navegação e cache — nunca os dados do site.

📤

Export antes de qualquer importação

Antes de importar um ficheiro do chefe, sempre exporte primeiro os seus dados. Assim se a importação correr mal, pode recuperar o que tinha.

📂

Mantenha os 3 ficheiros juntos

Se precisar mover ou copiar o site, mova sempre os 3 juntos: index.html, styles.css e problemas.html. Nunca um sem os outros.

✅ Rotina recomendada — 2 minutos por semana:

🗓️ Segunda de manhã: Abrir o site → Compartilhar → Exportar → Guardar na pasta Backups
📤 Ao fazer alterações grandes: Exportar e enviar ao chefe para ele importar
🔍 Uma vez por mês: Verificar se o GitHub Pages está online e a carregar correctamente