reaction

MailChimp Open Commerce (anteriormente comércio de reação)

Site de comércio aberto | Twitter | Documentação | Discord | Discussões

O MailChimp Open Commerce é uma plataforma de comércio sem cabeça da API, construída usando Node.js, MongoDB e GraphQL. Ele toca bem com NPM, Docker e Kubernetes.

Características

Rápido	Retorna dados em segundos divididos e consultas mais rápidas significam páginas da web mais rápidas
Comprovado	Sites de combustões de comércio aberto que fazem 10 de milhares de pedidos por dia com 100 de milhares de produtos
Composível	Um sistema de plug -in flexível permite que você escolha quais integrações funcionam melhor para você
Multi-inquilino	Hospedar várias lojas na mesma instalação
Escalável	Comece com um único servidor e escala até centenas
Produtos flexíveis	Permite que produtos, com opções e variantes atejam em uma ampla variedade de necessidades
Inventário	Rastrear inventário, permitir ou proibir pedidos de pedidos
Envio	Integrar -se a um provedor de taxas de envio ou construir sua própria tabela personalizada
Impostos	Integrar -se a um provedor de taxa de imposto ou construir sua própria tabela de impostos personalizada
Cumprimento	O sistema de atendimento flexível permite criar seus próprios métodos de atendimento
Rastreamento de pedidos	Veja e gerencie seus pedidos no sistema de administração incluído
E -mails	Modelos personalizáveis ​​para confirmações de pedidos e mais
Abrir	De código aberto totalmente aberto. Nunca seja trancado novamente

Começando

Para começar a trabalhar com seu próprio projeto criado no Mailchimp Open Commerce, você pode começar usando nossa nova CLI. A CLI é a maneira mais rápida e fácil de se desenvolver no comércio aberto. Ele permite que você crie e trabalhe com projetos de API, Admin e Storefront, por toda a linha de comando.

O que você precisa

• Recomendamos a instalação de NVM

• 14.18.1 ≤ versão do nó <16

• Git

• Docker

• Docker compor

  Além disso, você precisa configurar seu sistema para autenticação SSH com o GitHub

Instale a CLI

Primeiro instale a CLI executando:

 npm install -g reaction-cli

Você pode testar para ver se funcionou aqui executando:

 reaction help

Criando um projeto

Você pode criar seu projeto de comércio aberto em execução:

 reaction create-project api <your-project-name>

Isso criará um projeto de comércio aberto no diretório. Quando estiver concluído, navegue até o diretório do projeto:

 cd <your-project-name> 

Instale as dependências do projeto:

 npm install 

Por fim, inicie o servidor no modo de desenvolvimento:

 reaction develop api

NOTA: Opcionalmente, de dentro do projeto Diretório do Projeto, você pode emitir o comando acima sem mencionar o tipo de projeto e a CLI verificaria seu pacote.json para o "ProjectType" e o buscaria a partir daí. Isso espera que o próprio projeto tenha sido construído usando a versão mais recente da CLI, conforme explicado nas etapas acima.

Exemplo, em vez do comando acima, você pode pular mencionando 'API' e apenas usar:

 reaction develop

Isso iniciará o Open Commerce GraphQL Server e o Mongo Server. Pressione Ctrl+C para parar.

• Um plug -in personalizado de amostra foi instalado e você deve ver sua saída nos logs. (Seu plugin de amostra)
• Para adicionar um novo plug -in com base na execução do modelo de plug -in:

 reaction create-plugin api <your-plugin-name>

Validar se o plug-in foi criado nos custom-packages

 cd custom-packages

 cd <your-plugin-name>

 npm install 

Agora você precisa mudar de volta para a raiz:

 cd ../../

Agora você pode correr:

 reaction develop

Este plug -in agora será carregado na próxima vez que você iniciar o comércio aberto.

Parabéns!! Você está pronto para começar a desenvolver com comércio aberto

Consulte as instruções completas da CLI sobre como criar sua loja local e administrador.

Vá para as instruções completas de instalação para ver como configurar sua loja

Desenvolvimento da API

Se você estiver trabalhando em plugins principais (não desenvolvendo plugins para sua própria instalação), você deve seguir estas instruções

O que você precisa

• PNPM
• Docker
• Docker compor

Instale o PNPM

npm i -g [email protected]

Clonar e iniciar a fonte

git clone https://github.com/reactioncommerce/reaction.git
cd reaction
pnpm install
cp apps/reaction/.env.example apps/reaction/.env

Comece a servidor dev-servidor com Mongo no Local:

 # # you must change MONGO_URL in the .env to mongodb://localhost:27017/reaction before start
pnpm run start:dev

Inicie o servidor de dev com MongoDB no Docker

docker-compose up -d
pnpm run start:dev

Fluxo de desenvolvimento

1. Faça algumas alterações em um ou mais pacotes.
2. Adicione uma troca no mesmo pr.
3. Repita o processo de fazer alterações e adicionar alterações.
4. Crie pr

Como lançar

1. Execute a ação release para criar Version PR . Este PR removerá todos os arquivos de alterações, aumentará as versões dos pacotes, atualiza os arquivos Changelog.
2. Merge Version PR no tronco, o Circleci publicará todos os pacotes no NPM.

Fluxos de pré -lançamento

1. Todos os PRs serão fundidos no ramo prerelease antes de desencadear a ação PRERELEASE .
2. Antes de fundir o PRS na filial prerelease , verifique se todas as mudanças são adicionadas.
3. Acionar manualmente a ação PRERELEASE para criar Version Packages (next) pr. Após a mesclagem, o alteração/ação aumentará as versões dos pacotes como {next-version}-next.{number} , atualize os arquivos Changelog.
4. Merge Version Packages (next) PR no prerelease Branch, a ação publicará todos os pacotes no NPM.

Envolver -se

Contribuir

Se você gosta do que vê, estrela -nos no Github.

Encontre um bug, um erro de digitação ou algo que não esteja bem documentado? Adoraríamos que você abra um problema nos dizendo o que podemos melhorar! Este projeto usa CommitLint, use seu formato de mensagem de comprometimento.

Adoramos seus pedidos de tração! Confira nossa Good First Issue e Help Wanted para obter boas questões a serem resolvidas. Confira nosso guia de colaboradores para obter mais informações

Licença

A reação é GNU GPLV3 licenciada