# Troubleshoot Problem SyncMed

Buku Panduan Teknis ini ditujukan khusus untuk Administrator TI dan personel teknis yang bertanggung jawab atas implementasi, konfigurasi, dan pemeliharaan platform SIMRS SyncMed.

Dokumentasi ini mencakup aspek-aspek krusial untuk memastikan sistem berjalan dengan optimal, aman, dan terintegrasi. Topik utama meliputi:

- Arsitektur Sistem dan Persyaratan Infrastruktur
- Panduan Instalasi dan Konfigurasi Awal
- Manajemen Pengguna, Peran (Roles), dan Hak Akses
- Konfigurasi Master Data (Data Dokter, Layanan, Tarif)
- Pemeliharaan Database, Prosedur Pencadangan (Backup), dan Pemulihan
- Panduan Integrasi (misalnya dengan BPJS, SATUSEHAT, dan LIS)
- Langkah-langkah Troubleshooting Umum

Jadikan buku ini sebagai referensi utama Anda untuk mengelola fondasi teknis SyncMed di fasilitas kesehatan Anda.

# Mengatasi Masalah Akses Aplikasi dengan Menggunakan DNS Aman (Secure DNS)

**Berlaku untuk:**<span style="white-space: pre-wrap;"> Pengguna yang mengalami aplikasi gagal dimuat, data tidak muncul, atau akses diblokir di browser.</span>

### Pendahuluan: Mengapa Saya Tidak Bisa Mengakses Aplikasi?

<span style="white-space: pre-wrap;">Apakah Anda mencoba membuka aplikasi kesehatan kita namun hanya melihat layar </span>**loading**<span style="white-space: pre-wrap;"> yang tidak berujung? Atau mungkin aplikasi terbuka, tetapi data penting (seperti jadwal atau riwayat pasien) gagal dimuat?</span>

<span style="white-space: pre-wrap;">Ketika ini terjadi, insting pertama kita mungkin adalah menyalahkan aplikasi. Namun, seringkali masalahnya bukan pada aplikasi itu sendiri, melainkan pada koneksi internet Anda. Salah satu penyebab paling umum adalah masalah pada </span>**Sistem Penamaan Domain (DNS)**.

<span style="white-space: pre-wrap;">Artikel ini akan memandu Anda melalui langkah teknis lanjutan untuk mengatasi masalah koneksi dengan mengaktifkan </span>**DNS Aman (DNS over HTTPS)**<span style="white-space: pre-wrap;"> langsung di browser Anda.</span>

### Apa Itu DNS dan Mengapa Ini Penting?

Secara sederhana, DNS adalah "buku telepon" internet. Saat Anda mengetik alamat situs web (seperti alamat aplikasi kesehatan kita), browser Anda bertanya ke server DNS untuk mencari "nomor telepon" (Alamat IP) yang sesuai.

**Masalahnya:**<span style="white-space: pre-wrap;"> Secara default, permintaan "buku telepon" ini tidak dienkripsi. Artinya, Penyedia Layanan Internet (ISP) Anda atau siapa pun di jaringan Anda dapat melihat (dan terkadang memblokir) situs mana yang Anda coba akses.</span>

**Solusinya:**<span style="white-space: pre-wrap;"> </span>**DNS over HTTPS (DoH)**<span style="white-space: pre-wrap;"> adalah standar modern yang mengenkripsi permintaan DNS Anda. Ini "menyembunyikan" permintaan Anda, memberikan dua keuntungan besar:</span>

1. **Privasi:**<span style="white-space: pre-wrap;"> Mencegah ISP atau jaringan lokal mengintip aktivitas browsing Anda.</span>
2. **Mengatasi Pemblokiran:**<span style="white-space: pre-wrap;"> Ini seringkali dapat melewati pemblokiran level dasar yang mungkin diterapkan oleh ISP Anda, yang mungkin secara keliru memblokir akses ke layanan kami.</span>

Kami akan menggunakan layanan DNS 1.1.1.1 dari Cloudflare, yang dikenal cepat dan aman.

---

### Cara Mengaktifkan DNS Aman di Browser Anda

Berikut adalah langkah-langkah untuk mengaktifkan DoH pada browser desktop populer.

#### 🌐 Google Chrome (dan browser serupa seperti Brave, Vivaldi)

1. <span style="white-space: pre-wrap;">Klik ikon tiga titik (⋮) di pojok kanan atas dan pilih </span>**Settings (Pengaturan)**.
2. <span style="white-space: pre-wrap;">Di menu sebelah kiri, klik </span>**Privacy and security (Privasi dan keamanan)**.
3. <span style="white-space: pre-wrap;">Klik </span>**Security (Keamanan)**.
4. <span style="white-space: pre-wrap;">Gulir ke bawah ke bagian "Advanced" (Lanjutan) dan temukan </span>**Use secure DNS (Gunakan DNS aman)**.
5. <span style="white-space: pre-wrap;">Aktifkan opsi ini dan pilih opsi </span>**With (Dengan)**.
6. <span style="white-space: pre-wrap;">Di menu </span>**dropdown**<span style="white-space: pre-wrap;"> yang muncul, pilih </span>**Cloudflare (1.1.1.1)**.
7. Tutup tab pengaturan. Perubahan disimpan secara otomatis.

