Data, Backup & Sinkronisasi

Kelola data presentasi lokal gereja Anda, atur variabel environment backend server, cadangkan database, dan sinkronkan susunan ibadah antar-perangkat.

Ditulis untuk WorshipDeck 0.1.2

Lokasi Penyimpanan & File Data

WorshipDeck menggunakan arsitektur local-first. Seluruh catatan susunan acara, tata letak kustom, dan aset media tersimpan murni pada komputer lokal Anda:

Komponen Instalasi Server Instalasi Desktop Windows
Database SQLite ./data.db (atau path di DB_PATH) %LocalAppData%\WorshipDeck\data.db
Unggahan Media ./uploads/ (atau path di DATA_DIR) %LocalAppData%\WorshipDeck\uploads\
Cache PPTX ./data/pptx-cache/ %LocalAppData%\WorshipDeck\pptx-cache\

Variabel Environment Server

Saat menjalankan WorshipDeck pada server Linux atau Windows, konfigurasi diatur melalui variabel environment pada file .env:

Variabel Default Deskripsi
DB_PATH ./data.db Path sistem file absolut atau relatif menuju file database SQLite utama.
PORT 3000 Port TCP tempat server HTTP menerima koneksi dari konsol operator dan layar jemaat.
LISTEN_ADDR 0.0.0.0 (server) Interface jaringan yang diikat server. Build desktop mengunci nilai ini ke 127.0.0.1 demi membatasi akses hanya ke komputer lokal.
DATA_DIR ./data Folder penyimpan flyer yang diunggah, aset media, dan file JSON terjemahan Alkitab.
SYNC_ALLOWED_ORIGINS (kosong) Daftar URL remote yang diizinkan berkomunikasi dengan server ini untuk keperluan Cloud Data Sync.

Cadangan & Pemulihan Manual

Karena WorshipDeck menyimpan seluruh status dalam file biasa di sistem komputer Anda, pembuatan cadangan lengkap tidak memerlukan perkakas khusus:

  1. Hentikan aplikasi atau service WorshipDeck untuk memastikan seluruh transaksi database sudah ditulis tuntas ke disk.
  2. Salin file data.db dan seluruh isi folder uploads/ ke media penyimpanan eksternal yang aman atau flashdisk terenkripsi.
  3. Untuk memulihkan data pada komputer baru, pasang WorshipDeck, hentikan servicenya, lalu timpa file data.db dan folder uploads/ baru dengan salinan cadangan Anda.
Saat Anda memperbarui software ke versi yang lebih baru, skrip upgrade server maupun installer desktop menjaga database dan file media Anda tetap utuh tanpa terhapus.

Sinkronisasi Cloud Data Sync

Gereja yang menjalankan lebih dari satu instance WorshipDeck (misalnya laptop persiapan di kantor gereja dan server presentasi di bilik multimedia) dapat menyinkronkan data lewat menu Settings → Sync:

  • Otorisasi Alamat Asal: Server hanya menerima permintaan sinkronisasi dari alamat jaringan yang sudah didaftarkan pada variabel environment SYNC_ALLOWED_ORIGINS miliknya.
  • Autentikasi Sementara: Administrator masuk ke instance tujuan dengan kredensial yang sah; token autentikasi hanya disimpan di memori sementara dan tidak pernah disimpan ke disk.
  • Penyelesaian Konflik: Jika susunan ibadah yang masuk bertabrakan dengan susunan ibadah lokal yang sudah diubah, administrator dapat memilih dari tiga strategi: Keep Local (pertahankan lokal), Use Cloud (pakai data masuk), atau Save Both (simpan keduanya dengan mengganti nama salinan baru).
  • Kunci Penayangan Live: Fitur sinkronisasi otomatis dinonaktifkan saat konsol presentasi sedang aktif menayangkan slide.

Pengamanan Factory Reset

Jika Anda perlu membersihkan komputer atau mengembalikan lingkungan pengujian ke kondisi awal, buka Settings → Sync lalu gulir ke bagian Factory Reset:

Kategori Yang Dihapus Total Yang Tetap Tersimpan Aman
Dihapus Total Seluruh jadwal ibadah, entri susunan acara, pengumuman kustom, dan file media yang pernah diunggah. Tidak ada.
Tersimpan Aman Tidak ada. Akun administrator dan operator, pengaturan sistem, font TrueType yang diimpor, serta korpus bawaan buku lagu SDAH dan Alkitab KJV yang diisi ulang otomatis.
Factory Reset bersifat permanen dan tidak dapat dibatalkan. Demi mencegah penghapusan yang tidak disengaja, sistem mewajibkan administrator mengetikkan frasa konfirmasi persis factory reset sebelum eksekusi dimulai.