Aviation Parts Platform
Plataforma Shopify de peças para equipamento de aviação com duas custom apps desenvolvidas de raiz
O cliente é fabricante de equipamento de apoio em solo para aviação — Ground Support Equipment. A sua loja de peças serve clientes em todo o mundo que precisam de encomendar componentes específicos para equipamento crítico. Com um catálogo de quase um milhão de registos, uma loja Shopify convencional simplesmente não chegava. Era preciso construir de raiz.
O tema foi construído usando Dawn como base — completamente personalizado para as necessidades da loja, com toda a lógica de frontend para comunicar com as duas custom apps, gestão de utilizadores autenticados, e uma experiência de navegação adaptada a um catálogo de dimensão enterprise.
A search app é uma API completamente custom construída com Fastify, acoplada ao tema via Shopify App Proxy. Toda a comunicação entre o frontend e a app é encaminhada pelo proxy do Shopify, com verificação de utilizador e validação de assinatura HMAC em cada request — garantindo que apenas utilizadores autenticados acedem aos dados. Foi desenvolvido um endpoint público para o cliente submeter o seu catálogo à base de dados da app, permitindo gerir e manipular quase um milhão de registos de peças e componentes de forma eficiente.
A quotes app transformou completamente o modelo de negócio da loja. Em vez do fluxo de compra convencional, os utilizadores submetem pedidos de orçamento que passam por um processo de aprovação interno. Os admins têm um painel embedded completo onde podem ver todas as quotes, filtrar por salesperson, consultar os itens de cada quote, e ajustar preços individualmente — com lógica de desconto automática para compensar as alterações já que o Shopify não permite modificar o preço de um produto por order. Comentários dos admins são enviados por email ao utilizador com um template custom. Emails automáticos são disparados em cada etapa do processo — submissão, aprovação, e comentários. Do lado do utilizador, app extensions permitem acompanhar o estado das quotes, gerir itens, alterar quantidades, e remover produtos.
As duas apps são APIs RESTful que comunicam com a Storefront API e Admin API do Shopify via GraphQL — usando a Admin API onde a Storefront API tem limitações. A search app foi construída com Fastify, a quotes app com Remix. O tema usa Liquid e Alpine.js para toda a interação com as apps.
Construí o tema, desenvolvi as duas apps de raiz, sozinho, em aproximadamente 140 horas. Frontend no tema, backend em Fastify e Remix, integrações com as APIs do Shopify, sistema de emails com templates custom, e painel de administração completo.