TUTORIAL INSTALASI DAN PENGGUNAAN
QM SUITE FRONTPAGE V1.0.0
============================================================

A. TUJUAN
------------------------------------------------------------
QM Suite menyatukan 9 aplikasi DEB ke dalam satu frontpage.
Klik aplikasi -> sistem memeriksa instalasi -> jika belum ada,
DEB lokal dipasang -> aplikasi dijalankan -> aplikasi dibuka
pada browser/tab terpisah.

Aplikasi TIDAK ditampilkan di panel kanan dan TIDAK memakai iframe.

B. DAFTAR APLIKASI DAN PORT
------------------------------------------------------------
1. QM Komputasi          : http://localhost:8801
2. DockFlow              : http://localhost:8802
3. ReactionQM            : http://localhost:8803
4. SpectraQM             : http://localhost:8804
5. MD Komputasi          : http://localhost:8805
6. MolPrep               : http://localhost:8806
7. QSAR / ADMET Studio   : http://localhost:8807
8. QMScreen              : http://localhost:8808
9. ElektroKimia          : http://localhost:8809

Frontpage default         : http://localhost:8799

C. INSTALASI PAKET UTAMA DI WSL/UBUNTU
------------------------------------------------------------
1. Buka Ubuntu/WSL.
2. Masuk ke folder tempat file DEB berada, misalnya:

   cd /mnt/c/Users/USWE/Desktop/QMSuite

3. Install launcher:

   sudo apt install ./qm-suite-launcher_1.0.0_amd64.deb

4. Setelah selesai, jalankan:

   qm-suite

Browser frontpage akan dibuka otomatis.

D. AGAR KLIK INSTALASI LEBIH LANCAR
------------------------------------------------------------
Sebelum menjalankan QM Suite, boleh melakukan validasi sudo:

   sudo -v
   qm-suite

Jika sudo masih meminta password saat sebuah aplikasi belum terpasang,
masukkan password HANYA pada terminal Ubuntu/WSL yang menjalankan
QM Suite. Jangan pernah mengetik password sudo pada halaman browser.

E. CARA MENGGUNAKAN FRONTPAGE
------------------------------------------------------------
1. Buka QM Suite dengan perintah:

   qm-suite

2. Tunggu sampai kartu aplikasi menampilkan status:
   - TERPASANG        = paket sudah tersedia.
   - BELUM TERPASANG  = paket belum tersedia.
   - MEMASANG...      = DEB sedang di-install.
   - MENJALANKAN...   = server aplikasi sedang dimulai.
   - AKTIF            = aplikasi siap digunakan.
   - ERROR            = proses gagal; lihat pesan/log.

3. Jika status BELUM TERPASANG:
   klik "Pasang & Jalankan".

4. Jika status TERPASANG:
   klik "Jalankan".

5. Setelah server aktif, aplikasi akan dibuka pada browser/tab
   terpisah. Frontpage tetap berada pada halaman sendiri.

F. MENJALANKAN FRONTPAGE TANPA MEMBUKA BROWSER
------------------------------------------------------------

   qm-suite --no-browser

Kemudian buka alamat yang ditampilkan di terminal.

G. MENGGANTI PORT FRONTPAGE
------------------------------------------------------------
Contoh menggunakan port 8795:

   qm-suite --port 8795

atau:

   QMSUITE_PORT=8795 qm-suite

Port aplikasi 8801-8809 telah dipisahkan tetap oleh launcher agar
sembilan aplikasi tidak saling bertabrakan.

H. MEMERIKSA STATUS PAKET DARI TERMINAL
------------------------------------------------------------

   qm-suite --status

I. LOKASI FILE
------------------------------------------------------------
Launcher Python:
   /opt/qm-suite-launcher/QMSuite_Frontpage_V1.0.0.py

DEB sembilan aplikasi:
   /opt/qm-suite-launcher/debs/

Log aplikasi:
   ~/.local/share/qm-suite-launcher/logs/

J. FIRST RUN APLIKASI
------------------------------------------------------------
Beberapa aplikasi membuat virtual environment sendiri dan mengunduh
library Python pada first run. Koneksi internet mungkin diperlukan.
Waktu persiapan tergantung aplikasi dan dependency yang belum ada.

K. JIKA APT/DPKG ERROR
------------------------------------------------------------
Jika pernah ada instalasi DEB yang terputus atau belum terkonfigurasi:

   sudo dpkg --configure -a
   sudo apt --fix-broken install

Kemudian:

   qm-suite

L. JIKA APLIKASI TIDAK TERBUKA
------------------------------------------------------------
1. Klik "Perbarui Status".
2. Periksa apakah status menjadi AKTIF.
3. Jika AKTIF, klik tombol "Buka".
4. Periksa log:

   ls -lh ~/.local/share/qm-suite-launcher/logs/
   tail -n 100 ~/.local/share/qm-suite-launcher/logs/qm.log

Ganti qm.log dengan nama log aplikasi yang diperiksa.

M. UNINSTALL LAUNCHER
------------------------------------------------------------

   sudo apt remove qm-suite-launcher

Paket aplikasi yang pernah dipasang melalui frontpage tidak dihapus
otomatis. Ini disengaja agar aplikasi dan data yang sudah digunakan
tetap tersedia.

============================================================
Copyright (c) Kasmui, 2026
