450 lines
9.6 KiB
Markdown
450 lines
9.6 KiB
Markdown
|
|
---
|
||
|
|
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.
|