presensi/PROJECT_CONDITION_AUDIT.md

Audit Kondisi Project SMAN 1 — Detail

Tanggal: 2026-02-23

---

1. Struktur Module

Module yang sudah ada

Module	Lokasi	Isi utama
Academic	app/Modules/Academic/	Classes, Students, Subjects, Teachers, Schedules, Lesson Slots, DapodikSync (controller + service + mapping model)
Attendance	app/Modules/Attendance/	AttendanceSession, Checkin, Report
Auth	app/Modules/Auth/	Login, User, Role, UserRole
Dashboard	app/Modules/Dashboard/	Dashboard, Schedule, Attendance, Realtime
Devices	app/Modules/Devices/	Device, Mobile, DeviceAuth
Notification	app/Modules/Notification/	Telegram, Parent, StudentParent
Geo	app/Modules/Geo/	Zone, GeoFence

Cek per modul yang Anda tanyakan

Modul	Status	Keterangan
Classes	✅ Ada	Di dalam Academic: ClassModel, ClassEntity, ClassController (CRUD), route GET/POST/PUT/DELETE /api/academic/classes, halaman /dashboard/academic/classes
Students	✅ Ada	Di dalam Academic: StudentModel, StudentEntity, StudentController (CRUD + paginasi), route GET/POST/PUT/DELETE /api/academic/students, halaman /dashboard/academic/students
Attendance	✅ Ada	Module Attendance terpisah: AttendanceSessionModel, AttendanceCheckinService, AttendanceReportService, dll. Tabel: attendance_sessions (bukan attendance_logs)
Schedule	✅ Ada	Di dalam Academic: ScheduleModel, ScheduleManagementController, ScheduleResolverService, lesson_slots. Tabel: schedules, lesson_slots
DapodikSync	✅ Ada	Di dalam Academic: DapodikClient, DapodikSyncService, DapodikSyncController, DapodikRombelMappingModel. Route: POST sync/students, GET/PUT rombels. Halaman /dashboard/academic/dapodik

Kesimpulan: Semua modul yang Anda sebut (Classes, Students, Attendance, Schedule, DapodikSync) sudah ada. Tidak ada modul terpisah bernama "Classes" atau "Students"; semuanya di bawah Academic.

---

2. Database

Tabel yang ada (beserta struktur)

Catatan: Tidak ada tabel bernama attendance_logs. Yang dipakai: attendance_sessions.

2.1 Tabel classes

Field	Type	Relasi
id	INT PK AUTO_INCREMENT	-
name	VARCHAR(100)	- (rombel, mis. A, B, C)
grade	VARCHAR(50)	- (tingkat, mis. 10, X)
major	VARCHAR(50) NOT NULL DEFAULT 'IPA'	- (jurusan)
wali_user_id	INT NULL	FK → users.id (SET NULL)
created_at	DATETIME NULL	-
updated_at	DATETIME NULL	-

Relasi keluar: students.class_id, schedules.class_id, dapodik_rombel_mappings.class_id → classes.id

---

2.2 Tabel students

Field	Type	Relasi
id	INT PK AUTO_INCREMENT	-
nisn	VARCHAR(50) NOT NULL UNIQUE	-
name	VARCHAR(255)	-
gender	VARCHAR(1) NULL	L/P
class_id	INT NULL	FK → classes.id (SET NULL) — nullable untuk unmapped
is_active	TINYINT(1) DEFAULT 1	-
parent_link_code	VARCHAR	(dari migration lain)
created_at	DATETIME NULL	-
updated_at	DATETIME NULL	-

Relasi: class_id → classes.id (boleh NULL untuk siswa belum di-map dari Dapodik).

---

2.3 Tabel attendance_sessions (bukan attendance_logs)

Field	Type	Relasi
id	INT PK	-
student_id	INT	FK → students.id
schedule_id	INT NULL	FK → schedules.id
device_id	INT	FK → devices.id
attendance_date	DATE	(dari migration unik)
checkin_at	DATETIME	-
latitude, longitude, confidence	DECIMAL	-
status	ENUM(PRESENT, LATE, OUTSIDE_ZONE, NO_SCHEDULE, INVALID_DEVICE)	-
created_at, updated_at	DATETIME NULL	-

Relasi: student_id → students, schedule_id → schedules, device_id → devices.

---

2.4 Tabel schedules

Field	Type	Relasi
id	INT PK	-
class_id	INT	FK → classes.id
lesson_slot_id	INT NULL	FK → lesson_slots.id
subject_id	INT	FK → subjects.id
teacher_user_id	INT NULL	FK → users.id
teacher_name	VARCHAR(255)	-
day_of_week	TINYINT (1=Senin, 7=Minggu)	-
start_time, end_time	TIME	-
room	VARCHAR(100) NULL	-
is_active	TINYINT DEFAULT 1	-
created_at, updated_at	DATETIME NULL	-

