机器翻译正文由机器翻译自项目原始文档（英文），排版经程序统一处理，可能存在偏差，请以原项目仓库为准。

Mailchimp开放商务（前身为Reaction Commerce）

Open Commerce Website | Twitter | Documentation | Discord | Discussions

Mailchimp Open Commerce 是一个以 API 为先、无头的商业平台，使用 Node.js、MongoDB 和 GraphQL 构建。它与 npm、Docker 和 Kubernetes 兼容。

功能

Getting started

To start working with your own project built on Mailchimp Open Commerce you can start by using our new CLI. The CLI is the quickest and easiest way to develop on Open Commerce. It allows you to create and work with API, Admin, and Storefront projects all via the command line.

你需要的东西

• We recommend installing nvm
• 14.18.1 ≤ Node version < 16
• Git
• Docker

• Docker Compose

  In addition, you need to have your system setup for SSH authentication with GitHub

安装 CLI

First install the cli by running:

npm install -g reaction-cli

You can test to see if it has worked here by running:

reaction help

创建项目

You can create your Open Commerce project by running:

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

This will create an Open Commerce project in the directory . Once this is complete, navigate to the project directory:

cd <your-project-name> 

Install the project dependencies:

npm install 

Finally, start the server in development mode:

reaction develop api

Note: Optionally, from within the project-directory you may issue the above command without mentioning the project type and the CLI would check your package.json for the "projectType" and pick it up from there. This expects that the project itself was built using the latest version of the CLI as explained in the above steps.

Example, instead of the above command, you may skip mentioning 'api' and just use:

  reaction develop

This will start the Open Commerce GraphQL server and Mongo Server. Press Ctrl+C to stop.

• A sample custom plugin has been installed, and you should see its output in the logs. (Your Sample Plugin)
• To add a new plugin based on our plugin template run:

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

  Validate whether the plugin was created in the custom-packages

  cd custom-packages

  cd <your-plugin-name>

  npm install 

  You now need to change back up to the root:

  cd ../../

  now you can run:

  reaction develop

  This plugin will now be loaded the next time you start Open Commerce.

Congratulations!! You're ready to start developing with Open Commerce

See the Complete CLI instructions for how to create your local storefront and admin.

Go to the complete installation instructions to see how to set up your store

API development

If you are working on core plugins (not developing plugins for your own installation) you should follow these instructions

你需要的东西

• pnpm
• Docker
• Docker Compose

安装 PNPM

npm i -g pnpm@7.11.0

克隆并启动源码

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

Start dev-server with mongo on local:

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

Start dev-server with mongodb on docker

docker-compose up -d
pnpm run start:dev

开发流程

1. Make some changes in one or more packages.
2. Add a changeset in that same PR.
3. Repeat the process of making changes and adding changesets.
4. Create PR

如何发布

1. Run release action to create Version PR. This PR will remove all changeset files, bump up packages versions, update CHANGELOG files.
2. Merge Version PR into trunk, CircleCI will publish all the packages into npm.

预发布流程

1. All PRs will be merged into prerelease branch before triggering PRERELEASE action.
2. Before merging PRs into prerelease branch, please make sure that all the changesets are added.
3. Manually trigger PRERELEASE action to create Version Packages (next) PR. After merged, the changeset/action will bump up packages versions as {next-version}-next.{number}, update CHANGELOG files.
4. Merge Version Packages (next) PR into prerelease branch, action will publish all the packages into npm.

Get involved

贡献

:star: If you like what you see, star us on GitHub.

Find a bug, a typo, or something that’s not documented well? We’d love for you to open an issue telling us what we can improve! This project uses commitlint, please use their commit message format.

We love your pull requests! Check out our Good First Issue and Help Wanted tags for good issues to tackle. Check out our contributors guide for more information

License

Reaction is GNU GPLv3 Licensed