# 👥 User Guide - Pemantauan Tugas Siswa

> **📚 Documentation Hub**: [README.md](README.md) | **🏠 Main**: [../README.md](../README.md)

## 🎯 Overview

**Pemantauan Tugas Siswa** adalah aplikasi web untuk membantu guru memantau dan mengelola tugas siswa secara efektif. Aplikasi ini menyediakan dashboard terpisah untuk Administrator, Guru, dan Siswa dengan fitur-fitur yang disesuaikan dengan kebutuhan masing-masing peran.

**🌐 URL Aplikasi**: http://103.99.27.99:1239/tugasku/

## 🚀 Getting Started

### **Akses Pertama Kali**
1. Buka browser dan kunjungi: http://103.99.27.99:1239/tugasku/
2. Klik tombol **"Masuk ke Aplikasi"** 
3. Gunakan kredensial default untuk login pertama kali

### **Kredensial Default**
```
👑 Administrator:
Email: admin@tugasku.com
Password: admin123

👨‍🏫 Guru:
Email: guru@tugasku.com  
Password: guru123

👨‍🎓 Siswa:
Email: siswa@tugasku.com
Password: siswa123
```

> ⚠️ **Penting**: Segera ubah password default setelah login pertama kali!

## 👑 Panduan Administrator

### **Dashboard Admin**
Setelah login sebagai administrator, Anda akan melihat dashboard dengan:
- 📊 **Statistik System**: Total users, kelas, tugas aktif
- 📈 **Grafik Activity**: Aktivitas pengguna dalam 30 hari terakhir
- 🔔 **Notifications**: Alert system dan reminder
- 📋 **Quick Actions**: Shortcut ke fungsi penting

### **1. Manajemen Users**
**📍 Lokasi**: `Admin → Users`

#### **Menambah User Baru**
1. Klik tombol **"+ Tambah User"**
2. Isi form dengan data lengkap:
   - **Nama Lengkap**: Nama user yang akan ditampilkan
   - **Email**: Email unique untuk login
   - **Password**: Password minimal 6 karakter
   - **Role**: Pilih Admin, Guru, atau Siswa
   - **Kelas**: (Untuk siswa) Pilih kelas yang sesuai
   - **Status**: Aktif/Nonaktif
3. Klik **"Simpan"**

#### **Mengedit User**
1. Klik ikon **✏️ Edit** pada user yang ingin diubah
2. Update data yang diperlukan
3. Klik **"Update"**

#### **Menghapus User**
1. Klik ikon **🗑️ Delete** pada user yang ingin dihapus
2. Konfirmasi penghapusan
3. User akan dinonaktifkan (soft delete)

### **2. Manajemen Kelas**
**📍 Lokasi**: `Admin → Manajemen Kelas`

> **🎯 Konsep**: Kelas berfungsi untuk **mengelompokkan siswa berdasarkan tingkatan** (VII, VIII, IX)

#### **Membuat Kelas Baru**
1. Klik **"+ Tambah Kelas"**
2. Isi informasi kelas:
   - **Nama Kelas**: Tingkatan (VII, VIII, IX)
   - **Wali Kelas**: Pilih guru yang bertanggung jawab
   - **Tahun Ajaran**: Contoh "2024/2025"
   - **Semester**: Ganjil atau Genap
   - **Deskripsi**: Keterangan tambahan
3. Klik **"Simpan"**

#### **Mengelola Siswa dalam Kelas**
1. Klik **"👥 Kelola Siswa"** pada kelas
2. Tambah siswa dengan klik **"+ Tambah Siswa"**
3. Pilih siswa dari daftar yang tersedia
4. Siswa akan otomatis terdaftar dalam kelas berdasarkan tingkatan

### **3. Mata Pelajaran**
**📍 Lokasi**: `Admin → Mata Pelajaran`

> **🎯 Konsep**: Mata pelajaran berfungsi untuk **memberikan tugas berdasarkan kelompok kelas** yang dipilih

#### **Membuat Mata Pelajaran Baru**
1. Klik **"+ Tambah Mata Pelajaran"**
2. Isi informasi mata pelajaran:
   - **Nama Mata Pelajaran**: Contoh "Matematika VII"
   - **Guru Pengampu**: Pilih guru yang mengajar
   - **Tahun Ajaran**: Contoh "2024/2025"
   - **Semester**: Ganjil atau Genap
   - **Kelas Target**: **Pilih multiple kelas** yang akan diajar
   - **Deskripsi**: Keterangan mata pelajaran
3. Klik **"Simpan"**

