kangmin/presensi
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Sync foto: generate embedding dan simpan ke student_faces, opsi no-embedding, update docs

Browse Source
This commit is contained in:
mwpn
2026-03-08 14:28:39 +07:00
parent 461c5c7882
commit 185b00df7c
2 changed files with 100 additions and 7 deletions
Download Patch File Download Diff File Expand all files Collapse all files

11
docs/SYNC_FOTO_WAJAH.md
View File

@@ -2,6 +2,8 @@
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).
@@ -23,11 +25,14 @@ Folder contoh: [Foto Siswa Kls XII TP 25-26](https://drive.google.com/drive/fold
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`.
- 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)
@@ -44,5 +49,7 @@ Ke depan bisa ditambah halaman di **Pengaturan Academic → Siswa**: per siswa a
| 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 |
| Sumber | Download folder Drive → rename file = NISN → jalankan script sync (dan pastikan face-service jalan) |
| Opsi | `--no-embedding` = hanya copy file, tidak generate embedding |