Logbook

Bimbingan yang tertata, kemajuan yang terlihat.

Aplikasi pencatatan & monitoring bimbingan Tugas Akhir (TA) dan Kerja Praktik (KP) — dari entri logbook pertama sampai sidang terakhir, mahasiswa dan dosen mencatat progres, memberi umpan balik, serta menuntaskan revisi dalam satu tempat.

🚀 Production  ·  📖 Panduan Pengguna  ·  🔌 API  ·  🧾 Changelog

Daftar isi

• Pratinjau
• Fitur utama
• Teknologi
• Menjalankan secara lokal
• Deployment dengan Docker Compose
• Pengujian
• Dokumentasi
• Lisensi

🖥️ Pratinjau

Dashboard mahasiswa	Dashboard dosen

Production: logbook.reloop.id · belum punya akun? Daftar gratis atau baca Panduan Pengguna.

✨ Fitur utama

🎓 Untuk mahasiswa

• 📝 Logbook & revisi — catat setiap sesi bimbingan, unggah dokumen, dan pantau status pengajuan secara real-time.
• 📄 Review PDF inline — anotasi dan komentar tepat pada bagian dokumen yang relevan (didukung PDF.js + React).
• 📂 Ruang kerja dokumen — simpan dan bagikan dokumen TA/KP (bab, revisi, lampiran) secara terpusat.
• 🎤 Seminar & sidang — kirim undangan dan materi seminar/sidang langsung ke dosen, plus finalisasi kelengkapan akhir (abstrak, cover, pengesahan).
• 💬 Chat & pengumuman — diskusi langsung dengan dosen dan terima pengumuman resmi.

👨‍🏫 Untuk dosen

• ✅ Keputusan review — setujui, minta revisi, atau arsipkan entri (catatan arsip opsional).
• 📥 Antrean review — dashboard ringkas berisi mahasiswa bimbingan dan antrean yang menunggu tindakan.
• 🗂️ Catatan sidang & riwayat menguji — dokumentasikan hasil sidang/pengujian per mahasiswa.
• 🔔 Notifikasi & kesehatan bimbingan — indikator keteraturan bimbingan dan pengingat otomatis.

🏛️ Untuk pengelola

• 👥 Manajemen pembimbing & penguji — kelola relasi bimbingan, alur seminar, sidang, hingga finalisasi TA/KP.
• 🔐 Hak akses berbasis peran — pemisahan data institusi dengan mode personal & institusi dalam satu deployment.
• 💾 Backup & restore sistem — pencadangan seluruh data dari panel admin.
• 📊 Ekspor data — unduh rekap dalam format Excel/PDF.

🛠️ Teknologi

Lapisan	Teknologi
Backend	Laravel 11 · PHP 8.4
Antarmuka	Blade · Tailwind CSS · React 19 · PDF.js
Database, cache & antrean	MySQL 8.4 · Redis 7
Realtime	Laravel Reverb (WebSocket)
Server & deployment	Nginx · Docker Compose

Arsitektur detail, endpoint API, dan spesifikasi mode personal/institusi tersedia di folder docs/.

🚀 Menjalankan secara lokal

Prasyarat

Kebutuhan	Versi
PHP	8.4+
Composer	2.x
Node.js + npm	20+
Database lokal	SQLite (tanpa MySQL/Redis)

1️⃣ Pasang dependensi

git clone https://github.com/relooplab/logbook.git
cd logbook
composer install
npm ci
cp .env.example .env

2️⃣ Konfigurasi .env untuk SQLite

Sesuaikan nilai berikut agar berjalan lokal tanpa MySQL atau Redis:

APP_ENV=local
APP_DEBUG=true
APP_URL=http://127.0.0.1:8000
DB_CONNECTION=sqlite
DB_DATABASE=database/database.sqlite
CACHE_STORE=file
SESSION_DRIVER=file
QUEUE_CONNECTION=sync
BROADCAST_CONNECTION=log
MAIL_MAILER=log

3️⃣ Siapkan database & jalankan

touch database/database.sqlite
php artisan key:generate
php artisan migrate --seed
php artisan storage:link
npm run build
php artisan serve

Buka http://127.0.0.1:8000. Saat mengubah antarmuka, jalankan npm run dev di terminal lain agar aset dimuat ulang otomatis.

🐳 Deployment dengan Docker Compose

Stack produksi terdiri dari layanan app (Laravel), nginx, MySQL 8.4, Redis 7, Reverb (WebSocket), queue worker, scheduler, dan Mailpit (hanya localhost).

1️⃣ Siapkan environment

Salin .env.example menjadi .env, lalu isi variabel wajib berikut dengan kredensial unik per lingkungan:

Variabel	Keterangan
APP_KEY	Generate via php artisan key:generate — tanpa ini Laravel gagal boot
APP_URL	URL publik aplikasi
DB_PASSWORD / MYSQL_ROOT_PASSWORD	Kredensial database
REVERB_APP_ID / REVERB_APP_KEY / REVERB_APP_SECRET	Kredensial WebSocket

🔒 Jangan pernah commit file .env ke Git.

2️⃣ Jalankan stack

cp .env.example .env
# Lengkapi .env terlebih dahulu, lalu:
docker compose config --quiet
docker compose up -d --build
docker compose exec logbook-ta-app php artisan migrate --force
docker compose ps

Checklist produksi

• Gunakan reverse proxy HTTPS dan tetapkan APP_DEBUG=false
• Konfigurasi SMTP produksi via variabel MAIL_*
• Port Mailpit tetap terikat ke localhost — jangan dibuka ke internet
• Cadangkan database dan berkas sebelum migrasi/deployment

Rincian seluruh variabel tersedia di .env.example.

🧪 Pengujian

php artisan test

⚠️ Gunakan database pengujian terpisah — jangan arahkan test suite ke database produksi.

📚 Dokumentasi

Dokumen	Isi
📖 Panduan Pengguna	Alur kerja lengkap per peran (Bahasa Indonesia)
📖 User Guide	English version of the user guide
🔌 API	Referensi endpoint chat & pengumuman
🧩 Mode personal/institusi	Spesifikasi mode aplikasi
📝 Glosarium	Istilah domain TA/KP
🧾 Changelog	Riwayat rilis

📄 Lisensi

Kode ini menggunakan Business Source License 1.1 — bukan lisensi open source.

• ✅ Penggunaan produksi personal (non-institusional) diizinkan sesuai ketentuan lisensi
• 🏛️ Penggunaan produksi oleh/untuk institusi memerlukan lisensi komersial terpisah
• 📧 Pertanyaan lisensi: dev@reloop.id

---

Dibangun dengan ❤️ oleh ReLoop Lab — Bimbingan yang tertata, kemajuan yang terlihat.

⬆ Kembali ke atas