PANDUAN PENAMBAHAN DATA SISWA KE SISTEM SPK JURUSAN

═════════════════════════════════════════════════════════════════════════════

1. STRUKTUR DATABASE UNTUK SISWA
────────────────────────────────────────────────────────────────────────────

Tabel: users (informasi siswa)
┌──────────────────┬──────────┬────────────────────────────────────────────┐
│ Kolom            │ Tipe     │ Keterangan                                 │
├──────────────────┼──────────┼────────────────────────────────────────────┤
│ id               │ Integer  │ ID Otomatis (jangan isi)                   │
│ name             │ String   │ Nama Lengkap Siswa (max 255 karakter)     │
│ email            │ String   │ Email Unik (format: nama@student.edu)      │
│ password         │ String   │ Password (bisa default atau custom)        │
│ role             │ String   │ Role tetap: "siswa" (jangan diubah)        │
│ kelompok_asal    │ String   │ IPA atau IPS (wajib diisi)                 │
└──────────────────┴──────────┴────────────────────────────────────────────┘

Tabel: rekomendasi (hasil test dan rekomendasi jurusan)
┌──────────────────┬──────────┬────────────────────────────────────────────┐
│ Kolom            │ Tipe     │ Keterangan                                 │
├──────────────────┼──────────┼────────────────────────────────────────────┤
│ user_id          │ Integer  │ ID Siswa (dari tabel users)                │
│ mtk              │ Decimal  │ Nilai Matematika (0-100)                   │
│ fisika           │ Decimal  │ Nilai Fisika (0-100) - Untuk IPA           │
│ kimia            │ Decimal  │ Nilai Kimia (0-100) - Untuk IPA            │
│ biologi          │ Decimal  │ Nilai Biologi (0-100) - Untuk IPA          │
│ ekonomi          │ Decimal  │ Nilai Ekonomi (0-100) - Untuk IPS          │
│ geografi         │ Decimal  │ Nilai Geografi (0-100) - Untuk IPS         │
│ sosiologi        │ Decimal  │ Nilai Sosiologi (0-100) - Untuk IPS        │
│ sejarah          │ Decimal  │ Nilai Sejarah (0-100) - Untuk IPS          │
│ minat            │ String   │ Minat Siswa (max 255 karakter)             │
│ preferensi_studi │ String   │ Preferensi Studi (lihat daftar di bawah)   │
│ cita_cita        │ String   │ Cita-cita/Karir Impian (max 255 karakter) │
│ prestasi         │ String   │ Prestasi yang dimiliki (max 255 karakter) │
│ hasil_rekomendasi│ JSON     │ Hasil ranking jurusan (otomatis generate)   │
└──────────────────┴──────────┴────────────────────────────────────────────┘

═════════════════════════════════════════════════════════════════════════════

2. DAFTAR PREFERENSI STUDI (Gunakan sesuai kategori)
────────────────────────────────────────────────────────────────────────────

UNTUK KELOMPOK IPA:
  • Sains & Teknologi
  • Pertanian & Lingkungan
  • Kesehatan & Ilmu Hayat

UNTUK KELOMPOK IPS:
  • Bisnis & Manajemen
  • Sosial & Humaniora

═════════════════════════════════════════════════════════════════════════════

3. DAFTAR JURUSAN & BOBOT MAPEL (UNTUK REFERENSI)
────────────────────────────────────────────────────────────────────────────

JURUSAN IPA:

1. TEKNOLOGI INFORMASI
   MTK: 0.50★  Fisika: 0.20  Kimia: 0.10  Biologi: 0.10
   (Cocok untuk: nilai MTK tinggi, logika kuat, tertarik programming)

2. TEKNIK
   MTK: 0.40  Fisika: 0.45★  Kimia: 0.15  Biologi: 0.10
   (Cocok untuk: fisika tinggi, suka mesin/listrik/konstruksi)

3. TEKNOLOGI PERTANIAN
   MTK: 0.35  Fisika: 0.35★  Kimia: 0.20  Biologi: 0.15
   (Cocok untuk: fisika-mtk tinggi, tertarik inovasi pertanian)

4. KESEHATAN
   MTK: 0.20  Fisika: 0.15  Kimia: 0.35  Biologi: 0.45★
   (Cocok untuk: kimia-biologi tinggi, peduli kesehatan)

5. PRODUKSI PERTANIAN
   MTK: 0.15  Fisika: 0.15  Kimia: 0.30  Biologi: 0.40★
   (Cocok untuk: biologi tinggi, tertarik pertanian tradisional)

6. PETERNAKAN
   MTK: 0.20  Fisika: 0.15  Kimia: 0.25  Biologi: 0.45★
   (Cocok untuk: biologi tinggi, tertarik hewan/ternak)

JURUSAN IPS:

7. BISNIS
   MTK: 0.45  Ekonomi: 0.50★  Geografi: 0.15  Sosiologi: 0.20
   (Cocok untuk: ekonomi-mtk tinggi, suka perhitungan bisnis)

8. MANAJEMEN AGRIBISNIS
   MTK: 0.35  Ekonomi: 0.45★  Geografi: 0.20  Sosiologi: 0.20
   (Cocok untuk: ekonomi tinggi, tertarik bisnis pertanian)

9. BAHASA, KOMUNIKASI, DAN PARIWISATA
   MTK: 0.15  Ekonomi: 0.25  Geografi: 0.35  Sosiologi: 0.35★
   (Cocok untuk: sejarah-sosiologi tinggi, suka bahasa/wisata)

═════════════════════════════════════════════════════════════════════════════

