marketplace demo

市场入门套件

根据 MIT 许可条款，该 Stelace 入门套件可免费使用。请随意分叉、贡献或将其变成您自己的❤️。

---

该入门套件提供了一个类似 AirBnB 的高性能市场前端 (Vue.js)，具有基于开源 Stelace API 服务器的预配置无服务器部署。

内容

• 特征 ？
  • 默认情况下很快？
  • 集成
• 测试
• 堆
• 入门
• 部署

现场演示

还提供专注于搜索、自动化和实时的平台模板。

斯泰莱丝是什么？

Stelace API 为从搜索密集型市场到在线社区应用程序的 Web 平台提供高级搜索、资产和用户管理、自动化和内容交付 API。 Stelace 开源市场后端可让您专注于使您的平台独一无二的方面。

API文档

---

特征 ？

• 资产管理。资产可以是任何东西，从公寓、房屋到汽车或音乐会
• 强大且容错的搜索？，基于相关性和动态可用性
• 用户身份验证，包括社交登录和 SSO
• 用户管理和评级
• 实时事件和消息传递
• 使用 Stelace 工作流程实现自动化？
• 使用无服务器功能的可定制支付流程
• 无头 CMS ？使用 Stelace 内容 API
• 图像和用户文件的全局 CDN
• 国际化？以及完整的翻译
• 无障碍
• ……
• 以及 Stelace API 的更多功能

默认情况下很快？

开箱即可获得 90+ PageSpeed 分数：

• 预渲染静态页面以实现最快的页面加载，并将 Vue.js 融入完整的 SPA。
• 使用quasar.conf.js中优化的 Webpack 配置进行代码分割。
• 使用 WebP 进行图像压缩并使用 AWS Lambda 无服务器调整大小
• 资源预取和预加载
• 感谢 Quasar，PWA 已准备就绪

该套件遵循 PRPL 模式：文档中的更多信息。

集成

利用这些集成可以更快地开始运行您的平台：

• 使用 Netlify 进行自动化和持续部署
• 使用 Netlify 功能和 Stelace 工作流程进行 Stripe 支付
• Sentry用于生产环境调试
• 通过 OpenStreetMap 提供商进行地图和地点搜索
• 谷歌分析

测试

• 使用 TestCafé 进行端到端跨浏览器测试
• 与 CircleCI 持续集成

堆

无服务器 JAMStack 架构：

• Vue.js
• 类星体框架
• Stelace API 作为后端
• Stelace 无头 CMS
• Stelace.js SDK
• Netlify 用于静态站点和 lambda 函数部署

Node.js >= 10.18 用于工具。

入门

您需要 Stelace API 密钥才能开始。好消息：Stelace 是开源的，因此您可以部署自己的服务器。

1. 克隆这个存储库

git clone https://github.com/stelace/marketplace-demo.git
cd marketplace-demo

2. 安装node_modules

 # using yarn instead of npm is recommended
yarn

如果您没有安装yarn，您可以按照这些说明进行操作。

3. 创建用于开发和生产的环境文件。

您可以复制.env.example并用 Stelace API 密钥填充它（使用服务器端开源项目生成它们）。

cp .env.example .env.development
# You may want to use live keys in this file
cp .env.example .env.production

需要填写以下环境变量：

• STELACE_INSTANT_WEBSITE_URL
• Vue 应用程序中使用的STELACE_PUBLISHABLE_API_KEY ( pubk_ ...)
• STELACE_SECRET_API_KEY ( seck_ ...) 用于数据播种脚本
• STELACE_API_URL可以留空，除非您使用自己的服务器而不是默认的api.stelace.com

请参阅.env.example了解有关环境变量的更多详细信息，包括地图、支付网关、日志记录和分析。

4. 种子发育数据

yarn seed

5. 启动开发服务器

quasar dev
# or, if you want to run Netlify functions with stripe payments as well:
yarn dev

有关前端配置和组件的更多详细信息，请参阅 Quasar 文档。

使用自托管的 Stelace API 服务器（开源后端）进行开发。

在启动该项目的服务器之前，必须在本地启动 Stelace Core API 服务器。

首先我们需要启动 Stelace Core API 所需的服务。

yarn docker:db

然后我们需要使用即时配置来初始化数据库。

 cd /path/to/stelace-core
git checkout dev
yarn setup:instant

将显示秘密和可发布的 api 密钥，以便您可以将其用作该项目的环境变量。您还需要设置一些环境变量，例如STELACE_API_URL (http://127.0.0.1:API_PORT)。

让我们启动服务器。

yarn dev

请参考stelace-server项目中的.env.example 。

6. 品牌推广

在src/styles.json中使用您自己的颜色和品牌自定义应用程序，记录在 styles.json.md 中。

部署

请参阅部署文档部分了解更多详细信息。