KAMPUSKU v3 — SISTEM KEHILANGAN DAN BARANG TEMUAN
================================================

Versi ini merombak struktur database dan alur aplikasi sesuai kebutuhan proyek:
- Pendaftaran mahasiswa mandiri memakai nama + NPM + password.
- Hanya 23 NPM pada daftar resmi di database yang dapat mendaftar.
- Semua halaman laporan dan API wajib login.
- QR mengarah ke halaman login; setelah login mahasiswa masuk ke dashboard dengan menu laporan.
- Mahasiswa dapat melihat nama barang temuan yang sudah diterima petugas, tanpa foto, lokasi, deskripsi, atau ciri khusus.
- Mahasiswa dapat mengajukan klaim tanpa membuat laporan kehilangan baru.
- Admin dapat mengirim beberapa pertanyaan; mahasiswa menjawab melalui percakapan klaim.
- Jumlah pesan admin yang belum dibaca tampil sebagai “Ada N pertanyaan dari admin” dan label “N baru”.
- Pengambilan wajib langsung oleh pemilik. Admin memasukkan NPM yang dilihat dari KTM; server mencocokkannya dengan NPM akun klaim.
- Riwayat penyerahan otomatis masuk arsip dengan nama, NPM pengambil, petugas, tanggal/jam, dan catatan.
- Admin memiliki arsip, pemulihan, penghapusan permanen, catatan internal, dan riwayat aktivitas.
- Mahasiswa mempunyai menu Profil untuk melihat nama/NPM/role dan mengganti password.


PEMASANGAN DI LARAGON
---------------------
1. Ekstrak folder KampusKu ke C:\laragon\www\kampusku
   Pastikan hasil akhirnya: C:\laragon\www\kampusku\index.html
2. Buka Laragon lalu klik Start All (Apache dan MySQL aktif).
3. Buka http://localhost/phpmyadmin/
4. Pilih tab Import dan impor file database\schema.sql.
   PENTING: schema.sql menghapus dan membuat ulang tabel database kampusku.
   Seluruh data versi lama akan hilang. Impor hanya jika memang ingin mulai dari database bersih.
5. Buat akun admin lewat Terminal Laragon. Buka Menu > Terminal, lalu jalankan:

   cd C:\laragon\www\kampusku
   php tools\buat_admin.php nama="Admin Kampus" email=admin@kampus.ac.id

   Ganti nama dan email dengan milik petugas kampus. Script akan meminta password setelah perintah dijalankan; password minimal 10 karakter.
   Script hanya dapat dijalankan melalui terminal (CLI), bukan browser. Jangan bagikan password admin.
6. Buka http://localhost/kampusku/

Jangan membuka index.html dengan klik dua kali atau Live Server; PHP harus dijalankan Apache Laragon.
Kebutuhan: PHP 8.1+, ekstensi pdo_mysql dan mbstring.


PENDAFTARAN MAHASISWA
---------------------
1. Mahasiswa memilih “Daftar sebagai mahasiswa”.
2. Isi nama lengkap sesuai daftar, NPM, dan password minimal 8 karakter.
3. Server mencocokkan nama dan NPM dengan tabel student_registry.
4. NPM yang tidak terdaftar, nama yang tidak cocok, atau NPM yang sudah punya akun akan ditolak.
5. Setelah berhasil, mahasiswa otomatis login dengan role mahasiswa.

Daftar ini hanya mencakup NPM yang diberikan untuk lima kelompok. NPM dengan huruf P sengaja tidak dimasukkan.
Jika ada mahasiswa lain, tambahkan NPM melalui admin database setelah memverifikasi data resmi kampus.


LOGIN
-----
- Mahasiswa: login dengan NPM + password.
- Admin: login dengan email + password yang dibuat melalui tools\buat_admin.php.
- Tidak ada akun demo dan tidak ada admin bawaan di schema.
- Role diambil dari database pada setiap permintaan; mahasiswa tidak dapat memilih role admin.