#### **Assignment Mata Pelajaran ke Kelas**
- **Multiple Selection**: Satu mata pelajaran dapat di-assign ke beberapa kelas sekaligus
- **Fleksibilitas**: Mata pelajaran memilih kelas yang sudah dibuat di Management Kelas
- **Copy Function**: Duplikasi mata pelajaran dengan relasi kelas yang sama

#### **Alur Kerja: Kelas → Mata Pelajaran → Tugas**
```
1. Admin buat KELAS (VII, VIII, IX) → Assign siswa ke kelas
2. Admin buat MATA PELAJARAN → Pilih kelas target dari daftar
3. Guru buat TUGAS → Berdasarkan mata pelajaran dan kelas
```

### **4. Laporan System**
**📍 Lokasi**: `Admin → Laporan`

#### **Report yang Tersedia**
- **📊 Laporan Activity**: Aktivitas user harian/bulanan
- **📈 Laporan Performance**: Performa siswa per kelas
- **🎯 Laporan Tugas**: Status completion tugas
- **👥 Laporan User**: Data lengkap semua pengguna

#### **Generate Report**
1. Pilih jenis laporan
2. Set periode (dari tanggal - sampai tanggal)
3. Pilih filter (kelas, guru, dll)
4. Klik **"Generate Report"**
5. Download PDF atau export Excel

### **5. System Settings**
**📍 Lokasi**: `Admin → Settings`

#### **Konfigurasi Aplikasi**
- **Nama Sekolah**: Update nama institusi
- **Logo Sekolah**: Upload logo baru (max 2MB)
- **Tahun Ajaran**: Set tahun ajaran aktif
- **Timezone**: Pengaturan zona waktu
- **Email Settings**: Konfigurasi SMTP untuk notifikasi

## 👨‍🏫 Panduan Guru

### **Dashboard Guru**
Dashboard guru menampilkan:
- 📝 **My Tasks**: Tugas yang sedang Anda kelola
- 👥 **My Classes**: Kelas yang Anda ajar
- 📊 **Student Progress**: Progress siswa dalam tugas
- 🔔 **Notifications**: Reminder dan alert

### **1. Manajemen Tugas**
**📍 Lokasi**: `Guru → Tugas`

#### **Membuat Tugas Baru**
1. Klik **"+ Buat Tugas Baru"**
2. Isi detail tugas:
   - **Judul Tugas**: Nama tugas yang jelas
   - **Deskripsi**: Penjelasan detail tentang tugas
   - **Mata Pelajaran**: Pilih mata pelajaran
   - **Kelas**: Pilih kelas target (bisa multiple)
   - **Deadline**: Set tanggal dan waktu deadline
   - **Tipe Tugas**: Individual/Kelompok
   - **File Attachment**: Upload file pendukung (opsional)
3. Klik **"Publish Tugas"**

#### **Mengedit Tugas**
1. Klik ikon **✏️ Edit** pada tugas
2. Update informasi yang diperlukan
3. **Save Changes** atau **Publish Update**

#### **Melihat Submission**
1. Klik **"👀 Lihat Submission"** pada tugas
2. Review semua pengumpulan siswa
3. Download file submission jika ada
4. Berikan feedback dan nilai

### **2. Penilaian dan Feedback**
**📍 Lokasi**: `Guru → Nilai`

#### **Memberikan Nilai**
1. Pilih tugas yang ingin dinilai
2. Klik **"📝 Beri Nilai"** pada submission siswa
3. Isi form penilaian:
   - **Nilai Angka**: 0-100
   - **Grade**: A, B, C, D, E
   - **Feedback**: Komentar dan saran
   - **Catatan Privat**: Note untuk guru lain
4. Klik **"Simpan Nilai"**

#### **Bulk Grading**
1. Select multiple submission dengan checkbox
2. Klik **"Bulk Actions"**
3. Pilih **"Set Grade"** atau **"Add Comment"**
4. Apply ke semua selected items

### **3. Monitoring Progress**
**📍 Lokasi**: `Guru → Pengamatan`

#### **Track Student Progress**
- **📊 Progress Chart**: Visual progress per siswa
- **📅 Timeline View**: Aktivitas siswa per hari
- **🎯 Completion Rate**: Persentase penyelesaian tugas
- **⏰ Late Submissions**: Daftar pengumpulan terlambat

#### **Generate Progress Report**
1. Pilih kelas dan periode
2. Select students (individual/all)
3. Choose report template
4. Generate PDF report
5. Share dengan orang tua atau admin

### **4. Komunikasi dengan Siswa**
**📍 Lokasi**: `Guru → Messages`

