56 lines
3.1 KiB
Markdown
56 lines
3.1 KiB
Markdown
# Sync Foto Wajah dari Google Drive untuk Smart Presensi
|
|
|
|
Foto wajah siswa dipakai untuk **verifikasi wajah** di aplikasi mobile (absen masuk/pulang). Foto disimpan di backend: `writable/faces/{student_id}.jpg`.
|
|
|
|
**Alur yang proper:** Verifikasi wajah memakai **vektor (embedding)** yang disimpan di tabel `student_faces`, bukan file gambar mentah. Jadi setelah foto formal ada (dari Drive atau sumber lain), kita **harus bikin vektor dulu** lewat face-service lalu simpan ke `student_faces`. Script sync di bawah mengerjakan keduanya: copy file **dan** generate embedding.
|
|
|
|
## Sumber foto
|
|
|
|
Folder contoh: [Foto Siswa Kls XII TP 25-26](https://drive.google.com/drive/folders/16E84NFGYPItaTANQwEyMQW5rkTCt6Asy) — berisi subfolder per kelas (XII-1, XII-2, … XII-12, Susulan).
|
|
|
|
## Cara 1: Download manual lalu jalankan script
|
|
|
|
1. **Download folder dari Google Drive**
|
|
- Buka folder di Drive, pilih semua subfolder (XII-1 … XII-12), lalu **Download** (zip).
|
|
- Ekstrak ke suatu folder, misalnya `C:\temp\foto-siswa-xii`.
|
|
|
|
2. **Konvensi nama file**
|
|
- Setiap foto **wajib** bernama **NISN** siswa + ekstensi, contoh:
|
|
- `1234567890.jpg` atau `1234567890.png`
|
|
- Jika di Drive nama file bukan NISN (misalnya "Budi Santoso.jpg"), rename dulu per file sesuai NISN siswa.
|
|
|
|
3. **Jalankan script sync**
|
|
- Dari **folder backend** (bukan dari scripts):
|
|
```bash
|
|
cd c:\laragon\www\sman1\backend
|
|
php scripts/sync_face_photos.php --source=C:\temp\foto-siswa-xii
|
|
```
|
|
- Pastikan **face-service** (Python) sudah jalan, karena script akan memanggilnya untuk generate embedding.
|
|
- Script akan:
|
|
- Scan semua subfolder (XII-1, XII-2, dll.),
|
|
- Untuk setiap file gambar (.jpg, .jpeg, .png), ambil nama file tanpa ekstensi = NISN,
|
|
- Cari siswa di database berdasarkan NISN,
|
|
- Copy file ke `writable/faces/{student_id}.jpg`,
|
|
- **Kirim gambar ke face-service → dapat embedding → simpan ke tabel `student_faces` (source=formal)**.
|
|
- Opsi `--no-embedding`: hanya copy file + update `face_hash`, tidak generate vektor (misalnya kalau face-service belum jalan).
|
|
|
|
## Cara 2: Upload per siswa lewat dashboard (rencana)
|
|
|
|
Ke depan bisa ditambah halaman di **Pengaturan Academic → Siswa**: per siswa ada tombol "Upload foto wajah", simpan ke `writable/faces/{student_id}.jpg`.
|
|
|
|
## API untuk mobile
|
|
|
|
- **GET** `/api/mobile/student/face-photo?student_id=123`
|
|
Mengembalikan gambar foto wajah siswa (atau 404 jika belum ada).
|
|
Dipakai aplikasi mobile untuk memuat foto referensi lalu membandingkan dengan wajah yang terdeteksi kamera (face-api.js).
|
|
|
|
## Ringkas
|
|
|
|
| Yang diatur | Keterangan |
|
|
|-------------|------------|
|
|
| Penyimpanan | `writable/faces/{student_id}.jpg` (atau .png) |
|
|
| **Vektor (embedding)** | Script sync memanggil face-service lalu menyimpan ke `student_faces` (source=formal). Verifikasi wajah memakai data ini. |
|
|
| Mapping | Nama file = NISN → cari siswa → simpan dengan student_id |
|
|
| Sumber | Download folder Drive → rename file = NISN → jalankan script sync (dan pastikan face-service jalan) |
|
|
| Opsi | `--no-embedding` = hanya copy file, tidak generate embedding |
|