saleor/saleor

## 目录 - [Saleor 的独特之处](#what-makes-saleor-special) - [为何采用仅 API 架构？](#why-api-only-architecture) - [功能特性](#features) - [安装](#installation) - [文档](#documentation) - [Saleor 平台](#saleor-platform) - [店面](#storefront) - [仪表板](#dashboard) - [贡献指南](#contributing) - [许可证](#license) ## 什么让 Saleor 独特？ - **Technology-agnostic** - no monolithic plugin architecture or technology lock-in. - **GraphQL only** - Not afterthought API design or fragmentation across different styles of API. - **Headless and API only** - APIs are the only way to interact, configure, or extend the backend. - **Open source** - a single version of Saleor without feature fragmentation or commercial limitations. - **Cloud native** - battle tested on global brands. - **Native-multichannel** - Per [channel](https://docs.saleor.io/developer/channels/overview) control of pricing, currencies, stock, product, and more. ## 为什么采用仅 API 架构？ Saleor's API-first extensibility provides powerful tools for developers to extend backend using [webhooks](https://docs.saleor.io/developer/extending/webhooks/overview), attributes, [metadata](https://docs.saleor.io/api-usage/metadata), [apps](https://docs.saleor.io/developer/extending/apps/overview), [subscription queries](https://docs.saleor.io/developer/extending/webhooks/subscription-webhook-payloads), [API extensions](https://docs.saleor.io/developer/extending/webhooks/synchronous-events/overview), [dashboard iframes](https://docs.saleor.io/developer/extending/apps/overview). Compared to traditional plugin architectures (monoliths) it provides the following benefits: - There is less downtime as apps are deployed independently. - Reliability and performance - custom logic is separated from the core. - Simplified upgrade paths - eliminates incompatibility conflicts between extensions. - Technology-agnostic - works with any technology, stack, or language. - Parallel development - easier to collaborate than with a monolithic core. - Simplified debugging - easier to narrow down bugs in independent services. - Scalability - extensions and apps can be scaled independently. ### 有什么权衡？ If you are a single developer working with a small business that doesn't have high traffic or a critical need for 24/7 availability, using a service-oriented approach might feel more complex compared to the traditional WordPress or Magento approach that provides a language-specific framework, runtime, database schema, aspect-oriented programming, and other tools to a quick start. However, if you deploy on a daily basis, reliability and uptime is critical, you need to collaborate with other developers, or you have non-trivial requirements you might be in the right place. ## 特性 - **Enterprise ready**: Secure, scalable, and stable. Battle-tested by big brands - **Dashboard**: User-friendly, fast, and productive. (Decoupled project [repo](https://github.com/saleor/saleor-dashboard) ) - **Global by design** Multi-currency, multi-language, multi-warehouse, tutti multi! - **CMS**: Manage product or marketing content. - **Product management**: A rich content model for large and complex catalogs. - **Orders**: Flexible order model, split payments, multi-warehouse, returns, and more. - **Customers**: Order history and preferences. - **Promotion engine**: Sales, vouchers, cart rules, giftcards. - **Payment orchestration**: multi-gateway, extensible payment API, flexible flows. - **Cart**: Advanced payment and tax options, with full control over discounts and promotions. - **Payments**: Flexible API architecture allows integration of any payment method. - **Translations**: Fully translatable catalog. - **SEO**: Unlimited SEO freedom with headless architecture. - **Apps**: Extend dashboard via iframe with any web stack.  ## 安装 [See the Saleor docs](https://docs.saleor.io/setup/docker-compose) for step-by-step installation and deployment instructions. For local development without Docker, follow our [Contributing Guide](./CONTRIBUTING.md). Note: The `main` branch is the development version of Saleor and it may be unstable. To use the latest stable version, download it from the [Releases](https://github.com/saleor/saleor/releases/) page or switch to a release tag. The current production-ready version is 3.x and you should use this version for all three components: - Saleor: - Dashboard: - Storefront: ### Saleor Cloud The fastest way to develop with Saleor is by using developer accounts in [Saleor Cloud](https://cloud.saleor.io). Register [here](https://cloud.saleor.io/register) or install our [CLI tool](https://github.com/saleor/saleor-cli): `npm i -g @saleor/cli` and run the following command: `saleor register` Bootstrap your first [storefront](https://github.com/saleor/react-storefront) with: `saleor storefront create --url {your-saleor-graphql-endpoint}` ## 文档 Saleor documentation is available here: [docs.saleor.io](https://docs.saleor.io) To contribute, please see the [`saleor/saleor-docs` repository](https://github.com/saleor/saleor-docs/). ## Saleor 平台 The easiest way to run all components of Saleor (API, storefront, and dashboard) together on your local machine is to use the [saleor-platform](https://github.com/saleor/saleor-platform) project. Go to that repository for instructions on how to use it. [View saleor-platform](https://github.com/saleor/saleor-platform) ## 店面 An open-source storefront example built with Next.js App Router, React.js, TypeScript, GraphQL, and Tailwind CSS. [React Storefront Repository](https://github.com/saleor/storefront) [View Storefront Example](https://storefront.saleor.io/) ## 仪表板 For the dashboard, go to the [saleor-dashboard](https://github.com/saleor/saleor-dashboard) repository. ## 贡献 We love your contributions and do our best to provide you with mentorship and support. If you are looking for an issue to tackle, take a look at issues labeled [`Good first issue`](https://github.com/saleor/saleor/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+first+issue%22+) and [`Help wanted`](https://github.com/saleor/saleor/issues?q=is%3Aopen+is%3Aissue+label%3A%22help+wanted%22). If nothing grabs your attention, check [our roadmap](https://saleor.io/roadmap) or [start a Discord discussion](https://saleor.io/discord) about a feature you'd like to see. Make sure to read our [Contribution Guidelines](http://docs.saleor.io/developer/community/contributing) before opening a PR or issue. Get more details (e.g., how to run Saleor on your local machine) in our [Contributing Guide](./CONTRIBUTING.md). ## 许可 Disclaimer: Everything you see here is open and free to use as long as you comply with the [license](https://github.com/saleor/saleor/blob/main/LICENSE). There are no hidden charges. We promise to do our best to fix bugs and improve the code. #### 用心打造 ❤️ 由 [Saleor Commerce](https://saleor.io)

标签：API, Commerce API, GraphQL, Headless Commerce, Saleor, SEO, Webhooks, 仪表盘, 元数据, 可组合, 可靠性, 同步事件, 后端API, 多渠道, 子域名突变, 开源商城, 开源许可, 扩展性, 技术无关, 文档, 无头架构, 独立部署, 电商, 电商平台, 订阅查询, 请求拦截, 逆向工具