Skip to content

About

No description, website, or topics provided.

Resources

Stars

1 star

Watchers

0 watching

Forks

 
 

Repository files navigation

👨‍🏫 Turator - Personal Tutor

Aplikasi desktop untuk mempermudah pencarian, pemesanan, dan pengelolaan jadwal tutor privat.


📝 Deskripsi Proyek

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.

🚀 Panduan Instalasi dan Menjalankan

Untuk menjalankan proyek ini di lingkungan lokal, ikuti langkah-langkah berikut.

▶️ Prasyarat

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.

▶️ Langkah-langkah

  1. 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
  2. Jalankan Aplikasi Proyek ini dapat dijalankan menggunakan skrip yang telah disediakan atau langsung melalui Gradle.

    Opsi 1: Menggunakan Skrip Bawaan (Windows)

    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

    Opsi 2: Menggunakan Gradle (Semua Sistem Operasi)

    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

📦 Modul & Pembagian Tugas

Proyek ini dikembangkan secara kolaboratif dengan pembagian tugas pada modul-modul berikut:

Modul Penanggung Jawab File Terkait
🔑 Autentikasi (Login & Register)
  • Muhammad Aidan Fathullah (18223002)
  • Surya Suharna (18223075)
LoginController.java, RegisterStudentController.java, RegisterTutorController.java, Siswa.java, Tutor.java
🔍 Pencarian Tutor
  • Darryl Rayhananta Adenan (18223042)
  • Matthew Sebastian Kurniawan (18223096)
PencarianController.java, TutorCardController.java, PencarianModel.java
🛒 Pemesanan Tutor
  • Darryl Rayhananta Adenan (18223042)
  • Matthew Sebastian Kurniawan (18223096)
SuccesOrderPoupController.java, TutorCardPopupController.java
🗓️ Sesi Belajar
  • Muhammad Hasbullah Faris (18223014)
  • Nazwan Siddqi Muttaqin (18223066)
SesiBelajarController.java, KartuJadwalController.java, DetailJadwalController.java, DaySelectionController.java
👤 Profil (Student & Tutor)
  • Surya Suharna (18223075)
ProfileTutorController.java, ProfileStudentController.java
🗃️ Database & Integrasi
  • Muhammad Aidan Fathullah (18223002)
BaseDAO, SiswaDAO, TutorDAO, dll

🗃️ Skema Basis Data

Struktur basis data aplikasi ini menggunakan beberapa tabel relasional sebagai berikut:

Tabel: public.sesi_belajar

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)

Tabel: public.subjects

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) REFERENCES subjects(id) ON DELETE CASCADE

Tabel: public.tutor_subjects

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) REFERENCES subjects(id) ON DELETE CASCADE
    • "tutor_subjects_tutor_id_fkey" FOREIGN KEY (tutor_id) REFERENCES tutor(id) ON DELETE CASCADE

Tabel: public.siswa

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[]))

Tabel: public.tutor

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) REFERENCES tutor(id) ON DELETE CASCADE

About

No description, website, or topics provided.

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages