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

# Buat Tugas Lanjutan

> Cara membuat tugas lanjutan dari tugas yang sebelumnya dikerjakan, langsung dari aplikasi mobile OpteraOne.

Fitur **Buat Tugas Lanjutan** memungkinkan Agen atau Teknisi untuk membuat tugas tindak lanjut (*follow-up*) secara mandiri dari tugas yang pernah ditugaskan kepada mereka — tanpa harus menunggu penugasan baru dari Admin.

Tugas lanjutan mewarisi data kontak dari tugas asalnya secara otomatis, sehingga Agen hanya perlu melengkapi detail pekerjaan dan informasi produk yang relevan.

<Note>
  Fitur ini hanya tersedia untuk tugas yang **pernah ditugaskan kepada Anda**. Anda tidak dapat membuat tugas lanjutan dari tugas milik Agen lain.
</Note>

***

## Cara Membuat Tugas Lanjutan

Pembuatan tugas lanjutan dilakukan dalam **3 langkah berurutan** yang diakses langsung dari halaman Detail Tugas.

### Langkah 0 — Buka Halaman Detail Tugas

Buka tugas yang ingin Anda tindak lanjuti. Pastikan tugas tersebut sebelumnya pernah ditugaskan kepada Anda.

Dari halaman **Detail Tugas**, ketuk tombol **"Buat Tugas Lanjutan"** yang tersedia di bagian bawah halaman.

<Note>
  Tombol **"Buat Tugas Lanjutan"** berlaku untuk semua status tugas. Anda dapat membuat tugas lanjutan kapan pun selama tugas asal masih terdaftar di akun Anda.
</Note>

***

## Langkah 1 — Info Kontak

Pada langkah pertama, sistem secara otomatis mengisi data kontak dari tugas asal.

Informasi yang ditampilkan meliputi:

| Field             | Keterangan                             |
| ----------------- | -------------------------------------- |
| **Grand Kontak**  | Nama grup atau perusahaan pelanggan    |
| **Kontak**        | Nama person yang menjadi kontak tugas  |
| **Detail Kontak** | Email, nomor HP, dan zona waktu kontak |

<Tip>
  Data kontak terisi otomatis dari tugas asal dan **tidak dapat diubah** pada langkah ini. Jika perlu menggunakan kontak yang berbeda, buat tugas baru dari halaman Daftar Tugas.
</Tip>

### Aset Terkait

Di bawah informasi kontak, sistem menampilkan aset-aset yang terkait dengan kontak tersebut. Ketuk **"Lihat List Aset"** untuk melihat seluruh aset yang tersedia.

Setelah memverifikasi data kontak, ketuk tombol **"Selanjutnya"** untuk melanjutkan ke langkah berikutnya.

***

## Langkah 2 — Info Tugas

Langkah kedua adalah inti dari pengisian tugas lanjutan. Isi semua detail pekerjaan yang akan dilakukan.

### Informasi Umum

| Field             | Keterangan                            | Wajib    |
| ----------------- | ------------------------------------- | -------- |
| **Nama Tugas**    | Judul pekerjaan yang akan dilakukan   | ✅ Ya     |
| **Kategori**      | Jenis kategori pekerjaan              | ✅ Ya     |
| **Prioritas**     | Kritikal / Tinggi / Normal / Rendah   | ✅ Ya     |
| **Titik Lokasi**  | Alamat atau lokasi spesifik pekerjaan | ✅ Ya     |
| **Detail Alamat** | Deskripsi tambahan lokasi             | Opsional |
| **Lampiran**      | File pendukung (PDF, gambar)          | Opsional |

### Waktu Tugas

| Field               | Keterangan                               | Wajib |
| ------------------- | ---------------------------------------- | ----- |
| **Tanggal Mulai**   | Tanggal Agen mulai mengerjakan           | ✅ Ya  |
| **Tanggal Selesai** | Batas waktu penyelesaian (deadline)      | ✅ Ya  |
| **Zona Waktu**      | Terisi otomatis sesuai zona waktu kontak | —     |

<Warning>
  Pastikan **Tanggal Mulai** tidak lebih awal dari hari ini dan **Tanggal Selesai** tidak lebih awal dari Tanggal Mulai. Input yang tidak valid akan memunculkan pesan kesalahan dan langkah tidak dapat dilanjutkan.
</Warning>

### Memilih Kategori