#### 🦊 Mozilla Firefox

Firefox memiliki salah satu implementasi DoH yang paling mudah diatur.

1. <span style="white-space: pre-wrap;">Klik ikon tiga garis (≡) di pojok kanan atas dan pilih </span>**Settings (Pengaturan)**.
2. <span style="white-space: pre-wrap;">Di tab </span>**General (Umum)**<span style="white-space: pre-wrap;">, gulir ke paling bawah hingga Anda menemukan </span>**Network Settings (Pengaturan Jaringan)**.
3. <span style="white-space: pre-wrap;">Klik tombol </span>**Settings... (Pengaturan...)**.
4. <span style="white-space: pre-wrap;">Sebuah jendela </span>**pop-up**<span style="white-space: pre-wrap;"> akan muncul. Gulir ke bawah dan centang kotak </span>**Enable DNS over HTTPS (Aktifkan DNS melalui HTTPS)**.
5. <span style="white-space: pre-wrap;">Di bawahnya, pada bagian </span>**Use Provider (Gunakan Penyedia)**<span style="white-space: pre-wrap;">, pilih </span>**Cloudflare**<span style="white-space: pre-wrap;"> dari menu </span>**dropdown**.
6. <span style="white-space: pre-wrap;">Klik </span>**OK**.

#### 🔵 Microsoft Edge

Browser Edge berbasis Chromium dan memiliki pengaturan yang mirip dengan Chrome.

1. <span style="white-space: pre-wrap;">Klik ikon tiga titik (···) di pojok kanan atas dan pilih </span>**Settings (Pengaturan)**.
2. <span style="white-space: pre-wrap;">Di menu sebelah kiri, klik </span>**Privacy, search, and services (Privasi, pencarian, dan layanan)**.
3. <span style="white-space: pre-wrap;">Gulir ke bawah hingga Anda menemukan bagian </span>**Security (Keamanan)**.
4. <span style="white-space: pre-wrap;">Cari </span>**Use secure DNS... (Gunakan DNS aman...)**<span style="white-space: pre-wrap;"> dan pastikan </span>**toggle**<span style="white-space: pre-wrap;">-nya </span>**Aktif**.
5. <span style="white-space: pre-wrap;">Pilih opsi </span>**Choose a service provider (Pilih penyedia layanan)**.
6. <span style="white-space: pre-wrap;">Klik menu </span>**dropdown**<span style="white-space: pre-wrap;"> di sebelahnya dan pilih </span>**Cloudflare (1.1.1.1)**.

---

### Langkah Selanjutnya: Apa yang Harus Dilakukan Sekarang?

1. **Mulai Ulang Browser:**<span style="white-space: pre-wrap;"> Setelah menerapkan pengaturan di atas, tutup sepenuhnya (keluar) dari browser Anda dan buka kembali.</span>
2. **Coba Lagi Akses Aplikasi:**<span style="white-space: pre-wrap;"> Buka kembali aplikasi kesehatan kami dan lihat apakah masalah </span>**loading**<span style="white-space: pre-wrap;"> atau akses Anda sudah teratasi.</span>
3. **Jika Masih Bermasalah:**<span style="white-space: pre-wrap;"> Jika masalah tetap ada, ini mungkin bukan disebabkan oleh pemblokiran DNS. Anda dapat mencoba menonaktifkan kembali pengaturan di atas (dengan membatalkan centang) untuk mengembalikan pengaturan ke default.</span>

### Peringatan dan Catatan Penting

- **Hanya Berlaku di Browser:**<span style="white-space: pre-wrap;"> Perlu diingat bahwa metode ini </span>**hanya mengamankan koneksi DNS dari browser Anda**<span style="white-space: pre-wrap;">. Ini tidak akan memengaruhi aplikasi lain di komputer Anda (seperti aplikasi email desktop, aplikasi </span>**chat**, dll.).
- **Jaringan Kantor:**<span style="white-space: pre-wrap;"> Jika Anda menggunakan komputer atau jaringan kantor, berhati-hatilah. Jaringan perusahaan mungkin memiliki aturan keamanan sendiri. Sebaiknya hubungi departemen IT Anda sebelum mengubah pengaturan jaringan.</span>

