Skip to main content

Arquitetura

📌 Identificação​

  • Documento: Visão Geral

  • 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

Arquitetura

Visão Geral da Arquitetura​

A Plataforma Reunir é baseada em uma arquitetura web tradicional utilizando WordPress como sistema principal, com extensões para e-commerce e marketplace.

A estrutura do sistema é composta por:

  • Backend administrativo (WordPress)
  • Sistema de produtos (WooCommerce)
  • Sistema de marketplace e vendedores (Dokan Pro)
  • Camada de customizações (CSS e PHP)

Componentes Principais​

WordPress​

O WordPress atua como núcleo do sistema, sendo responsável por:

  • Gerenciamento de usuários
  • Estrutura administrativa
  • Gerenciamento de páginas e conteúdos
  • Execução de plugins e temas

Toda a lógica base da aplicação depende do funcionamento do WordPress.

WooCommerce​

O WooCommerce é utilizado como base para a estrutura de produtos.

Responsabilidades:

  • Cadastro e gerenciamento de produtos
  • Estrutura de dados dos produtos
  • Exibição dos produtos no frontend

Observação importante:

Apesar de ser um plugin de e-commerce, as funcionalidades de pagamento, checkout e carrinho não são utilizadas na plataforma.

Dokan Pro​

O Dokan Pro é responsável pela implementação do modelo de marketplace.

Responsabilidades:

  • Criação e gestão de lojas por usuário
  • Painel do vendedor (dashboard)
  • Controle de produtos por vendedor
  • Interface de gerenciamento para os beneficiários

O Dokan é um dos componentes mais críticos do sistema.

Grande parte das customizações da plataforma impacta diretamente seu funcionamento.

Estrutura de Funcionamento​

A interação entre os componentes ocorre da seguinte forma:

  1. O WordPress gerencia o ambiente geral e autenticação
  2. O WooCommerce fornece a estrutura de produtos
  3. O Dokan associa produtos a vendedores e disponibiliza o dashboard
  4. Customizações em CSS e PHP adaptam o comportamento padrão

Fluxo Simplificado​

  • Usuário se cadastra na plataforma
  • Usuário cria sua loja (via Dokan)
  • Usuário adiciona produtos (estrutura WooCommerce)
  • Produtos são exibidos publicamente no site
  • Contato entre cliente e vendedor ocorre fora da plataforma

Camada de Customização​

A plataforma possui uma camada de customização que altera o comportamento padrão dos plugins.

Essa camada inclui:

CSS​

  • Ajustes visuais
  • Ocultação de elementos não utilizados
  • Adaptação da interface para melhor usabilidade

PHP​

  • Uso de hooks e filtros do WordPress
  • Alteração de comportamentos padrão
  • Ajustes em fluxos específicos do sistema

Observação Crítica​

Nem todas as customizações seguem padrões formais de desenvolvimento. As customizações foram feitas por pessoas que não são desenvolvedoras em Wordpress. A equipe técnica constava com um gestor de produto, um designer UX/UI e um técnico de suporte e atendimento.

Algumas foram implementadas para resolver necessidades específicas do projeto.

Por esse motivo:

  • Alterações devem ser feitas com cautela
  • É necessário validar impactos em múltiplos fluxos
  • Recomenda-se sempre testar antes de aplicar mudanças em produção

Estrutura de Dados​

A estrutura de dados segue o padrão do WordPress e WooCommerce:

  • Usuários → tabela padrão do WordPress
  • Produtos → post type do WooCommerce
  • Lojas → gerenciadas pelo Dokan (relacionadas a usuários)

Customizações podem alterar comportamentos padrão, mas não a estrutura base.

Limitações da Arquitetura​

  • Dependência alta de plugins (WooCommerce e Dokan)
  • Customizações podem dificultar atualizações futuras
  • Uso de funcionalidades de e-commerce parcialmente desativadas

Considerações para Evolução​

Caso a plataforma evolua no futuro (ex: adicionar pagamento ou novas funcionalidades), será necessário:

  • Revisar uso do WooCommerce
  • Atualizar termos e políticas
  • Validar impacto nas customizações existentes
  • Revisar fluxos do Dokan

Recomendações Técnicas​

  • Evitar alterações diretas em plugins
  • Priorizar uso de hooks e overrides
  • Documentar qualquer nova customização
  • Testar sempre em ambiente antes de produção