4. CONTOH DATA SISWA YANG LOGIS (FORMAT SPREADSHEET)
────────────────────────────────────────────────────────────────────────────

Format Excel/CSV:
name | email | kelompok_asal | mtk | fisika | kimia | biologi | ekonomi | geografi | sosiologi | sejarah | minat | preferensi_studi | cita_cita | prestasi

CONTOH DATA IPA:

Rinto Wijaya|rinto@student.edu|IPA|92|88|75|70|0|0|0|0|Logika Komputer|Sains & Teknologi|Software Engineer|Juara 1 Coding

Siti Aminah|siti@student.edu|IPA|78|68|90|89|0|0|0|0|Farmasi & Kesehatan|Kesehatan & Ilmu Hayat|Apoteker|Olimpiade Biologi

Hendra Suryanto|hendra@student.edu|IPA|87|86|76|78|0|0|0|0|Inovasi Pertanian|Sains & Teknologi|Engineer Pertanian|Penemu Alat

CONTOH DATA IPS:

Rina Handayani|rina@student.edu|IPS|0|0|0|0|92|85|80|78|Bisnis & Kewirausahaan|Bisnis & Manajemen|Entrepreneur|Juara Kompetisi Bisnis

Lisa Maharani|lisa@student.edu|IPS|0|0|0|0|76|85|82|85|Pariwisata & Budaya|Sosial & Humaniora|Tour Guide|Pelatihan Tour Guide

═════════════════════════════════════════════════════════════════════════════

5. TIPS UNTUK NILAI YANG LOGIS
────────────────────────────────────────────────────────────────────────────

UNTUK TEKNOLOGI INFORMASI:
  • MTK: 85-95 (prioritas tertinggi)
  • Fisika: 75-90 (penting)
  • Kimia, Biologi: 60-75 (tidak prioritas)

UNTUK TEKNIK:
  • Fisika: 85-95 (prioritas tertinggi)
  • MTK: 80-92 (penting)
  • Kimia: 60-80 (cukup)
  • Biologi: 50-70 (tidak prioritas)

UNTUK KESEHATAN:
  • Biologi: 85-95 (prioritas tertinggi)
  • Kimia: 80-92 (penting)
  • MTK, Fisika: 65-80 (cukup)

UNTUK BISNIS (IPS):
  • Ekonomi: 85-95 (prioritas tertinggi)
  • MTK: 80-92 (penting untuk akuntansi)
  • Geografi, Sosiologi: 70-85 (cukup)
  • Sejarah: 60-80 (tidak prioritas)

UNTUK BAHASA & PARIWISATA (IPS):
  • Sejarah: 85-95 (prioritas tertinggi - konteks budaya)
  • Sosiologi: 80-92 (penting - interaksi sosial)
  • Geografi: 75-90 (penting - destinasi wisata)
  • Ekonomi: 65-85 (cukup - bisnis pariwisata)
  • MTK: 50-75 (tidak prioritas)

═════════════════════════════════════════════════════════════════════════════

6. CARA IMPORT DATA KE SISTEM
────────────────────────────────────────────────────────────────────────────

Opsi 1: Manual via UI Admin
  1. Login sebagai Admin/BK
  2. Ke menu Admin > Guru BK > Tambah Siswa
  3. Isi data satu per satu
  4. Siswa bisa langsung akses sistem

Opsi 2: Bulk Import (melalui Database Langsung)
  1. Siapkan file CSV dengan format di atas
  2. Import ke database menggunakan migration/seeder
  3. Hubungi admin untuk setup seeder khusus

Opsi 3: API Import (untuk integrasi sistem SMK)
  1. Gunakan endpoint POST /api/students
  2. Format JSON dengan data siswa
  3. Sistem akan auto-generate rekomendasi

═════════════════════════════════════════════════════════════════════════════

7. TEMPLATE EXCEL UNTUK IMPORT (KOSONG SIAP DIISI)
────────────────────────────────────────────────────────────────────────────

Nama Siswa       | Email                | Kelompok | MTK | Fisika | Kimia | Biologi | Ekonomi | Geografi | Sosiologi | Sejarah | Minat | Preferensi | Cita-cita | Prestasi
─────────────────┼──────────────────────┼──────────┼─────┼────────┼───────┼─────────┼─────────┼──────────┼───────────┼─────────┼──────┼────────────┼───────────┼──────────
                 |                      | IPA/IPS  |     |        |       |         |         |          |           |         |      |            |           |          
                 |                      | IPA/IPS  |     |        |       |         |         |          |           |         |      |            |           |          
                 |                      | IPA/IPS  |     |        |       |         |         |          |           |         |      |            |           |          

═════════════════════════════════════════════════════════════════════════════

8. CATATAN PENTING
────────────────────────────────────────────────────────────────────────────

✓ Pastikan nilai mapel sesuai dengan kelompok asal:
  - IPA: isi MTK, Fisika, Kimia, Biologi (sisanya 0)
  - IPS: isi Ekonomi, Geografi, Sosiologi, Sejarah (sisanya 0)

✓ Email harus unik (tidak boleh sama dengan siswa lain)

✓ Preferensi studi harus sesuai kategori yang tersedia (lihat poin 2)

✓ Minat dan Cita-cita akan membantu sistem memberikan rekomendasi yang lebih akurat

✓ Prestasi menunjukkan potensi siswa (bisa dilihat di chat history nantinya)

✓ Setelah data diimport, siswa bisa langsung login dengan:
  - Email: sesuai yang didaftar
  - Password: "password" (atau sesuai yang ditetapkan admin)

═════════════════════════════════════════════════════════════════════════════

Jika ada pertanyaan atau butuh bantuan import data, hubungi admin sistem!
