Doc_chelvyn/Easset Mac/API & Functional/Catatan Perbaikan API — unt...

9.6 KiB

proyek modul kategori pembaca branch commit status tags
e-Asset Patra Jasa pj_easset API & Functional Tim functional / user (bukan programmer) cj/easet d1fd12f Selesai
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).

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

  1. 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).

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

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

  1. 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://<alamat-odoo>/api/docs), dalam kondisi sudah login di tab lain.

  1. Cari bagian Asset Transaction →

GET /api/asset-transaction/master/requests.

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

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

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