spartacus

Spartacus dan Etalase yang Dapat Disusun

Halo dan selamat datang!

README ini adalah bagian dari cabang develop , yang merupakan cabang pengembangan aktif di repositori Spartacus. Oleh karena itu, teks berikut mungkin berisi referensi ke karya yang sedang dalam proses dan belum dirilis secara resmi.

Dimulai dengan versi 2211.19, etalase yang dapat dikomposisi telah menyelaraskan versinya dengan SAP Commerce Cloud. Rilis etalase composable sebelumnya adalah versi 6.8. Untuk informasi selengkapnya, lihat Perubahan Penomoran Rilis dan Kebijakan Pembaruan untuk Etalase Composable Mulai Februari 2024.

Dimulai dengan versi 5.0, “SAP Commerce Cloud, composable storefront” adalah nama untuk rilis resmi perpustakaan proyek “Spartacus” yang diterbitkan oleh SAP. Etalase composable yang didukung secara resmi tersedia untuk pelanggan SAP Commerce Cloud. Dokumentasi tersedia di Portal Bantuan SAP.

Etalase yang dapat dikomposisi didasarkan pada kode sumber terbuka Spartacus, dan disertakan dalam lisensi SAP Commerce Cloud tanpa biaya tambahan. Etalase yang dapat dikomposisi memiliki kebijakan pembaruan lanjutan.

Pelanggan lokal masih dapat menggunakan open source Spartacus. Untuk informasi lebih lanjut, lihat Penerbitan Mandiri Perpustakaan Spartacus Menggunakan Kode Sumber Terbuka.

Apa itu Spartakus?

Spartacus adalah etalase JavaScript berbasis Angular yang ramping untuk SAP Commerce Cloud. Spartacus berbicara dengan SAP Commerce Cloud secara eksklusif melalui Commerce REST API.

• Dokumentasi tersedia di Portal Bantuan SAP.
• Cobalah contoh etalase Spartacus di situs demo publik kami.
• Pertanyaan teknis? Hubungi kami di Stack Overflow.
• Pertanyaan non-teknis? Bergabunglah dengan ruang kerja Slack kami.
• Untuk rincian tentang peluncuran 4.0, lihat halaman Informasi Rilis di Portal Bantuan SAP.

Spartakus adalah...

• Dapat Diperpanjang : Spartacus dirancang agar dapat diupgrade dengan tetap mempertahankan kemampuan perpanjangan penuh. Anda akan dapat mengadopsi versi baru Spartacus dengan memperbarui perpustakaan Spartacus yang akan kami tingkatkan secara berkala. (Untuk memastikan bahwa rilis pertama dapat diperluas dan ditingkatkan sesuai keinginan kami, perubahan besar kemungkinan besar akan dilakukan hingga peluncuran 1.0.)
• Dapat diupgrade : Kode Spartacus diterbitkan dan digunakan sebagai perpustakaan dan mengikuti konvensi versi semantik. Dengan menggunakan perpustakaan, Spartacus dapat diupgrade untuk rilis minor dan patch.
• Progresif : Spartacus sedang dalam perjalanan untuk sepenuhnya mematuhi daftar periksa Aplikasi Web Progresif (PWA). Kami bertujuan untuk menambahkan dukungan untuk semua fitur utama etalase berkemampuan PWA, untuk menawarkan pengalaman pelanggan terbaik, apa pun perangkat atau lokasinya.
• Sumber Terbuka : Spartacus adalah sumber terbuka. Ini akan terus dikembangkan oleh tim SAP Commerce Cloud, namun kami sangat antusias menyambut para kontributor dan membina komunitas pengembangan yang inklusif dan aktif untuk Spartacus. Lihat dokumentasi kontribusi kami untuk informasi lebih lanjut.
• Modern : Etalase Spartacus adalah bagian dari perjalanan baru kami yang menarik menuju teknologi yang dapat disesuaikan namun dapat ditingkatkan untuk instalasi SAP Commerce Cloud. Lihat Pengalaman Pelanggan SAP untuk informasi lebih lanjut tentang SAP Commerce Cloud.

Fitur Etalase

Spartacus menyediakan fitur etalase inti seperti:

• Halaman beranda
• Mencari
• Kategori
• Detail produk
• Halaman keranjang
• Menambahkan ke troli
• Check-out
• Riwayat pesanan