Ketuk field **Kategori** untuk membuka daftar kategori yang tersedia. Pilih salah satu kategori yang sesuai dengan jenis pekerjaan yang akan dilakukan.

<AccordionGroup>
  <Accordion title="Produk tidak tersedia" icon="box-open">
    Jika kategori yang dipilih **tidak memiliki produk** yang terkonfigurasi, sistem akan menampilkan pesan pemberitahuan.

    Pada kondisi ini, bagian **Produk** tidak akan muncul di halaman. Anda tetap dapat melanjutkan pengisian tugas tanpa perlu menambahkan produk.
  </Accordion>

  <Accordion title="Produk tersedia" icon="boxes-stacked">
    Jika kategori yang dipilih **memiliki produk** terkonfigurasi, bagian **Produk** akan muncul di bawah field Kategori. Anda dapat menambahkan satu atau lebih produk ke dalam tugas.
  </Accordion>
</AccordionGroup>

### Menambahkan Produk

Bagian Produk muncul secara otomatis ketika kategori yang dipilih memiliki produk terkonfigurasi.

<Steps>
  <Step title="Ketuk 'Tambah Produk'">
    Ketuk tombol **"+ Tambah Produk"** untuk membuka dialog penambahan produk.
  </Step>

  <Step title="Pilih Nama Produk">
    Dari dialog **Tambah Produk**, ketuk field **Nama Produk** dan pilih produk dari daftar yang tersedia.

    Setelah nama produk dipilih, field **Label** akan terisi otomatis sesuai dengan konfigurasi produk.

    <Note>
      Setelah nama produk dipilih, **Foto Produk** dan informasi detail produk akan dimuat dari sistem. Tunggu hingga gambar produk tampil sebelum melanjutkan.
    </Note>
  </Step>

  <Step title="Pilih Lokasi Stok">
    Ketuk field **Lokasi** untuk memilih gudang atau lokasi stok produk yang akan digunakan.

    Daftar lokasi yang muncul menampilkan semua gudang yang memiliki stok produk tersebut.

    <AccordionGroup>
      <Accordion title="Stok tersedia" icon="circle-check">
        Jika produk tersedia di lokasi yang dipilih, sistem menampilkan:

        * **Foto Produk** dari lokasi tersebut
        * **Stok di Lokasi** — jumlah unit yang tersedia
        * **Kode Produk** — kode identifikasi unik produk
        * **Jumlah Dipakai** — field input untuk mengisi jumlah unit yang akan digunakan (default: 1)

        Sesuaikan jumlah unit yang dibutuhkan, lalu ketuk **"Simpan"** untuk menambahkan produk ke daftar.
      </Accordion>

      <Accordion title="Stok tidak tersedia" icon="circle-xmark">
        Jika produk **tidak tersedia** di lokasi yang dipilih, sistem menampilkan pesan error:

        > *"Produk tidak tersedia di lokasi ini"*

        Pilih lokasi lain yang memiliki stok, atau batalkan penambahan produk ini.
      </Accordion>
    </AccordionGroup>
  </Step>

  <Step title="Produk Berhasil Ditambahkan">
    Produk yang berhasil disimpan akan muncul dalam daftar di bagian **Produk** dengan informasi nama, lokasi, foto, dan jumlah unit.

    <Note>
      Anda dapat menambahkan **lebih dari satu produk** ke dalam satu tugas lanjutan. Ketuk kembali **"+ Tambah Produk"** untuk menambahkan produk berikutnya.
    </Note>
  </Step>
</Steps>

<Warning>
  Jika saat proses pengisian terdapat produk dengan stok habis, sistem akan menampilkan **toast error** dan mengarahkan tampilan ke bagian produk yang bermasalah. Produk tersebut akan ditandai dengan indikator error berwarna merah. Hapus atau ganti produk tersebut sebelum melanjutkan ke langkah berikutnya.
</Warning>

### Menambahkan Tag

Tag digunakan untuk mengelompokkan atau memberi label tambahan pada tugas.

