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

# Halaman Beranda

> Mengenal tampilan dan fitur utama halaman beranda aplikasi  mobile OpteraOne untuk Agen dan Teknisi.

Setelah login berhasil, Anda akan diarahkan ke **Halaman Beranda**. Halaman ini adalah pusat navigasi utama yang menampilkan ringkasan tugas harian dan akses cepat ke seluruh fitur aplikasi.

<Note>
  Panduan ini berlaku untuk pengguna **Aplikasi Mobile**, yaitu Agen atau Teknisi lapangan. Tampilan beranda yang Anda lihat hanya menampilkan tugas yang ditugaskan **khusus kepada Anda** — bukan seluruh tugas dalam sistem.
</Note>

***

## Tampilan Halaman Beranda

<Frame>
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/ait-8f7a7cd9/images/app-home-overview.png" alt="Tampilan halaman beranda aplikasi OpteraOne" />
</Frame>

***

## Komponen Halaman Beranda

Halaman beranda terdiri dari 8 elemen utama yang dapat diakses langsung dari satu layar:

<AccordionGroup>
  <Accordion title="#1 — Nama Agen / Teknisi" icon="user">
    Sapaan personal yang menampilkan nama Anda sebagai pengguna yang sedang login, ditampilkan di bagian paling atas layar dalam format:

    **"Halo, \[Nama Anda]"**

    <Frame>
      <img src="https://mintlify.s3.us-west-1.amazonaws.com/ait-8f7a7cd9/images/app-home-greeting.png" alt="Sapaan nama pengguna di beranda" />
    </Frame>
  </Accordion>

  <Accordion title="#2 — Ikon Notifikasi" icon="bell">
    Ikon lonceng di sudut kanan atas yang mengakses halaman daftar notifikasi. Badge merah dengan angka akan muncul jika ada notifikasi yang belum dibaca.

    <Frame>
      <img src="https://mintlify.s3.us-west-1.amazonaws.com/ait-8f7a7cd9/images/app-home-notification.png" alt="Ikon notifikasi dengan badge di beranda" />
    </Frame>

    Jenis notifikasi yang akan diterima:

    * Tugas baru yang ditugaskan kepada Anda
    * Perubahan jadwal atau detail tugas
    * Hasil review laporan dari admin (Disetujui / Butuh Perbaikan / Ditolak)
    * Pengingat deadline tugas yang mendekati batas waktu

    <Tip>
      Pastikan notifikasi dari aplikasi OpteraOne sudah diaktifkan di pengaturan perangkat Anda agar tidak melewatkan tugas atau pembaruan penting.
    </Tip>
  </Accordion>

  <Accordion title="#3 — Ringkasan Tugas" icon="chart-bar">
    Tiga kotak berwarna yang menampilkan jumlah tugas yang ditugaskan kepada Anda dalam tiga periode waktu:

    <Frame>
      <img src="https://mintlify.s3.us-west-1.amazonaws.com/ait-8f7a7cd9/images/app-home-summary.png" alt="Ringkasan tugas di beranda" />
    </Frame>

    | Kotak          | Periode          | Keterangan                             |
    | -------------- | ---------------- | -------------------------------------- |
    | **Hari Ini**   | Hari ini         | Tugas yang harus diselesaikan hari ini |
    | **Besok**      | Esok hari        | Tugas yang dijadwalkan untuk besok     |
    | **Minggu Ini** | Senin s/d Minggu | Total tugas dalam minggu berjalan      |

    Ketuk salah satu kotak untuk langsung masuk ke Daftar Tugas yang sudah difilter sesuai periode waktu tersebut.
  </Accordion>

  <Accordion title="#4 — Tugas Hari Ini" icon="list-check">
    Daftar tugas yang perlu dikerjakan hari ini, diurutkan otomatis berdasarkan **tingkat prioritas** dari tertinggi ke terendah:

    <Frame>
      <img src="https://mintlify.s3.us-west-1.amazonaws.com/ait-8f7a7cd9/images/app-home-today-tasks.png" alt="Daftar tugas hari ini di beranda" />
    </Frame>

    | Prioritas  | Ikon | Warna   |
    | ---------- | ---- | ------- |
    | **Kritis** | ↑↑   | Merah   |
    | **Tinggi** | ↑    | Oranye  |
    | **Normal** | →    | Biru    |
    | **Rendah** | ↓    | Abu-abu |

    Tugas yang melewati deadline akan menampilkan label **"Terlambat"** berwarna merah di sisi kanan kartu tugas.

    <Warning>
      Tugas berlabel **"Terlambat"** berarti deadline sudah terlewati. Segera hubungi admin atau supervisor untuk koordinasi lebih lanjut.
    </Warning>
  </Accordion>

  <Accordion title="#5 — Lihat Semua Tugas" icon="arrow-right">
    Tautan **"Lihat semua"** di sebelah kanan judul seksi Tugas Hari Ini. Mengarahkan Anda ke halaman Daftar Tugas lengkap yang mencakup semua tugas — tidak hanya yang dijadwalkan hari ini.
  </Accordion>

  <Accordion title="#6 — Kartu Informasi Tugas" icon="rectangle-list">
    Setiap kartu tugas dalam daftar menampilkan informasi ringkas:

    <Frame>
      <img src="https://mintlify.s3.us-west-1.amazonaws.com/ait-8f7a7cd9/images/app-home-task-card.png" alt="Kartu informasi tugas di beranda" />
    </Frame>

    * **Tingkat prioritas** — ditampilkan di bagian atas kartu
    * **Nama tugas** — judul pekerjaan yang akan dilakukan
    * **Nomor tugas** — nomor identifikasi unik (contoh: #AIT-19450817001)
    * **Tanggal & jam mulai** — kapan tugas harus dimulai
    * **Tanggal & jam berakhir** — batas waktu penyelesaian

    Ketuk kartu tugas untuk masuk ke halaman **Detail Tugas** dan melihat informasi lengkapnya.
  </Accordion>

  <Accordion title="#7 — Ikon Daftar Tugas" icon="clipboard">
    Ikon di navigation bar bagian bawah layar untuk navigasi langsung ke halaman **Daftar Tugas** dari mana pun dalam aplikasi.

    <Frame>
      <img src="https://mintlify.s3.us-west-1.amazonaws.com/ait-8f7a7cd9/images/app-home-navbar.png" alt="Navigation bar aplikasi dengan ikon tugas aktif" />
    </Frame>
  </Accordion>

  <Accordion title="#8 — Ikon Halaman Profil" icon="circle-user">
    Ikon di navigation bar bagian bawah layar untuk mengakses halaman **Profil** Anda — termasuk pengaturan akun dan preferensi aplikasi.
  </Accordion>
</AccordionGroup>

***

## Fungsi Muat Ulang Data

Data di halaman beranda tidak diperbarui secara otomatis. Gunakan fungsi **pull to refresh** untuk memastikan data yang ditampilkan adalah yang terbaru dari server.

<Steps>
  <Step title="Geser Layar ke Bawah">
    Dari posisi paling atas halaman beranda, tempatkan jari Anda di layar dan geser ke bawah.

    Indikator loading **"Perbarui halaman..."** beserta ikon berputar akan muncul di bagian atas layar.

    <Frame>
      <img src="https://mintlify.s3.us-west-1.amazonaws.com/ait-8f7a7cd9/images/app-home-refresh.png" alt="Indikator muat ulang data beranda" />
    </Frame>
  </Step>

  <Step title="Lepaskan dan Tunggu">
    Lepaskan jari Anda. Aplikasi akan memuat data terbaru dari server.
  </Step>

  <Step title="Pembaruan Selesai">
    Setelah data berhasil dimuat ulang, pesan konfirmasi **"Perbarui halaman selesai"** akan muncul sebentar di bagian atas layar lalu menghilang secara otomatis.

    <Frame>
      <img src="https://mintlify.s3.us-west-1.amazonaws.com/ait-8f7a7cd9/images/app-home-refresh-done.png" alt="Konfirmasi muat ulang beranda selesai" />
    </Frame>
  </Step>
</Steps>

<Tip>
  Lakukan muat ulang setiap kali membuka aplikasi setelah beberapa waktu tidak digunakan untuk memastikan daftar tugas sudah mencerminkan penugasan terbaru dari dispatcher.
</Tip>

***

## Kondisi Khusus Halaman Beranda

Halaman beranda menampilkan tampilan yang berbeda tergantung kondisi operasional saat ini:

<Tabs>
  <Tab title="Ada Tugas Sedang Berlangsung">
    Jika ada tugas yang sedang dalam status **"Sedang Berlangsung"**, halaman beranda akan menampilkan seksi khusus **"Tugas Sedang Berlangsung"** di atas daftar Tugas Hari Ini.

    <Frame>
      <img src="https://mintlify.s3.us-west-1.amazonaws.com/ait-8f7a7cd9/images/app-home-ongoing.png" alt="Beranda dengan tugas sedang berlangsung" />
    </Frame>

    Kartu tugas yang sedang berlangsung ditampilkan dengan banner biru **"Sedang Berlangsung"** di bagian bawah kartu sebagai pembeda visual.

    <Note>
      Hanya satu tugas yang dapat berstatus **"Sedang Berlangsung"** dalam satu waktu. Selesaikan atau kirim laporan tugas yang sedang aktif sebelum memulai tugas baru.
    </Note>
  </Tab>

  <Tab title="Ada Versi Aplikasi Terbaru">
    Jika ada pembaruan aplikasi OpteraOne yang tersedia, pop-up notifikasi **"Versi Baru Tersedia"** akan muncul di atas halaman beranda.

    <Frame>
      <img src="https://mintlify.s3.us-west-1.amazonaws.com/ait-8f7a7cd9/images/app-home-update.png" alt="Pop-up notifikasi versi baru tersedia" />
    </Frame>

    Pilih salah satu opsi:

    | Opsi             | Aksi                                                              |
    | ---------------- | ----------------------------------------------------------------- |
    | **"Perbarui"**   | Diarahkan ke App Store / Play Store untuk mengunduh versi terbaru |
    | **"Nanti saja"** | Menutup pop-up dan melanjutkan dengan versi saat ini              |

    <Tip>
      Selalu perbarui aplikasi ke versi terbaru sesegera mungkin untuk mendapatkan fitur terbaru, peningkatan performa, dan perbaikan bug.
    </Tip>
  </Tab>

  <Tab title="Tidak Ada Tugas Hari Ini">
    Jika tidak ada tugas yang dijadwalkan untuk hari ini, seksi **"Tugas Hari Ini"** akan menampilkan tampilan kosong.

    Gunakan **Ringkasan Tugas** (#3) untuk melihat apakah ada tugas yang dijadwalkan untuk besok atau minggu ini, atau ketuk **"Lihat semua"** untuk melihat seluruh daftar tugas Anda.
  </Tab>
</Tabs>

***

## Langkah Selanjutnya

<CardGroup cols={2}>
  <Card title="Daftar Tugas →" icon="list" href="/daftar-tugas">
    Pelajari cara melihat semua tugas, mencari tugas spesifik, dan memfilter berdasarkan status atau prioritas.
  </Card>

  <Card title="Detail Tugas →" icon="file-lines" href="/detail-tugas">
    Pelajari cara membaca informasi lengkap sebuah tugas sebelum memulai pekerjaan.
  </Card>
</CardGroup>