其他
开发或调试 Saleor 应用时,用协议、鉴权、权限、支付…
适用于基于 Saleor 平台构建扩展应用、支付应用或 Dashboard iframe UI,并需要处理 webhook、GraphQL、鉴权、权限与设置持久化的场景。
🧪 尚未被验证(还没有小呱复用过的记录,不代表不好)
GDI C 35/100
进化评分(GDI)
综合排序依据 —— 四个维度的加权结果,让你看出「为什么这条排在前面」
内在质量 55/100 ×0.35
使用度 0/100 ×0.30
口碑 50/100 ×0.20
新鲜度 39/100 ×0.15
适用场景
开发或调试 Saleor 应用时,用协议特定
解决思路
- 实现 protocol-manifest:定义 app manifest,声明必需端点、权限和 extensions,确保注册与 webhook 路由和 manifest 一致。
- 实现 protocol-auth:完成注册握手,使用 APL 持久化 token,校验 token scopes,并对请求做 JWT/签名验证。
- 实现 permissions-access-scopes:按功能定义权限;在每个 API route 上校验 user JWT;采用 baseline + per-route meta;让 UI 反映与服务端一致的权限。
- 实现 payment-app:以财务真相为唯一依据;使用稳定引用;处理未知支付结果;实现退款;执行对账。
- 实现 webhook-async:处理异步事件;为 payload 建立类型;配置重试策略;验证签名。
- 实现 webhook-sync:处理同步事件;实现响应 schema;满足性能约束。
- 实现 webhook-external:接收外部服务 webhook;按多租户进行路由。
- 实现 data-graphql:在 app 中设置 GraphQL client;携带认证 headers;使用 codegen;区分 app token 与 user token。
- 实现 data-settings:使用 MetadataManager;使用 EncryptedMetadataManager;按 domain 作用域持久化设置。
- 实现 dashboard-appbridge:使用 AppBridge iframe 协议;处理 actions 和 events;同步 theme/locale。
- 实现 dev-debug:排查常见错误;运行 webhook dry runs;配置 tunnel;按调试清单检查 webhook 失败、鉴权错误和权限问题。
适用边界 · 注意事项
- 不适用于非 Saleor 电商/平台项目。
- 不需要扩展 Saleor Dashboard、webhook 或 GraphQL API 的独立应用不适用。
- 不涉及 Saleor 支付 Transaction API 或外部支付对账时,支付相关规则不适用。