#### **Send Announcement**
1. Klik **"📢 New Announcement"**
2. Select target (kelas/individual siswa)
3. Write message title and content
4. Set priority level
5. Schedule atau send immediately

#### **Private Messaging**
1. Klik nama siswa di daftar
2. Write private message
3. Attach files if needed
4. Send message

## 👨‍🎓 Panduan Siswa

### **Dashboard Siswa**
Dashboard siswa menampilkan:
- 📝 **Tugas Terbaru**: Assignment yang perlu dikerjakan
- ⏰ **Deadline Terdekat**: Reminder tugas yang segera berakhir
- 📊 **Progress Belajar**: Statistik personal progress
- 🎯 **Achievements**: Badge dan pencapaian

### **1. Mengerjakan Tugas**
**📍 Lokasi**: `Siswa → Tugas`

#### **Melihat Detail Tugas**
1. Klik tugas dari daftar
2. Baca deskripsi dan requirements
3. Download file attachment jika ada
4. Check deadline dan waktu tersisa

#### **Submit Tugas**
1. Klik **"📤 Submit Tugas"**
2. Upload file jawaban:
   - **Pilih File**: Browse dan pilih file (PDF, DOC, JPG)
   - **Max Size**: 10MB per file
   - **Multiple Files**: Bisa upload beberapa file
3. Tulis komentar submission (opsional)
4. Klik **"Submit"**

#### **Edit Submission**
> ⚠️ **Note**: Hanya bisa edit sebelum deadline

1. Klik **"✏️ Edit Submission"**
2. Replace file atau update komentar
3. Klik **"Update Submission"**

### **2. Melihat Nilai dan Feedback**
**📍 Lokasi**: `Siswa → Nilai`

#### **Check Grades**
- **📊 Grade Overview**: Semua nilai dalam bentuk chart
- **📝 Detailed View**: Nilai per tugas dengan feedback
- **📈 Progress Tracking**: Trend nilai dari waktu ke waktu
- **🎯 GPA Calculator**: Hitung rata-rata nilai

#### **Download Report Card**
1. Pilih periode (semester/tahun)
2. Select subjects (semua/specific)
3. Choose format (PDF/Excel)
4. Generate dan download

### **3. Progress Tracking**
**📍 Lokasi**: `Siswa → Progress`

#### **Personal Analytics**
- **📊 Completion Rate**: Persentase tugas selesai
- **⏰ On-Time Percentage**: Seberapa sering tepat waktu
- **📈 Grade Trend**: Trend nilai naik/turun
- **🎯 Subject Performance**: Performa per mata pelajaran

#### **Set Learning Goals**
1. Klik **"🎯 Set New Goal"**
2. Choose goal type:
   - Target nilai rata-rata
   - Completion rate target
   - Consistency goal
3. Set timeline dan reminder
4. Track progress regularly

### **4. Communication**
**📍 Lokasi**: `Siswa → Messages`

#### **Read Announcements**
- **📢 Class Announcements**: Pengumuman dari guru
- **🔔 System Notifications**: Update system dan reminder
- **📅 Calendar Events**: Jadwal dan acara penting

#### **Ask Questions**
1. Klik **"❓ Ask Teacher"**
2. Select subject teacher
3. Write your question clearly
4. Attach screenshot/file jika perlu
5. Submit question

## 🔧 Fitur Umum

### **1. Profile Management**
**📍 Lokasi**: `Profile → Edit Profile`

#### **Update Profile Info**
- **📷 Change Avatar**: Upload foto profil baru
- **📧 Update Email**: Ganti email login
- **🔒 Change Password**: Update password security
- **📱 Contact Info**: Update nomor telefon

#### **Privacy Settings**
- **👁️ Profile Visibility**: Atur siapa yang bisa melihat profil
- **📧 Email Notifications**: Pengaturan notifikasi email
- **🔔 Push Notifications**: Atur notifikasi browser

### **2. Search & Filter**
Semua halaman memiliki fitur pencarian dan filter:

#### **Quick Search**
- **🔍 Global Search**: Search box di header
- **🏷️ Filter by Tags**: Filter berdasarkan tag/kategori
- **📅 Date Range**: Filter berdasarkan tanggal
- **👥 User Filter**: Filter berdasarkan user/kelas

#### **Advanced Search**
- **Multi-criteria**: Kombinasi beberapa filter
- **Save Search**: Simpan pencarian favorit
- **Export Results**: Export hasil pencarian

### **3. Notifications**
**📍 Lokasi**: `🔔 Bell Icon` di header

