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 |
|
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)
-
Login ke Odoo (web).
-
Menu Pemeliharaan Aset → Permintaan Pemeliharaan Aset.
-
Klik salah satu baris periode pemeliharaan sampai form-nya terbuka.
-
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)
-
Menu Pemeliharaan Aset → Permintaan Pemeliharaan Aset.
-
Di kanan atas, ganti tampilan menjadi Kalender.
-
Posisi setiap periode di kalender itulah Tanggal Terjadwal-nya.
-
Cocokkan dengan Tanggal Transaksi: yang berada dalam rentang ±30 hari
itulah yang akan muncul di mobile.
Cara C — Saring langsung pakai Filter Tanggal Terjadwal
-
Menu Pemeliharaan Aset → Permintaan Pemeliharaan Aset.
-
Klik panah kecil di kotak pencarian → Filter.
-
Pilih filter berbasis Tanggal Terjadwal, lalu pilih bulan yang
diinginkan (bisa juga pakai Kelompokkan Berdasarkan → Tanggal Terjadwal
supaya datanya terkelompok per bulan).
- 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
-
Menu Aset → Transaksi Aset → Baru.
-
Isi Tipe = Pemeliharaan.
-
Isi Tanggal Transaksi, misal
15/08/2026. -
Isi Aset dengan aset yang sudah disiapkan.
-
Klik dropdown Periode Pemeliharaan → catat daftar yang muncul.
-
Buka menu yang sama di mobile, isi Tipe, Tanggal Transaksi, dan Aset
yang persis sama.
- 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
- Masih di layar mobile, ubah Tanggal Transaksi menjadi **2 bulan lebih
awal** dari sebelumnya (contoh: dari 15 Agustus jadi 15 Juni).
- 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.
- Kembalikan Tanggal Transaksi ke tanggal semula.
✅ Hasil yang benar: daftar kembali seperti Uji 1.
Uji 3 — Cek batas 30 hari (opsional, untuk yang teliti)
-
Pilih satu periode, catat Tanggal Terjadwal-nya, misal 25 Juli 2026.
-
Isi Tanggal Transaksi = 20 Agustus 2026 (selisih 26 hari → masih di
dalam 30 hari). ✅ Periode tersebut harus muncul.
- Ganti Tanggal Transaksi = 1 September 2026 (selisih 38 hari → di luar
30 hari). ✅ Periode tersebut harus hilang.
Uji 4 — Tanggal transaksi dikosongkan
- 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:
- Buka alamat Odoo diikuti
/api/docsdi browser (contoh:
https://<alamat-odoo>/api/docs), dalam kondisi sudah login di tab lain.
- Cari bagian Asset Transaction →
GET /api/asset-transaction/master/requests.
- Klik Try it out, lalu isi:
-
date→ tanggal transaksi, format YYYY-MM-DD (contoh2026-08-15) -
equipment_id→ ID aset yang diuji -
type→maintenance
- 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(formatYYYY-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:
- 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.
- 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.