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

450 lines
9.6 KiB
Markdown
Raw Permalink Normal View History

---
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://<alamat-odoo>/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.