> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mertani.co.id/llms.txt
> Use this file to discover all available pages before exploring further.

# Pengaturan Level Status

**Pengaturan Level Status** digunakan untuk menentukan kondisi peringatan (normal, waspada, bahaya, dll.) berdasarkan nilai pembacaan sensor. Konfigurasi ini berlaku secara otomatis dan digunakan di seluruh sistem termasuk visualisasi peta, tabel pemantauan, dan sistem alerting.

> Setiap instansi dapat mengatur level status secara mandiri, mulai dari nama level, warna badge, dan rentang nilai dapat disesuaikan dengan standar lokal atau regulasi yang berlaku.

***

## Kategori yang Dapat Dikonfigurasi

| Kategori | Deskripsi                                                              |
| -------- | ---------------------------------------------------------------------- |
| **ARR**  | Intensitas curah hujan -> per jam dan akumulasi harian                 |
| **AWLR** | Tinggi muka air -> mendukung pola naik (banjir) dan turun (kekeringan) |
| **WQMS** | Kualitas air -> dikonfigurasi per parameter sensor                     |
| **AQMS** | Kualitas udara -> umumnya mengikuti standar indeks ISPU/AQI            |

***

## Cara Membuka Konfigurasi

<Steps>
  <Step title="Buka menu Pengaturan">
    Masuk ke **Pengaturan → Level Status**.
  </Step>

  <Step title="Pilih kategori device">
    Pilih tab kategori yang ingin dikonfigurasi: **ARR**, **AWLR**, **WQMS**, atau **AQMS**.
  </Step>

  <Step title="Pilih device">
    Dari daftar device, klik badge status pada device yang ingin dikonfigurasi:

    * <span style={{ backgroundColor: 'rgba(229, 231, 235, 0.7)', color: '#4B5563', padding: '2px 8px', borderRadius: '6px', fontWeight: '600' }}>Belum Diatur</span> -> konfigurasi belum pernah dibuat
    * <span style={{ backgroundColor: 'rgba(18, 183, 106, 0.24)', color: '#12b76a', padding: '2px 8px', borderRadius: '6px', fontWeight: '600' }}>Sudah Diatur</span> -> konfigurasi sudah ada, klik untuk mengedit

    Panel konfigurasi akan terbuka di sisi kanan layar.

    <Frame>
      <video src="https://mintcdn.com/mertani/s_1RXp64XZSqMTTx/assets/dashboard-guides/configs/level-status.webm?fit=max&auto=format&n=s_1RXp64XZSqMTTx&q=85&s=2313550ec8919f53af6fe2c9ffad97c6" controls autoPlay loop playsInline muted data-path="assets/dashboard-guides/configs/level-status.webm" />
    </Frame>
  </Step>
</Steps>

***

## Antarmuka Konfigurasi

Setiap konfigurasi level status menggunakan antarmuka yang sama:

| Elemen              | Fungsi                                                                         |
| ------------------- | ------------------------------------------------------------------------------ |
| **Nama kriteria**   | Label level yang ditampilkan sebagai badge di dashboard                        |
| **Warna**           | Warna badge, dapat dipilih dari color picker atau input kode Hex/RGB           |
| **Dari**            | Batas bawah range nilai                                                        |
| **Sampai**          | Batas atas range nilai                                                         |
| **Limit** ☑         | Aktifkan untuk nilai tak terbatas di ujung range (contoh: `> 20` atau `< -80`) |
| **Drag handle** (⠿) | Seret untuk mengubah urutan kriteria                                           |
| **Kriteria baru +** | Tambah level baru di bagian bawah                                              |

<Note>
  Gunakan **Limit** pada kriteria pertama atau terakhir untuk menangani nilai di luar batas normal, misalnya level "Sangat Lebat" dengan range `> 100` atau level "Sangat Rawan" dengan range `< -80`.
</Note>

***

## Konfigurasi per Kategori

