拆分付款POC：教程快速参考

本页总结了如何组织分割支付概念验证教程系列。 它会将每个编号的源提示文件映射到其发布的Experience League页面，列出读者建议的分区顺序，并收集作者和维护者的注释。

逐文件引用

创建拆分付款POC：App Builder和AI工具

Source标签： 00_TUTORIAL_OVERVIEW.md （概念性概述；发布的系列随此页面打开。）

目的：​本教程的简介和方向。

为什么需要它：​在“如何”之前为开发人员提供“原因”。 解释他们将构建的内容、受众是谁，以及关键是，如果他们的站点与干净的Luma安装不同，则必须自定义哪些内容。 还用作系列其余部分的目录。

教程使用：​正在打开部分。 在任何技术步骤之前设置上下文。

拆分付款POC：架构和设计决策

目的：​对PoC中的每个架构决策进行深入说明。

为什么需要它：​使用此PoC时最常见的困惑点是了解​为什么 PHP与App Builder中的某些内容。 如果没有此上下文，开发人员会尝试移动无法移动的项目（例如商店信用申请）并失败。 本文档用明确的推理来预防这些故障。

涵盖的关键主题：

教程使用：“架构”或“工作原理”部分。 经验丰富的Commerce开发人员可以跳过，但对于App Builder的新手至关重要。

拆分付款POC：先决条件和环境设置

用途：​在编写代码或运行提示之前完成预检核对清单。

为什么需要它：​安装阶段在教程中具有最高的失败率。 本文档确保正确配置Commerce管理员（准确的COD标题、启用商店点数、测试客户余额、创建集成），并确保App Builder项目连接I/O事件和Commerce事件提供程序，以及本地环境具有正确的版本。

强调项：

教程使用：“先决条件”或“入门”部分。 应该以交互方式完成 — 而不仅仅是阅读。

拆分付款POC：环境变量引用

用途：​所有三个组件的所有环境变量都集中在一处。

为什么需要它：​相同的四个OAuth凭据出现在三个具有不同变量名称（COMMERCE_*与COMMERCE_INTEGRATION_*）的不同文件中。 只有一个引用会阻止在一个凭据集出现拼写错误时进行“为何无法正常工作”调试。

组件已覆盖：

教程使用：​引用侧边栏或“配置”部分。 还用作生成提示的助手。

拆分付款POC：Commerce模块AI提示

用途：​完整、自包含的AI提示生成整个Client_SplitPayment PHP模块。

为什么需要它：​这是PHP端的主AI生成工件。 编写此脚本的目的是让没有PHP经验的开发人员可以将其交付给Cursor（使用Claude）并获得工作模块。 每个文件都被指定，每个行为契约都被定义，关键实现注释被包含在内，并且提供了用于以后启用该模块的命令。

覆盖范围：

教程用法：“构建Commerce模块”部分。 提示本身就是人工因素 — 开发人员将其复制到他们的人工智能工具中并运行它。

拆分付款POC：App Builder orchestrator AI提示

用途：​用于生成split-payment-orchestrator App Builder应用程序的完整、自包含的AI提示。

为什么需要它：​四个App Builder操作(payment-orchestrator、payment-accept、payment-decline、demo-dashboard)是“移出PHP的内容”故事的核心。 此提示会生成所有具有完整行为规范、正确app.config.yaml结构和事件注册配置的规则集。

覆盖范围：

教程使用：“构建App Builder应用程序”部分。 伴随Commerce module提示符。

拆分付款POC：Experience Cloud UI扩展AI提示

用途： AI提示生成可选的Experience Cloud Admin UI SDK扩展。

为什么需要它： Orchestrator提示中的演示仪表板刻意粗糙 — 它是概念验证，而不是生产。 此部分向开发人员展示下一步骤：使用管理UI SDK将拆分付款仪表板嵌入到Commerce管理外壳程序中。 原始提示中完全缺失它。

覆盖范围：

教程使用：​可选的“更进一步”或“生产路径”部分。 如果本教程仅侧重于PoC，则可以跳过。

拆分付款POC：测试和验证指南

用途：​分步测试指南按正确的验证顺序覆盖了每个组件。

为什么需要它：​生成组件只完成一半的工作。 开发人员需要明确的验证路径，从最低级别（数据库列、REST端点）开始，构建到完整的端到端流程。 最初的提示有一个设置核对清单，但没有明确的测试流程。

覆盖范围：

教程使用：“测试”或“验证”部分。 也可用作故障排除参考。

拆分付款POC：概念验证后的后续步骤

用途：​将PoC发展为生产就绪模式的路线图。

为什么需要它： PoC教程可能会让开发人员知道“现在怎么办？” 感觉。 本文档将演示的自然进展映射到生产：使用Experience Cloud扩展替换演示仪表板，连接真正的ERP，添加API Mesh，扩展App Builder工作流程，以及生产部署核对清单。

密钥内容：

教程使用：“后续步骤”结束部分。 对于设定实际项目的范围而言，作为对话起始者也很有用。

建议的教程部分

基于这些文件，读者适用的典型结构为：

面向教程作者的重要说明

根据Luma主题假设：​每个生成提示都生成用于干净的Luma安装的代码。 教程应在顶部清楚地说明这一点 — 具有自定义结账的开发人员将需要调整LayoutProcessorPlugin注入路径并可能调整RequireJS配置。 系列简介和构建提示包括此内容的自定义标注。

在PHP模块上：​该教程显式不提供PHP代码作为复制粘贴下载。 AI提示符​ 生成 ​它。 这是有意为之 — 它教导了使用AI创建Commerce扩展的模式，而不仅仅是复制粘贴样板。 但是，当在干净环境中出现提示时，生成的代码应该与app/code/Client/SplitPayment/中的工作代码完全匹配。

在$100阈值上：​这是硬编码的PoC值。 本教程应注意，实际商店将需要通过Commerce管理配置而不是编译时常量来配置此设置。

商店点数依赖关系：​生成的拆分付款流需要Magento_CustomerBalance（本地商店点数模块）。

Related split payment POC resources