+简体中文 / English
+English / 简体中文
-一个功能强大、架构灵活的企业级交易上商城平台，原生支持B2C、B2B2C、S2B2C、O2O等10余种商业模式，提供统一后台管理多端商城，助力企业快速构建数字化商业基座。 +A powerful and flexibly architected enterprise-grade trading marketplace platform, natively supporting over 10 business models including B2C, B2B2C, S2B2C, and O2O. It provides a unified backend to manage multi-storefront operations, empowering businesses to rapidly build their digital commerce foundation. -## 项目介绍 -ECShopX 是商派基于23年服务全球知名品牌企业的经验沉淀，推出的开源商城系统。它采用模块化架构，支持灵活扩展和个性化定制开发，为企业提供从商品、订单、会员、营销到财务结算的全链路官方商城解决方案。 +## Project Overview +ECShopX is an open-source e-commerce system developed by ShopeX, leveraging 23 years of practical experience in digital project implementation. Built on a modular architecture, it enables flexible scalability and personalized customization, offering enterprises a comprehensive official commerce solution that spans the entire business process—from product and order management to membership, marketing, and financial settlement. -## 适用场景 -* B2C品牌私域商城：构建官方小程序、APP、PC官网、H5等多端DTC商城。 -* B2C员工内购福利平台：支持多品牌集团开展“员工&亲友内购业务”。 -* BBC多商户平台：打造类似京东、美团的“自营+多商户入驻”模式的B2B2C在线平台。 -* SBC供应链协同：建立连接品牌、经销商与终端门店的S2B2C供应链平台。 -* O2O品牌云店+即时零售：O2O品牌云店可实现线上线下一体化的商品、会员、营销与库存管理；支持线上下单，附近门店自提和即时配送等场景。 -* O2O经销商云店：专为品牌企业赋能经销商开展线上业务的解决方案。该系统通过搭建统一平台，聚合所有经销商门店资源，实现"线上下单、门店发货/自提"的O2O模式。核心价值在于打通品牌-经销商-消费者的全链路业务场景。 +## Use Cases +* B2C Brand Private Domain Mall: Build a multi-terminal DTC (Direct-to-Consumer) mall covering official Mini Programs, apps, PC official websites, H5, etc. +* B2C Employee Purchase & Welfare Platform: Enable multi-brand groups to launch "employee & friends-and-family internal purchase businesses". +* B2B2C Multi-Merchant Platform: Create an online B2B2C platform with the "self-operated + merchant settlement" model, similar to JD.com and Meituan. +* S2B2C Supply Chain Collaboration: Establish an S2B2C supply chain platform connecting brands, distributors, and terminal stores. +* O2O Brand Cloud Store + Instant Retail: The O2O brand cloud store enables integrated online-offline management of commodities, members, marketing, and inventory; it supports scenarios such as online ordering, click-and-collect at nearby stores, and instant delivery. +* O2O Distributor Cloud Store: A mall platform solution for brand owners to empower distributors in developing online O2O businesses. -## 核心特性 -### 多模式商城 -* 统一后台管理：一套系统统一管理B2C、B2B2C、S2B2C等多种业务模式。 -* 全渠道多端适配：无缝支持小程序、APP、H5、PC端，数据完全同步。 -* 多租户隔离：支持平台内多商户独立运营，数据与权限严格隔离。 +## Core Features +### Multi-Mode E-commerce Mall +* Unified Backend Management: A single system to uniformly manage various business models such as B2C, B2B2C, and S2B2C. +* Omni-Channel & Multi-Terminal Adaptation: Seamlessly supports Mini Programs, APPs, H5 pages, and PC endpoints with fully synchronized data across all platforms. +* Multi-Tenant Isolation: Supports independent operations for multiple merchants within the platform, ensuring strict data and permission isolation. -### 商品、订单与营销 -* 店铺管理：展示当前店铺信息店铺名称、地址、店铺号、是否自提、是否快递配送、商家自配送、店铺状态；支持店铺码、店铺支付配置、店铺装修 -* 商品管理：展示商品标题、SKU编码、是否赠品、商品类型、库存、市场价、销售价、店铺销售状态，上下架状态、销售分类；批量修改 -* 订单管理：支持按待支付、待发货、待退款、待自提、已取消、已完成等状态快速筛选订单； -* 智能营销：内置优惠券、积分、会员等级、拼团、秒杀等多种营销工具。 -* 内容管理：内置图文视频种草社区，打造私域专属“小红书” -* 模版管理：支持丰富的自定义场景与行业模版 +### Products, Orders, and Marketing +* Store Management：Display current store information including store name, address, store number, self-pickup availability, express delivery availability, merchant self-delivery, and store status; support store code, store payment configuration, and store decoration. +* Product Management：Display product title, SKU code, gift item status, product type, inventory, market price, selling price, store sales status, shelving status, and sales category; support batch modification. +* Order Management：Support quick filtering of orders by statuses such as pending payment, pending delivery, pending refund, pending pickup, cancelled, and completed. +* Intelligent Marketing：Built-in multiple marketing tools including coupons, points, member levels, group buying, and flash sales. +* Content Management：Built-in image, text and video grass-planting community to create a private domain-exclusive "Xiaohongshu". +* Template Management：Support a wealth of custom scenarios and industry templates. -### 会员与权限 -* 统一会员：打通各端会员体系，实现积分、等级、资产全域通用。 -* 精细化权限：支持平台方、供应商、门店、导购等多角色精细化权限控制。 +### Membership and Permissions +* Unified membership marketing: Integrate membership systems across all channels to enable universal use of points, tiers, and assets throughout the entire ecosystem. +* Fine-grained permission management: Support detailed access control for multiple roles such as platform operators, suppliers, stores, and sales advisors. -### 系统集成与扩展 -* 开放API：提供丰富的RESTful API，便于与ERP、WMS、CRM等第三方系统集成。 -* 模块化设计：核心功能高度模块化，便于二次开发与功能扩展。 +### System Integration and Expansion +* Open API: Provide a rich set of RESTful APIs to facilitate integration with third-party systems such as ERP, WMS, CRM, etc. +* Modular design: The core functions are highly modular, making it easy to perform secondary development and extend functionalities. -## 系统要求 +## System Requirements - php >= 7.4 - lumen = 8.3 - mysql >= 5.7 - redis >= 4.0 -## 安装指南 -### 配置 .env 文件 +## Installation Guide +### Configure the .env file * Update database settings * Update Redis settings * Update other settings -### 安装 +### Installation ``` composer install ``` @@ -58,27 +58,27 @@ composer install ``` cp .env.full .env ``` -按需修改您的信息，最小闭环请修改DB REDIS相关信息即可 +Adjust your info as needed; for a minimal closed loop, just modify the DB and Redis settings. -### 生成 APP_KEY +### Generate APP_KEY ``` php artisan key:generate ``` -### 更新数据库 +### Update Database > The initial login password is > admin Shopex123 ``` php artisan doctrine:migrations:migrate ``` -### 添加语言包并初始化语言环境 +### Add Language and Initialize Language Environment > If you don't need to add more languages, you don't need to execute this command;The sample value of {lang} like 'zh-CN' 'en-CN' ``` php artisan lang:init {lang} ``` -#### NGINX 配置模板 -> 如果您使用 nginx，则可以使用以下文件作为模板。 +### NGINX Config Template +> If you use nginx, you can use the following file as a template ``` server { listen 80; @@ -183,26 +183,24 @@ server { } ``` -### 启动服务 +### Start the Server Launch using 'php server' ``` php -S 127.0.0.1:9058 -t public ``` -## 许可证 -本项目采用 Apache-2.0 开源许可证。 -每个包含在本发行版中的 ECShopX 源文件，均依据 Apache 2.0 开源许可证与ShopeX商派附加条款进行授权。 +## License +This project is licensed under the Apache-2.0 open-source license. +Each ECShopX source file included in this distribution is licensed under the Apache License 2.0, together with the additional terms imposed by ShopeX. -开源软件许可协议（Apache 2.0） —— 请参阅 LICENSE.txt 文件以获取 Apache 2.0 协议的完整文本。 +Open Software License (Apache 2.0) – Please see LICENSE.txt for the full text of the Apache 2.0 license. -## 贡献 -我们欢迎所有形式的贡献！ -请阅读 [CONTRIBUTING.md](CONTRIBUTING.md) 了解如何参与。 +## Contribution +We welcome contributions in all forms! Please read [CONTRIBUTING.md](CONTRIBUTING.md) to learn how to participate. -## 支持 -* 文档：请首先查阅[官方文档](https://op.shopex.cn/doc_ecshopx_dev/docs/readme.html) -* 🐛 问题反馈：请在 [Issues] 中提交。 - -## 致谢 -感谢所有为 ECShopX 做出贡献的开发者、用户以及商派背后的全球品牌客户们！ +## Support +* Documentation: Please refer to the [official documentation](https://op.shopex.cn/doc_ecshopx_dev/docs/readme.html) first. +* 🐛 Issue Reporting: Submit via [GitHub Issues]. +## Acknowledgments +Thank you to all developers and users who have contributed to ECShopX!