shopix 的安装和配置教程

项目基础介绍

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

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

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

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

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

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

安装步骤

1. 克隆项目仓库到本地：

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

2. 安装项目依赖：

   mix deps.get
   

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

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

4. 创建并迁移数据库：

   mix ecto.create && mix ecto.migrate
   

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

   ADMIN_EMAIL=[e-mail] ADMIN_PASSWORD=abcd1234 mix run priv/repo/seeds.exs
   

6. 安装 Node.js 依赖：

   cd assets && npm install
   

7. 启动 Phoenix 端点：

   mix phx.server
   

8. 在浏览器中访问 http://localhost:4000/admin，使用管理员凭据登录。

9. 在全局配置标签中，填写 Uploadcare 公钥。

10. 在“支付网关”字段中，添加 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"
      }
    }
    

完成以上步骤后，您应该能够成功安装和配置 shopix 电子商务平台，并开始开发工作。