Aplikasi desktop untuk mempermudah pencarian, pemesanan, dan pengelolaan jadwal tutor privat.
Turator adalah sebuah aplikasi perangkat lunak yang dirancang untuk menjadi jembatan antara siswa dan tutor privat. Aplikasi ini menyediakan platform yang efisien dan ramah pengguna untuk mendukung kebutuhan belajar-mengajar.
- Untuk Siswa 🧑🎓: Memungkinkan pencarian tutor berdasarkan mata pelajaran, melakukan pemesanan sesi, menjadwalkan ulang, hingga memberikan ulasan dan rating.
- Untuk Tutor 👩🏫: Menyediakan fitur untuk mengatur jadwal ketersediaan, mengelola permintaan sesi, serta memberikan laporan perkembangan belajar siswa.
Untuk menjalankan proyek ini di lingkungan lokal, ikuti langkah-langkah berikut.
Pastikan sistem Anda memenuhi persyaratan berikut:
- Sistem Operasi: Windows 10+, macOS 12+, atau Linux.
- Java Development Kit (JDK): Versi 11 atau yang lebih baru.
- DBMS: PostgreSQL.
-
Clone Repositori Buka terminal atau CMD dan jalankan perintah berikut:
git clone "[https://github.com/suryasuharna23/IF2050-2025-K2D-Turator.git](https://github.com/suryasuharna23/IF2050-2025-K2D-Turator.git)" cd IF2050-2025-K2D-Turator
-
Jalankan Aplikasi Proyek ini dapat dijalankan menggunakan skrip yang telah disediakan atau langsung melalui Gradle.
Buka CMD atau PowerShell, lalu jalankan salah satu perintah berikut sesuai kebutuhan:
-
Mode Cepat (Quick Start): Menjalankan aplikasi dengan konfigurasi minimal, mungkin menggunakan database sementara. Cocok untuk melihat-lihat antarmuka tanpa setup penuh.
.\run-turator.bat quick -
Mode Pengembangan (Development): Menjalankan aplikasi dalam mode pengembangan. Biasanya terhubung ke database lokal dan mungkin akan mengatur (membuat/menghapus) tabel secara otomatis.
.\run-turator.bat dev -
Mode Produksi (Production): Menjalankan aplikasi dalam mode produksi. Dikonfigurasi untuk koneksi ke database yang stabil dan tidak akan mengubah struktur data.
.\run-turator.bat prod
Jika Anda tidak menggunakan Windows atau ingin menjalankan via Gradle secara langsung, gunakan perintah berikut di terminal:
-
Di Windows CMD :
gradlew run
-
Di macOS / Linux / Powershell:
./gradlew run
-
Proyek ini dikembangkan secara kolaboratif dengan pembagian tugas pada modul-modul berikut:
| Modul | Penanggung Jawab | File Terkait |
|---|---|---|
| 🔑 Autentikasi (Login & Register) |
|
LoginController.java, RegisterStudentController.java, RegisterTutorController.java, Siswa.java, Tutor.java |
| 🔍 Pencarian Tutor |
|
PencarianController.java, TutorCardController.java, PencarianModel.java |
| 🛒 Pemesanan Tutor |
|
SuccesOrderPoupController.java, TutorCardPopupController.java |
| 🗓️ Sesi Belajar |
|
SesiBelajarController.java, KartuJadwalController.java, DetailJadwalController.java, DaySelectionController.java |
| 👤 Profil (Student & Tutor) |
|
ProfileTutorController.java, ProfileStudentController.java |
| 🗃️ Database & Integrasi |
|
BaseDAO, SiswaDAO, TutorDAO, dll |
Struktur basis data aplikasi ini menggunakan beberapa tabel relasional sebagai berikut:
| Column | Type | Nullable | Default |
|---|---|---|---|
id |
integer |
not null | nextval('sesi_belajar_id_seq'::regclass) |
tutor_id |
integer |
not null | |
siswa_id |
integer |
not null | |
subject_id |
integer |
not null | |
tanggal |
date |
not null | |
waktu_mulai |
time without time zone |
not null | |
waktu_selesai |
time without time zone |
not null | |
harga |
numeric(10,2) |
||
meeting_url |
character varying(500) |
||
status |
character varying(50) |
'scheduled'::character varying |
|
catatan |
text |
||
created_at |
timestamp without time zone |
CURRENT_TIMESTAMP |
|
updated_at |
timestamp without time zone |
CURRENT_TIMESTAMP |
- Indexes:
"sesi_belajar_pkey"PRIMARY KEY, btree (id)"sesi_belajar_tutor_id_siswa_id_tanggal_waktu_mulai_key"UNIQUE CONSTRAINT, btree (tutor_id,siswa_id,tanggal,waktu_mulai)"idx_sesi_belajar_date_range"btree (tanggal,waktu_mulai)"idx_sesi_belajar_siswa_date"btree (siswa_id,tanggal)"idx_sesi_belajar_status"btree (status)"idx_sesi_belajar_tutor_date"btree (tutor_id,tanggal)
- Check constraints:
"sesi_belajar_status_check"CHECK (status::text = ANY (ARRAY['scheduled'::character varying, 'in-progress'::character varying, 'completed'::character varying, 'cancelled'::character varying]::text[]))"valid_session_date"CHECK (tanggal>=CURRENT_DATE)"valid_session_time"CHECK (waktu_mulai<waktu_selesai)
| Column | Type | Nullable | Default |
|---|---|---|---|
id |
integer |
not null | nextval('subjects_id_seq'::regclass) |
name |
character varying(100) |
not null | |
category |
character varying(50) |
||
description |
text |
||
created_at |
timestamp without time zone |
CURRENT_TIMESTAMP |
- Indexes:
"subjects_pkey"PRIMARY KEY, btree (id)"subjects_name_key"UNIQUE CONSTRAINT, btree (name)
- Referenced by:
- TABLE
"tutor_subjects"CONSTRAINT"tutor_subjects_subject_id_fkey"FOREIGN KEY (subject_id) REFERENCESsubjects(id) ON DELETE CASCADE
- TABLE
| Column | Type | Nullable | Default |
|---|---|---|---|
id |
integer |
not null | nextval('tutor_subjects_id_seq'::regclass) |
tutor_id |
integer |
not null | |
subject_id |
integer |
not null | |
proficiency_level |
character varying(20) |
'Intermediate'::character varying |
|
created_at |
timestamp without time zone |
CURRENT_TIMESTAMP |
- Indexes:
"tutor_subjects_pkey"PRIMARY KEY, btree (id)"tutor_subjects_tutor_id_subject_id_key"UNIQUE CONSTRAINT, btree (tutor_id,subject_id)
- Check constraints:
"tutor_subjects_proficiency_level_check"CHECK (proficiency_level::text = ANY (ARRAY['Beginner'::character varying, 'Intermediate'::character varying, 'Advanced'::character varying, 'Expert'::character varying]::text[]))
- Foreign-key constraints:
"tutor_subjects_subject_id_fkey"FOREIGN KEY (subject_id) REFERENCESsubjects(id) ON DELETE CASCADE"tutor_subjects_tutor_id_fkey"FOREIGN KEY (tutor_id) REFERENCEStutor(id) ON DELETE CASCADE
| Column | Type | Nullable | Default |
|---|---|---|---|
id |
integer |
not null | nextval('siswa_id_seq'::regclass) |
full_name |
character varying(255) |
not null | |
email |
character varying(255) |
not null | |
password_hash |
character varying(255) |
not null | |
birth_date |
date |
||
gender |
character varying(20) |
||
education_level |
character varying(50) |
||
timezone |
character varying(50) |
'Asia/Jakarta'::character varying |
|
is_active |
boolean |
true |
|
created_at |
timestamp without time zone |
CURRENT_TIMESTAMP |
|
updated_at |
timestamp without time zone |
CURRENT_TIMESTAMP |
- Indexes:
"siswa_pkey"PRIMARY KEY, btree (id)"siswa_email_key"UNIQUE CONSTRAINT, btree (email)
- Check constraints:
"siswa_education_level_check"CHECK (education_level::text = ANY (ARRAY['SD'::character varying, 'SMP'::character varying, 'SMA'::character varying, 'D3'::character varying, 'D4'::character varying, 'S1'::character varying, 'S2'::character varying, 'S3'::character varying, NULL::character varying]::text[]))"siswa_gender_check"CHECK (gender::text = ANY (ARRAY['Male'::character varying, 'Female'::character varying, 'Not Specified'::character varying, NULL::character varying]::text[]))
| Column | Type | Nullable | Default |
|---|---|---|---|
id |
integer |
not null | nextval('tutor_id_seq'::regclass) |
full_name |
character varying(255) |
not null | |
email |
character varying(255) |
not null | |
password_hash |
character varying(255) |
not null | |
birth_date |
date |
||
gender |
character varying(20) |
||
education_level |
character varying(50) |
||
hourly_rate |
numeric(10,2) |
||
bio |
text |
||
availability |
character varying(98) |
'00000000...0000'::character varying |
|
timezone |
character varying(50) |
'Asia/Jakarta'::character varying |
|
is_active |
boolean |
true |
|
created_at |
timestamp without time zone |
CURRENT_TIMESTAMP |
|
updated_at |
timestamp without time zone |
CURRENT_TIMESTAMP |
- Indexes:
"tutor_pkey"PRIMARY KEY, btree (id)"tutor_email_key"UNIQUE CONSTRAINT, btree (email)
- Check constraints:
"tutor_education_level_check"CHECK (education_level::text = ANY (ARRAY['SD'::character varying, 'SMP'::character varying, 'SMA'::character varying, 'D3'::character varying, 'D4'::character varying, 'S1'::character varying, 'S2'::character varying, 'S3'::character varying, NULL::character varying]::text[]))"tutor_gender_check"CHECK (gender::text = ANY (ARRAY['Male'::character varying, 'Female'::character varying, 'Not Specified'::character varying, NULL::character varying]::text[]))"valid_availability"CHECK (`length(availability::text) = 98 AND availability::text ~ '^[01]+$'::text)
- Referenced by:
- TABLE
"tutor_subjects"CONSTRAINT"tutor_subjects_tutor_id_fkey"FOREIGN KEY (tutor_id) REFERENCEStutor(id) ON DELETE CASCADE
- TABLE