reaction

MailChimp Open Commerce（以前の反応商取引）

Open Commerce Webサイト| Twitter |ドキュメント|不和|議論

MailChimp Open Commerceは、Node.js、Mongodb、およびGraphQLを使用して構築されたAPIファーストのヘッドレスコマースプラットフォームです。 NPM、Docker、Kubernetesでうまく機能します。

特徴

速い	分割秒単位でデータを返し、クエリが速いことはより速いWebページを意味します
証明されています	Open Commerce Fuelsサイトは、1日あたり数千の注文を行っており、100個の製品を使用して燃料を供給しています。
合成可能	柔軟なプラグインシステムを使用すると、どの統合が最適かを選択できます。
マルチテナント	同じインストールで複数のショップをホストします
スケーラブル	単一のサーバーから始めて、数百までスケールアップします
柔軟な製品	オプションとバリエーションを備えた製品がさまざまなニーズに合うようになります
在庫	在庫を追跡し、バックオーダーを許可または禁止します
配送	出荷レートプロバイダーと統合するか、独自のカスタムテーブルを構築する
税金	税率プロバイダーと統合するか、独自のカスタム税テーブルを作成する
充足	柔軟なフルフィルメントシステムを使用すると、独自のフルフィルメント方法を作成できます
注文追跡	付属の管理者システムで注文を表示および管理する
メール	注文確認などのカスタマイズ可能なテンプレート
開ける	完全にオープンソース。二度と閉じ込められないでください

はじめる

MailChimp Open Commerceに基づいて構築された独自のプロジェクトの操作を開始するには、新しいCLIを使用することから始めることができます。 CLIは、オープンコマースで開発するための最も迅速で簡単な方法です。これにより、API、管理者、およびストアフロントプロジェクトをすべてコマンドラインを介して作成して作業できます。

あなたが必要とするもの

• NVMをインストールすることをお勧めします

• 14.18.1≤ノードバージョン<16

• git

• Docker

• Dockerは作曲します

  さらに、GitHubを使用してSSH認証用のシステムをセットアップする必要があります

CLIをインストールします

最初に実行してCLIをインストールします。

 npm install -g reaction-cli

テストして、実行してここで機能しているかどうかを確認できます。

 reaction help

プロジェクトの作成

実行して、Open Commerceプロジェクトを作成できます。

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

これにより、ディレクトリにオープンコマースプロジェクトが作成されます。これが完了したら、プロジェクトディレクトリに移動します。

 cd <your-project-name> 

プロジェクトの依存関係をインストールします。

 npm install 

最後に、開発モードでサーバーを起動します。

 reaction develop api

注：オプションで、Project-Directory内からプロジェクトの種類に言及せずに上記のコマンドを発行することができ、CLIはPackage.jsonを「ProjectType」をチェックしてそこから拾います。これは、上記の手順で説明されているように、プロジェクト自体がCLIの最新バージョンを使用して構築されることを期待しています。

たとえば、上記のコマンドの代わりに、「API」に言及してスキップして使用することができます。

 reaction develop

これにより、Open Commerce GraphQL ServerとMongo Serverが開始されます。 Ctrl+Cを押して停止します。

• サンプルカスタムプラグインがインストールされており、ログに出力が表示されるはずです。 （サンプルプラグイン）
• プラグインテンプレートの実行に基づいて新しいプラグインを追加するには：

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

プラグインがcustom-packagesで作成されたかどうかを検証します

 cd custom-packages

 cd <your-plugin-name>

 npm install 

今、あなたはルートに戻る必要があります：

 cd ../../

これで実行できます：

 reaction develop

このプラグインは、次にOpen Commerceを開始するときにロードされます。

おめでとう！！オープンコマースで開発を開始する準備ができました

ローカルストアフロントと管理者を作成する方法については、完全な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を使用してDev-Serverを開始します：

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

DockerにMongodbを使用してDev-Serverを開始します

docker-compose up -d
pnpm run start:dev

開発フロー

1. 1つ以上のパッケージにいくつかの変更を加えます。
2. 同じPRに変更を追加します。
3. 変更を加えて変更セットを追加するプロセスを繰り返します。
4. PRを作成します

リリース方法

1. releaseアクションを実行してVersion PRを作成します。このPRは、すべてのChangesetファイル、パッケージバージョンのバンプアップ、ChangElogファイルを更新します。
2. Version PRをトランクにマージすると、CircleciはすべてのパッケージをNPMに公開します。

プレレリースフロー

1. すべてのPRSは、 PRERELEASEアクションをトリガーする前に、 prereleaseブランチに統合されます。
2. PRSをprerelease Branchにマージする前に、すべての変更セットが追加されていることを確認してください。
3. Version Packages (next) prを作成するために、 PRERELEASEアクションを手動でトリガーします。マージされた後、Changeset/Actionはパッケージバージョンを{next-version}-next.{number}としてぶつけ、changelogファイルを更新します。
4. Version Packages (next) PRをprereleaseブランチにマージすると、アクションはすべてのパッケージをNPMに公開します。

参加してください

貢献する

あなたが見るものが好きなら、Githubで私たちを主演してください。

バグ、タイプミス、またはよく文書化されていないものを見つけますか？私たちが何を改善できるかを教えてくれる問題を開くことを願っています！このプロジェクトはCommitlintを使用しています。コミットメッセージフォーマットを使用してください。

私たちはあなたのプルリクエストが大好きです！私Help WantedのGood First Issueをチェックしてください。詳細については、寄稿者ガイドをご覧ください

ライセンス

反応はGNU GPLV3ライセンスです