EN

Aplikasi & data demo

Cara setiap aplikasi memuat, menyimpan, dan mengembalikan data demonya — serta tempat menghubungkan backend Anda sendiri.

Cara kerja aplikasi

Kalender, Chat, Faktur, Kanban, E-commerce (beserta toko untuk pembelinya), Gudang, Proyek, dan Kasir (POS) berjalan sepenuhnya di browser. Tidak ada server: setiap aplikasi dimulai dari data demo yang ditulis di berkas JavaScript-nya, dan setiap aksi — menambah produk, mengemas pesanan, memindahkan kartu, mencatat penjualan — langsung bekerja pada data itu.

  • Aplikasi yang menyimpan: Faktur, Kanban, E-commerce dan tokonya, Gudang, Proyek, dan Kasir (POS) menyalin datanya ke localStorage browser begitu ada yang berubah. Perubahan Anda tetap ada setelah halaman dimuat ulang dan dipakai bersama oleh semua halaman aplikasi itu.
  • Aplikasi yang tidak menyimpan: Kalender (calendar.js) dan Chat (chat.js) menyimpan semuanya di memori saja. Acara yang Anda tambahkan dan pesan yang Anda kirim hilang setelah halaman dimuat ulang — setiap kunjungan dimulai lagi dari data demo.

Semua data demo memakai tanggal tetap yang sama — Rabu, 23 September 2026 — sehingga dasbor, tanggal jatuh tempo, dan label “hari ini” selalu cocok satu sama lain.

Tempat setiap aplikasi menyimpan datanya

Setiap aplikasi punya satu berkas data bersama yang dimuat lebih dulu oleh semua halaman aplikasi itu. Berkas ini berisi data demo serta fungsi muat dan simpannya. Nama di bawah adalah kunci simpanan halaman berbahasa Inggris.

AplikasiBerkas dataDisimpan di kunciKembali ke data demo
Kalendercalendar.jsTidak tersimpanMuat ulang halaman
Chatchat.jsTidak tersimpanMuat ulang halaman
Fakturinvoices.jssl-invoicesKembalikan data demo
Kanbankanban.jssl-kanbanKembalikan papan
Proyekprojects.jssl-proj, sl-kanbanKembalikan data demo
E-commerceecommerce.jssl-shop-… (7 kunci)Kembalikan data demo
Toko (sisi pembeli)store.jssl-store-cartBersama E-commerce
Gudangwarehouse.jssl-wmsKembalikan data demo
Kasir (POS)pos.jssl-posKembalikan data demo

Letak tombol pengembalian data dan apa saja yang dikembalikannya:

  • Faktur — di daftar Faktur.
  • Kanban — Kembalikan papan di halaman Kanban hanya mengembalikan papannya.
  • Proyek — di Semua proyek, Lembar waktu, atau Beban kerja. Tombol ini mengembalikan proyek dan papan Kanban, karena kedua aplikasi berbagi papan yang sama.
  • E-commerce — di Produk, Pesanan, Pelanggan, Kategori, Diskon, Ulasan, atau Pengaturan toko. Masing-masing mengembalikan seluruh toko: produk, pesanan, pelanggan, kategori, diskon, ulasan, dan pengaturan (sl-shop-products, sl-shop-orders, sl-shop-customers, sl-shop-cats, sl-shop-discounts, sl-shop-reviews, sl-shop-settings).
  • Toko — pesanan dan ulasan dari toko disimpan bersama data E-commerce, jadi ikut kembali saat data E-commerce dikembalikan. Keranjang (sl-store-cart) kosong sendiri saat pesanan dibuat.
  • Gudang — di Stok, Penerimaan, Stok opname, atau Pembelian.
  • Kasir (POS) — di layar kasir (dasbor Kasir), Penjualan, Menu, Member, atau Shift & kas.

Dua preferensi kecil E-commerce disimpan terpisah: catatan tim tentang pelanggan (sl-shop-notes, dihapus oleh tombol kembalikan di halaman Pelanggan) dan pilihan tampilan tabel atau kisi di Produk (sl-shop-view).

Untuk menghapus semuanya sekaligus, buka developer tools browser Anda, masuk ke Application › Local storage (Chrome dan Edge), lalu hapus kunci yang berawalan sl-.

