> ## 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.

# Manajemen Tugas dengan Aset & Produk

> Cara menghubungkan tugas dengan aset dan produk yang digunakan, serta memantau riwayat servis dan penggunaan inventaris di CMS OpteraOne.

Fitur **Manajemen Tugas Aset & Inventaris** menghubungkan setiap tugas lapangan dengan aset spesifik dan produk yang digunakan pada aset tersebut. Detail aset dan lokasi terisi otomatis saat tersedia, dan tanggal servis berikutnya dihitung ulang setelah tugas selesai — memastikan riwayat servis aset, perencanaan jadwal perawatan, dan pelacakan inventaris tetap akurat hingga tingkat tugas.

<Note>
  Fitur ini tersedia sebagai bagian dari modul **Asset Management System (AMS)**. Pastikan data aset dan produk sudah dikonfigurasi di sistem sebelum membuat tugas yang terhubung dengan aset.
</Note>

***

## Cara Kerja Fitur Ini

Ketika sebuah tugas dibuat dan dihubungkan dengan aset, sistem secara otomatis:

* Mengisi **detail aset** (nama, tipe, lokasi) berdasarkan data aset yang sudah terdaftar
* Menghitung ulang **tanggal servis berikutnya** setelah tugas selesai
* Mencatat **produk yang digunakan** selama pengerjaan ke dalam riwayat inventaris
* Memperbarui **riwayat servis aset** secara real-time

<CardGroup cols={2}>
  <Card title="Pelacakan Aset" icon="box">
    Setiap tugas tercatat dalam riwayat servis aset yang terhubung, memudahkan audit dan perencanaan perawatan berikutnya.
  </Card>

  <Card title="Manajemen Inventaris" icon="package">
    Produk yang dipakai dalam setiap tugas tercatat otomatis, menjaga stok dan penggunaan inventaris tetap akurat.
  </Card>

  <Card title="Jadwal Servis Otomatis" icon="calendar">
    Tanggal servis berikutnya dihitung ulang secara otomatis setelah tugas selesai berdasarkan interval servis yang dikonfigurasi.
  </Card>

  <Card title="Lokasi Otomatis" icon="map-pin">
    Detail lokasi aset terisi otomatis saat aset dipilih, mengurangi risiko kesalahan input dan mempercepat pembuatan tugas.
  </Card>
</CardGroup>

***

## Membuat Tugas dengan Aset & Inventaris

Pembuatan tugas yang dihubungkan dengan aset dan produk mengikuti alur yang sama seperti pembuatan tugas biasa, namun dengan tambahan **langkah pengisian Produk** di bagian Info Tugas.

### Langkah 1 — Info Kontak

<Steps>
  <Step title="Klik Tombol 'Buat Tugas'">
    Dari halaman **Daftar Tugas**, klik tombol **"Buat Tugas"** di bagian kanan atas halaman.
  </Step>

  <Step title="Pilih Kontak Pelanggan">
    Cari dan pilih kontak pelanggan yang terkait dengan tugas ini. Data kontak mencakup nama pelanggan, perusahaan, dan lokasi yang sudah terdaftar di sistem.

    <Tip>
      Gunakan kolom pencarian untuk menemukan kontak dengan cepat jika jumlah kontak sudah banyak.
    </Tip>

    Klik **"Selanjutnya"** untuk melanjutkan ke langkah berikutnya.
  </Step>
</Steps>

***

### Langkah 2 — Info Tugas & Produk

Pada langkah ini, selain mengisi detail tugas seperti biasa, Anda juga akan menambahkan **produk** yang digunakan dalam pengerjaan tugas.

