--- proyek: e-Asset Patra Jasa modul: pj_easset kategori: API & Functional pembaca: Tim functional / user (bukan programmer) branch: cj/easet commit: d1fd12f status: Selesai tags: - easset - api - functional - pemeliharaan --- > Index: [[Easset — Index]] · Kategori: **API & Functional** Dokumen ini ditulis untuk tim **functional / user**, bukan programmer. Isinya: apa yang diperbaiki, kenapa, cara mengeceknya di layar, dan cara membaca tanggalnya. --- ## 1. Daftar "Periode Pemeliharaan" di Mobile Sekarang Ikut Tanggal Transaksi **Endpoint:** `GET /api/asset-transaction/master/requests` **Commit:** `d1fd12f` · Branch `cj/easet` **Layar terkait:** Transaksi Aset → tipe **Pemeliharaan** → field **Periode Pemeliharaan** ### Masalahnya dulu Waktu user membuat transaksi **Pemeliharaan** di **web (Odoo)**, dropdown *Periode Pemeliharaan* hanya menampilkan periode yang jadwalnya **berdekatan** dengan tanggal transaksi. Jadi user tidak bisa salah pilih periode bulan lain. Tapi di **mobile**, daftar yang sama menampilkan **semua periode pemeliharaan yang pernah dibuat** — dari tahun lalu sampai tahun depan, tanpa batas. Akibatnya: - daftar pilihan sangat panjang dan membingungkan, - user gampang keliru memilih periode yang bukan jadwalnya, - isi checklist yang tertarik ke transaksi jadi ikut salah, karena checklist disalin dari periode yang dipilih. ### Sekarang jadi bagaimana Daftar *Periode Pemeliharaan* di mobile sekarang **disaring memakai aturan yang sama seperti di web**, yaitu berdasarkan **Tanggal Terjadwal** periode tersebut dibandingkan dengan **Tanggal Transaksi** yang sedang diisi user. > **Aturan tanggalnya:** > Periode pemeliharaan hanya muncul kalau **Tanggal Terjadwal**-nya berada > dalam rentang **30 hari sebelum sampai 30 hari sesudah Tanggal Transaksi**. Kalau user belum mengisi Tanggal Transaksi, sistem memakai **tanggal hari ini** sebagai patokan — sama persis seperti form di web, yang otomatis mengisi Tanggal Transaksi dengan tanggal hari ini. ### Contoh perhitungan Misal user membuat transaksi dengan **Tanggal Transaksi = 15 Agustus 2026**: | | Tanggal | |---|---| | Batas paling awal (30 hari sebelum) | **16 Juli 2026** | | Tanggal Transaksi | 15 Agustus 2026 | | Batas paling akhir (30 hari sesudah) | **14 September 2026** | Maka: | Periode Pemeliharaan | Tanggal Terjadwal | Muncul di daftar? | |---|---|---| | Servis AC Juni | 20 Juni 2026 | ❌ Tidak (lewat dari 30 hari sebelum) | | Servis AC Juli | 25 Juli 2026 | ✅ Ya | | Servis AC Agustus | 15 Agustus 2026 | ✅ Ya | | Servis AC September | 10 September 2026 | ✅ Ya | | Servis AC Oktober | 5 Oktober 2026 | ❌ Tidak (lewat dari 30 hari sesudah) | Urutan daftar juga diubah: periode dengan **Tanggal Terjadwal paling baru tampil di paling atas**. --- ## 2. Cara Melihat "Tanggal Terjadwal" Sebuah Periode Pemeliharaan Ini yang paling sering ditanyakan: *"Kok periode X tidak muncul? Tanggalnya yang mana sih yang dipakai?"* Yang dipakai adalah field **Tanggal Terjadwal** (bukan Tanggal Permintaan, bukan tanggal dibuat). Berikut cara melihatnya — pilih salah satu cara. ### Cara A — Buka satu per satu (paling pasti) 1. Login ke Odoo (web). 2. Menu **Pemeliharaan Aset** → **Permintaan Pemeliharaan Aset**. 3. Klik salah satu baris periode pemeliharaan sampai form-nya terbuka. 4. Lihat kolom sebelah **kanan**, ada field **Tanggal Terjadwal**. Nilai inilah yang dipakai sistem untuk menyaring daftar di mobile. > Catatan: di tampilan **list/tabel**, kolom Tanggal Terjadwal memang **tidak > ditampilkan** dan tidak bisa ditambahkan lewat tombol kolom. Jadi harus > dibuka form-nya, atau pakai Cara B / Cara C di bawah. ### Cara B — Tampilan Kalender (paling enak untuk lihat sebaran jadwal) 1. Menu **Pemeliharaan Aset** → **Permintaan Pemeliharaan Aset**. 2. Di kanan atas, ganti tampilan menjadi **Kalender**. 3. Posisi setiap periode di kalender **itulah Tanggal Terjadwal**-nya. 4. Cocokkan dengan Tanggal Transaksi: yang berada dalam rentang ±30 hari itulah yang akan muncul di mobile. ### Cara C — Saring langsung pakai Filter Tanggal Terjadwal 1. Menu **Pemeliharaan Aset** → **Permintaan Pemeliharaan Aset**. 2. Klik panah kecil di kotak pencarian → **Filter**. 3. Pilih filter berbasis **Tanggal Terjadwal**, lalu pilih bulan yang diinginkan (bisa juga pakai **Kelompokkan Berdasarkan** → Tanggal Terjadwal supaya datanya terkelompok per bulan). 4. Hasilnya = daftar periode pada bulan tersebut. Bandingkan dengan rentang ±30 hari dari Tanggal Transaksi. --- ## 3. Cara Menguji (Testing) Tujuan pengujian: memastikan **daftar di mobile sama dengan daftar di web**. ### Persiapan Siapkan satu aset yang punya beberapa periode pemeliharaan dengan Tanggal Terjadwal berbeda-beda (idealnya: ada yang bulan lalu, bulan ini, dan 2 bulan ke depan). Catat dulu tanggal-tanggalnya memakai Cara A/B/C di atas. ### Uji 1 — Bandingkan dengan tampilan di web 1. Menu **Aset** → **Transaksi Aset** → **Baru**. 2. Isi **Tipe** = *Pemeliharaan*. 3. Isi **Tanggal Transaksi**, misal `15/08/2026`. 4. Isi **Aset** dengan aset yang sudah disiapkan. 5. Klik dropdown **Periode Pemeliharaan** → **catat daftar yang muncul**. 6. Buka menu yang sama di **mobile**, isi Tipe, Tanggal Transaksi, dan Aset yang **persis sama**. 7. Buka dropdown **Periode Pemeliharaan** di mobile. ✅ **Hasil yang benar:** isi daftar di mobile **sama** dengan yang di web. ### Uji 2 — Ubah tanggal transaksi, daftar ikut berubah 1. Masih di layar mobile, ubah **Tanggal Transaksi** menjadi **2 bulan lebih awal** dari sebelumnya (contoh: dari 15 Agustus jadi 15 Juni). 2. Buka lagi dropdown **Periode Pemeliharaan**. ✅ **Hasil yang benar:** periode yang tadinya muncul sekarang **hilang**, dan yang muncul adalah periode dengan Tanggal Terjadwal di sekitar Juni. 3. Kembalikan Tanggal Transaksi ke tanggal semula. ✅ **Hasil yang benar:** daftar kembali seperti Uji 1. ### Uji 3 — Cek batas 30 hari (opsional, untuk yang teliti) 1. Pilih satu periode, catat Tanggal Terjadwal-nya, misal **25 Juli 2026**. 2. Isi Tanggal Transaksi = **20 Agustus 2026** (selisih 26 hari → masih di dalam 30 hari). ✅ Periode tersebut **harus muncul**. 3. Ganti Tanggal Transaksi = **1 September 2026** (selisih 38 hari → di luar 30 hari). ✅ Periode tersebut **harus hilang**. ### Uji 4 — Tanggal transaksi dikosongkan 1. Buat transaksi baru tanpa mengubah Tanggal Transaksi (biarkan default). ✅ **Hasil yang benar:** daftar yang muncul adalah periode dengan Tanggal Terjadwal di sekitar **hari ini** (±30 hari). ### Uji 5 — Cek langsung lewat halaman dokumentasi API (untuk tim IT/QA) Kalau ingin membuktikan tanpa aplikasi mobile: 1. Buka alamat Odoo diikuti `/api/docs` di browser (contoh: `https:///api/docs`), dalam kondisi **sudah login** di tab lain. 2. Cari bagian **Asset Transaction** → `GET /api/asset-transaction/master/requests`. 3. Klik **Try it out**, lalu isi: - `date` → tanggal transaksi, format **YYYY-MM-DD** (contoh `2026-08-15`) - `equipment_id` → ID aset yang diuji - `type` → `maintenance` 4. Klik **Execute**, lihat daftar yang keluar di bagian *Response*. ✅ **Hasil yang benar:** daftar sama dengan dropdown di web pada tanggal yang sama. --- ## 4. Kalau Periode yang Dicari Tidak Muncul — Cek Ini Dulu Urutkan pengecekan seperti ini sebelum melapor sebagai bug: | Cek | Cara | |---|---| | 1. Tanggal Terjadwal periode berapa? | Lihat Bagian 2 (Cara A/B/C) | | 2. Selisihnya dengan Tanggal Transaksi lebih dari 30 hari? | Kalau ya, memang **sengaja disembunyikan** — bukan bug. Perbaiki Tanggal Transaksi, atau perbaiki jadwal periodenya | | 3. Asetnya sudah benar? | Daftar juga disaring per **Aset** — periode milik aset lain tidak akan muncul | | 4. Statusnya *Check*? | Periode dengan tahap **Check** memang tidak ditampilkan untuk transaksi Pemeliharaan | | 5. Periodenya memang sudah dibuat? | Cek di **Permintaan Pemeliharaan Aset**; kalau belum ada, generate dulu lewat wizard preventive | --- ## 5. Catatan Teknis Singkat (untuk developer) - File: `pj_easset/controllers/asset_transaction/asset_transaction.py` (fungsi `_get_requests_master`) dan `pj_easset/controllers/swagger.py`. - Parameter query baru: `date` (format `YYYY-MM-DD`). Kosong atau tidak valid → jatuh ke hari ini, tidak error. - Rentang hari disimpan di konstanta `REQUEST_SCHEDULE_WINDOW_DAYS = 30`, mengikuti `_compute_request_date_range` pada `snk.maintenance.transaction`. **Kalau rentang di form berubah, ubah juga konstanta ini** supaya web dan mobile tidak beda. - Tidak ada perubahan struktur database → **tidak perlu migration, tidak perlu naik version manifest**. Deploy cukup restart service Odoo. ### Perbedaan yang masih tersisa antara Web dan API Dua hal berikut **belum** disamakan karena di luar lingkup perbaikan ini. Mohon jangan dilaporkan sebagai bug baru sebelum diputuskan bersama: 1. **Patokan tanggalnya beda nama field.** Form web menyaring memakai *Tanggal Permintaan*, API ini memakai *Tanggal Terjadwal* (sesuai permintaan). Untuk periode yang dibuat lewat wizard Generate Preventive, kedua tanggal ini **diisi nilai yang sama**, jadi hasilnya identik. Bedanya baru terasa kalau ada periode yang Tanggal Terjadwal-nya diubah manual tanpa mengubah Tanggal Permintaan. 2. **Status periode.** Form web menyembunyikan periode berstatus *Selesai*, *Dibatalkan*, dan *Ditolak*; API belum melakukan itu, jadi periode dengan status tersebut masih bisa muncul di mobile.