스파르타쿠스

기타 소스코드

@spartacus

다운로드

스파르타쿠스와 컴포저블 매장

안녕하세요, 환영합니다!

이 README는 Spartacus 저장소의 활성 개발 분기인 develop 분기의 일부입니다. 따라서 다음 텍스트에는 진행 중이지만 아직 공식적으로 출시되지 않은 작업에 대한 참조가 포함될 수 있습니다.

버전 2211.19부터 컴포저블 매장의 버전 관리가 SAP Commerce Cloud에 맞춰졌습니다. 컴포저블 상점의 이전 릴리스는 버전 6.8이었습니다. 자세한 내용은 2024년 2월부터 시작되는 컴포저블 스토어프런트의 릴리스 번호 지정 및 업데이트 정책 변경 사항을 참조하세요.

버전 5.0부터 "SAP Commerce Cloud, composable storefront"는 SAP가 게시한 프로젝트 "Spartacus" 라이브러리의 공식 릴리스 이름입니다. 공식적으로 지원되는 컴포저블 매장은 SAP Commerce Cloud 고객에게 제공됩니다. 문서는 SAP Help Portal에서 제공됩니다.

컴포저블 상점은 Spartacus 오픈 소스 코드를 기반으로 하며 추가 비용 없이 SAP Commerce Cloud 라이선스에 포함됩니다. 컴포저블 매장에는 롤포워드 업데이트 정책이 있습니다.

온프레미스 고객은 여전히 Spartacus 오픈 소스를 사용할 수 있습니다. 자세한 내용은 오픈 소스 코드를 사용하여 Spartacus 라이브러리 자체 게시를 참조하세요.

스파르타쿠스란 무엇인가?

Spartacus는 SAP Commerce Cloud를 위한 간결한 Angular 기반 JavaScript 상점입니다. Spartacus는 Commerce REST API를 통해서만 SAP Commerce Cloud와 통신합니다.

문서는 SAP Help Portal에서 제공됩니다.
공개 데모 사이트에서 샘플 Spartacus 매장을 시험해 보세요.
기술적인 질문이 있나요? Stack Overflow에서 우리에게 연락하세요.
기술적이지 않은 질문인가요? Slack 작업 공간에 참여하세요.
4.0 출시에 대한 자세한 내용은 SAP Help Portal의 릴리스 정보 페이지를 참조하세요.

스파르타쿠스는...

확장 가능 : Spartacus는 완전한 확장성을 유지하면서 업그레이드가 가능하도록 설계되었습니다. 정기적으로 개선되는 Spartacus 라이브러리를 업데이트하여 Spartacus의 새 버전을 채택할 수 있습니다. (첫 번째 릴리스가 우리가 원하는 만큼 확장 및 업그레이드 가능하도록 하기 위해 1.0 출시까지 주요 변경 사항이 도입될 가능성이 높습니다.)
업그레이드 가능 : Spartacus 코드는 게시되어 라이브러리로 사용되며 의미론적 버전 관리 규칙을 따릅니다. 라이브러리를 사용하면 Spartacus는 마이너 릴리스와 패치 릴리스로 업그레이드될 수 있습니다.
프로그레시브 : Spartacus는 프로그레시브 웹 애플리케이션(PWA) 체크리스트를 완벽하게 준수하기 위한 여정을 진행 중입니다. 우리는 PWA 지원 매장의 모든 주요 기능에 대한 지원을 추가하여 장치나 위치에 관계없이 최상의 고객 경험을 제공하는 것을 목표로 합니다.
오픈 소스 : 스파르타쿠스는 오픈 소스입니다. 이는 SAP Commerce Cloud 팀에 의해 지속적으로 개발될 예정이지만, 우리는 기여자를 환영하고 Spartacus를 위한 포괄적이고 활동적인 개발 커뮤니티를 육성하기를 매우 열망하고 있습니다. 자세한 내용은 기여 문서를 참조하세요.
현대적 : Spartacus 매장은 SAP Commerce Cloud 설치를 위한 맞춤화 가능하면서도 업그레이드 가능한 기술을 향한 흥미롭고 새로운 여정의 일부입니다. SAP Commerce Cloud에 대한 자세한 내용은 SAP Customer Experience를 참조하세요.

