fulfillment

HotWax Commerce Fulfillment é um aplicativo web progressivo (PWA) para equipes de lojas e armazéns realizarem operações de atendimento de pedidos. Seu nome lógico de repositório é Fulfillment, e seu propósito comercial declarado é permitir que organizações enviem pedidos de clientes e movam inventário com eficiência. As responsabilidades principais incluem localizar pedidos abertos, criar listas de picking, selecionar e escanear itens, embalar remessas, gerar etiquetas e enviar pedidos. Ele também processa pedidos de transferência entre instalações, incluindo picking, shipping e rejeição. As operações de transportadora e shipping cobrem métodos de envio da transportadora, etiquetas de rastreamento e notas de embalagem. O aplicativo lida com inventário e casos de exceção, como itens não atendíveis, rejeições e atualizações de status de pedidos, e resolve permissões de usuário, instalações e contexto de loja de produtos para o trabalho de atendimento. Os fluxos de trabalho documentados começam com pedidos abertos para picking: construindo filas de pedidos baseadas em Solr, criando listas de picking ou ondas, e escaneando itens para atualizar quantidades selecionadas antes de embalar e enviar. O packing e shipping geram notas de embalagem, etiquetas de envio e códigos de rastreamento, e atualizam o status da remessa de aprovado para embalado para enviado. Os fluxos de pedidos de transferência recuperam pedidos de transferência, escaneiam itens, criam remessas de saída e capturam motivos de rejeição quando o inventário não é atendível. O suporte a impressão e dispositivo cobre listas de picking, notas de embalagem e etiquetas, incluindo fluxos de impressoras Zebra. A pilha de tecnologia é Vue 3, Ionic Vue, Vue Router, Pinia e TypeScript, empacotada como um mobile/PWA com Capacitor, ferramentas de PWA do Ionic e service workers. As dependências de plataforma e utilidade incluem o cliente de API do HotWax OMS (@hotwax/oms-api), componentes do HotWax DXP, Firebase e runtime de Module Federation. O mapa de dependências conecta serviços do HotWax OMS / Maarg para pedidos, remessas, listas de picking e contexto de instalação/usuário; busca baseada em Solr para pedidos abertos e filas de atendimento; serviços de documentos para impressão de listas de picking, notas de embalagem, etiquetas de envio e documentos personalizados; Firebase para notificações e hospedagem de entrada remota; e integração com impressoras Zebra. O aplicativo é desenvolvido e executado a partir do workspace pnpm do accxui, em vez de sua própria pasta. Para executar localmente, coloque o aplicativo em apps/fulfillment dentro de um checkout do accxui, copie .env.example para .env e defina os valores necessários, depois execute pnpm install na raiz do accxui e inicie com pnpm --filter fulfillment dev. Os pré-requisitos são Node v22.12.0 ou superior e pnpm. A configuração do ambiente inclui VITE_BASE_URL para chamadas de API do OMS, VITE_LOGIN_URL para login no HotWax Launchpad, VITE_APP_VERSION_CONFIG para hospedagem de aplicativos multi-versão (necessário para o Vite carregar a configuração), VITE_FIREBASE_CONFIG e VITE_FIREBASE_VAPID_KEY para notificações, VITE_REMOTE_ENTRY para extensões de module federation, e VITE_DEFAULT_PRODUCT_STORE_SETTINGS para flags de atendimento padrão de nível de loja. As notas de build para usuários e contribuidores usam o workspace do accxui, com o caminho do contribuitor adicionando um git clone em apps/fulfillment e um comando de build pnpm --filter fulfillment build. As diretrizes de contribuição pedem aos contribuidores que façam fork e clonem o branch main, escolham uma issue, usem nomes de branch como fulfillment-pwa/issue-number, incluam o número da issue nas mensagens de commit e enviem um PR para main com o template fornecido. Relatórios de bugs e solicitações de recursos são distinguidos, e perguntas de suporte ou configuração são direcionadas a canais especificados. Os recursos de UI/UX incluem um arquivo da comunidade Figma, e perguntas da comunidade podem ser enviadas para o canal Discord do projeto. O aplicativo é lançado sob a Licença Apache v2.0. As diretrizes de automação do Playwright descrevem a instalação de navegadores com npx playwright install, a execução de testes com comandos como npx playwright test, npx playwright test tests/login.spec.js, npx playwright test --headed, npx playwright test --project=chromium e npx playwright test --debug, e a visualização de relatórios com npx playwright show-report.