hollar/hollar-solidus

Hollar Solidus Web应用及API Docker镜像

镜像概述

本镜像为Hollar基于Solidus（Rails电商框架）开发的Web应用及API提供Docker化部署支持，包含MySQL、Elasticsearch等依赖服务的配置指南，以及支付集成、产品导入、后台任务处理等核心功能的使用说明，适用于本地开发与测试场景。

核心功能

• Docker部署支持：提供两种部署方式（本地Ruby+Docker服务、全Docker容器化），平衡性能与复杂度需求；
• 支付集成：支持Braintree支付网关配置，可模拟沙盒环境支付流程；
• 产品数据导入：支持从Filemaker直接导入全量产品，或通过CSV文件导入指定SKU产品；
• 图片导入：手动导入产品图片并上传至S3存储；
• 后台任务处理：通过Amazon SQS处理低/中/高/紧急优先级后台任务；
• API测试：提供Postman配置文件，方便API接口调试；
• 社交登录：支持基于本地端口的社交登录配置。

使用场景

• 本地开发环境快速搭建；
• 新功能开发与测试验证；
• API接口调试与集成测试；
• 支付流程模拟与验证；
• 产品数据导入功能测试。

配置说明

部署方式

方式1：推荐（性能最优）

本地运行Ruby/Rails，依赖服务通过Docker启动：

sh
# 依赖安装（一次性命令）
brew install mysql imagemagick wget

# 创建Docker网络
docker network create hollar

# 启动Elasticsearch服务
docker run -d --name elasticsearch-hollar \
  --network hollar \
  -p 9200:9200 -p 9300:9300 \
  elasticsearch:2-alpine

# 启动MySQL服务
docker run -d --name mysql-hollar \
  --network hollar \
  -e MYSQL_ALLOW_EMPTY_PASSWORD=yes -e MYSQL_ROOT_PASSWORD="" \
  -p 3306:3306 \
  mysql

sh
# 初始化环境（会清除现有环境）
./bin/bootstrap

# 启动应用
./bin/start
# 访问地址：http://localhost:3000

重启后需重新启动服务：

sh
docker start elasticsearch-hollar
docker start mysql-hollar

方式2：全Docker部署（最简单）

全容器化部署，适合测试场景（性能较低）：

sh
docker network create hollar
docker-compose run --rm web ./bin/bootstrap
docker-compose up -d
# 访问地址：http://localhost:33000

架构注意事项

本项目基于面向对象设计，禁止使用实现命令模式的服务对象。应使用ActiveSupport Concerns提取模型逻辑，而非创建独立服务类。详情参考：

• Rails Concerns使用指南
• 贫血领域模型（Martin Fowler）

支付配置（Braintree）

1. 在Solidus后台添加支付方式：
   • Provider：Spree::Gateway::BraintreeGateway
   • Name：描述性名称（如“Braintree测试环境”）
   • Environment：sandbox
   • Display：Both
   • Active：Yes
   • Merchant ID/Public Key/Private Key/Client SEK：从.env文件获取

后台任务处理

通过Amazon SQS运行后台worker：

ruby
bundle exec shoryuken -R -C config/shoryuken.yml

支持4种优先级队列（低/中/高/紧急），如development_low_priority等。

数据库配置

复制config/database.yml.example到config/database.yml即可使用。

产品数据导入（Filemaker）

直接导入全量产品

sh
rake 'filemaker:importer:all_products'
# 测试时导入前10条：rake 'filemaker:importer:all_products[10]'

通过CSV导入指定SKU

1. 在tmp/import/csv/目录创建CSV文件，每行一个SKU；
2. 运行导入命令：

   sh
   rake 'filemaker:importer:all_products_from_csv'
   # 不归档文件：rake 'filemaker:importer:all_products_from_csv[false]'
   

API测试（Postman）

1. 安装Postman：[***]
2. 导入项目api_queries目录下的Backup.postman_dump.json文件即可使用。

其他注意事项

• 礼品卡产品需设置特定名称（Gift Card）、slug（gift-card）及属性（Unsearchable=true）；
• 导入图片时，可注释product_factory.rb中的process_image方法以跳过图片处理，加快导入速度；
• Turbolinks已从项目中移除，JS代码无需针对Turbolink事件。