#### **Notification Types**
- **📝 New Task**: Tugas baru dari guru
- **⏰ Deadline Reminder**: Pengingat deadline
- **📊 Grade Posted**: Nilai baru tersedia
- **📢 Announcements**: Pengumuman penting
- **💬 New Message**: Pesan baru dari guru/admin

#### **Notification Settings**
1. Klik **"⚙️ Notification Settings"**
2. Choose notification types:
   - Email notifications
   - Browser push notifications
   - SMS alerts (jika tersedia)
3. Set frequency dan timing
4. Save preferences

## 📱 Mobile Access

### **Responsive Design**
Aplikasi dapat diakses melalui mobile browser dengan fitur:
- **📱 Mobile-Optimized**: Interface disesuaikan untuk mobile
- **👆 Touch-Friendly**: Button dan link mudah ditekan
- **⚡ Fast Loading**: Optimized untuk koneksi mobile
- **💾 Offline Capable**: Beberapa fitur tersedia offline

### **Mobile Best Practices**
- **📶 Check Connection**: Pastikan koneksi internet stabil
- **🔋 Battery Saver**: Tutup tab lain untuk menghemat baterai
- **📱 Portrait Mode**: Gunakan orientasi portrait untuk experience terbaik
- **🔄 Refresh Regular**: Pull-to-refresh untuk update terbaru

## 🆘 Troubleshooting

### **Common Issues**

#### **🚫 Cannot Login**
**Problem**: Login gagal dengan kredensial yang benar  
**Solution**:
1. Clear browser cache dan cookies
2. Check caps lock untuk password
3. Reset password melalui admin
4. Try incognito/private browsing mode

#### **📤 File Upload Failed**
**Problem**: Gagal upload file tugas  
**Solution**:
1. Check file size (max 10MB)
2. Supported formats: PDF, DOC, DOCX, JPG, PNG
3. Rename file jika ada karakter khusus
4. Try upload satu file dulu

#### **⚡ Page Loading Slow**
**Problem**: Aplikasi lambat loading  
**Solution**:
1. Check internet connection speed
2. Clear browser cache
3. Close unnecessary tabs
4. Try different browser

#### **🔔 No Notifications**
**Problem**: Tidak menerima notifikasi  
**Solution**:
1. Check notification settings in profile
2. Allow browser notifications
3. Check email spam folder
4. Update notification preferences

### **Contact Support**
Jika masalah masih berlanjut:
- **📧 Email**: admin@tugasku.com
- **📱 Phone**: Contact your system administrator  
- **💬 In-App**: Use "Contact Support" feature
- **🕐 Hours**: Monday-Friday 8:00-16:00

## 🎯 Tips & Best Practices

### **For Students**
1. **⏰ Check Daily**: Login setiap hari untuk update terbaru
2. **📅 Use Calendar**: Manfaatkan calendar view untuk planning
3. **📝 Submit Early**: Jangan tunggu deadline terakhir
4. **💾 Backup Work**: Selalu backup file penting
5. **❓ Ask Questions**: Jangan ragu bertanya pada guru

### **For Teachers**
1. **📋 Plan Ahead**: Buat tugas di awal semester
2. **🔔 Set Reminders**: Use reminder untuk deadline
3. **💬 Engage Students**: Aktif komunikasi dengan siswa
4. **📊 Monitor Progress**: Check student progress regularly
5. **📈 Use Analytics**: Manfaatkan data untuk improve teaching

### **For Administrators**
1. **🔒 Security First**: Regular password updates
2. **📊 Monitor Usage**: Track system usage dan performance
3. **💾 Backup Data**: Regular database backup
4. **📧 Train Users**: Provide training untuk new users
5. **🔄 Stay Updated**: Keep system updated dan secure

## 📚 Additional Resources

### **Video Tutorials**
- **🎥 Getting Started**: Basic navigation tutorial
- **🎬 Advanced Features**: Power user features
- **📹 Mobile Guide**: Using app on mobile devices

### **Documentation**
- **📖 [Installation Guide](installation.md)**: Setup instructions
- **🔧 [Development Guide](development.md)**: For developers
- **🏗️ [Architecture](architecture.md)**: System architecture
- **🗄️ [Database Schema](database.md)**: Database structure

### **Community**
- **💬 User Forum**: Share tips dan ask questions
- **📧 Newsletter**: Monthly updates dan tips
- **🐛 Bug Reports**: Report issues dan suggestions

---

**🎓 Happy Learning! Aplikasi ini dirancang untuk membantu proses belajar mengajar menjadi lebih efektif dan menyenangkan.**