Shopee Feriados - Alerta de Roteirização
Extension Actions
Notifica sobre feriados próximos para validação de roteirização com os hubs
# Feriados SPX - Extensão para Chrome
Esta é uma extensão para o Google Chrome desenvolvida para alertar os colaboradores da Shopee SPX sobre feriados regionais e nacionais que possam impactar as operações de roteirização e coleta.
## Funcionalidades
* **Aviso Persistente:** Exibe um modal de aviso sobre feriados próximos ou finais de semana.
* **Bloqueio de Interação:** O aviso permanece na tela até que o colaborador clique em **"Entendi"** ou no link para a planilha de feriados, garantindo a visualização da informação crítica.
* **Recarregamento Automático:** Força o recarregamento da página inicial (`#/index`) na primeira visita para garantir a correta inicialização da extensão e a exibição confiável do aviso.
* **Dados Atualizados:** Contém dados de feriados regionais e nacionais do Brasil de **2025 a 2030**.
## Instalação (Modo Desenvolvedor)
Para instalar a extensão no seu navegador:
1. **Baixe o arquivo ZIP** da última versão da extensão.
2. Descompacte o arquivo em uma pasta de fácil acesso.
3. Abra o Google Chrome e navegue para `chrome://extensions`.
4. Ative o **"Modo desenvolvedor"** (geralmente no canto superior direito).
5. Clique em **"Carregar sem compactação"** (ou "Load unpacked").
6. Selecione a pasta onde você descompactou a extensão.
A extensão será instalada e estará ativa.
## Como Funciona
A extensão monitora a navegação dentro do sistema SPX.
1. Ao acessar a página inicial (`https://spx.shopee.com.br/#/index` ), a extensão força um recarregamento da página para garantir a correta injeção do script.
2. Após o recarregamento, o script verifica o arquivo `feriados.json` e o dia atual.
3. Se houver feriados regionais ou nacionais nos próximos 7 dias, ou se for final de semana, um modal de aviso é exibido.
4. O modal só pode ser fechado com a interação explícita do usuário (clique em "Entendi" ou no link da planilha).
## Estrutura do Projeto
* `manifest.json`: Arquivo de configuração da extensão.
* `content.js`: O script principal que injeta o aviso na página da Shopee, contém a lógica de recarregamento forçado e o bloqueio do modal.
* `feriados.json`: O banco de dados de feriados, contendo as datas de 2025 a 2030.
* `background.js`: Script de fundo para gerenciamento do *badge* da extensão.
* `icon*.png`: Ícones da extensão.
## Contribuição
Sinta-se à vontade para contribuir com melhorias, correções de bugs ou atualizações na lista de feriados.
1. Faça um *fork* do projeto.
2. Crie um *branch* para sua funcionalidade (`git checkout -b feature/nova-funcionalidade`).
3. Faça suas alterações e *commit* (`git commit -m 'feat: Adiciona nova funcionalidade'`).
4. Faça o *push* para o *branch* (`git push origin feature/nova-funcionalidade`).
5. Abra um *Pull Request*.
---
*Desenvolvido por Edipo Fernandes - LogBrain*