매장 특징

Spartacus는 다음과 같은 핵심 매장 기능을 제공합니다.

홈페이지
찾다
카테고리
제품 세부정보
장바구니 페이지
장바구니에 추가
점검
주문 내역

자세한 내용은 SAP Help Portal의 릴리스 문서를 참조하세요.

요구사항

Spartacus 2211을 사용하는 경우 SAP Help Portal에서 2211 Angular 개발 환경 요구 사항을 참조하세요.

Spartacus 6.x를 사용하는 경우 SAP Help Portal에서 관련 6.x Angular 개발 환경 요구 사항을 참조하세요.

Spartacus 5.x를 사용하는 경우 SAP Help Portal에서 관련 5.x Angular 개발 환경 요구 사항을 참조하세요.

백엔드 요구 사항은 컴포저블 매장 호환성 매트릭스를 참조하세요.

Spartacus 4.x로 작업하는 경우 Angular 개발 환경에는 다음이 포함되어야 합니다.

각도 CLI: 12.0 이상, < 13.
원사: v1.15 이상
node.js: 버전 14.15 가 필요합니다. 버전 12.x는 2022년 4월 30일에 수명이 종료되었으며 Spartacus에서는 더 이상 지원되지 않습니다. 가능한 한 빨리 기존 Spartacus 상점을 Node.js 14로 마이그레이션하는 것이 좋습니다. Spartacus 및 Node.js 14에 문제가 있는 경우 최신 릴리스로 업그레이드하세요. Node.js 14에서 계속 문제가 발생하는 경우 SAP를 통해 지원 티켓을 생성하세요. Spartacus는 Node.js 버전 16.x도 지원하지만 이 버전은 Public Cloud 빌더의 Commerce Cloud에서 아직 지원되지 않습니다.

Spartacus 3.x로 작업하는 경우 Angular 개발 환경에는 다음이 포함되어야 합니다.

Angular CLI: 10.1 이상, < 11.
node.js: 12.16.1 이상, < 13.0. 최신 12.x 버전을 권장합니다.
원사: v1.15 이상

Spartacus 2.x로 작업하는 경우 Angular 개발 환경에는 다음이 포함되어야 합니다.

Angular CLI: 9.1 이상, < 10.
node.js: 10.14.1 이상, < 13.0. 최신 12.x 버전을 권장합니다.
원사: v1.15 이상

Spartacus 1.x로 작업하는 경우 Angular 개발 환경에는 다음이 포함되어야 합니다.

Angular CLI: v8.0.0 이상, < v9.0.0
node.js: v10 이상, < v12
원사: v1.15 이상

백엔드에는 SAP Commerce Cloud 버전 1905 이상이 필요하며, SAP Commerce Cloud 버전 2005 이상을 권장합니다.

참고: 일부 Spartacus 기능에는 최신 버전의 SAP Commerce Cloud에서만 사용할 수 있는 API 엔드포인트가 필요합니다. 자세한 내용은 SAP Help Portal의 호환성 매트릭스를 참조하세요.

다운로드 및 설치

Spartacus를 시작하고 실행하려면 미리 만들어진 라이브러리에서 상점 애플리케이션을 구축하는 것이 권장되는 접근 방식입니다. 소스에서 복제하고 빌드할 수도 있지만 업그레이드가 그렇게 간단하지는 않습니다.

Spartacus는 현재 Commerce API를 통해 SAP Commerce Cloud 인스턴스에서만 사용할 수 있습니다.

