Struktur Project & Folder UniteAlarm

 📂 Mengapa Struktur Project Itu Penting?

Struktur folder yang rapi membuat aplikasi:

mudah dipahami

mudah dikembangkan

gampang di-debug

siap dijadikan installer / EXE

UniteAlarm disusun dengan struktur sederhana namun profesional.

🧱 Struktur Folder UniteAlarm

Berikut contoh struktur dasar project UniteAlarm:

UniteAlarm/

│

├── main.py

├── config.json

├── alarm_data.json

│

├── assets/

│   ├── icon.ico

│   └── alarm.wav

│

├── modules/

│   ├── alarm_manager.py

│   ├── tray_manager.py

│   └── notifier.py

│

└── README.md

📄 Penjelasan Setiap File

🔹 main.py

File utama aplikasi.

Berfungsi sebagai:

titik awal program

pemanggil GUI

penghubung semua modul

Jika UniteAlarm dijadikan EXE, file ini yang dieksekusi.

🔹 config.json

Digunakan untuk menyimpan:

mode silent

status libur

pengaturan default aplikasi

Contoh isi:

{

  "silent_mode": false,

  "holiday_mode": false

}

🔹 alarm_data.json

Berisi daftar alarm yang dibuat pengguna.

Disimpan secara lokal agar:

tidak hilang saat aplikasi ditutup

mudah dibaca ulang saat startup

📁 Folder assets

Menyimpan semua resource statis:

icon aplikasi

file audio alarm

gambar pendukung

Pemisahan ini menjaga kode tetap bersih.

📁 Folder modules

Folder ini berisi logika inti aplikasi:

alarm_manager.py

Mengatur jadwal alarm dan pengecekan waktu

tray_manager.py

Mengelola system tray

notifier.py

Menampilkan notifikasi Windows

Dengan modul terpisah, kode jadi mudah dirawat.

📄 README.md

Digunakan untuk:

dokumentasi singkat

catatan pengembangan

informasi versi

File ini penting jika project dibagikan ke publik.

🧠 Alur Kerja Aplikasi

Saat UniteAlarm dijalankan:

main.py dijalankan

Konfigurasi dibaca dari config.json

Alarm dimuat dari alarm_data.json

Sistem tray diaktifkan

Aplikasi berjalan di background

Alur ini menjaga aplikasi tetap stabil.

📌 Penutup

Struktur project yang baik adalah fondasi aplikasi yang sehat.

UniteAlarm menggunakan pendekatan modular agar mudah dikembangkan ke tahap selanjutnya.