Lihat dokumentasi Rilis di Portal Bantuan SAP untuk informasi lebih lanjut.

Persyaratan

Jika Anda bekerja dengan Spartacus 2211, lihat persyaratan lingkungan pengembangan 2211 Angular di Portal Bantuan SAP.

Jika Anda bekerja dengan Spartacus 6.x, lihat persyaratan lingkungan pengembangan 6.x Angular yang relevan di Portal Bantuan SAP.

Jika Anda bekerja dengan Spartacus 5.x, lihat persyaratan lingkungan pengembangan 5.x Angular yang relevan di Portal Bantuan SAP.

Untuk persyaratan back end, lihat Matriks Kompatibilitas Storefront yang Dapat Dikomposisi.

Jika Anda bekerja dengan Spartacus 4.x, lingkungan pengembangan Angular Anda harus mencakup hal berikut:

• CLI sudut: 12.0 atau lebih baru, <13.
• benang: v1.15 atau lebih baru
• node.js: Versi 14.15 diperlukan. Versi 12.x mencapai akhir masa pakainya pada 30 April 2022, dan tidak lagi didukung oleh Spartacus. Sangat disarankan agar Anda memigrasikan etalase Spartacus yang ada ke Node.js 14 sesegera mungkin. Jika ada masalah dengan Spartacus dan Node.js 14, harap tingkatkan ke rilis terbaru. Jika Anda terus mengalami masalah dengan Node.js 14, buat tiket dukungan dengan SAP. Spartacus juga mendukung Node.js versi 16.x, tetapi versi ini belum didukung di Commerce Cloud di pembuat Public Cloud.

Jika Anda bekerja dengan Spartacus 3.x, lingkungan pengembangan Angular Anda harus mencakup hal berikut:

• CLI sudut: 10.1 atau lebih baru, <11.
• node.js: 12.16.1 atau lebih baru, <13.0. Versi 12.x terbaru direkomendasikan.
• benang: v1.15 atau lebih baru

Jika Anda bekerja dengan Spartacus 2.x, lingkungan pengembangan Angular Anda harus mencakup hal berikut:

• CLI sudut: 9.1 atau lebih baru, <10.
• node.js: 10.14.1 atau lebih baru, <13.0. Versi 12.x terbaru direkomendasikan.
• benang: v1.15 atau lebih baru

Jika Anda bekerja dengan Spartacus 1.x, lingkungan pengembangan Angular Anda harus mencakup hal berikut:

• CLI sudut: v8.0.0 atau lebih baru,
• node.js: v10 atau lebih baru, < v12
• benang: v1.15 atau lebih baru

Untuk bagian belakang, diperlukan SAP Commerce Cloud versi 1905 atau lebih tinggi, dan direkomendasikan SAP Commerce Cloud versi 2005 atau lebih baru.

Catatan: Beberapa fitur Spartacus memerlukan titik akhir API yang hanya tersedia di versi SAP Commerce Cloud yang lebih baru. Untuk informasi lebih lanjut, lihat Matriks Kompatibilitas di Portal Bantuan SAP.

Unduh dan Instalasi

Untuk memulai dan menjalankan Spartacus, pendekatan yang disarankan adalah membangun aplikasi etalase Anda dari perpustakaan yang sudah jadi. Anda juga dapat mengkloning dan membangun dari sumber, tetapi peningkatannya tidak sesederhana itu.

Spartacus saat ini hanya dapat digunakan dengan instans SAP Commerce Cloud melalui Commerce API.

Untuk menambahkan perpustakaan Spartacus dengan cepat ke aplikasi Angular, Anda dapat menggunakan skema Spartacus: ng add @spartacus/schematics . Ini akan menyiapkan dan menginstal perpustakaan Spartacus ke proyek Angular Anda. Silakan periksa dokumentasi skema Spartacus resmi untuk semua prasyarat dan instruksi tentang cara menggunakan skema Spartacus.

Untuk petunjuk pengaturan lengkap, lihat Menyiapkan Composable Storefront di Portal Bantuan SAP.

Menyesuaikan dan Memperluas Spartacus

Untuk memenuhi janji kami akan peningkatan kemampuan, pola desain Spartacus adalah membuat fitur non-inti sebagai pustaka fitur yang menambah atau mengubah fungsionalitas yang disediakan.

Saat menggunakan Spartacus, Anda membuat aplikasi yang menggunakan perpustakaan Spartacus, yang berisi sumber daya inti yang diperlukan untuk bekerja dengan SAP Commerce. Anda kemudian membuat fitur baru yang berisi fungsionalitas dan halaman khusus apa pun.

Konten untuk halaman Spartacus diambil dari SAP Commerce Cloud CMS (Content Management System), seperti logo, tautan, spanduk, dan halaman statis. Kami merekomendasikan agar fitur berbasis konten baru mengikuti pola yang sama untuk memungkinkan Pengelola Konten mengubah konten halaman melalui alat CMS.

Dokumentasi untuk menyesuaikan dan memperluas Spartacus masih dalam pengembangan dan dirilis setelah tersedia.

Dokumentasi aplikasi Spartacus

Versi 5.x dan lebih baru

Lihat API Etalase yang Dapat Dikomposisi.

Versi 4.x dan lebih lama

Dokumentasi terbaru yang dihasilkan untuk perpustakaan aplikasi Spartacus (modul, kelas, antarmuka, dan sebagainya) dihosting di sini: https://sap.github.io/spartacus/

Dokumentasi aplikasi memiliki versi dan disertakan di bagian Aset pada setiap rilis setiap perpustakaan Spartacus. Anda dapat mengunduh dokumentasi untuk versi tertentu dengan mengakses bagian Aset di perpustakaan Spartacus mana pun dari rilis tersebut, lalu mengklik docs.tar.gz atau docs.zip . Untuk menemukan folder Aset untuk perpustakaan tertentu, akses Perpustakaan yang Dirilis untuk Spartacus, klik tautan untuk perpustakaan yang Anda minati, dan gulir ke bagian bawah halaman.

Misalnya, untuk mengunduh dokumentasi aplikasi untuk rilis 3.4.0, Anda dapat mengakses folder Aset dari perpustakaan @spartacus/[email protected] di sini.

Catatan: Rilis 1.x dan 2.x perpustakaan Spartacus hanya berfungsi dengan SAP Commerce versi 1905 dan 2005. Fitur tertentu, seperti pembatalan dan pengembalian, hanya tersedia dengan SAP Commerce 2005, karena dukungan OCC API yang diperlukan hanya tersedia di SAP Commerce 2005.

Keterbatasan

Ketika 1.0.0 dirilis, disarankan untuk menggunakan SAP Commerce 1905. Spartacus bekerja dengan SAP Commerce Cloud Rilis 1808 dan 1811, dengan beberapa batasan.

Spartacus juga sedang diperbarui agar dapat berfungsi dengan baik dengan rilis SAP Commerce Cloud yang akan datang. Ini berarti bahwa fitur-fitur tertentu dari Spartacus hanya dapat berfungsi dengan SAP Commerce Cloud edisi mendatang yang belum dirilis. Ini akan diperhatikan saat kami merilis versi baru Spartacus.

Masalah yang Diketahui

Masalah yang diketahui didokumentasikan dalam sistem pelacakan masalah GitHub.

Cara Mendapatkan Dukungan

Spartacus disediakan "apa adanya" tanpa jalur dukungan resmi.

Untuk mendapatkan bantuan dari komunitas Spartacus:

• Untuk pertanyaan pengembang, kirimkan pertanyaan ke Stack Overflow dengan tag 'spartacus'.

Berkontribusi

Tim Spartacus menyambut masukan, ide, permintaan, dan terutama kontribusi kode.

• Baca dokumen Berkontribusi dan pelajari cara:
  • Bantu orang lain
  • Laporkan masalah
  • Kontribusikan kode ke Spartacus

Yang Harus Dilakukan

Banyak perbaikan yang akan datang! Semua tugas akan diposting ke sistem pelacakan masalah GitHub kami. Seperti disebutkan, beberapa perbaikan berarti perubahan besar. Meskipun kami berusaha untuk menghindari hal tersebut, kami tidak dapat menjamin hal ini tidak akan terjadi sebelum rilis pertama.

Lisensi

Hak Cipta (c) 2024 SAP SE atau perusahaan afiliasi SAP. Semua hak dilindungi undang-undang. File ini dilisensikan di bawah Lisensi Perangkat Lunak Apache, v. 2 kecuali sebagaimana dinyatakan lain dalam file LISENSI.