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:
- Hentikan aplikasi atau service WorshipDeck untuk memastikan seluruh transaksi database sudah ditulis tuntas ke disk.
- Salin file
data.dbdan seluruh isi folderuploads/ke media penyimpanan eksternal yang aman atau flashdisk terenkripsi. - Untuk memulihkan data pada komputer baru, pasang WorshipDeck, hentikan servicenya, lalu timpa file
data.dbdan folderuploads/baru dengan salinan cadangan Anda.
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_ORIGINSmiliknya. - 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 sebelum eksekusi dimulai.