Visão Geral
O DomainDrop (src/Plugins/domain_drop) é o módulo oficial de Dropshipping e Comércio Eletrônico Físico do Domain-System v2.7.0. Ele integra o SDK Oficial da AliExpress Open Platform (protocolo TOP com assinatura criptográfica HMAC-SHA256 e autenticação OAuth 2.0) diretamente ao núcleo leve do sistema (~30 MB), permitindo operar uma loja virtual completa sem depender de plataformas externas pesadas.
🚀 Principais Funcionalidades
- Integração com SDK Oficial do AliExpress (
AliExpressApiClientInterface):- Suporte às APIs oficiais da AliExpress Open Platform: consulta de produtos (
aliexpress.ds.product.get), feed de ofertas (aliexpress.ds.recommend.feed.get), cálculo de frete (aliexpress.logistics.buyer.freight.get), criação automatizada de pedidos (aliexpress.trade.buy.placeorder) e rastreamento logístico em tempo real (aliexpress.logistics.redefining.getlogisticsselleraddresses/queryTrackingInfo). - Assinatura criptográfica
HMAC-SHA256com Circuit Breaker próprio para chamadas externas.
- Suporte às APIs oficiais da AliExpress Open Platform: consulta de produtos (
- Mineração Autônoma & Ciclo Flash de 24 Horas (
ProductMiningServiceInterface):- Curadoria inteligente que prioriza produtos com estoque no Brasil (Entreposto Nacional com entrega rápida) e complementa com ofertas globais de alta conversão.
- Conversão cambial dinâmica (
USD → BRL) viaCurrencyConverterInterfacecom margem de lucro configurável. - Enriquecimento de títulos e descrições persuasivas com Inteligência Artificial (
AiProductEnricherInterface). - Rotação diária sincronizada com o cronômetro regressivo de 24h na vitrine e cabeçalhos anti-cache HTTP (
CachePolicy) para exibição imediata das ofertas renovadas.
- Espaço do Cliente Completo (
/minha-conta,/entrar,/cadastro):- Autenticação isolada da tabela administrativa (
domain_drop_customers) para segurança máxima de privilégios. - 🛰️ Acompanhamento de Entrega Integrado: Linha do tempo visual de 5 etapas dentro da área do cliente, com consulta direta aos Correios, Cainiao Global e eventos em tempo real do SDK do AliExpress.
- 💬 Reclamações, Observações & Dúvidas: Abertura de chamados com upload seguro de até 4 fotos/PDFs (validação de magic bytes) e vinculação opcional de pedido ou produto do catálogo — permitindo ao cliente indicar o produto ou código manualmente mesmo antes da compensação bancária.
- Autenticação isolada da tabela administrativa (
- Gestão Administrativa de Clientes, Pedidos & Mediação Bilingue (
/admin/dropship):- 👥 Clientes & Compradores (
/admin/dropship/customers): Listagem estilo CRM com busca por nome/e-mail/CPF, métricas de pedidos/chamados, ativação/suspensão de conta e histórico de solicitações recentes. - 📦 Pedidos, SLA & Disputas (
/admin/dropship/orders): Barra de progresso de SLA de entrega e botão único de Mediação com Fornecedor (SellerMediationService) que traduz automaticamente o chamado para Chinês Simplificado (zh-CN) quando o vendedor é internacional (CN) ou mantém em Português (pt-BR) para fornecedores nacionais (BR).
- 👥 Clientes & Compradores (
🏛️ Contratos Principais (SOLID / DIP)
namespace DomainSystem\Plugins\domain_drop\Contracts;
interface AliExpressApiClientInterface // Comunicação assinada com AliExpress Open Platform SDK
interface ProductMiningServiceInterface // Curadoria 24h, precificação BRL e ciclo diário
interface DropshipCatalogRepositoryInterface // Persistência PDO do catálogo (MySQL / SQLite)
interface DropshipOrderRepositoryInterface // Gestão de pedidos e códigos de rastreio
interface DropshipCustomerRepositoryInterface // Gestão de clientes cadastrados e métricas CRM
interface DropshipDisputeRepositoryInterface // Chamados, reclamações, observações e anexos
🎨 Isolamento entre Temas Nativos e Flex Builder
Temas dedicados de e-commerce como o rachidd_store declaram "flex_builder": false em seu theme.json. O ThemeDiscoveryService::supportsFlexBuilder() detecta essa diretiva e isola automaticamente o cabeçalho e o rodapé nativos do tema, exibindo um aviso claro no painel do Flex Builder para evitar conflitos de edição.