shopix 的安装和配置教程

2025-05-27 06:58:05作者：裴锟轩Denise

项目基础介绍

shopix 是一个正在开发中的电子商务平台，使用 Elixir 语言编写，并基于 Phoenix Web 框架构建。该项目旨在为用户提供一个具备完善功能的电商平台，目前仍在不断开发和完善中，不建议在生产环境中使用，除非经过严格测试。

项目使用的关键技术和框架

Elixir：一种函数式、并发、分布式编程语言，适用于构建可扩展和容错的应用程序。
Phoenix：一个建立在 Elixir 之上的 Web 框架，提供了构建现代 Web 应用程序所需的所有工具和库。
Bootstrap 4：一个前端框架，用于快速开发响应式布局和网页。
Uploadcare：一个图像处理服务，允许用户上传、存储和操作图像。
Braintree：一个支付解决方案，支持多种支付方式，方便用户进行在线交易。

项目安装和配置的准备工作

在开始安装 shopix 之前，请确保您的开发环境满足以下要求：

安装了 Elixir 和 Erlang。
安装了 Node.js 和 npm。
准备了用于数据库的配置信息（如 PostgreSQL 或其他支持的数据库）。
创建了 Uploadcare 和 Braintree 的账户，并获取了必要的 API 密钥。

安装步骤

克隆项目仓库到本地：

git clone https://github.com/nicolasblanco/shopix.git
cd shopix

安装项目依赖：
```
mix deps.get
```

配置数据库访问信息。编辑 config/dev.exs 文件，填写数据库配置：

config :shopix, Shopix.Repo,
  username: "your_username",
  password: "your_password",
  database: "shopix_dev",
  hostname: "localhost",
  ...

创建并迁移数据库：
```
mix ecto.create && mix ecto.migrate
```

运行种子脚本来创建初始管理员账户：

ADMIN_EMAIL=admin@admin.com ADMIN_PASSWORD=abcd1234 mix run priv/repo/seeds.exs

安装 Node.js 依赖：
```
cd assets && npm install
```
启动 Phoenix 端点：
```
mix phx.server
```
在浏览器中访问 http://localhost:4000/admin，使用管理员凭据登录。
在全局配置标签中，填写 Uploadcare 公钥。

在“支付网关”字段中，添加 Braintree 配置信息：

{
  "provider_config":{
    "public_key":"your_braintree_public_key",
    "private_key":"your_braintree_private_key",
    "merchant_id":"your_braintree_merchant_id",
    "environment":"sandbox",
    "client_token":"your_braintree_tokenized_key"
  }
}