Unique: (class_id, lesson_slot_id, day_of_week).

Relasi: class_id → classes, subject_id → subjects, teacher_user_id → users, lesson_slot_id → lesson_slots.

---

2.5 Tabel tambahan terkait

• dapodik_rombel_mappings: id, dapodik_rombel (UNIQUE), class_id (FK → classes, NULL), last_seen_at, created_at, updated_at.
• lesson_slots: id, slot_number, start_time, end_time, is_active.
• subjects: id, name, code (nullable).

---

3. Flow Master Data

3.1 Kelas: input manual atau belum?

• Input kelas: manual lewat halaman Classes (/dashboard/academic/classes), hanya untuk role ADMIN.
• Form: Tingkat (text), Jurusan (text), Rombel (text), Wali Kelas (dropdown user).
• Data disimpan ke tabel classes (name = rombel, grade, major, wali_user_id).
• Jika belum pernah input: tabel classes kosong → tidak ada pilihan kelas di mana pun (Schedule Builder, Students, dll.).

3.2 Schedule Builder mengambil data kelas dari mana?

• Dari API: GET /api/academic/classes (admin_only).
• Halaman Schedule Builder index (/dashboard/academic/schedule-builder) memanggil API ini lalu mengisi dropdown "Kelas" (option value = class id, text = nama/rombel).
• Data sumber: tabel classes via ClassController::index().

3.3 Kenapa dropdown kelas bisa kosong?

• Penyebab: Tabel classes tidak punya data (belum ada satu baris pun).
• Alur: Tidak ada kelas → API /api/academic/classes mengembalikan array kosong → dropdown hanya berisi "— Pilih kelas —" → Open Builder tidak bisa dipakai.
• Solusi: Login sebagai ADMIN → buka Academic → Classes → tambah minimal satu kelas (mis. Tingkat 10, Jurusan IPA, Rombel 1). Setelah itu dropdown di Schedule Builder akan terisi.

---

4. Dapodik Integration

Aspek	Status	Keterangan
Controller Dapodik Sync	✅ Ada	App\Modules\Academic\Controllers\DapodikSyncController
Endpoint API	✅ Ada	POST /api/academic/dapodik/sync/students, GET /api/academic/dapodik/rombels, PUT /api/academic/dapodik/rombels/{id} (semua admin_only)
Rencana vs realisasi	✅ Sudah diimplementasi	DapodikClient (getSekolah, getPesertaDidik), DapodikSyncService (sync siswa + rombel mapping), halaman Dapodik di dashboard

Env yang dipakai: DAPODIK_BASE_URL, DAPODIK_TOKEN, DAPODIK_NPSN (di .env).

---

5. Student Page

Apakah halaman Student sudah tampil?

• Route: ✅ Ada — GET /dashboard/academic/students → DashboardAcademicController::students, filter dashboard_admin_page.
• Controller: ✅ Ada — method students() me-render view dashboard/students.
• View: ✅ Ada — app/Views/dashboard/students.php (tabel, filter, paginasi, modal tambah/edit/hapus).
• Query/relasi: ✅ API GET /api/academic/students jalan; join ke classes untuk class_label; class_id boleh NULL (tidak gagal).

Kenapa bisa “belum tampil”?

Kemungkinan:

