reaction

MailChimp Open Commerce（以前是反应贸易）

开放商业网站| Twitter |文档|不和谐|讨论

MailChimp Open Commerce是一个使用Node.js，MongoDB和GraphQl构建的API优先，无头商务平台。它可以与NPM，Docker和Kubernetes一起表现出色。

特征

快速地	返回分秒的数据，更快的查询是指更快的网页
经过证明	开放式商业燃料网站每天进行10次订单的10个订单，其中100种产品
合成	灵活的插件系统使您可以选择哪些集成最适合您
多租户	在同一安装中托管多家商店
可扩展	从一台服务器开始，然后扩展多达数百个
灵活的产品	允许产品，具有选择和变体可以满足各种需求的产品
存货	跟踪库存，允许或禁止后订单等
船运	与运输汇率提供商集成或建立自己的自定义表
税	与税率提供商集成或建立自己的自定义税务表
履行	灵活的履行系统允许您创建自己的履行方法
订单跟踪	在随附的管理系统中查看和管理您的订单
电子邮件	可自定义的模板用于订单确认以及更多
打开	完全开源。再也不会被锁定了

入门

要开始使用自己的项目建立在MailChimp Open Commerce上，您可以使用我们的新CLI开始。 CLI是开放贸易开发的最快，最简单的方法。它允许您通过命令行创建和使用API​​，Admin和StoreFront项目。

您需要什么

• 我们建议安装NVM

• 14.18.1≤节点版本<16

• git

• Docker

• Docker组成

  此外，您需要使用GitHub进行SSH身份验证的系统设置

安装CLI

首先通过运行安装CLI：

 npm install -g reaction-cli

您可以测试以查看它是否在此处运行：

 reaction help

创建一个项目

您可以通过运行来创建开放式商务项目：

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

这将在目录中创建一个开放式商务项目。完成此操作后，导航到项目目录：

 cd <your-project-name> 

安装项目依赖性：

 npm install 

最后，以开发模式启动服务器：

 reaction develop api

注意：可选的是，在项目目录中，您可以在不提及项目类型的情况下发出上述命令，并且CLI会检查您的软件包。JSON的“ ProjectType”并从那里捡起它。这预计该项目本身是使用上述步骤中最新版本的CLI构建的。

例如，您可以跳过提及“ API”而不是上述命令，然后使用：

 reaction develop

这将启动Open Commerce GraphQL Server和Mongo服务器。按CTRL+C停止。

• 已经安装了示例自定义插件，您应该在日志中看到其输出。 （您的示例插件）
• 要根据我们的插件模板运行添加新插件：

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

验证插件是否是在custom-packages中创建的

 cd custom-packages

 cd <your-plugin-name>

 npm install 

您现在需要更改为根：

 cd ../../

现在您可以运行：

 reaction develop

下次您开始开放商务时，该插件现在将加载。

恭喜！您已经准备好开始开发开放式贸易

有关如何创建本地店面和管理员的完整CLI说明。

转到完整的安装说明以查看如何设置您的商店

API开发

如果您正在使用核心插件（不为自己的安装开发插件），则应按照以下说明

您需要什么

• PNPM
• Docker
• Docker组成

安装PNPM

npm i -g [email protected]

克隆并开始源

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

与Mongo一起在本地开始开发服务：

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

用docker启动dev-server

docker-compose up -d
pnpm run start:dev

发展流

1. 对一个或多个软件包进行一些更改。
2. 在同一PR中添加更改。
3. 重复进行更改和添加更改的过程。
4. 创建PR

如何释放

1. 运行release操作以创建Version PR 。该公关将删除所有更改文件，凸起软件包版本，更新ChangElog文件。
2. Merge Version PR进入后备箱，CircleCi将将所有软件包发布到NPM中。

预发行

1. 在触发PRERELEASE作用之前，所有PR将合并到prerelease分支中。
2. 在将PRS合并到prerelease分支之前，请确保添加所有更改集。
3. 手动触发PRERELEASE操作以创建Version Packages (next) pr。合并后，更改/操作将以{next-version}-next.{number} ，更新ChangElog文件碰撞包装版本。
4. 合并Version Packages (next) PR到prerelease分支，操作将将所有软件包发布到NPM中。

介入

贡献

如果您喜欢所看到的，请在Github上饰演我们。

查找错误，错别字或没有很好记录的东西？我们希望您能打开一个问题，告诉我们我们可以改善什么！该项目使用commitlint，请使用其提交消息格式。

我们喜欢您的拉力要求！查看我们的Good First Issue ，并Help Wanted标签，以解决问题。查看我们的贡献者指南以获取更多信息

执照

反应是GNU GPLV3许可