<Tabs>
  <Tab title="ARR - Curah Hujan">
    Konfigurasi ARR memiliki dua sub-konfigurasi yang terpisah: **per jam** (intensitas sesaat) dan **harian** (akumulasi).

    ### Status per Jam

    Menentukan status berdasarkan nilai curah hujan dalam **1 jam terakhir**.

    **Cara mengatur:**

    1. Pada panel konfigurasi `level status` device ARR, pastikan berada di tab **Status per Jam**
    2. Tambah kriteria dengan klik **"Kriteria baru +"**
    3. Isi nama level, pilih warna, dan tentukan range **Dari** dan **Sampai**
    4. Untuk level tertinggi, aktifkan **Limit** dan gunakan nilai `> [angka]`
    5. Urutkan kriteria dari terendah ke tertinggi menggunakan drag handle
    6. Klik **"Simpan"**

    **Contoh konfigurasi:**

    | Level                                                                                                                                                                  | Dari | Sampai              | Warna   |
    | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---- | ------------------- | ------- |
    | <span style={{ backgroundColor: 'rgba(229, 231, 235, 0.5)', color: '#4B5563', padding: '2px 8px', borderRadius: '6px', fontWeight: '600' }}>Berawan</span>             | 0    | 0.1                 | #4B5563 |
    | <span style={{ backgroundColor: 'rgba(136, 202, 249, 0.24)', color: '#88CAF9', padding: '2px 8px', borderRadius: '6px', fontWeight: '600' }}>Hujan Ringan</span>       | 0.2  | 20                  | #88CAF9 |
    | <span style={{ backgroundColor: 'rgba(250, 212, 147, 0.24)', color: '#FAD493', padding: '2px 8px', borderRadius: '6px', fontWeight: '600' }}>Hujan Sedang</span>       | 20.1 | 50                  | #FAD493 |
    | <span style={{ backgroundColor: 'rgba(242, 156, 110, 0.24)', color: '#F29C6E', padding: '2px 8px', borderRadius: '6px', fontWeight: '600' }}>Hujan Lebat</span>        | 50.1 | 100                 | #F29C6E |
    | <span style={{ backgroundColor: 'rgba(255, 121, 121, 0.24)', color: '#FF7979', padding: '2px 8px', borderRadius: '6px', fontWeight: '600' }}>Hujan Sangat Lebat</span> | 100  | `> 100` *(Limit ☑)* | #FF7979 |

    ### Status Harian

    Menentukan status berdasarkan **akumulasi curah hujan sejak waktu yang ditentukan** hingga 24 jam berikutnya.

    Terdapat dua pengaturan tambahan di bagian atas:

    | Field                     | Keterangan                                                                                                 |
    | ------------------------- | ---------------------------------------------------------------------------------------------------------- |
    | **Waktu mulai akumulasi** | Jam mulai penghitungan akumulasi harian (contoh: `07:00` → akumulasi dihitung 07:00–06:59 hari berikutnya) |
    | **Time Zone**             | Offset zona waktu dalam angka (contoh: `7` untuk WIB / UTC+7, `9` untuk WITA)                              |

    Kriteria level diisi dengan cara yang sama seperti status per jam.
  </Tab>

  <Tab title="AWLR - Tinggi Muka Air">
    Konfigurasi AWLR mendukung dua pola peringatan yang berbeda tergantung karakteristik lokasi:

    | Pola                   | Kondisi                                  | Contoh penggunaan                                     |
    | ---------------------- | ---------------------------------------- | ----------------------------------------------------- |
    | **Level Status Naik**  | Semakin tinggi nilai = semakin berbahaya | Pos banjir, sungai pasang                             |
    | **Level Status Turun** | Semakin rendah nilai = semakin berbahaya | Waduk kekeringan, sumur, area genangan yang mengering |

    Pilih tab yang sesuai pada panel konfigurasi device.

    ### Level Status Naik

    **Contoh konfigurasi (Pos Duga Air - Sungai):**

    | Level                                                                                                                                                     | Dari  | Sampai              | Warna   |
    | --------------------------------------------------------------------------------------------------------------------------------------------------------- | ----- | ------------------- | ------- |
    | <span style={{ backgroundColor: 'rgba(18, 183, 106, 0.24)', color: '#12B76A', padding: '2px 8px', borderRadius: '6px', fontWeight: '600' }}>Normal</span> | 0     | 387                 | #12B76A |
    | <span style={{ backgroundColor: 'rgba(255, 193, 7, 0.24)', color: '#FFC107', padding: '2px 8px', borderRadius: '6px', fontWeight: '600' }}>Waspada</span> | 387.1 | 518.3               | #FFC107 |
    | <span style={{ backgroundColor: 'rgba(255, 105, 0, 0.24)', color: '#ffa000', padding: '2px 8px', borderRadius: '6px', fontWeight: '600' }}>Siaga</span>   | 518.4 | 615                 | #FF6900 |
    | <span style={{ backgroundColor: 'rgba(239, 76, 73, 0.24)', color: '#EF4C49', padding: '2px 8px', borderRadius: '6px', fontWeight: '600' }}>Bahaya</span>  | 615   | `> 615` *(Limit ☑)* | #EF4C49 |

    ### Level Status Turun

    Untuk pola turun, level paling berbahaya berada di **nilai terendah**. Gunakan **Limit** pada kriteria dengan nilai terkecil.

    **Contoh konfigurasi (Tinggi Muka Air Tanah):**

    | Level                                                                                                                                                          | Dari                | Sampai            | Warna   |
    | -------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------- | ----------------- | ------- |
    | <span style={{ backgroundColor: 'rgba(0, 143, 251, 0.24)', color: '#008FFB', padding: '2px 8px', borderRadius: '6px', fontWeight: '600' }}>Tergenang</span>    | 0                   | `> 0` *(Limit ☑)* | #008FFB |
    | <span style={{ backgroundColor: 'rgba(18, 183, 106, 0.24)', color: '#12B76A', padding: '2px 8px', borderRadius: '6px', fontWeight: '600' }}>Normal</span>      | -40                 | 0                 | #12B76A |
    | <span style={{ backgroundColor: 'rgba(255, 193, 7, 0.24)', color: '#FFC107', padding: '2px 8px', borderRadius: '6px', fontWeight: '600' }}>Rawan</span>        | -80                 | -40               | #FFC107 |
    | <span style={{ backgroundColor: 'rgba(239, 76, 73, 0.24)', color: '#EF4C49', padding: '2px 8px', borderRadius: '6px', fontWeight: '600' }}>Sangat Rawan</span> | `< -80` *(Limit ☑)* | -80               | #EF4C49 |

    <Note>
      Untuk **Level Status Turun**, Limit diletakkan di field **Dari** (bukan Sampai) karena batas berbahaya ada di sisi bawah range.
    </Note>
  </Tab>

  <Tab title="WQMS - Kualitas Air">
    Konfigurasi WQMS dilakukan **per parameter sensor** - setiap parameter (TDS, pH, Ammonia, BOD, COD, dll.) memiliki konfigurasi level statusnya masing-masing.

    **Cara mengatur:**

    1. Buka pengaturan `level status` device WQMS
    2. Pilih parameter sensor yang ingin dikonfigurasi
    3. Isi kriteria sesuai baku mutu yang berlaku
    4. Klik **"Simpan"**

    **Contoh konfigurasi (Water TDS):**

    | Level                                                                                                                                                                 | Dari | Sampai             | Warna   |
    | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---- | ------------------ | ------- |
    | <span style={{ backgroundColor: 'rgba(18, 183, 106, 0.24)', color: '#12B76A', padding: '2px 8px', borderRadius: '6px', fontWeight: '600' }}>Memenuhi Baku Mutu</span> | 0    | 1                  | #12B76A |
    | <span style={{ backgroundColor: 'rgba(0, 143, 251, 0.24)', color: '#008FFB', padding: '2px 8px', borderRadius: '6px', fontWeight: '600' }}>Cemar Ringan</span>        | 1    | 5                  | #008FFB |
    | <span style={{ backgroundColor: 'rgba(255, 193, 7, 0.24)', color: '#FFC107', padding: '2px 8px', borderRadius: '6px', fontWeight: '600' }}>Cemar Sedang</span>        | 5    | 10                 | #FFC107 |
    | <span style={{ backgroundColor: 'rgba(239, 76, 73, 0.24)', color: '#EF4C49', padding: '2px 8px', borderRadius: '6px', fontWeight: '600' }}>Cemar Berat</span>         | 10   | `> 10` *(Limit ☑)* | #EF4C49 |

    <Note>
      Status global device WQMS mengikuti **parameter paling kritis** (worst-case). Jika satu parameter berstatus "Cemar Berat", status keseluruhan device ikut naik ke level tersebut meskipun parameter lain dalam kondisi baik.
    </Note>
  </Tab>

  <Tab title="AQMS - Kualitas Udara">
    Konfigurasi AQMS dilakukan per parameter kualitas udara (PM2.5, PM10, CO, SO₂, NO₂, dll.) dengan mengikuti indeks standar ISPU (Indeks Standar Pencemar Udara) atau AQI yang ditetapkan oleh instansi lingkungan hidup.

    **Cara mengatur:**

    1. Buka pengaturan `level status` device AQMS
    2. Pilih parameter sensor yang ingin dikonfigurasi
    3. Isi kriteria sesuai indeks yang berlaku
    4. Klik **"Simpan"**

    **Contoh konfigurasi (PM2.5):**

    | Level                                                                                                                                                                | Dari | Sampai              | Warna   |
    | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---- | ------------------- | ------- |
    | <span style={{ backgroundColor: 'rgba(18, 183, 106, 0.24)', color: '#12B76A', padding: '2px 8px', borderRadius: '6px', fontWeight: '600' }}>Baik</span>              | 0    | 50                  | #12B76A |
    | <span style={{ backgroundColor: 'rgba(0, 143, 251, 0.24)', color: '#008FFB', padding: '2px 8px', borderRadius: '6px', fontWeight: '600' }}>Sedang</span>             | 50   | 100                 | #008FFB |
    | <span style={{ backgroundColor: 'rgba(255, 193, 7, 0.24)', color: '#FFC107', padding: '2px 8px', borderRadius: '6px', fontWeight: '600' }}>Tidak Sehat</span>        | 100  | 200                 | #FFC107 |
    | <span style={{ backgroundColor: 'rgba(239, 76, 73, 0.24)', color: '#EF4C49', padding: '2px 8px', borderRadius: '6px', fontWeight: '600' }}>Sangat Tidak Sehat</span> | 200  | 300                 | #EF4C49 |
    | <span style={{ backgroundColor: 'rgba(50, 52, 54, 0.24)', color: '#4B5563', padding: '2px 8px', borderRadius: '6px', fontWeight: '600' }}>Bahaya</span>              | 300  | `> 300` *(Limit ☑)* | #010e17 |

    <Note>
      Karena AQMS umumnya mengikuti regulasi nasional, disarankan untuk mengacu pada standar ISPU yang berlaku saat mengisi range nilai setiap level.
    </Note>
  </Tab>
</Tabs>

***

## Tips Konfigurasi

| Tips                                         | Alasan                                                                                        |
| -------------------------------------------- | --------------------------------------------------------------------------------------------- |
| **Hindari overlap antar range**              | Nilai yang masuk ke dua range sekaligus dapat menghasilkan status yang tidak konsisten        |
| **Gunakan warna yang konsisten**             | Hijau = aman, kuning = waspada, oranye = siaga, merah = bahaya -> memudahkan pembacaan visual |
| **Selalu gunakan Limit di ujung range**      | Memastikan nilai ekstrem (sangat tinggi atau sangat rendah) tetap mendapat status yang tepat  |
| **Urutkan dari level terendah ke tertinggi** | Memudahkan pembacaan dan menghindari kesalahan konfigurasi                                    |
| **Ikuti standar instansi jika tersedia**     | Terutama untuk WQMS dan AQMS yang memiliki regulasi baku mutu resmi                           |