SuperAPI AI 工具集

shopify-reference-architecture

编程与开发

查看项目

更新于 10-15 23:29

技能介绍

用途:该技能用于实现 Shopify 应用参考架构,基于 Shopify 官方 Remix 应用模板,涵盖项目结构、Prisma 会话存储、扩展架构以及推荐的应用模式,适合在设置新的 Shopify 应用时参考。

主要能力:提供官方项目结构(app/routes、extensions、prisma、shopify.app.toml 等);shopify.server.ts 单例配置 API 客户端、会话存储、Webhook 与鉴权钩子;Prisma schema 定义 Session 模型(开发用 SQLite,生产用 PostgreSQL);管理员路由通过 authenticate.admin(request) 获取已鉴权 GraphQL 客户端并用 Polaris 组件渲染;主题应用扩展通过 Liquid 模板与 {% schema %} 提供商家设置。

使用方式:前提为熟悉 Remix 基础、已安装 Shopify CLI 3.x、了解 Prisma ORM。快速脚手架可用:shopify app init --template remix;或 npx degit Shopify/shopify-app-template-remix my-shopify-app 后执行 cd my-shopify-app、npm install、shopify app dev。数据库迁移执行 npx prisma migrate dev,部署扩展执行 shopify app deploy。

适用场景:搭建新 Shopify 应用、配置会话存储、开发管理员后台页面、在线商店主题扩展与 Checkout UI 扩展、Shopify Function 等。

限制:需理解 Remix 与 Prisma 基础;未迁移数据库会报 Session not found;缺少 APP_UNINSTALLED 处理会导致鉴权重定向循环;扩展未部署则不显示;缺少 AppProvider 会导致 Polaris 样式缺失。具体 API 版本、依赖版本及完整实现细节资料暂未提供。