迁移评估
Commerce迁移评估是对您现有Adobe Commerce实施情况的自动分析。 Adobe的工具会扫描您的Commerce代码库,并生成一个结构化报表,其中清点所有已构建、自定义或修改的内容。 然后,该报告将指示对代码库所做的自定义对迁移到Adobe Commerce as a Cloud Service有何影响。
报告以HTML文件的形式提供,您可以通过任何浏览器打开。 不需要访问生产环境,除非最初共享项目代码库。
评估提供:
- 按类型和影响级别组织的商店中每个自定义模块的完整清单
- 根据风险预测指标计算的迁移复杂性评级(高、Medium或低)
- 需要规划迁移的最具影响力的后端和店面区域的优先级视图
- 每个自定义模块的描述,可将其用作Adobe AI开发人员工具的直接输入
了解迁移评估报告
报告分为三个选项卡: Summary、Module Reports和Report Reliability。
“摘要”选项卡
“Summary”选项卡概述了按以下区域组织的关键信号:
- 迁移复杂性
- 文件类型划分
- 影响最大的模块
- 迁移驱动因素
- 自定义细分
迁移复杂性
迁移复杂性部分包含对存储整体的评估评级。 它解释了得分的计算方式,并强调了您的主要风险驱动因素。
迁移复杂性和复杂性分数
复杂性分数根据迁移的难度对每个输入进行加权。 得分映射到使用固定阈值的迁移复杂性评级:
自定义模块比率
专门为您的实施构建的模块的百分比。 更高的比率意味着必须审核和迁移更多的自定义代码。 客户的自定义模块平均比率约为62%。
文件类型划分
代码库中按类型组织的文件数列表。
影响最大的模块
存储中需要最关注迁移的特定模块的策划列表。 这些模块通常是与结账、支付或订单管理交互的模块。 每个高影响力的模块都需要自己的迁移计划。 此列表是与您的技术团队进行对话的最佳起点。
店面复杂性
店面复杂性部分介绍了迁移店面的前端展示层所需的工作。 此工作流是与后端代码迁移截然不同的工作流,由前端开发人员解决,通常需要单独的规划对话。
-
自定义主题 — 商店自定义主题的命名空间(例如,BrandName_Theme)。 自定义主题的存在意味着Adobe Commerce as a Cloud Service需要完整主题重建。 每个具有自定义主题命名空间的评估存储都必须规划一个专用的前端迁移工作流。
-
总块数 — 存储中的块和模板(.phtml)文件的数量。 块是主要的服务器端渲染构件,每个构件代表一个离散的迁移任务。
迁移驱动因素
“迁移驱动程序”部分显示驱动复杂性评定的主要因素。
每个驱动程序均显示为“高”、“Medium”或“低”工作量。 在设定范围和规划时,首先解决评级最高的驱动程序问题。
数据模型
“数据模型”部分显示自定义表的计数、对Adobe Commerce核心数据库表的修改以及关键实体属性值(EAV)属性。
核心表修改是最难迁移的类别,因为它们会创建对特定平台架构版本的依赖关系,并且对于复杂性分数公式影响较大。
自定义细分
“自定义细分”部分提供了您的商店中每个自定义类别的详细量度。
布局XML
布局XML文件的数量及其总操作计数。 布局XML定义每个页面的结构,包括出现的块、它们出现的容器以及它们所属的页面类型。
文件数量多,操作繁多,表明必须重新构建重要的页面结构自定义。
核心句柄覆盖
布局XML覆盖核心Adobe Commerce页面句柄的地点数(例如,checkout_cart_index或catalog_product_view)。 核心句柄覆盖是风险最高的布局信号,因为它们会在平台级别修改页面结构,并且需要明确重建。
个块
存储中的块和模板(.phtml)文件的数量。 块是主要的服务器端渲染构件。 每个块代表一个离散的迁移任务。
高风险块
接触核心渲染路径的块,例如结帐渲染、购物车显示和类似的前端表面。 任何高风险块在计划之前都需要进行单独的迁移评估。
主题和电子邮件模板
商店自定义主题的命名空间(例如,BrandName_Theme)。 自定义主题的存在意味着需要重建完整主题。 每个具有自定义主题命名空间的评估存储都必须规划一个专用的前端迁移工作流。
模板覆盖(修改了核心)
已覆盖的核心Adobe Commerce .phtml模板数。 每个核心模板覆盖都会创建对该模板特定版本的依赖关系。 平台更新可更改模板以静默方式中断覆盖。
需要插入式迁移
Adobe Commerce as a Cloud Service对店面使用模块化插入组件架构,包括结帐、购物车和产品详细信息。 必须将这些曲面的定制作为放置元件重新构建。 这些自定义可涵盖广泛的功能,例如添加自定义结账步骤、修改购物车显示逻辑或扩展产品详细信息页面。
Drop-in migration required字段指示哪些店面区域需要插入式重建。
“模块报表”选项卡
Module Reports选项卡包含商店中每个自定义模块的专用条目。 与您的技术团队共享此信息。
对于每个模块,报表均会显示:
工作流
-
首先筛选到 高影响 模块。 这些带来了最大的迁移工作量和成本。
-
对于每个自定义模块,请确定以下问题的答案:
- 是否仍在积极使用此模块?
- 能否将模块替换为本机Adobe Commerce as a Cloud Service功能?
- 如果必须重新构建模块,其替换需要提供什么功能?
-
确定可以弃用或替换的自定义模块。 在写入任何代码之前,每个代码都会缩小迁移范围。
-
使用 重新生成 迁移建议复制每个自定义模块的说明。 这些描述可以直接提供给Adobe的AI开发人员工具,有关详细信息,请参阅用于Commerce扩展性的AI开发人员工具。
参考:关键术语
用于Commerce可扩展性的AI开发人员工具
您可以使用 Module Reports 选项卡中的模块描述作为Adobe AI开发人员工具的提示。 该工具可帮助您构建和部署与Adobe Commerce as a Cloud Service兼容的替换扩展。
工具提供的功能
Adobe的用于Commerce可扩展性的AI开发人员工具包含两个主要功能。
- Adobe Commerce App Builder MCP服务器 — 模型上下文协议(MCP)集成,用于将AI编码助理直接连接到Adobe Commerce文档、API和App Builder开发模式。 开发人员可以描述他们要构建的内容,MCP服务器在IDE中提供了可感知Commerce的代码生成、架构指导和部署自动化。
- 代理技能 — 预建的人工智能技能,涵盖常见的Commerce可扩展性模式,如REST API、签出扩展、店面组件和事件驱动集成。 技能可指导AI完成特定于Adobe Commerce as a Cloud Service和App Builder的架构、实施、测试和部署步骤。
安装AI工具
有关完整说明和特定IDE配置,请参阅安装AI开发人员工具。
先决条件: Node.js 22.x、npm 9.0.0或更高版本、Adobe I/O CLI。
安装命令:
aio commerce extensibility tools-setup
从评估报告中创建提示
虽然评估为您提供了开发蓝图,但AI工具允许您的团队在最终确定完整迁移计划之前立即开始构建。
- 打开 Module Reports 选项卡并找到具有 重新生成 推荐的高影响力模块。
- 阅读模块的描述,例如:
Manages custom shipping rate calculations based on customer account tier and order weight thresholds.
- 打开您的IDE,例如GitHub Copilot、Cursor或Claude,并启用Commerce可扩展性MCP服务器。
- 使用模块描述来提示AI代理。
- 查看基架App Builder应用程序并与代理迭代以优化实施。
后续步骤
- 打开 Summary 选项卡。 查看迁移复杂性和影响最大的模块,然后查看自定义细分子部分。 如果您的商店有自定义主题、高风险块或列出了签出放置项,请与后端迁移一起规划一个并行前端工作流。
- 与您的技术团队或开发合作伙伴共享 Module Reports 选项卡。 要求他们标记任何不再主动使用或可由Adobe Commerce as a Cloud Service功能替换的自定义模块。
- 开始构建自定义项。 使用模块描述作为AI工具输入,开始构建兼容的扩展基架。
- 安排与您的Adobe客户团队进行演练通话。 Adobe可与您一起查看调查结果,回答有关特定模块和店面信号的任何问题,并帮助您根据复杂性配置文件制定迁移方法。