Spartacus と Composable ストアフロント

こんにちは、ようこそ！

この README は、Spartacus リポジトリ内のアクティブな開発ブランチであるdevelopブランチの一部です。そのため、以下の本文には、進行中の、まだ正式にリリースされていない作業への参照が含まれている可能性があります。

バージョン 2211.19 以降、コンポーザブルストアフロントのバージョン管理は SAP Commerce Cloud と一致しています。コンポーザブルストアフロントの以前のリリースはバージョン 6.8 でした。詳細については、「2024 年 2 月以降のコンポーザブルストアフロントのリリース番号付けと更新ポリシーの変更」を参照してください。

バージョン 5.0 以降、「SAP Commerce Cloud、コンポーザブルストアフロント」は、SAP が公開するプロジェクト「Spartacus」ライブラリの正式リリースの名前です。 SAP Commerce Cloud の顧客は、公式にサポートされているコンポーザブルストアフロントを利用できます。ドキュメントは SAP Help Portal で入手できます。

Composable Storefront は 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 ヘルプポータルの「リリース情報」ページを参照してください。

スパルタカスは…

拡張可能: Spartacus は、完全な拡張性を維持しながらアップグレードできるように設計されています。定期的に強化される Spartacus ライブラリを更新することで、新しいバージョンの Spartacus を採用できるようになります。 (最初のリリースが期待どおりに拡張可能でアップグレード可能であることを保証するために、1.0 のリリースまでに重大な変更が導入される可能性が非常に高くなります。)
アップグレード可能: Spartacus コードはライブラリとして公開および使用され、セマンティックバージョニング規則に従います。ライブラリを使用すると、Spartacus をマイナーリリースおよびパッチリリースにアップグレードできます。
Progressive : Spartacus は、Progressive Web Application (PWA) チェックリストに完全に準拠するための取り組みを進めています。私たちは、デバイスや場所に関係なく、可能な限り最高の顧客エクスペリエンスを提供するために、PWA 対応ストアフロントのすべての主要機能のサポートを追加することを目指しています。
オープンソース: Spartacus はオープンソースです。 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 開発環境には次のものが含まれている必要があります。

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 もサポートしていますが、このバージョンはパブリッククラウドビルダーの 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 インスタンスでのみ使用できます。

Spartacus ライブラリを Angular アプリケーションにすばやく追加するには、Spartacus スケマティックを使用できます。 ng add @spartacus/schematics 。これにより、Spartacus ライブラリがセットアップされ、Angular プロジェクトにインストールされます。すべての前提条件と Spartacus 回路図の使用方法については、公式の Spartacus 回路図ドキュメントを確認してください。

完全なセットアップ手順については、SAP ヘルプポータルの「コンポーザブルストアフロントのセットアップ」を参照してください。

Spartacus のカスタマイズと拡張

アップグレード可能性の約束を維持するために、Spartacus の設計パターンでは、非コア機能を、提供された機能に追加または変更する機能ライブラリとして構築します。

Spartacus を使用する場合、Spartacus ライブラリを取り込むアプリを構築します。Spartacus ライブラリには、SAP Commerce と連携するために必要なコアリソースが含まれています。次に、カスタム機能とページを含む新しい機能を構築します。

Spartacus ページのコンテンツ (ロゴ、リンク、バナー、静的ページなど) は、SAP Commerce Cloud CMS (コンテンツ管理システム) から取得されます。コンテンツ管理者が CMS ツールを通じてページコンテンツを変更できるように、新しいコンテンツ主導の機能も同じパターンに従うことをお勧めします。

Spartacus のカスタマイズと拡張に関するドキュメントはまだ開発中であり、利用可能になり次第リリースされます。

Spartacus アプリケーションのドキュメント

バージョン 5.x 以降

「コンポーザブル Storefront API」を参照してください。

バージョン4.x以降

Spartacus アプリケーションライブラリ (モジュール、クラス、インターフェイスなど) について生成された最新のドキュメントは、https://sap.github.io/spartacus/ でホストされています。

アプリケーションのドキュメントはバージョン管理されており、すべての Spartacus ライブラリの各リリースのアセットセクションに含まれています。特定のバージョンのドキュメントをダウンロードするには、その特定のリリースの Spartacus ライブラリの[Assets]セクションにアクセスし、 docs.tar.gzまたはdocs.zipをクリックします。特定のライブラリのAssetsフォルダを見つけるには、Spartacus 用にリリースされたライブラリにアクセスし、興味のあるライブラリのリンクをクリックして、ページの一番下までスクロールします。

たとえば、3.4.0 リリースのアプリケーションドキュメントをダウンロードするには、ここから@spartacus/[email protected]ライブラリのAssetsフォルダーにアクセスします。

注: Spartacus ライブラリの 1.x および 2.x リリースは、SAP Commerce バージョン 1905 および 2005 でのみ動作します。必要な OCC API サポートは SAP Commerce 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 の将来の未リリースのエディションでのみ動作する可能性があることを意味します。これは、Spartacus の新しいバージョンをリリースするときに注目されます。