<Steps>
  <Step title="Isi Detail Tugas">
    Lengkapi semua field informasi tugas:

    | Field                      | Keterangan                                  | Wajib |
    | -------------------------- | ------------------------------------------- | ----- |
    | **Kategori Tugas**         | Jenis pekerjaan yang akan dilakukan         | ✅ Ya  |
    | **Lokasi**                 | Alamat atau lokasi spesifik yang dikunjungi | ✅ Ya  |
    | **Detail Pekerjaan**       | Deskripsi lengkap pekerjaan                 | ✅ Ya  |
    | **Prioritas**              | Kritikal / Tinggi / Normal / Rendah         | ✅ Ya  |
    | **Tanggal & Jam Mulai**    | Waktu teknisi diharapkan mulai bekerja      | ✅ Ya  |
    | **Tanggal & Jam Berakhir** | Batas waktu penyelesaian tugas              | ✅ Ya  |
  </Step>

  <Step title="Tambahkan Produk yang Digunakan">
    Di bagian bawah form Info Tugas, terdapat seksi **Produk**. Seksi ini digunakan untuk mencatat produk atau material yang akan digunakan selama pengerjaan tugas.

    Klik tombol **"+ Tambah Produk"** untuk menambahkan produk.

    Untuk setiap produk, isi informasi berikut:

    | Field             | Keterangan                               | Wajib |
    | ----------------- | ---------------------------------------- | ----- |
    | **Produk**        | Pilih produk dari daftar inventaris      | ✅ Ya  |
    | **Jumlah Produk** | Kuantitas produk yang digunakan          | ✅ Ya  |
    | **Unit**          | Satuan produk (misalnya: pcs, liter, kg) | ✅ Ya  |

    <Tip>
      Anda dapat menambahkan lebih dari satu produk dalam satu tugas. Klik **"+ Tambah Produk"** kembali untuk menambahkan baris produk baru.
    </Tip>

    Untuk menghapus produk yang sudah ditambahkan, klik ikon **🗑️ (hapus)** di baris produk yang bersangkutan.
  </Step>

  <Step title="Klik Selanjutnya">
    Setelah semua field dan produk terisi, klik **"Selanjutnya"** untuk melanjutkan ke langkah penugasan.
  </Step>
</Steps>

<Warning>
  Pastikan jumlah produk yang dimasukkan sesuai dengan rencana penggunaan di lapangan. Data ini akan tercatat dalam riwayat inventaris dan memengaruhi saldo stok yang tersedia.
</Warning>

***

### Langkah 3 — Info Penugasan

<Steps>
  <Step title="Pilih Agen / Teknisi">
    Sistem menampilkan daftar Agen/Teknisi yang tersedia. Klik tombol **"Pilih"** pada teknisi yang akan mengerjakan tugas ini.

    <Tip>
      Anda dapat menugaskan tugas ke **lebih dari satu** Agen/Teknisi jika pekerjaan memerlukan tim.
    </Tip>
  </Step>

  <Step title="Atur Pengaturan Persetujuan">
    Tentukan apakah laporan tugas ini perlu direview oleh Admin atau Supervisor sebelum dinyatakan selesai.

    | Pilihan   | Keterangan                                                                    |
    | --------- | ----------------------------------------------------------------------------- |
    | **Ya**    | Laporan masuk ke status "Menunggu Persetujuan" dan perlu direview             |
    | **Tidak** | Laporan yang dikirim teknisi langsung mengubah status tugas menjadi "Selesai" |

    Jika memilih **"Ya"**, pilih siapa yang bertanggung jawab sebagai pemeriksa dari daftar pengguna yang tersedia.

    <Note>
      Pemeriksa yang dipilih akan mendapatkan notifikasi otomatis ketika teknisi mengirimkan laporan dan tugas masuk ke status "Menunggu Persetujuan".
    </Note>
  </Step>

  <Step title="Klik Selanjutnya & Simpan">
    Klik **"Selanjutnya"** untuk melihat konfirmasi ringkasan tugas. Periksa kembali seluruh data termasuk daftar produk yang ditambahkan. Jika sudah sesuai, klik **"Simpan"** untuk menyimpan tugas.
  </Step>
</Steps>

***

## Melihat Detail Tugas Aset & Inventaris

Setelah tugas dibuat, Anda dapat melihat semua informasi terkait aset dan produk dari halaman **Detail Tugas**.

### Navigasi ke Detail Tugas

<Steps>
  <Step title="Buka Daftar Tugas">
    Dari menu navigasi utama, klik **Tugas** untuk membuka halaman Daftar Tugas.
  </Step>

  <Step title="Klik Nama Tugas">
    Klik nama tugas yang ingin dilihat detailnya. Anda akan diarahkan ke halaman **Detail Tugas**.
  </Step>
</Steps>

***

### Informasi yang Ditampilkan di Detail Tugas

