spreecommerce/spree

Spree 电商解决方案镜像

Spree是一个基于Ruby on Rails的完整开源电商解决方案，最初由Sean Schofield开发，现由Spark Solutions维护。它包含多个模块化组件，支持灵活定制和扩展，适用于各类电商场景。

核心功能

• spree_core：核心模型、服务与邮件功能，是Spree运行的基础组件。
• spree_frontend：默认的Rails客户前端界面，提供商品浏览、购物车等功能。
• spree_backend：管理面板，支持商品、订单、用户、库存等全流程管理。
• spree_api：提供REST API v1/v2（即将支持GraphQL），便于第三方系统集成。
• spree_cmd：命令行工具，简化项目初始化与管理操作。
• spree_sample：示例数据，帮助快速测试平台功能。

使用场景

• 快速搭建中小型电商网站。
• 定制化电商平台（如多商户、多币种、多语言场景）。
• 集成第三方支付网关、物流服务或分析工具。

配置说明

Docker部署示例

运行Spree示例应用：

shell
docker run --rm -it -p 3000:3000 spreecommerce/spree:3.6.4

• 前端访问：http://localhost:3000
• 管理面板：http://localhost:3000/admin（默认凭据：*** / spree123）

Rails项目集成

根据Rails版本添加Gem依赖：

Rails 5.2

ruby
gem 'spree', '~> 3.7.0.rc1'
gem 'spree_auth_devise', '~> 3.4'
gem 'spree_gateway', '~> 3.4'

Rails 5.1

ruby
gem 'spree', '~> 3.5.0'
gem 'spree_auth_devise', '~> 3.4'
gem 'spree_gateway', '~> 3.4'

Rails 5.0

ruby
gem 'spree', '~> 3.2.7'
gem 'spree_auth_devise', '~> 3.4'
gem 'spree_gateway', '~> 3.4'

安装步骤：

1. 执行bundle install安装依赖。
2. 运行生成器初始化：

shell
rails g spree:install --user_class=Spree::User
rails g spree:auth:install
rails g spree_gateway:install

3. 启动服务器：rails server，访问http://localhost:3000。

扩展支持

Spree提供丰富扩展，如支付网关（spree_gateway）、多币种（spree_multi_currency）、多商户（spree_multi_vendor）等，可通过Gemfile集成所需功能。

性能优化

开发环境中可关闭资产调试以提升速度，在config/environments/development.rb中添加：

ruby
config.assets.debug = false

许可证

Spree采用New BSD License开源协议，允许自由使用、修改和分发。