reaction

MailChimp Open Commerce (sebelumnya Commerce Reaksi)

Situs Web Open Commerce | Twitter | Dokumentasi | Perselisihan | Diskusi

MailChimp Open Commerce adalah platform perdagangan API-first, headless yang dibangun menggunakan Node.js, MongoDB, dan GraphQL. Ini bermain baik dengan NPM, Docker dan Kubernetes.

Fitur

Cepat	Mengembalikan data dalam detik split, dan kueri yang lebih cepat berarti halaman web yang lebih cepat
Terbukti	Situs Bahan Bakar Perdagangan Terbuka Melakukan 10 -an ribuan pesanan per hari dengan 100 -an ribuan produk
Dapat dikomposisi	Sistem plugin yang fleksibel memungkinkan Anda untuk memilih dan memilih integrasi mana yang paling cocok untuk Anda
Multi-penyewa	Host beberapa toko di instalasi yang sama
Scalable	Mulailah dengan satu server dan skala hingga ratusan
Produk fleksibel	Memungkinkan produk, dengan opsi dan varian agar sesuai dengan berbagai kebutuhan
Inventaris	Lacak inventaris, izinkan atau larang backorder dan banyak lagi
Pengiriman	Integrasi dengan penyedia tarif pengiriman atau bangun tabel khusus Anda sendiri
Pajak	Berintegrasi dengan penyedia tarif pajak atau membangun tabel pajak khusus Anda sendiri
Pemenuhan	Sistem pemenuhan yang fleksibel memungkinkan Anda membuat metode pemenuhan Anda sendiri
Pesanan pelacakan	Lihat dan kelola pesanan Anda di sistem admin yang disertakan
Email	Template yang dapat disesuaikan untuk konfirmasi pesanan dan banyak lagi
Membuka	Sumber terbuka sepenuhnya. Tidak pernah terkunci lagi

Memulai

Untuk mulai bekerja dengan proyek Anda sendiri yang dibangun di atas MailChimp Open Commerce, Anda dapat mulai dengan menggunakan CLI baru kami. CLI adalah cara tercepat dan termudah untuk berkembang di perdagangan terbuka. Ini memungkinkan Anda untuk membuat dan bekerja dengan proyek API, admin, dan etalase semua melalui baris perintah.

Apa yang Anda butuhkan

• Kami sarankan menginstal NVM

• 14.18.1 ≤ versi simpul <16

• Git

• Buruh pelabuhan

• Docker menyusun

  Selain itu, Anda perlu mengatur sistem Anda untuk otentikasi SSH dengan GitHub

Instal CLI

Pertama instal CLI dengan menjalankan:

 npm install -g reaction-cli

Anda dapat menguji untuk melihat apakah itu telah bekerja di sini dengan menjalankan:

 reaction help

Membuat proyek

Anda dapat membuat proyek Open Commerce Anda dengan menjalankan:

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

Ini akan membuat proyek perdagangan terbuka di direktori. Setelah ini selesai, arahkan ke direktori proyek:

 cd <your-project-name> 

Instal dependensi proyek:

 npm install 

Akhirnya, mulailah server dalam mode pengembangan:

 reaction develop api

Catatan: Secara opsional, dari dalam proyektori proyek Anda dapat mengeluarkan perintah di atas tanpa menyebutkan jenis proyek dan CLI akan memeriksa paket Anda.json untuk "ProjectType" dan mengambilnya dari sana. Ini mengharapkan bahwa proyek itu sendiri dibangun menggunakan versi terbaru CLI seperti yang dijelaskan dalam langkah -langkah di atas.

Contoh, alih -alih perintah di atas, Anda dapat melewatkan menyebutkan 'API' dan cukup gunakan:

 reaction develop

Ini akan memulai server GraphQL dan Mongo Commerce Open Commerce. Tekan Ctrl+C untuk berhenti.

• Contoh plugin khusus telah diinstal, dan Anda akan melihat outputnya di log. (Plugin Sampel Anda)
• Untuk menambahkan plugin baru berdasarkan Template Plugin kami Run:

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

Validasi apakah plugin dibuat di custom-packages

 cd custom-packages

 cd <your-plugin-name>

 npm install 

Anda sekarang perlu mengubah kembali ke root:

 cd ../../

Sekarang Anda dapat menjalankan:

 reaction develop

Plugin ini sekarang akan dimuat saat berikutnya Anda memulai Open Commerce.

Selamat!! Anda siap untuk mulai berkembang dengan perdagangan terbuka

Lihat instruksi CLI lengkap untuk cara membuat etalase dan admin lokal Anda.

Buka instruksi instalasi lengkap untuk melihat cara mengatur toko Anda

Pengembangan API

Jika Anda mengerjakan plugin inti (tidak mengembangkan plugin untuk instalasi Anda sendiri), Anda harus mengikuti instruksi ini

Apa yang Anda butuhkan

• PNPM
• Buruh pelabuhan
• Docker menyusun

Instal PNPM

npm i -g [email protected]

Klon dan mulai sumbernya

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

Mulai Dev-Server dengan Mongo di Lokal:

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

Mulai Dev-Server dengan MongoDB di Docker

docker-compose up -d
pnpm run start:dev

Aliran Pengembangan

1. Buat beberapa perubahan dalam satu atau lebih paket.
2. Tambahkan perubahan di PR yang sama.
3. Ulangi proses membuat perubahan dan menambahkan perubahan.
4. Buat PR

Cara melepaskan

1. Jalankan tindakan release untuk membuat Version PR . PR ini akan menghapus semua file Changeset, menabrak versi paket, memperbarui file ChangeLog.
2. Gabungan Version PR ke trunk, Circleci akan menerbitkan semua paket ke dalam NPM.

Prerelease mengalir

1. Semua PR akan digabungkan menjadi cabang prerelease sebelum memicu tindakan PRERELEASE .
2. Sebelum menggabungkan PR ke cabang prerelease , pastikan semua perubahan ditambahkan.
3. Tindakan PRERELEASE secara manual untuk membuat Version Packages (next) PR. Setelah digabungkan, perubahan/tindakan akan meningkatkan versi paket sebagai {next-version}-next.{number} , perbarui file changelog.
4. Version Packages (next) PR ke Cabang prerelease , Action akan menerbitkan semua paket ke NPM.

Terlibat

Menyumbang

Jika Anda menyukai apa yang Anda lihat, bintanglah di GitHub.

Temukan bug, kesalahan ketik, atau sesuatu yang tidak didokumentasikan dengan baik? Kami ingin Anda membuka masalah yang memberi tahu kami apa yang dapat kami tingkatkan! Proyek ini menggunakan CommitLint, silakan gunakan format pesan komit mereka.

Kami menyukai permintaan tarikan Anda! Lihatlah Good First Issue dan Help Wanted untuk ditangani. Lihat Panduan Kontributor kami untuk informasi lebih lanjut

Lisensi

Reaksi berlisensi GNU GPLV3