Halaman Detail Tugas menampilkan informasi lengkap termasuk data aset dan inventaris:

<AccordionGroup>
  <Accordion title="Informasi Umum" icon="info">
    Menampilkan data inti tugas:

    * **Nama tugas** dan kategori
    * **Status tugas** terkini
    * **Prioritas** pekerjaan
    * **Detail pekerjaan** (deskripsi)
    * **Periode waktu** mulai dan berakhir
    * **Informasi kontak** pelanggan
    * **Lokasi** pengerjaan
  </Accordion>

  <Accordion title="Agen / Teknisi yang Ditugaskan" icon="hard-hat">
    Menampilkan daftar Agen/Teknisi yang ditugaskan beserta status keterlibatan mereka dalam tugas ini.
  </Accordion>

  <Accordion title="Produk yang Digunakan" icon="package">
    Menampilkan daftar semua produk yang tercatat untuk tugas ini, termasuk:

    * Nama produk
    * Jumlah yang direncanakan
    * Unit satuan
    * Status penggunaan (jika sudah dikonfirmasi oleh teknisi di lapangan)
  </Accordion>
</AccordionGroup>

***

## Mengubah Tugas dengan Aset & Produk

Perubahan data tugas — termasuk daftar produk — dapat dilakukan melalui dua cara.

<Tabs>
  <Tab title="Via Ikon Edit di Daftar">
    Dari halaman **Daftar Tugas**, klik ikon **Edit (✏️)** pada kolom Aksi di baris tugas yang ingin diubah.

    Halaman Ubah Tugas terbuka dengan struktur 3 langkah yang sama seperti pembuatan tugas baru.
  </Tab>

  <Tab title="Via Halaman Detail">
    Dari halaman **Detail Tugas**, klik tombol **"Lainnya"** → pilih **"Ubah Tugas"**.

    Anda akan masuk ke halaman Ubah Tugas dengan semua data yang sudah terisi sebelumnya.
  </Tab>
</Tabs>

### Data yang Dapat Diubah

| Langkah            | Data yang Dapat Diubah                                               |
| ------------------ | -------------------------------------------------------------------- |
| **Info Kontak**    | Kontak pelanggan yang terkait dengan tugas                           |
| **Info Tugas**     | Kategori, lokasi, deskripsi, prioritas, periode waktu, daftar produk |
| **Info Penugasan** | Agen/Teknisi yang ditugaskan dan pengaturan persetujuan              |

<Steps>
  <Step title="Navigasi ke Langkah yang Perlu Diubah">
    Gunakan tombol **"Sebelumnya"** dan **"Selanjutnya"** untuk berpindah antar langkah.
  </Step>

  <Step title="Ubah Data atau Produk">
    Untuk mengubah produk, pergi ke **Langkah 2 — Info Tugas**. Di seksi Produk, Anda dapat:

    * **Mengubah** jumlah atau unit produk yang sudah ada
    * **Menambah** produk baru dengan klik **"+ Tambah Produk"**
    * **Menghapus** produk yang tidak diperlukan dengan klik ikon **🗑️**
  </Step>

  <Step title="Simpan Perubahan">
    Navigasi ke langkah terakhir dan klik **"Selanjutnya"**. Periksa konfirmasi ringkasan, lalu klik **"Simpan"**.
  </Step>
</Steps>

<Warning>
  Mengubah daftar produk pada tugas yang berstatus **Sedang Berlangsung** akan memperbarui data yang dilihat oleh teknisi di aplikasi mobile. Koordinasikan perubahan ini dengan teknisi yang bersangkutan.
</Warning>

***

## Skenario Validasi

Sistem menerapkan validasi tertentu saat menghubungkan tugas dengan produk. Berikut skenario yang mungkin terjadi dan cara penanganannya:

