Build & Kontribusi · Dokumentasi WorshipDeck

Prasyarat

WorshipDeck terdiri dari backend Go dan frontend React 19. Untuk build, Anda memerlukan:

Go. Versi 1.24 atau lebih baru. CGO tidak diperlukan karena driver SQLite-nya ditulis murni dengan Go (modernc.org/sqlite).
Node.js. Versi 22.12 atau lebih baru, beserta npm.
Git. Untuk mengkloning repositori dan bekerja di branch.

git clone https://github.com/wiradeltaid/worship-deck.git
cd worship-deck
npm install
npm run setup
npm run dev

Tanpa Data Jemaat Asli

WorshipDeck adalah repositori publik. Jangan pernah meng-commit data jemaat asli, seperti nama keluarga, foto anak, pokok doa, catatan persembahan, atau nomor telepon.

Gunakan jemaat sintetis di example registry bawaan untuk contoh dan data uji.

Sebelum push, jalankan guard repositori publik secara terpisah:

node --import ./tests/register-ts-resolve.mjs --test --experimental-strip-types tests/public-repo-guard.test.mjs

Guard ini gagal bila menemukan nama jemaat asli, nomor telepon, atau file presentasi yang belum dibersihkan. Hapus data itu sebelum push.

Menjalankan Pengujian

Repositori ini memiliki pemeriksaan untuk backend Go dan frontend React:

# Pemeriksaan tipe
npm run typecheck

# ESLint
npm run lint

# Semua pengujian Node, termasuk guard repositori publik (node:test)
npm test

# Pengujian Go
go test ./cmd/... ./internal/...

# Build produksi antarmuka
npm run build

Semuanya harus lulus sebelum Anda membuka pull request.

Lisensi dan Atribusi

WorshipDeck adalah software bebas dan open source dengan lisensi MIT.

Teks buku lagu dan Alkitab. Lirik lagu dan teks Alkitab memiliki sumber dan ketentuannya sendiri. Lihat ATTRIBUTIONS.md di repositori untuk pernyataan hak cipta lengkapnya.