Mailchimp Open Commerce (trước đây là Reaction Commerce)
Mailchimp Open Commerce là một nền tảng thương mại API đầu tiên, không có giao diện người dùng, được xây dựng bằng Node.js, MongoDB và GraphQL. Nó hoạt động tốt với npm, Docker và Kubernetes.
Tính năng
| Nhanh Chóng | Trả về dữ liệu trong vài giây, và các truy vấn nhanh hơn đồng nghĩa với trang web nhanh hơn |
|---|---|
| Được Chứng Minh | Open Commerce cung cấp nhiều trang web thực hiện hàng chục nghìn đơn hàng mỗi ngày với hàng trăm nghìn sản phẩm |
| Có Thể Tùy Chỉnh | Hệ thống plugin linh hoạt cho phép bạn chọn lựa các tích hợp phù hợp nhất với bạn |
| Đa Khách Hàng | Lưu trữ nhiều cửa hàng trong cài đặt cùng một lúc |
| Mở Rộng | Bắt đầu với một máy chủ duy nhất và mở rộng lên hàng trăm máy chủ |
| Sản Phẩm Linh Hoạt | Cho phép Sản phẩm, với các tùy chọn và biến thể phù hợp với nhiều nhu cầu khác nhau |
| Quản Lý Kho | Theo dõi tồn kho, cho phép hoặc không cho phép đặt hàng sau và nhiều hơn nữa |
| Vận Chuyển | Tích hợp với nhà cung cấp giá vận chuyển hoặc xây dựng bảng giá vận chuyển tùy chỉnh của riêng bạn |
| Thuế | Tích hợp với nhà cung cấp thuế hoặc xây dựng bảng thuế tùy chỉnh của riêng bạn |
| Thực Hiện | Hệ thống thực hiện linh hoạt cho phép bạn tạo phương thức thực hiện riêng của bạn |
| Theo Dõi Đơn Hàng | Xem và quản lý đơn hàng của bạn trong hệ thống quản trị được bao gồm |
| Emails | Mẫu có thể tùy chỉnh cho xác nhận đơn hàng và nhiều tính năng khác |
| Mở | Hoàn toàn mã nguồn mở. Không bị khóa lại nữa |
Bắt đầu
Để bắt đầu làm việc với dự án của bạn dựa trên Mailchimp Open Commerce, bạn có thể bắt đầu bằng cách sử dụng công cụ dòng lệnh mới của chúng tôi. Công cụ dòng lệnh là cách nhanh nhất và dễ dàng nhất để phát triển trên Open Commerce. Nó cho phép bạn tạo và làm việc với các dự án API, Quản trị và Cửa hàng tất cả thông qua dòng lệnh.
Những gì bạn cần
Chúng tôi khuyên bạn nên cài đặt nvm
Ngoài ra, bạn cần thiết lập hệ thống của mình cho SSH authentication with GitHub
Cài đặt CLI
Trước tiên, cài đặt CLI bằng cách chạy:
npm install -g reaction-cli
Bạn có thể kiểm tra xem nó đã hoạt động tại đây bằng cách chạy:
reaction help
Tạo dự án
Bạn có thể tạo dự án Open Commerce của mình bằng cách chạy:
reaction create-project api <your-project-name>
Điều này sẽ tạo ra một dự án Open Commerce trong thư mục . Khi hoàn thành, điều hướng đến thư mục dự án:
cd <your-project-name>
Cài đặt các phụ thuộc của dự án:
npm install
Cuối cùng, khởi động máy chủ ở chế độ phát triển:
reaction develop api
Lưu ý: Theo tùy chọn, từ bên trong thư mục dự án, bạn có thể thực hiện lệnh trên mà không cần đề cập đến loại dự án và CLI sẽ kiểm tra package.json của bạn để lấy “projectType” và lấy nó từ đó. Điều này đòi hỏi dự án chính đã được xây dựng bằng phiên bản mới nhất của CLI như được giải thích trong các bước ở trên.
Ví dụ, thay vì lệnh ở trên, bạn có thể bỏ qua việc đề cập ‘api’ và chỉ sử dụng:
reaction develop
Điều này sẽ khởi động máy chủ GraphQL Open Commerce và Máy chủ Mongo. Nhấn Ctrl+C để dừng lại.
- Một plugin tùy chỉnh mẫu đã được cài đặt, và bạn nên thấy kết quả của nó trong các nhật ký. (Your Sample Plugin)
-
Để thêm một plugin mới dựa trên mẫu plugin của chúng tôi, hãy chạy:
reaction create-plugin api
Xác minh xem plugin đã được tạo trong custom-packages
cd custom-packages
cd <your-plugin-name>
npm install
Bây giờ bạn cần quay lại thư mục gốc:
cd ../../
Bây giờ bạn có thể chạy:
reaction develop
Plugin này sẽ được tải lên lần sau khi bạn khởi động Open Commerce.
Chúc mừng!! Bạn đã sẵn sàng để bắt đầu phát triển với Open Commerce
Xem Complete CLI instructions để biết cách tạo cửa hàng địa phương và bảng quản trị của bạn.
Điều hướng đến installation instructions để xem cách thiết lập cửa hàng của bạn
Phát triển API
Nếu bạn đang làm việc trên các plugin chính (không phát triển plugin cho cài đặt riêng của bạn) bạn nên tuân theo hướng dẫn này
Những gì bạn cần
Cài đặt PNPM
npm i -g pnpm@7.11.0
Sao chép và Khởi chạy nguồn
git clone https://github.com/reactioncommerce/reaction.git
cd reaction
pnpm install
cp apps/reaction/.env.example apps/reaction/.env
Khởi chạy máy chủ phát triển với mongo cục bộ:
## you must change MONGO_URL in the .env to mongodb://localhost:27017/reaction before start
pnpm run start:dev
Khởi chạy máy chủ phát triển với mongodb trên docker
docker-compose up -d pnpm run start:dev
Luồng phát triển
. Thực hiện một số thay đổi trong một hoặc nhiều gói.
. Add a changeset trong cùng PR đó.
. Lặp lại quy trình thực hiện thay đổi và thêm các changesets.
. Tạo PR
Cách phát hành
. Chạy hành động release để tạo Phiên bản PR. PR này sẽ loại bỏ tất cả các tệp changeset, tăng phiên bản các gói, cập nhật tệp CHANGELOG.
. Ghép nối Phiên bản PR vào nhánh chính, CircleCI sẽ xuất bản tất cả các gói lên npm.
Luồng trước khi phát hành
. Tất cả các PR sẽ được ghép vào nhánh prerelease trước khi kích hoạt hành động PRERELEASE.
. Trước khi ghép các PR vào nhánh prerelease, hãy đảm bảo rằng tất cả các changeset đã được thêm vào.
. Kích hoạt hành động PRERELEASE bằng tay để tạo Phiên bản Gói (next) PR. Sau khi ghép nối, changeset/hành động sẽ tăng phiên bản các gói thành {next-version}-next.{number}, cập nhật tệp CHANGELOG.
. Ghép nối Phiên bản Gói (next) PR vào nhánh prerelease, hành động sẽ xuất bản tất cả các gói lên npm.
Tham gia
Đóng góp
⭐ Nếu bạn thích những gì bạn thấy, hãy đánh dấu sao cho chúng tôi trên GitHub.
Tìm thấy lỗi, lỗi chính tả hoặc điều gì đó không được tài liệu tốt? Chúng tôi rất muốn bạn open an issue cho chúng tôi biết chúng tôi có thể cải thiện điều gì! Dự án này sử dụng commitlint, hãy sử dụng commit message format của họ.
Chúng tôi yêu các yêu cầu kéo của bạn! Kiểm tra các Good First Issue và Help Wanted của chúng tôi để tìm các vấn đề tốt để giải quyết. Kiểm tra contributors guide của chúng tôi để biết thêm thông tin
Open Commerce Website | Twitter | Documentation | Discord | Discussions
Chi tiết Tải về:
Tác giả: Reactioncommerce
Mã nguồn: https://github.com/reactioncommerce/reaction
Giấy phép: GPL-3.0 license
