마이그레이션 평가 도구
Commerce 마이그레이션 평가는 기존 Adobe Commerce 구현에 대한 자동화된 분석입니다. Adobe의 도구 기능은 Commerce 코드베이스를 스캔하고 빌드되거나, 사용자 정의되거나, 수정된 모든 사항을 인벤터리하는 구조화된 보고서를 생성합니다. 그러면 코드베이스에 대한 사용자 지정이 Adobe Commerce as a Cloud Service(으)로의 마이그레이션에 어떤 영향을 미치는지 보여줍니다.
처리된 마이그레이션 평가 보고서는 https://experience.adobe.com/@<ims-org-name>/commerce-migration-assessment/shared-assessments에서 액세스할 수 있습니다. 프로젝트 코드베이스를 처음 공유하는 경우를 제외하고 프로덕션 환경에 액세스할 필요가 없습니다.
평가에서 제공하는 항목:
- 유형 및 영향 수준별로 구성된 스토어의 모든 사용자 정의 모듈에 대한 전체 인벤토리
- 위험 예측 지표에서 계산된 마이그레이션 복잡성 등급(높음, Medium 또는 낮음)
- 마이그레이션 계획이 필요한 가장 영향력이 큰 백엔드 및 상점 영역에 대한 우선 순위 보기
- Adobe의 AI 개발자 도구에 대한 직접 입력으로 사용할 수 있는 각 사용자 정의 모듈에 대한 설명입니다
마이그레이션 평가 보고서 이해
보고서는 Summary, Module Reports, Report Reliability 세 개의 탭으로 구성됩니다.
요약 탭
Summary 탭은 다음 영역으로 구성된 주요 신호에 대한 개요를 제공합니다.
- 마이그레이션 복잡성
- 파일 유형 분류
- 가장 큰 영향을 미치는 모듈
- 마이그레이션 드라이버
- 사용자 지정 분류
마이그레이션 복잡성
마이그레이션 복잡성 섹션에는 저장소 전체에 대한 평가 등급이 포함되어 있습니다. 점수가 계산된 방식을 설명하고 주요 위험 요소를 강조합니다.
마이그레이션 복잡성 및 복잡성 점수
복잡성 점수는 각 입력에 마이그레이션이 얼마나 어려운지 가중치를 부여합니다. 점수는 고정 임계값을 사용하여 마이그레이션 복잡성 등급에 매핑됩니다.
사용자 지정 모듈 비율
구현을 위해 특별히 빌드된 모듈의 비율입니다. 비율이 높을수록 더 많은 사용자 지정 코드를 감사하고 마이그레이션해야 합니다. 평균 고객의 사용자 정의 모듈 비율은 약 62%입니다.
파일 형식 분류
코드베이스에 있는 파일 수를 유형별로 정리한 목록.
가장 영향이 큰 모듈
가장 많은 마이그레이션에 주의가 필요한 저장소의 특정 모듈에 대한 선별된 목록입니다. 이러한 모듈은 종종 체크아웃, 결제 또는 주문 관리와 상호 작용하는 모듈입니다. 영향을 많이 받는 각 모듈에는 고유한 마이그레이션 계획이 필요합니다. 이 목록은 기술 팀과의 대화에 가장 좋은 시작점입니다.
Storefront 복잡성
Storefront 복잡성 섹션은 스토어의 프론트엔드 프레젠테이션 레이어를 마이그레이션하는 데 필요한 노력을 나타냅니다. 이 워크플로우는 백엔드 코드 마이그레이션과 구별되는 워크플로우는 프론트엔드 개발자가 처리하며 일반적으로 별도의 계획 대화가 필요합니다.
-
사용자 지정 테마 - 스토어 사용자 지정 테마의 네임스페이스(예: BrandName_Theme). 사용자 지정 테마가 있으면 Adobe Commerce as a Cloud Service에 전체 테마를 다시 빌드해야 합니다. 사용자 정의 테마 네임스페이스가 있는 모든 평가 스토어는 전용 프론트엔드 마이그레이션 워크스트림을 계획해야 합니다.
-
총 블록 수 - 스토어에 있는 블록 및 템플릿(.phtml) 파일 수입니다. 블록은 기본 서버측 렌더링 아티팩트이며, 각각은 개별 마이그레이션 작업을 나타냅니다.
마이그레이션 드라이버
마이그레이션 드라이버 섹션에는 복잡성 평가를 유도하는 주요 요인이 표시됩니다.
각 드라이버는 높음, Medium 또는 낮음으로 표시됩니다. 범위 지정 및 계획 시 가장 높은 등급의 드라이버를 먼저 해결합니다.
데이터 모델
데이터 모델 섹션에는 사용자 지정 테이블 수, Adobe Commerce 코어 데이터베이스 테이블에 대한 수정 사항 및 중요한 EAV(Entity-Attribute-Value) 특성이 표시됩니다.
핵심 테이블 수정 사항은 특정 플랫폼 스키마 버전에 대한 종속성을 만들고 복잡성 점수 공식에 높은 영향을 미치기 때문에 마이그레이션하기 가장 어려운 범주입니다.
사용자 지정 분류
사용자 지정 분류 섹션은 스토어의 모든 사용자 지정 카테고리에 대한 세부 지표를 제공합니다.
레이아웃 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 서버 - AI 코딩 도우미를 Adobe Commerce 설명서, API 및 App Builder 개발 패턴에 직접 연결하는 MCP(모델 컨텍스트 프로토콜) 통합입니다. 개발자는 빌드할 내용을 설명할 수 있으며 MCP 서버는 IDE 내에서 Commerce 인식 코드 생성, 아키텍처 지침 및 배포 자동화를 제공합니다.
- 에이전트 기술 - REST API, 체크아웃 확장, 상점 구성 요소 및 이벤트 기반 통합과 같은 일반적인 Commerce 확장성 패턴을 다루는 사전 빌드된 AI 기술. Adobe Commerce as a Cloud Service 및 App Builder과(와) 관련된 아키텍처, 구현, 테스트 및 배포 단계를 통해 AI를 안내합니다.
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.
- Commerce 확장성 MCP 서버가 활성화된 상태에서 IDE(예: GitHub Copilot, Cursor 또는 Cloud)를 엽니다.
- 모듈 설명을 사용하여 AI 에이전트를 묻는 메시지를 표시합니다.
- 스캐폴딩한 App Builder 응용 프로그램을 검토하고 에이전트를 반복하여 구현을 구체화합니다.
다음 단계
- Summary 탭을 엽니다. 마이그레이션 복잡성 및 가장 큰 영향을 미치는 모듈을 검토한 다음 사용자 지정 분류 하위 섹션을 확인하십시오. 스토어에 사용자 지정 테마, 고위험 블록 또는 체크아웃 드롭인이 나열되어 있는 경우 백엔드 마이그레이션과 함께 병렬 프론트엔드 워크스트림을 계획합니다.
- Module Reports 탭을 기술 팀이나 개발 파트너와 공유합니다. 더 이상 사용되지 않거나 Adobe Commerce as a Cloud Service 기능으로 대체할 수 있는 사용자 지정 모듈에 플래그를 지정하도록 요청하십시오.
- 사용자 지정 빌드를 시작합니다. 모듈 설명을 AI 도구 입력으로 사용하여 호환되는 확장 스캐폴딩을 시작합니다.
- Adobe 계정 팀과 연습 호출을 예약합니다. Adobe은 사용자와 함께 결과를 검토하고 특정 모듈 및 상점 내 신호에 대한 질문에 답변하며 복잡성 프로필에 대한 마이그레이션 접근 방식을 매핑하는 데 도움이 됩니다.
리소스
-
Adobe Commerce as a Cloud Service
-
확장성
-
Storefront 개발