<AccordionGroup>
  <Accordion title="Produk Tidak Terhubung ke Tugas Lain" icon="circle-check">
    **Kondisi:** Produk yang dipilih tidak sedang digunakan di tugas lain yang aktif.

    **Hasil:** Produk dapat ditambahkan langsung tanpa hambatan. Penggunaan produk tercatat normal dalam inventaris.
  </Accordion>

  <Accordion title="Produk Terhubung ke Tugas Lain yang Sudah Selesai" icon="circle-check">
    **Kondisi:** Produk yang dipilih sebelumnya sudah digunakan di tugas lain yang berstatus **Selesai**.

    **Hasil:** Produk tetap dapat ditambahkan. Riwayat penggunaan sebelumnya tetap tersimpan dan tidak terpengaruh oleh tugas baru ini.
  </Accordion>

  <Accordion title="Produk Terhubung ke Tugas Lain yang Sedang Berlangsung" icon="triangle-alert">
    **Kondisi:** Produk yang dipilih saat ini sedang terdaftar dalam tugas lain yang berstatus **Sedang Berlangsung**.

    **Hasil:** Sistem menampilkan notifikasi peringatan bahwa produk ini sedang digunakan di tugas lain yang aktif. Anda tetap dapat melanjutkan, namun pastikan stok produk mencukupi untuk kedua tugas tersebut.

    <Warning>
      Perhatikan ketersediaan stok produk sebelum melanjutkan. Penggunaan produk yang sama di dua tugas aktif sekaligus dapat menyebabkan kekurangan inventaris di lapangan.
    </Warning>
  </Accordion>
</AccordionGroup>

***

## Mengubah Kategori Tugas melalui Daftar Kategori

Selain mengubah tugas secara langsung, Admin juga dapat mengelola produk yang terhubung pada tingkat **Kategori Tugas** — sehingga setiap tugas baru dengan kategori tersebut sudah memiliki konfigurasi produk default.

### Mengakses Pengaturan Kategori Tugas

<Steps>
  <Step title="Buka Menu Pengaturan">
    Dari navigasi utama CMS, klik **Pengaturan** → pilih **Kategori Tugas**.
  </Step>

  <Step title="Pilih Kategori yang Ingin Diubah">
    Dari halaman Daftar Kategori Tugas, klik ikon **Edit (✏️)** pada kategori yang ingin diubah, atau klik nama kategori untuk membuka detail lalu pilih **"Ubah Kategori Tugas"** dari menu **"Lainnya"**.
  </Step>
</Steps>

### Validasi saat Mengubah Kategori

Saat mengubah kategori tugas yang sudah memiliki tugas aktif terhubung, sistem menampilkan konfirmasi tambahan:

| Kondisi                                             | Keterangan                                                                  |
| --------------------------------------------------- | --------------------------------------------------------------------------- |
| **Tidak terhubung ke tugas lain**                   | Perubahan dapat disimpan langsung tanpa hambatan                            |
| **Terhubung ke tugas lain yang Selesai**            | Konfirmasi ditampilkan; perubahan berlaku untuk tugas baru ke depan         |
| **Terhubung ke tugas lain yang Sedang Berlangsung** | Konfirmasi ditampilkan; perubahan tidak memengaruhi tugas yang sedang aktif |

<Note>
  Perubahan pada Kategori Tugas hanya berlaku untuk tugas yang **dibuat setelah perubahan disimpan**. Tugas yang sudah ada tidak terpengaruh.
</Note>

***

## Konfirmasi Simpan Produk

Setiap kali menyimpan tugas yang memiliki daftar produk, sistem akan menampilkan **halaman konfirmasi** yang merangkum semua data termasuk:

* Informasi kontak pelanggan
* Detail tugas (kategori, lokasi, prioritas, periode)
* **Daftar produk** beserta jumlah dan satuan
* Agen/Teknisi yang ditugaskan
* Pengaturan persetujuan

Periksa seluruh data sebelum mengklik **"Simpan"** untuk memastikan tidak ada informasi yang terlewat atau salah.

***

## Dampak pada Riwayat Servis & Inventaris

Ketika tugas yang terhubung dengan aset dan produk berubah status menjadi **Selesai**, sistem secara otomatis memperbarui:

<CardGroup cols={2}>
  <Card title="Riwayat Servis Aset" icon="history">
    Tugas yang selesai tercatat dalam riwayat servis aset terkait, lengkap dengan tanggal, teknisi, dan produk yang digunakan.
  </Card>

  <Card title="Tanggal Servis Berikutnya" icon="calendar-check">
    Sistem menghitung ulang tanggal servis berikutnya berdasarkan interval servis yang dikonfigurasi untuk aset tersebut.
  </Card>

  <Card title="Saldo Inventaris" icon="warehouse">
    Jumlah produk yang tercatat dalam tugas dikurangi dari saldo stok inventaris secara otomatis.
  </Card>

  <Card title="Laporan Penggunaan Produk" icon="chart-bar">
    Data penggunaan produk per tugas tersedia untuk analisis kebutuhan inventaris dan perencanaan pengadaan.
  </Card>