<Steps>
  <Step title="Ketuk 'Tambah Tag'">
    Ketuk tombol **"+ Tambah Tag"** untuk membuka dialog penambahan tag.
  </Step>

  <Step title="Pilih atau Buat Tag">
    Dari dialog **Tambah Tag**, Anda dapat:

    * **Memilih dari daftar** — ketuk salah satu tag yang sudah tersedia
    * **Membuat tag baru** — ketik nama tag baru pada field input

    <Note>
      Nama tag bersifat wajib. Field yang kosong tidak akan disimpan dan akan menampilkan pesan **"Field is empty"**.
    </Note>
  </Step>

  <Step title="Ketuk 'Selesai'">
    Setelah memilih atau membuat tag, ketuk **"Selesai"** untuk menyimpan. Tag akan muncul di bagian bawah form Info Tugas.
  </Step>
</Steps>

Setelah semua field terisi, ketuk **"Selanjutnya"** untuk melanjutkan ke langkah terakhir.

***

## Langkah 3 — Preview Tugas

Langkah ketiga menampilkan ringkasan seluruh data tugas lanjutan yang akan dibuat. Periksa kembali semua informasi sebelum menyimpan.

### Ringkasan yang Ditampilkan

* **Informasi Tugas** — nama tugas, kategori, prioritas, lokasi, lampiran, waktu mulai dan selesai
* **Informasi Kontak** — data pelanggan dari tugas asal
* **Informasi Aset** — daftar aset terkait kontak
* **Informasi Produk** — daftar produk beserta lokasi stok dan jumlah yang dipakai

### Kondisi pada Langkah Preview

<AccordionGroup>
  <Accordion title="Semua data valid — siap disimpan" icon="circle-check">
    Jika semua data lengkap dan valid, tombol **"Selanjutnya"** aktif. Ketuk untuk menyimpan tugas lanjutan.

    Setelah disimpan, tugas baru akan tercatat dalam sistem dengan status **"Aktif"** dan dapat dipantau oleh Admin melalui CMS.
  </Accordion>

  <Accordion title="Tidak ada agreement yang ditetapkan" icon="triangle-exclamation">
    Jika kontak belum memiliki agreement yang aktif di sistem, halaman preview menampilkan pesan peringatan.

    Anda tetap dapat menyimpan tugas, namun pastikan sudah berkoordinasi dengan Admin terkait ketentuan agreement yang berlaku.
  </Accordion>

  <Accordion title="Agreement sudah ditetapkan" icon="file-contract">
    Jika kontak memiliki agreement aktif, detail agreement akan ditampilkan pada bagian preview untuk referensi Anda.
  </Accordion>

  <Accordion title="Gagal memuat inventori" icon="circle-exclamation">
    Jika sistem gagal memuat data inventori (misalnya karena koneksi terputus), halaman preview menampilkan pesan error. Ketuk untuk mencoba memuat ulang data inventori sebelum menyimpan tugas.
  </Accordion>

  <Accordion title="Stok produk habis" icon="box-open">
    Jika satu atau lebih produk yang dipilih kehabisan stok saat preview dimuat, sistem menampilkan peringatan. Kembali ke langkah sebelumnya untuk mengganti produk atau lokasi stok yang bermasalah.
  </Accordion>
</AccordionGroup>

Setelah memverifikasi semua data, ketuk **"Selanjutnya"** untuk menyimpan tugas lanjutan.

***

## Navigasi Antar Langkah

| Aksi                   | Fungsi                                                         |
| ---------------------- | -------------------------------------------------------------- |
| **Selanjutnya**        | Menyimpan data langkah saat ini dan maju ke langkah berikutnya |
| **Sebelumnya**         | Kembali ke langkah sebelumnya tanpa kehilangan data            |
| **Tombol ← (kembali)** | Membatalkan proses dan kembali ke halaman Detail Tugas asal    |

<Note>
  Membatalkan proses di langkah mana pun dengan menekan tombol kembali akan menghapus semua data yang sudah diisi pada sesi pembuatan tugas ini.
</Note>

***

## Langkah Selanjutnya

Setelah tugas lanjutan berhasil dibuat, tugas akan muncul di Daftar Tugas Anda dan dapat segera dikerjakan sesuai periode waktu yang telah ditentukan.

<CardGroup cols={2}>
  <Card title="Daftar Tugas →" icon="list-check" href="/daftar-tugas">
    Lihat seluruh tugas yang ditugaskan kepada Anda, termasuk tugas lanjutan yang baru saja dibuat.
  </Card>

  <Card title="Detail Tugas →" icon="clipboard" href="/detail-tugas">
    Pelajari cara membaca halaman Detail Tugas dan mempersiapkan diri sebelum memulai pengerjaan.
  </Card>
</CardGroup>