spree

Spree é uma plataforma de eCommerce headless de código aberto lançada sob a licença BSD 3-Clause. O README a posiciona para storefronts transfronteiriços, atacado B2B e backends de comércio personalizados, enfatizando que os comerciantes mantêm a propriedade do código, dados e infraestrutura, sem taxas de plataforma ou de transação. Arquitetura e interfaces - Uma API REST com chaves publicáveis, limitação de taxa e uma especificação OpenAPI 3.0; um SDK TypeScript adiciona segurança de tipos e preenchimento automático. - Um Painel Administrativo construído com Tailwind CSS que suporta permissões baseadas em funções. - Uma storefront Next.js (mantida em um repositório separado spree/storefront) construída com Next.js 16, React 19, Tailwind CSS 4 e TypeScript, fornecendo roteamento de URL multi-região, contas de cliente, SEO e pagamentos Stripe, incluindo Apple Pay, Google Pay, Klarna e Affirm. - Um pacote CLI (@spree/cli) que inicia a stack (web, worker, banco de dados), executa geradores e migrações, acompanha logs e chama a API Admin diretamente via comandos get/post/patch/delete. Os geradores podem criar endpoints de API completos, modelos e esquema de banco de dados para um novo recurso. `spree api endpoints` e `spree api schema` exploram a API offline. As credenciais são zero-config no desenvolvimento local, o que o README observa ser adequado para scripts e agentes de IA. Capacidades de comércio - Markets agrupam moeda, idioma, métodos de pagamento e regras de envio por país; um Centro de Traduções lida com a localização de produtos em massa, e o histórico de preços automático de 30 dias suporta a conformidade com a Diretiva Omnibus da UE. - Recursos de B2B e atacado incluem Listas de Preços para preços regionais, B2B e de atacado, Grupos de Clientes para segmentação, empresas com locais e contatos para organizações de compradores, Catálogos para sortimentos por segmento e storefronts restritos via chaves publicáveis. - Canais de Venda permitem que múltiplas storefronts, pontos de venda, painéis B2B ou aplicativos móveis funcionem a partir de um único backend, cada um com seus próprios produtos, preços, métodos de pagamento e regras de envio. - Sessões de Pagamento são agnósticas ao provedor; plugins do Stripe, Adyen e PayPal já vêm prontos para a storefront Next.js, e um SDK de Provedor de Pagamento permite provedores personalizados. - Um motor de promoções baseado em regras e suporte nativo a cartões-presente / créditos de loja. - Recursos de catálogo de produtos incluem metafields, importação/exportação CSV, produtos digitais, tags de produtos e operações em massa. A integração com MeiliSearch fornece busca tolerante a erros e filtragem facetada. - Um Event Bus, Webhooks 2.0 e integrações nativas com GA4, Google Tag Manager e Klaviyo cobrem a extensibilidade. - O cálculo automático de impostos com Avatax e Stripe Tax é listado como disponível na edição de código aberto. Primeiros passos e implantação Um sandbox gratuito hospedado é oferecido para avaliação, ou `npx create-spree-app@latest my-store` cria o backend, Painel Administrativo e storefront em um único projeto; Node.js 22+ e Docker são necessários. O backend é fornecido com imagens Docker oficiais e Dockerfiles para hospedagem em nuvem, on-premises ou VPS em provedores compatíveis com Docker, como AWS, Azure, GCP, Render, Railway, Fly.io e Heroku; a storefront pode ser implantada no Vercel, Netlify ou qualquer host Node.js. Desenvolvimento Agêntico O projeto publica habilidades de agente (instaláveis via `npx skills add spree/agent-skills`) que ensinam assistentes de codificação as convenções do Spree, padrões de customização e fluxos de atualização, além de um servidor MCP de documentação, documentação pronta para LLM (llms.txt, Markdown por página, um pacote npm offline) e arquivos AGENTS.md/CLAUDE.md gerados em projetos scaffolded. Licenciamento e edições O código principal em spree/spree é BSD 3-Clause. Uma Enterprise Edition paga é construída sobre a mesma API REST e núcleo de código aberto, adicionando recursos que o README lista como exclusivos da Enterprise: fluxos de aprovação B2B e integrações de ERP, automações de marketplace como sincronização de vendedores Shopify/WooCommerce, onboarding do Stripe Connect e regras de comissão automatizadas, uma camada SaaS multi-tenant com provisionamento de inquilinos e faturamento white-label, segurança empresarial como SSO (SAML/OIDC), criptografia em repouso, log de auditoria e arquitetura compatível com PCI, além de suporte com SLA, versões LTS e monitoramento 24/7. A funcionalidade de marketplace multi-vendedor, como contas de vendedor, pagamentos divididos, saques e comissões, é marcada como disponível em ambas as edições. Comunidade Contribuições são bem-vindas através do guia de contribuição, uma comunidade no Discord, um roadmap público de marcos e issues no GitHub.