Cuidados Importantes
📌 Identificação
-
Documento: Cuidados Importantes
-
Criado por: Camilo Mascarenhas
-
Contato (criador): pm.camilomascarenhas@gmail.com
-
Data de criação: 08/04/2026
-
Última atualização: 08/04/2026
-
Atualizado por: Camilo Mascarenhas
-
Contato (última edição): pm.camilomascarenhas@gmail.com
-
Versão: 1.0
-
Status: Ativo
-
Responsável técnico: Davi Júnior
-
Histórico de versões:
- v1.0 — Criação do documento
Cuidados Importantes
Visão Geral
A plataforma possui alto nível de customização e depende de múltiplas camadas (CSS, PHP, plugins).
Alterações sem análise podem causar falhas críticas.
Pontos Críticos
1. Code Snippets
- Central de lógica da plataforma
- Alterações podem afetar múltiplos fluxos
- Não há versionamento externo
Risco:
- Quebra de funcionalidades essenciais
2. CSS
- Responsável por ocultar e adaptar interface
- Muitos comportamentos dependem apenas de CSS
Risco:
- Exposição de funcionalidades indesejadas
- Quebra de layout
3. Dokan
- Base do dashboard do vendedor
- Altamente customizado
Risco:
- Atualizações podem quebrar estrutura
- Mudanças impactam diretamente usuários
4. WooCommerce
- Utilizado fora do padrão
Risco:
- Atualizações podem reativar fluxo de compra
- Conflitos com customizações
5. Mobile
- Possui tratamento específico
Risco:
- Pequenas alterações quebram layout
- Impacto direto na usabilidade
Situações de Alto Risco
- Atualizar múltiplos plugins ao mesmo tempo
- Remover CSS sem análise
- Desativar snippets
- Alterar estrutura do Dokan
- Mudar tema
Boas Práticas Gerais
- Sempre testar após alterações
- Trabalhar uma mudança por vez
- Validar impacto no painel do vendedor
- Testar mobile e desktop
- Garantir backup antes de alterações críticas
Ordem de Verificação em Problemas
- CSS
- Snippets (PHP)
- Plugin (Dokan/WooCommerce)
- Atualização recente
- Cache
Dependência de Conhecimento
- Plataforma depende de conhecimento acumulado
- Nem tudo está documentado em código
- Parte do comportamento é implícita
Observações Importantes
- Não existe ambiente de testes
- Alterações afetam produção diretamente
- Sistema não segue padrão puro dos plugins
Diagnóstico
- Identificar área afetada
- Verificar alterações recentes
- Conferir CSS e snippets
- Testar comportamento no painel
- Validar impacto geral