reaction

MailChimp Open Commerce (ehemals Reaktionskommere)

Open Commerce -Website | Twitter | Dokumentation | Zwietracht | Diskussionen

MailChimp Open Commerce ist eine API-erste, kopflose Handelsplattform, die mit Node.js, MongoDB und GraphQL erstellt wurde. Es spielt gut mit NPM, Docker und Kubernetes.

Merkmale

Schnell	Gibt Daten in geteilten Sekunden zurück, und schnellere Abfragen bedeuten schnellere Webseiten
Bewiesen	Open Commerce -Brennstoffe, die 10 von Tausenden von Bestellungen pro Tag mit 100 von Tausenden von Produkten erstellen
Komponierbar	Mit einem flexiblen Plugin -System können Sie auswählen, welche Integrationen für Sie am besten geeignet sind
Multi-Mieter	Veranstalten mehrere Geschäfte in derselben Installation
Skalierbar	Beginnen Sie mit einem einzelnen Server und skalieren Sie bis zu Hunderte
Flexible Produkte	Ermöglicht Produkte mit Optionen und Varianten, eine Vielzahl von Anforderungen zu entsprechen
Inventar	Inventar
Versand	Integrieren
Steuern	Integrieren Sie sich in einen Steuersatzanbieter oder erstellen Sie eine eigene benutzerdefinierte Steuertabelle
Erfüllung	Mit flexibles Erfüllungssystem können Sie Ihre eigenen Erfüllungsmethoden erstellen
Bestellverfolgung	Zeigen und verwalten Sie Ihre Bestellungen im enthaltenen Administratorsystem
E -Mails	Anpassbare Vorlagen für Bestellbestätigungen und mehr
Offen	Volles Open Source. Nie wieder eingesperrt sein

Erste Schritte

Um mit Ihrem eigenen Projekt zu arbeiten, das auf dem MailChimp Open Commerce basiert, können Sie mit unserer neuen CLI beginnen. Die CLI ist der schnellste und einfachste Weg, um sich auf offenem Handel zu entwickeln. Sie können mit API-, Admin- und StoreFront -Projekten über die Befehlszeile erstellen und arbeiten.

Was du brauchst

• Wir empfehlen die Installation von NVM

• 14.18.1 ≤ Knotenversion <16

• Git

• Docker

• Docker komponieren

  Darüber hinaus müssen Sie Ihr System -Setup für die SSH -Authentifizierung mit GitHub einrichten.

Installieren Sie die CLI

Installieren Sie zuerst die CLI durch Ausführen:

 npm install -g reaction-cli

Sie können testen, ob es hier durch Laufen funktioniert hat:

 reaction help

Ein Projekt erstellen

Sie können Ihr Open Commerce -Projekt erstellen, indem Sie ausgeführt werden:

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

Dadurch wird im Verzeichnis ein offenes Handelsprojekt erstellt. Sobald dies abgeschlossen ist, navigieren Sie zum Projektverzeichnis:

 cd <your-project-name> 

Installieren Sie die Projektabhängigkeiten:

 npm install 

Starten Sie den Server schließlich im Entwicklungsmodus:

 reaction develop api

HINWEIS: Optional können Sie aus dem Projekt-Verzeichnis den obigen Befehl ausgeben, ohne den Projekttyp zu erwähnen, und die CLI würde Ihr Paket.json auf den "Projekttyp" überprüfen und ihn von dort abholen. Dies geht davon aus, dass das Projekt selbst unter Verwendung der neuesten Version der CLI erstellt wurde, wie in den obigen Schritten erläutert.

Beispiel anstelle des obigen Befehls können Sie die Erwähnung von "API" überspringen und einfach verwenden:

 reaction develop

Dadurch wird der Open Commerce GraphQL Server und den Mongo -Server gestartet. Drücken Sie Strg+C, um zu stoppen.

• Es wurde ein benutzerdefiniertes Plugin installiert, und Sie sollten die Ausgabe in den Protokollen sehen. (Ihr Beispiel -Plugin)
• So fügen Sie ein neues Plugin hinzu, das auf unserem Plugin -Vorlagenlauf basiert:

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

Überprüfen Sie, ob das Plugin in den custom-packages erstellt wurde

 cd custom-packages

 cd <your-plugin-name>

 npm install 

Sie müssen jetzt wieder auf die Wurzel wechseln:

 cd ../../

Jetzt können Sie rennen:

 reaction develop

Dieses Plugin wird nun beim nächsten Starten des Open Commerce geladen.

Glückwunsch!! Sie sind bereit, sich mit offenem Handel zu entwickeln

Sehen Sie sich die vollständigen CLI -Anweisungen zum Erstellen Ihres lokalen Storefront und Administrators an.

Gehen Sie zu den vollständigen Installationsanweisungen, um zu sehen, wie Sie Ihr Geschäft einrichten

API -Entwicklung

Wenn Sie an Kern -Plugins arbeiten (keine Plugins für Ihre eigene Installation entwickeln), sollten Sie diese Anweisungen befolgen

Was du brauchst

• pnpm
• Docker
• Docker komponieren

Installieren Sie PNPM

npm i -g [email protected]

Klonen und die Quelle starten

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

Starten Sie Dev-Server mit Mongo auf lokaler Bedeutung:

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

Starten Sie Dev-Server mit MongoDB auf Docker

docker-compose up -d
pnpm run start:dev

Entwicklungsfluss

1. Nehmen Sie einige Änderungen in einem oder mehreren Paketen vor.
2. Fügen Sie einen Änderungssatz in derselben PR hinzu.
3. Wiederholen Sie den Vorgang, Änderungen vorzunehmen und Änderungen hinzuzufügen.
4. PR erstellen

Wie man freigibt

1. release -Aktion ausführen, um Version PR zu erstellen. Mit diesem PR werden alle Änderungenset -Dateien entfernt, Paketeversionen steigen und Changelog -Dateien aktualisieren.
2. Merge Version PR in Trunk, Circleci wird alle Pakete in NPM veröffentlichen.

Vorversionflüsse

1. Alle PRs werden vor dem Auslösen von PRERELEASE in prerelease verschmolzen.
2. Stellen Sie vor dem Zusammenführen von PRS in prerelease -Filiale sicher, dass alle Änderungen hinzugefügt werden.
3. Lösen Sie die Aktion PRERELEASE manuell aus, um Version Packages (next) PR zu erstellen. Nach der Fusion stößt der Änderungsset/Action Paketeversionen als {next-version}-next.{number} , Aktualisierung von Changelog-Dateien.
4. Merge Version Packages (next) PR in prerelease -Niederlassung, Aktion wird alle Pakete in NPM veröffentlichen.

Sich beteiligen

Beitragen

Wenn Ihnen gefällt, was Sie sehen, spiel uns uns auf Github.

Finden Sie einen Fehler, einen Tippfehler oder etwas, das nicht gut dokumentiert ist? Wir würden uns freuen, wenn Sie ein Problem eröffnen, das uns sagt, was wir verbessern können! Dieses Projekt verwendet CommitLint. Bitte verwenden Sie das Commit -Nachrichtenformat.

Wir lieben Ihre Pull -Anfragen! Schauen Sie sich unser Good First Issue und Help Wanted Tags zu helfen, um gute Probleme zu lösen. Weitere Informationen finden Sie in unserem Mitwirkenden -Leitfaden

Lizenz

Reaktion ist GNU GPLV3 lizenziert