<span style="white-space: pre-wrap;">Jika langkah-langkah ini tidak menyelesaikan masalah Anda, silakan catat pesan </span>**error**<span style="white-space: pre-wrap;"> apa pun yang Anda lihat dan </span>**segera hubungi Tim Dukungan Teknis kami**<span style="white-space: pre-wrap;"> untuk bantuan lebih lanjut.</span>

# Mengatasi Kendala Tampilan, Error, atau Gagal Memuat pada Aplikasi SyncMed

**Gejala:**<span style="white-space: pre-wrap;"> Apakah Anda mengalami hal-hal berikut saat membuka aplikasi SIMRS?</span>

- <span style="white-space: pre-wrap;">Halaman tidak bisa di-klik atau </span>**stuck**.
- Tampilan berantakan atau menu tidak muncul.
- Data lama masih muncul padahal sudah di-update.
- **Namun, saat dicoba menggunakan mode** ***Incognito*****, aplikasi berjalan lancar.**

**Penyebab:**<span style="white-space: pre-wrap;"> Browser (Chrome/Edge/Firefox) Anda menyimpan "ingatan lama" (Cache/Site Data) yang bentrok dengan pembaruan terbaru aplikasi. Kita perlu membersihkan ingatan lama tersebut agar aplikasi memuat data yang paling baru.</span>

Silakan ikuti 2 langkah mudah di bawah ini:

---

### LANGKAH 1: Paksa Muat Ulang (Hard Refresh)

Langkah ini paling cepat dan seringkali langsung menyelesaikan masalah tanpa menghapus data login.

1. Pastikan Anda sedang membuka halaman aplikasi SIMRS yang bermasalah.
2. <span style="white-space: pre-wrap;">Tekan kombinasi tombol berikut di keyboard secara bersamaan: </span>**CTRL**<span style="white-space: pre-wrap;"> + </span>**SHIFT**<span style="white-space: pre-wrap;"> + </span>**R**
3. Tunggu browser memuat ulang halaman.
4. Coba gunakan aplikasi kembali.

> **Catatan:**<span style="white-space: pre-wrap;"> Jika langkah ini berhasil, silahkan lanjut ke Langkah 2. Jika masalah masih ada, lanjut ke langkah di bawah.</span>

---

### LANGKAH 2: Bersihkan Data Situs (Clear Site Data)

Jika Langkah 1 belum berhasil, kita perlu menghapus penyimpanan lokal khusus untuk aplikasi ini.

**Peringatan:**<span style="color: rgb(224, 62, 45); white-space: pre-wrap;"> Langkah ini akan membuat Anda </span>**Log Out**<span style="color: rgb(224, 62, 45); white-space: pre-wrap;"> otomatis. Pastikan Anda ingat username dan password Anda.</span>

1. Lihat pada bagian atas browser (di sebelah kiri alamat website/URL).
2. <span style="white-space: pre-wrap;">Klik ikon </span>**Gembok (Lock Icon)**<span style="white-space: pre-wrap;"> atau ikon </span>**Pengaturan**.
3. <span style="white-space: pre-wrap;">Pilih menu </span>**"Site Settings"**<span style="white-space: pre-wrap;"> (Setelan Situs) atau </span>**"Cookies and Site Data"**.
4. <span style="white-space: pre-wrap;">Cari tombol </span>**"Delete Data"**<span style="white-space: pre-wrap;"> (Hapus Data) atau </span>**"Reset Permissions"**.
    - **Cara Cepat di Chrome:**<span style="white-space: pre-wrap;"> Klik Gembok -&gt; Cookies and Site Data -&gt; Manage cookies and site data -&gt; Klik icon </span>**Sampah**<span style="white-space: pre-wrap;"> di sebelah nama web SIMRS -&gt; Klik </span>**Done**.
5. Tutup browser Anda sepenuhnya, lalu buka kembali.
6. Login ulang ke aplikasi SIMRS.

[![image.png](https://docs.oxytech.id/uploads/images/gallery/2025-12/scaled-1680-/tzVimage.png)](https://docs.oxytech.id/uploads/images/gallery/2025-12/tzVimage.png)

---

#### Masih Berkendala?

<span style="white-space: pre-wrap;">Jika kedua langkah di atas sudah dilakukan namun kendala masih terjadi, mohon segera hubungi </span>**Tim IT Support**<span style="white-space: pre-wrap;"> dengan menyertakan screenshot pesan error yang muncul.</span>

---

#### Tips Tambahan untuk User

Untuk menghindari masalah ini di kemudian hari, disarankan untuk:

- <span style="white-space: pre-wrap;">Tidak menumpuk terlalu banyak </span>**tab**<span style="white-space: pre-wrap;"> browser yang tidak digunakan.</span>
- <span style="white-space: pre-wrap;">Melakukan </span>**Hard Refresh**<span style="white-space: pre-wrap;"> (Langkah 1) setiap kali ada pemberitahuan update fitur baru dari tim IT.</span>