Dokumentasi proyek

Jalankan aplikasi absensi dengan tenang.

Panduan singkat untuk mengunduh, memasang, dan menjalankan aplikasi absensi di komputer lokal.

Mulai instalasi Lihat repository

Persiapan

Cek tools terlebih dahulu

Belum punya tools? Pilih cara instalasi di bawah. Setelah selesai, kembali ke bagian cek versi.

WindowsPowerShell

Instal Node.js dan Git lewat terminal:

winget install OpenJS.NodeJS.LTS Git.Git

Instal lewat GUI / browser ↗

LinuxTerminal

Untuk Debian atau Ubuntu:

sudo apt update
sudo apt install -y nodejs npm git

Instal lewat GUI / browser ↗

macOSTerminal

Jika Homebrew sudah terpasang:

brew install node git

Instal lewat GUI / browser ↗

GUI / browser: buka halaman unduhan resmi, pilih installer sesuai sistem operasi, lalu ikuti langkah Next sampai selesai. Git dapat diunduh dari git-scm.com/downloads.

Jika tools sudah terpasang, jalankan perintah berikut. Jika muncul nomor versi, berarti siap digunakan.

Pilih sistem operasiBelum dicek

Jalankan di PowerShell

node --version
npm --version
git --version

Saya sudah melihat nomor versi untuk semua perintah.

Unduh source code

Pilih cara yang paling nyaman

Repository resmi aplikasi tersedia di GitHub. Pilih salah satu cara berikut.

⌘Disarankan untuk developer

Clone lewat CLI

Salin repository langsung dari terminal. Cara ini mudah untuk update berikutnya.

gh repo clone reyyksy/absensi

Belum punya GitHub CLI? Gunakan cara Git biasa:

git clone https://github.com/reyyksy/absensi.git

↓Tanpa terminal

Unduh dari GitHub

Cocok jika belum terbiasa memakai command line.

Buka repository di GitHub.
Klik tombol Code.
Pilih Download ZIP.
Ekstrak file ZIP ke folder pilihan.

Buka repository GitHub

Instalasi & penggunaan

Pasang dependency, lalu jalankan

Masuk ke folder hasil clone. Contoh di bawah menggunakan folder absensi.

01 / Masuk folder proyek

cd absensi

02 / Install dependency

npm install

03 / Jalankan aplikasi

node src/server.js

Setelah server aktif, buka http://localhost di browser.

Akses aplikasi

Client dan admin punya alamat berbeda

Server web menggunakan port 80. Gunakan alamat berikut setelah server berhasil dijalankan.

CLIENT

Halaman absensi

Dipakai anggota untuk mencari nama dan melakukan absensi.

http://localhost/

ADMIN

Dashboard admin

Dipakai admin untuk mengelola data dan melihat hasil absensi.

http://localhost/admin.html

Web client & adminPort 80

API backendPort 3000 · internal

Data anggota

Ubah nama atau kelas di satu file

Edit file src/members.js untuk mengubah data anggota. Formatnya adalah [nomor_absen, "nama", "kelas"].

Contoh data

[1, "NAMA BARU", "10 A TJKT"]

✓

Nomor absen harus unik dan tidak boleh kosong. Setelah file disimpan, perubahan akan tersinkron otomatis saat server berjalan.

Opsional

Atur password admin

Atur password sebelum menjalankan server. Pilih perintah sesuai sistem operasi.

Windows · sementara

$env:ADMIN_PASSWORD = "passwordbaru"

Windows · permanen

[System.Environment]::SetEnvironmentVariable("ADMIN_PASSWORD", "passwordbaru", "User")

Linux / macOS · permanen

export ADMIN_PASSWORD="passwordbaru"

Ganti passwordbaru dengan password pilihanmu. Perintah sementara hanya berlaku di terminal yang sedang terbuka.

Selesai

Hasil absensi tersimpan otomatis

File Excel hasil absensi akan dibuat di folder berikut:

▰data/exports/

Untuk menghentikan server, tekan Ctrl + C di terminal.