Angular 애플리케이션에 Spartacus 라이브러리를 빠르게 추가하려면 Spartacus 회로도( ng add @spartacus/schematics 를 사용할 수 있습니다. 그러면 Angular 프로젝트에 Spartacus 라이브러리가 설정되고 설치됩니다. 스파르타쿠스 회로도 사용 방법에 대한 모든 전제 조건과 지침은 공식 스파르타쿠스 회로도 문서를 확인하세요.

전체 설정 지침은 SAP Help Portal에서 컴포저블 스토어프런트 설정을 참조하세요.

Spartacus 사용자 정의 및 확장

업그레이드 가능성에 대한 약속을 유지하기 위해 Spartacus의 디자인 패턴은 비핵심 기능을 제공된 기능에 추가하거나 변경하는 기능 라이브러리로 구축하는 것입니다.

Spartacus를 사용할 때 SAP Commerce 작업에 필요한 핵심 리소스가 포함된 Spartacus 라이브러리를 가져오는 앱을 구축합니다. 그런 다음 사용자 정의 기능과 페이지를 포함하는 새로운 기능을 구축합니다.

로고, 링크, 배너, 정적 페이지 등 Spartacus 페이지의 콘텐츠는 SAP Commerce Cloud CMS(콘텐츠 관리 시스템)에서 가져옵니다. 새로운 콘텐츠 기반 기능은 콘텐츠 관리자가 CMS 도구를 통해 페이지 콘텐츠를 수정할 수 있도록 동일한 패턴을 따르는 것이 좋습니다.

Spartacus 사용자 정의 및 확장을 위한 문서는 아직 개발 중이며, 출시되는 대로 출시될 예정입니다.

스파르타쿠스 애플리케이션 문서

버전 5.x 이상

컴포저블 Storefront API를 참조하세요.

버전 4.x 이상

Spartacus 애플리케이션 라이브러리(모듈, 클래스, 인터페이스 등)에 대해 최근 생성된 문서는 여기에서 호스팅됩니다: https://sap.github.io/spartacus/

애플리케이션 문서는 버전이 지정되어 있으며 모든 Spartacus 라이브러리의 모든 릴리스에 대한 자산 섹션에 포함되어 있습니다. 특정 릴리스에서 Spartacus 라이브러리의 자산 섹션에 액세스한 다음 docs.tar.gz 또는 docs.zip 클릭하여 특정 버전에 대한 문서를 다운로드할 수 있습니다. 특정 라이브러리에 대한 자산 폴더를 찾으려면 Spartacus용 릴리스 라이브러리에 액세스하고 관심 있는 라이브러리에 대한 링크를 클릭한 후 페이지 하단으로 스크롤하십시오.

예를 들어, 3.4.0 릴리스용 애플리케이션 문서를 다운로드하려면 여기에서 @spartacus/[email protected] 라이브러리의 Assets 폴더에 액세스할 수 있습니다.

참고: Spartacus 라이브러리의 1.x 및 2.x 릴리스는 SAP Commerce 버전 1905 및 2005에서만 작동합니다. 취소 및 반품과 같은 특정 기능은 SAP Commerce 2005에서만 사용할 수 있습니다. SAP Commerce 2005에서 사용할 수 있습니다.

제한사항

1.0.0이 출시되면 SAP Commerce 1905를 사용하는 것이 좋습니다. Spartacus는 몇 가지 제한 사항이 있지만 SAP Commerce Cloud 릴리스 1808 및 1811과 함께 작동합니다.

Spartacus도 곧 출시될 SAP Commerce Cloud와 잘 작동하도록 업데이트되고 있습니다. 이는 Spartacus의 특정 기능이 SAP Commerce Cloud의 아직 출시되지 않은 향후 버전에서만 작동할 수 있음을 의미합니다. 이는 스파르타쿠스의 새 버전이 출시될 때 언급될 것입니다.

알려진 문제

알려진 문제는 GitHub 문제 추적 시스템에 문서화되어 있습니다.

지원을 받는 방법

스파르타쿠스는 공식적인 지원 없이 "있는 그대로" 제공됩니다.

Spartacus 커뮤니티로부터 도움을 받으려면:

개발자 질문의 경우 'spartacus' 태그를 사용하여 Stack Overflow에 질문을 게시하세요.

기여

Team Spartacus는 피드백, 아이디어, 요청, 특히 코드 기여를 환영합니다.

기여 문서를 읽고 다음 방법을 알아보세요.
- 다른 사람들을 도와주세요
- 문제 신고
- Spartacus에 코드 기여

할 일

많은 개선이 이루어지고 있습니다! 모든 작업은 GitHub 문제 추적 시스템에 게시됩니다. 앞서 언급했듯이 일부 개선 사항은 획기적인 변화를 의미합니다. 이를 방지하기 위해 노력하고 있지만 첫 번째 릴리스 이전에 이러한 일이 발생하지 않을 것이라고 보장할 수는 없습니다.