Skip to main content

Gambiarras

📌 Identificação​

  • Documento: Gambiarras

  • 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

Gambiarras

Visão Geral​

A plataforma utiliza diversas soluções não convencionais para adaptar o WooCommerce e o Dokan a um modelo de vitrine simplificada.

Essas soluções foram necessárias para atender usuários sem conhecimento técnico e reduzir complexidade.

Principais Gambiarras​

1. Uso intensivo de CSS para ocultação​

Descrição:

  • Funcionalidades não utilizadas são apenas escondidas
  • Elementos continuam existindo no DOM

Motivo:

  • Evitar alteração estrutural profunda
  • Implementação rápida

Impacto:

  • Fragilidade em atualizações
  • Dependência de seletores

2. Uso de Code Snippets como backend principal​

Descrição:

  • Lógica da aplicação distribuída em múltiplos snippets

Motivo:

  • Evitar criação de plugin customizado
  • Facilidade de edição via painel

Impacto:

  • Difícil rastreamento de lógica
  • Alto risco em alterações

3. WooCommerce sem fluxo de compra​

Descrição:

  • WooCommerce utilizado apenas como estrutura de produto

Motivo:

  • Plataforma não realiza pagamentos

Impacto:

  • Desvio do comportamento padrão
  • Necessidade constante de ajustes

4. Dokan altamente modificado​

Descrição:

  • Painel do vendedor simplificado via CSS e PHP

Motivo:

  • Usuários não técnicos
  • Redução de erro

Impacto:

  • Incompatibilidade com atualizações
  • Dependência de estrutura interna do plugin

5. Transformação de tabela em cards (mobile)​

Descrição:

  • Listagem de produtos convertida manualmente para cards

Motivo:

  • Melhorar usabilidade mobile

Impacto:

  • Alto acoplamento com HTML do Dokan
  • Sensível a mudanças

6. Rotas forçadas manualmente​

Descrição:

  • Ajuste de rotas do Dokan para /painel

Motivo:

  • Padronização de acesso

Impacto:

  • Pode conflitar com atualizações
  • Dependência de snippets

7. Botões recriados manualmente​

Descrição:

  • Botões adicionados via PHP e estilizados via CSS

Motivo:

  • Adicionar funcionalidades específicas (ex: WhatsApp)

Impacto:

  • Possível duplicidade
  • Dependência de múltiplas camadas

Características Gerais​

  • Baixo acoplamento estrutural (sem mexer em core)
  • Alto acoplamento visual (CSS dependente)
  • Lógica distribuída
  • Forte dependência de plugins

Observações Importantes​

  • As gambiarras são parte essencial da plataforma
  • Remover sem análise pode quebrar o sistema
  • Algumas são soluções permanentes

Riscos​

  • Quebra após atualização
  • Dificuldade de manutenção
  • Dependência de conhecimento específico
  • Comportamento imprevisível

Boas Práticas​

  • Não remover sem entender o impacto
  • Documentar alterações
  • Testar sempre após mudanças
  • Evitar adicionar novas gambiarras sem necessidade

Diagnóstico​

  1. Identificar origem da funcionalidade (CSS ou PHP)
  2. Verificar dependências cruzadas
  3. Testar alteração isolada
  4. Validar impacto geral