Data demo per bahasa

Halaman berbahasa Indonesia menyimpan salinan sendiri untuk data setiap aplikasi. Setiap berkas data menyusun kunci simpanannya dengan window.slI18n.key(), yang menambahkan @id di halaman berbahasa Indonesia:

JavaScript
window.slI18n.key('sl-shop-orders');
// English pages:    'sl-shop-orders'
// Indonesian pages: 'sl-shop-orders@id'

Jadi kedua demo tidak pernah tercampur, dan mengembalikan data di satu bahasa tidak menyentuh bahasa lainnya. Demo Indonesia juga memakai nominal rupiah sendiri, bukan sekadar mengganti simbol mata uang: harga toko = harga dolar × 15.000, biaya gudang × 10.000, faktur punya tarif sendiri dan pajak 11%, dan kafe punya menu sendiri dengan harga rupiah.

Pilihan yang menyangkut Anda atau layar Anda, bukan catatan demo — pengaturan tampilan dari panel pengaturan tampilan dan data akun di halaman Pengaturan — dipakai bersama oleh kedua bahasa.

Hubungan antar-aplikasi

  • Toko dan admin berbagi satu toko. Toko untuk pembeli membaca produk, stok, kategori, dan kode diskon yang sama dengan admin E-commerce. Pesanan yang dibuat saat checkout mengurangi stok dan langsung muncul di Pesanan; ulasan yang ditulis di halaman produk menunggu persetujuan di Ulasan.
  • Kanban dan Proyek berbagi satu daftar tugas. Papan Kanban adalah satu-satunya daftar tugas: progres proyek, tugas di halaman proyek, dan dasbor Proyek semuanya dihitung darinya.
  • Dasbor membaca data aplikasi. Dasbor E-commerce, Proyek, dan Gudang menghitung angkanya dari window.slShop, window.slProj, dan window.slWms, jadi perubahan di aplikasi langsung terlihat di dasbornya. Grafik yang riwayatnya tidak ada di demo (seperti grafik penjualan 30 hari) berupa potret tetap. Dasbor Kasir adalah layar kasir itu sendiri, dan dasbor Umum (index.html) menampilkan angka demo tetap.
  • UI Kit memakai ulang Faktur. Tabel di halaman Tabel data dibangun dari window.slInvoices.
  • Notifikasi menunjuk ke rekaman aplikasi. Lonceng di bilah atas menampilkan kejadian terbaru — pesanan baru, pesan chat, ulasan yang perlu disetujui, faktur lewat jatuh tempo, dan lainnya — dan masing-masing membuka rekaman itu di aplikasinya. Membuka satu notifikasi menandainya sudah dibaca; status dibaca disimpan di browser. Daftarnya ada di assets/js/selaras.js (cari “notifications”); ganti dengan data dari backend Anda.

Gudang dan E-commerce terpisah: stok gudang tidak terhubung dengan stok toko.

Menghubungkan backend Anda sendiri

Semua aplikasi mengikuti pola yang sama: berkas data memuat data sekali ke memori, skrip halaman membaca dan mengubah data di memori itu, lalu memanggil fungsi simpan setelah setiap perubahan. Karena itu, berkas data adalah satu-satunya tempat yang perlu diubah.

Berkas dataDibuka sebagaiDimuat denganDisimpan dengan
ecommerce.jswindow.slShopLihat di bawahLihat di bawah
invoices.jswindow.slInvoicesload()save()
projects.jswindow.slProjload(), loadTasks()save(), saveTasks()
kanban.jswindow.slKanbanload()save()
warehouse.jswindow.slWmsobjek wmssave()
pos.jswindow.slPosload()save()
store.jswindow.slStoreobjek keranjang datapersist()

ecommerce.js punya satu pasang fungsi untuk tiap jenis data: load() dan save() untuk produk, loadOrders() / saveOrders(), loadReviews() / saveReviews(), dan loadDiscounts() / saveDiscounts(), sedangkan pelanggan, kategori, dan pengaturan toko dibaca langsung di tempat dan disimpan dengan saveCustomers(), saveCats(), dan saveSettings().

Cari blok /* ---------- storage ---------- */ di setiap berkas. Perhatikan bahwa papan Kanban (sl-kanban) dibaca dan ditulis oleh projects.js maupun kanban.js, jadi ubah keduanya.

