Skip to main content

Dívidas Técnicas

📌 Identificação​

  • Documento: Dívidas Técnicas

  • 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

Dívidas Técnicas

Visão Geral​

A plataforma possui dívidas técnicas decorrentes de decisões tomadas para acelerar a implementação e simplificar o uso para usuários finais.

Essas dívidas impactam manutenção, estabilidade e evolução do sistema.

Principais Dívidas​

1. Uso excessivo de CSS para lógica​

Descrição:

  • Funcionalidades controladas apenas visualmente

Impacto:

  • Fragilidade em atualizações
  • Dependência de estrutura HTML

2. Lógica distribuída em Code Snippets​

Descrição:

  • Código fragmentado em múltiplos pontos

Impacto:

  • Difícil manutenção
  • Baixa rastreabilidade

3. Ausência de ambiente de desenvolvimento​

Descrição:

  • Alterações feitas diretamente em produção

Impacto:

  • Alto risco
  • Dificuldade de testes

4. Uso não convencional do WooCommerce​

Descrição:

  • WooCommerce sem fluxo de compra

Impacto:

  • Necessidade constante de adaptação
  • Possível conflito com atualizações

5. Dependência forte do Dokan​

Descrição:

  • Estrutura central baseada no plugin

Impacto:

  • Risco em atualizações
  • Limitação de customização

6. Falta de versionamento de código​

Descrição:

  • Alterações feitas via painel

Impacto:

  • Dificuldade de controle
  • Sem histórico estruturado

7. Customizações acopladas ao tema​

Descrição:

  • CSS depende da estrutura do tema

Impacto:

  • Mudança de tema pode quebrar sistema

8. Mobile com solução adaptada​

Descrição:

  • Transformação manual de layout

Impacto:

  • Sensível a mudanças
  • Difícil manutenção

Impactos Gerais​

  • Aumento da complexidade
  • Risco de instabilidade
  • Dificuldade de evolução
  • Dependência de conhecimento específico

Possíveis Direções de Correção​

  • Centralizar lógica em plugin próprio
  • Reduzir dependência de CSS
  • Criar ambiente de testes
  • Melhorar organização do código
  • Reduzir acoplamento com plugins

Observações Importantes​

  • Nem todas as dívidas precisam ser resolvidas imediatamente
  • Algumas são aceitáveis no contexto do projeto
  • Priorizar impacto no funcionamento da plataforma

Diagnóstico​

  1. Identificar pontos críticos
  2. Avaliar impacto de cada dívida
  3. Definir prioridade
  4. Planejar correção gradual