PROFIL MAHASISWA
----------------
Menu Profil menampilkan nama, NPM, role, dan tanggal pendaftaran. Nama dan NPM mengikuti daftar resmi dan tidak dapat diubah sendiri. Mahasiswa dapat mengganti password dengan memasukkan password saat ini dan password baru.


ALUR QR DAN PELAPORAN
---------------------
QR Code admin mengarah ke halaman login. Setelah login, mahasiswa melihat dashboard dengan pilihan:
- Laporan Kehilangan: untuk barang yang belum ditemukan.
- Laporan Barang Temuan: untuk barang yang ditemukan mahasiswa.
- Barang Temuan: daftar barang yang sudah diterima petugas dan dapat diklaim.

Semua laporan harus dibuat dalam keadaan login. Endpoint tidak menyediakan pengiriman anonim.
Untuk mengakses dari HP, gunakan IP laptop dalam jaringan Wi-Fi yang sama dan izinkan Apache melalui Windows Firewall. QR dari localhost hanya dapat dibuka di laptop itu sendiri.


ALUR KLAIM DAN PENGAMBILAN
--------------------------
1. Mahasiswa login dan membuka Barang Temuan.
2. Daftar mahasiswa hanya menampilkan nama/kategori barang yang sudah berstatus Disimpan petugas.
   Foto, lokasi, detail, ciri umum, dan ciri khusus tidak dikirim oleh API untuk role mahasiswa.
3. Mahasiswa memilih barang lalu mengajukan klaim dengan penjelasan kepemilikan.
4. Admin meninjau klaim dan dapat mengirim beberapa pertanyaan.
5. Mahasiswa menjawab dari menu Verifikasi Klaim. Riwayat percakapan hanya terlihat oleh mahasiswa pemilik klaim dan admin.
6. Admin menerima atau menolak klaim.
7. Jika diterima, mahasiswa harus datang sendiri dan menunjukkan KTM.
8. Admin mengetik NPM dari KTM. Server membandingkan NPM dengan akun mahasiswa yang mengajukan klaim. Jika berbeda, penyerahan ditolak.
9. Setelah berhasil, sistem mencatat nama dan NPM mahasiswa, petugas, tanggal/jam, serta catatan penyerahan. Barang otomatis masuk arsip.


ARSIP DAN CATATAN ADMIN
-----------------------
- Laporan kehilangan berstatus Selesai atau Ditolak dapat diarsipkan dari halaman kelola laporan.
- Barang temuan yang telah diserahkan otomatis masuk arsip; barang tidak diserahkan dapat ditutup admin.
- Arsip dapat dipulihkan ke daftar aktif.
- Penghapusan permanen hanya tersedia dari arsip dan memerlukan konfirmasi. Data terkait akan benar-benar terhapus.
- Catatan internal admin dapat ditambahkan pada detail laporan/temuan, dilihat di Arsip & Catatan, dan dihapus.
- Aktivitas admin dicatat untuk membantu penelusuran tindakan.


PENGATURAN DATABASE
-------------------
api/config.php berisi host, nama database, username, password, zona waktu, dan lokasi QR.
Default Laragon: host 127.0.0.1, database kampusku, user root, password kosong.
Untuk server publik, gunakan user MySQL khusus, HTTPS, password database yang kuat, dan backup rutin.


BATASAN / CATATAN
-----------------
- Daftar NPM yang tersedia hanya 23 mahasiswa dari data yang diberikan, belum tentu seluruh mahasiswa kampus.
- Pencocokan nama + NPM mempersulit pendaftaran menggunakan NPM orang lain, tetapi bukan verifikasi identitas setingkat SSO atau OTP. Untuk penggunaan resmi, kampus sebaiknya memvalidasi daftar dan alur identitas.
- QR library dimuat dari CDN; pembuatan QR memerlukan internet.
- Sistem ini belum di-hosting publik dan perlu pengujian operasional kampus sebelum dipakai sungguhan.