1. Bukan ADMIN — halaman dan menu Students hanya untuk role ADMIN. Jika login bukan ADMIN, menu Academic (termasuk Students) tidak muncul.
2. URL salah — harus akses tepat: /dashboard/academic/students (mis. http://localhost/sman1/backend/public/dashboard/academic/students).
3. Session/redirect — jika belum login atau filter redirect, akan ke halaman login/dashboard.
4. Data kosong — halaman tetap tampil; yang kosong hanya tabel siswa (belum ada data siswa). Bukan penyebab “halaman tidak tampil”.

Kesimpulan: Secara kode, route, controller, view, dan relasi sudah ada dan konsisten. Kalau “belum tampil”, paling mungkin karena bukan user ADMIN atau salah URL/base URL.

---

6. Problem Diagnosis

“Schedule Builder meminta kelas, tapi tidak ada tempat input kelas”

• Faktanya: Sudah ada tempat input kelas, yaitu halaman Classes (/dashboard/academic/classes), hanya untuk ADMIN.
• Alur yang benar:
  1. ADMIN buka Academic → Classes (atau lewat Academic → Settings → kartu Classes).
  2. Klik Tambah Kelas → isi Tingkat, Jurusan, Rombel, (opsional) Wali Kelas → Simpan.
  3. Setelah ada minimal 1 kelas, buka Schedule Builder → dropdown Kelas terisi → pilih kelas → Open Builder.

Jadi masalahnya bukan “tidak ada tempat input”, melainkan:

• User belum pernah mengisi kelas di halaman Classes, atau
• Menu Classes tidak terlihat (mis. karena tidak login sebagai ADMIN).

Rekomendasi: Di halaman Schedule Builder index bisa ditambah kalimat singkat: “Jika dropdown kosong, tambah dulu kelas di Academic → Classes.”

---

7. Ringkasan Kondisi Project

Aspek	Status	Keterangan
Module Academic (Classes, Students, Subjects, Teachers, Schedules, Lesson Slots)	✅ Sudah jadi	CRUD API + halaman dashboard per entitas
Module Attendance	✅ Sudah jadi	attendance_sessions, check-in, report
Module Schedule (jadwal per kelas)	✅ Sudah jadi	Schedule Builder, bulk save, lesson_slots
Module DapodikSync	✅ Sudah jadi	Sync siswa, mapping rombel → class, halaman Dapodik
Tabel classes, students, schedules, attendance_sessions	✅ Sudah jadi	Struktur + relasi jelas (termasuk lesson_slots, subjects, dapodik_rombel_mappings)
Input kelas manual	✅ Sudah jadi	Halaman Classes, form lengkap
Schedule Builder pakai data kelas	✅ Sudah jadi	Dari GET /api/academic/classes
Halaman Students	✅ Sudah jadi	Route, controller, view, API, paginasi, filter
Dropdown kelas kosong	⚠️ Setengah jadi	Fitur jalan; kosong karena belum ada data kelas di DB
Dapodik sebagai sumber master kelas	⚠️ Setengah jadi	Saat ini Dapodik hanya sync siswa + mapping rombel → class. Kelas internal tetap buat manual di Classes; belum ada “sync rombel → buat kelas otomatis”

---

8. Arsitektur saran: Dapodik sebagai sumber utama master data

Target alur: DAPODIK → Sync → Classes → Students → Schedule → Attendance.

Kondisi saat ini

• Classes: input manual; tidak ada sync dari Dapodik.
• Students: bisa dari Dapodik (sync siswa + mapping rombel → class_id). class_id bisa NULL (unmapped).
• Schedule & Attendance: sudah mengandalkan classes + students.

Opsi arsitektur

Opsi A — Kelas tetap manual (minimal change)

• Tetap: Classes diisi manual (grade + major + rombel).
• Dapodik: sync siswa + mapping dapodik_rombel → class_id.
• Sesuai jika: rombel Dapodik banyak dan Anda ingin satu rombel Dapodik = satu kelas internal yang sudah Anda buat manual.

Opsi B — Sync rombel Dapodik → buat/update kelas (disarankan untuk “Dapodik sumber utama”)

1. Tambah sync kelas/rombel dari Dapodik

   • Endpoint Dapodik: daftar rombongan belajar (rombel) per sekolah.
   • Logic: untuk setiap rombel Dapodik, buat atau update satu baris di classes (mis. parse nama rombel jadi grade + major + name/rombel), plus tetap isi dapodik_rombel_mappings (dapodik_rombel → class_id) agar siswa sync bisa map ke kelas yang sama.
   • Aturan: satu dapodik_rombel = satu class_id; kelas bisa dibuat otomatis dari nama rombel Dapodik (mis. "10 IPA 1" → grade=10, major=IPA, name=1).

2. Urutan sync disarankan

   • Sync rombel/kelas dulu (baca Dapodik → insert/update classes + dapodik_rombel_mappings).
   • Lalu sync siswa (seperti sekarang); mapping rombel → class_id sudah terisi, sehingga siswa dapat class_id otomatis.

3. Tetap boleh edit manual

   • Halaman Classes tetap dipakai untuk koreksi/naming (grade, major, rombel, wali).
   • Setelah sync, admin bisa ubah nama/struktur kelas jika perlu.

Opsi C — Hybrid (seperti B + flag sumber)

• Tambah kolom mis. source (manual / dapodik) di classes supaya bisa bedakan kelas yang dari Dapodik vs yang buat manual.

Rekomendasi singkat

• Langkah 1: Pastikan ada data kelas (manual) dulu agar Schedule Builder dan dropdown siswa tidak kosong.
• Langkah 2: Jika ingin Dapodik sebagai sumber utama kelas, tambah sync rombel Dapodik → classes (Opsi B); jadwalkan sync rombel dulu, baru sync siswa.
• Langkah 3: Tetap pakai Dapodik Sync yang sudah ada untuk siswa dan mapping rombel → class; setelah kelas bisa dari Dapodik, mapping itu akan mengisi class_id siswa tanpa perlu input kelas manual dulu.

Dengan ini, arsitektur bergerak ke: DAPODIK → Sync (rombel + siswa) → Classes & Students terisi → Schedule (manual di builder) → Attendance.