Contoh: pesanan e-commerce

Skrip halaman membaca slShop.shop.orders begitu dijalankan, jadi datanya harus sudah tersedia sebelumnya. Cara paling sederhana: biarkan server Anda menuliskan pesanan langsung ke halaman, sebelum assets/js/ecommerce.js:

HTML
<script>
  window.SL_DATA = { orders: [] }; // your server fills this array with the orders from your database
</script>

Lalu, di ecommerce.js, ambil pesanan dari sana dan kirim setiap perubahan ke API Anda:

JavaScript
var loadOrders = function () {
  if (window.SL_DATA && window.SL_DATA.orders) return window.SL_DATA.orders;
  return clone(ORDERS_DEMO);
};
shop.orders = loadOrders();

var saveOrders = function () {
  fetch('/api/orders', {
    method: 'PUT',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify(shop.orders)
  }).then(function (res) {
    if (!res.ok) throw new Error('HTTP ' + res.status);
  }).catch(function () {
    toast('The orders could not be saved. Please try again.');
  });
  return true; // the callers expect true = saved
};

Cara ini mengirim seluruh daftar setiap kali ada perubahan, sehingga skrip halaman tidak perlu disentuh. Untuk mengirim hanya pesanan yang berubah (misalnya PUT /api/orders/SL-10431), ubah bagian yang memanggil saveOrders() — ecommerce-orders.js, ecommerce-order.js, ecommerce-order-new.js, dan store-checkout.js.

Kalau Anda lebih suka mengambil data dari browser, lakukan fetch lebih dulu, baru muat ecommerce.js dan skrip halamannya. Untuk menyegarkan data setelah halaman berjalan, ganti array-nya lalu gambar ulang: sebagian besar halaman membuka fungsi gambar ulangnya lewat window, misalnya window.slOrders.render() di halaman Pesanan.

Yang perlu diperhatikan

  • Pertahankan bentuk objeknya. API Anda sebaiknya mengembalikan objek dengan field yang sama seperti data demo — pembentuk data demo di setiap berkas data memperlihatkan semua field-nya. Sebuah pesanan, misalnya, punya no, at, customer (kunci di slShop.CUSTOMERS), channel, items, shipping, discount, payment, fulfillment, tracking, refunds, note, events, dan method.
  • Nilai hasil hitungan tidak disimpan. Total pesanan berasal dari slShop.orderTotals(), dan status “Lewat tempo” pada faktur dihitung dari tanggal jatuh temponya. Kirim data masukannya, bukan hasilnya.
  • Satu aksi bisa menyimpan beberapa hal. Membuat pesanan juga menyimpan produk (stok) dan pelanggan. Di server Anda, tangani perubahan seperti ini dalam satu transaksi.
  • Periksa ulang semuanya di server. Harga, stok, dan kode diskon diperiksa di browser untuk keperluan demo; backend sungguhan tidak boleh memercayai total atau stok yang dikirim browser.
  • Ganti tanggal demo. “Hari ini” di demo ditetapkan 23 September 2026: TODAY (dan NOW bila jamnya penting) di setiap berkas data, serta NOW di calendar.js dan chat.js. Pakai tanggal sebenarnya begitu datanya sungguhan.
  • Pembungkus simpanan hanya untuk lokal. Data yang masuk ke localStorage dibungkus dalam objek bernomor versi; API Anda tidak memerlukannya.
  • Nominal hanya diformat, tidak dikonversi. window.slFmt.money() menampilkan nominal dengan mata uang halaman — dolar di halaman Inggris, rupiah di halaman Indonesia. Konversi nominal demo hanya terjadi di dalam data demo.

localStorage hanya untuk demo

Jangan pakai untuk menyimpan data sungguhan

Data di localStorage hanya ada di satu browser pada satu perangkat. Data ini tidak dibagi ke pengguna atau perangkat lain, siapa pun yang memakai browser itu bisa membaca dan mengubahnya, data hilang saat data situs dihapus, dan ukurannya terbatas — foto produk cepat memenuhinya, lalu aplikasi menampilkan pesan bahwa penyimpanan browser penuh. Hubungkan backend sebelum aplikasi dipakai sungguhan.