update README.md.

Signed-off-by: 唐永川 <tangyongchuan@shopex.cn>
This commit is contained in:
唐永川
2025-12-24 07:18:53 +00:00
committed by Gitee
parent c5e44957ae
commit 2e0f5d4604

106
README.md
View File

@@ -1,56 +1,56 @@
<p align="center">![输入图片说明](logo2.png)</p>
<p align="center"><img width="600" height="416" alt="logo2" src="https://github.com/user-attachments/assets/abf6c4c7-8cb1-477e-aea4-9e526cd8225a" /></p>
#
<p align="center">简体中文 / <a href="README_en.md">English</a></p>
<p align="center">English / <a href="README_cn.md">简体中文</a></p>
一个功能强大、架构灵活的企业级交易上商城平台,原生支持B2CB2B2CS2B2C、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.
## 核心特性
### 多模式商城
* 统一后台管理:一套系统统一管理B2CB2B2C、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 ManagementDisplay 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 ManagementDisplay 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 ManagementSupport quick filtering of orders by statuses such as pending payment, pending delivery, pending refund, pending pickup, cancelled, and completed.
* Intelligent MarketingBuilt-in multiple marketing tools including coupons, points, member levels, group buying, and flash sales.
* Content ManagementBuilt-in image, text and video grass-planting community to create a private domain-exclusive "Xiaohongshu".
* Template ManagementSupport 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便于与ERPWMSCRM等第三方系统集成。
* 模块化设计:核心功能高度模块化,便于二次开发与功能扩展。
### 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!