MIF_E31230745/PANDUAN_IMPORT_SISWA.txt

211 lines
13 KiB
Plaintext

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!