</CardGroup>

***

## Ringkasan Alur Kerja

```mermaid theme={null}
flowchart TD
    A[Buat Tugas Baru] --> B[Langkah 1: Info Kontak]
    B --> C[Langkah 2: Info Tugas]
    C --> D[Tambah Produk yang Digunakan]
    D --> E{Validasi Produk}
    E -->|Tidak terhubung tugas lain| F[Lanjut Normal]
    E -->|Terhubung tugas Selesai| F
    E -->|Terhubung tugas Berlangsung| G[Tampil Peringatan Stok]
    G --> F
    F --> H[Langkah 3: Info Penugasan]
    H --> I[Konfirmasi & Simpan]
    I --> J[Tugas Aktif — Notifikasi ke Teknisi]
    J --> K[Teknisi Mengerjakan & Mengirim Laporan]
    K --> L{Perlu Persetujuan?}
    L -->|Ya| M[Menunggu Persetujuan Admin]
    M --> N[Admin Setujui / Perbaiki / Tolak]
    N -->|Setujui| O[Status: Selesai]
    L -->|Tidak| O
    O --> P[Update Riwayat Servis Aset]
    O --> Q[Update Saldo Inventaris]
    O --> R[Hitung Ulang Tanggal Servis Berikutnya]
```

***

## Pertanyaan Umum

<AccordionGroup>
  <Accordion title="Apakah saya wajib menambahkan produk saat membuat tugas?" icon="circle-help">
    Tidak. Penambahan produk bersifat **opsional**. Anda hanya perlu menambahkan produk jika tugas tersebut memang menggunakan material atau produk dari inventaris. Tugas tanpa produk tetap dapat dibuat dan dijalankan secara normal.
  </Accordion>

  <Accordion title="Apa yang terjadi jika stok produk tidak mencukupi?" icon="triangle-alert">
    Sistem akan menampilkan peringatan saat produk yang dipilih juga sedang digunakan di tugas aktif lain. Namun, sistem tidak memblokir penambahan produk secara otomatis. Pastikan Anda memverifikasi ketersediaan stok secara manual sebelum menyimpan tugas.
  </Accordion>

  <Accordion title="Bisakah teknisi mengubah daftar produk dari aplikasi mobile?" icon="mobile-screen">
    Teknisi dapat melaporkan produk yang sebenarnya digunakan saat mengisi checklist dan mengirim laporan di aplikasi mobile. Data aktual penggunaan produk dari lapangan akan tercatat dalam laporan tugas yang dapat direview oleh Admin.
  </Accordion>

  <Accordion title="Bagaimana cara melihat riwayat servis suatu aset?" icon="history">
    Riwayat servis aset dapat dilihat di modul **Asset Management** pada halaman detail aset. Setiap tugas yang sudah selesai dan terhubung ke aset tersebut akan tercatat secara kronologis.
  </Accordion>

  <Accordion title="Apakah perubahan produk pada tugas yang sedang berlangsung langsung terlihat oleh teknisi?" icon="refresh">
    Ya. Perubahan yang disimpan akan langsung memperbarui data tugas yang terlihat oleh teknisi di aplikasi mobile. Disarankan untuk memberitahu teknisi secara langsung jika ada perubahan produk yang signifikan saat tugas sedang berlangsung.
  </Accordion>
</AccordionGroup>

***

## Langkah Selanjutnya

<CardGroup cols={2}>
  <Card title="Manajemen Tugas →" icon="clipboard-list" href="/manajemen-tugas">
    Pelajari cara lengkap membuat, menugaskan, dan memantau tugas lapangan di CMS OpteraOne.
  </Card>

  <Card title="Manajemen Kategori Tugas →" icon="folder" href="/manajemen-kategori-tugas">
    Kelola kategori tugas sebagai dasar pengelompokan jenis pekerjaan dan konfigurasi aset default.
  </Card>
</CardGroup>