Doc_chelvyn/Easset Mac/Bug & Fixing/Easset — Print Barcode Marg...

361 lines
7.8 KiB
Markdown
Raw Permalink Normal View History

---
proyek: e-Asset Patra Jasa
modul: pj_easset
odoo: 18.0 Community
kategori: Bug & Fixing
branch: cj/easet
ticket: Print Barcode — Perbaiki margin atas layout print barcode (P2 · CJ/Cila · 2026-08-02)
status: Selesai — hanya controller, tanpa migration
tags:
- easset
- bug-fixing
- barcode
- print
---
> Index: [[Easset — Index]] · Kategori: **Bug & Fixing**
> Entri ringkasnya di [[Easset — List Fixing]] (2026-08-03).
Modul: `pj_easset` · Odoo 18 Community · Branch kerja: `cj/easet`
Ticket: **Print Barcode — Perbaiki margin atas layout print barcode** (P2 · CJ/Cila · 02-Aug-2026)
Acceptance: *hasil print memiliki margin atas konsisten dan tidak terpotong*
---
## 1. Lokasi Kode
Label barcode **bukan** QWeb report / template XML. Dia HTML string yang di-generate
langsung di dalam controller Python.
**File:** `pj_easset/controllers/maintenance/equipment_asset.py`
**Method:** `get_equipment_barcode_multi_html()`
**Endpoint:** `GET /api/equipment/barcode_multi.html?ids=1,2,3`
Alur pemanggilannya:
```
Form / list Aset
└── tombol "Print Barcode"
→ action server di views/maintenance/snk_equipment_maintenance_view.xml
(baris ~518, buka url /api/equipment/barcode_multi.html?ids=…)
→ controller get_equipment_barcode_multi_html()
→ HTML + CSS inline → browser → Ctrl+P
```
Ada juga jalur ZPL langsung ke printer (`/api/equipment/barcode_multi.zpl`,
method `get_equipment_barcode_multi_zpl`). **Jalur ZPL tidak ikut diubah** —
perbaikan ini murni di jalur HTML/browser.
**Struktur HTML yang di-generate:** tiap 2 aset jadi satu `<table class="page">`
(1 baris, 2 `<td class="page-cell">`), satu `page` = satu lembar label
`106mm × 33mm` (2 label @ `53mm`).
---
## 2. Masalah
Hasil print punya margin atas yang berubah-ubah antar label, dan bagian atas
barcode ikut terpotong.
**Penyebab — dua hal, dua-duanya di CSS:**
1. **Negative margin di blok `@media print`.** `.barcode-img` pakai
`margin: -3mm auto 1mm` dan `.asset-number` pakai `margin: -3mm 0`. Konten
ditarik 3mm ke atas sampai keluar dari area cell → bagian atas barcode
ter-*clip* saat dicetak.
2. **Angka posisi vertikal beda antara CSS layar dan CSS print.**
`.page-cell` pakai `vertical-align: top` + `padding-top`, tapi nilainya
tidak sinkron (layar vs print). Akibatnya preview di browser tidak mewakili
hasil cetak, dan tiap kali angkanya diutak-atik manual hasilnya tidak
konsisten.
Ditambah tinggi barcode print `24mm` + teks + padding membuat total konten
mepet ke batas label `33mm`.
---
## 3. Perbaikan
Prinsipnya: **posisi vertikal jangan dihitung manual** — serahkan ke browser
lewat centering, lalu geser seperlunya pakai padding (bukan negative margin).
Perubahan yang dilakukan, **7 properti, semuanya vertikal**:
| Blok | Properti | Sebelum | Sesudah |
|---|---|---|---|
| `.page-cell` (layar) | `vertical-align` | `top` | `middle` |
| `.page-cell` (layar) | posisi vertikal | `padding-top: 2mm` | `padding: 0 0 2mm` |
| `.asset-number` (layar) | padding / leading | `padding-top: 0` | `padding: 0` + `line-height: 1.1` |
| `.page-cell` (print) | `vertical-align` | `top !important` | `middle !important` |
| `.page-cell` (print) | posisi vertikal | `padding-top: 2mm !important` | `padding: 0 0 2mm !important` |
| `.barcode-img` (print) | `margin` | `-3mm auto 1mm !important` | `0 auto 1mm !important` |
| `.asset-number` (print) | `margin` | `-3mm 0 !important` | `0 !important` + `line-height: 1.1` |
### Cara kerjanya
`vertical-align: middle` pada `<td>` membuat browser membagi sisa ruang
(`33mm` − tinggi konten) rata ke atas dan bawah. Karena dihitung otomatis dari
tinggi konten, margin atasnya **konsisten di semua label** tanpa angka manual.
`padding-bottom: 2mm` mengurangi ruang dari sisi bawah, sehingga titik tengahnya
naik **1mm** — ini yang dipakai untuk permintaan "atasnya dinaikin sedikit".
Naiknya selalu **setengah** dari angka padding-bottom:
| `padding` | Konten naik | Jarak atas (print) | Jarak bawah |
|---|---|---|---|
| `0 0 0` | — | ~2.5mm | ~2.5mm |
| `0 0 2mm` ← **dipakai sekarang** | 1mm | ~1.5mm | ~3.5mm |
| `0 0 3mm` | 1.5mm | ~1.0mm | ~4.0mm |
| `0 0 4mm` | 2mm | ~0.5mm | ~4.5mm |
Batas aman ± `5mm`. Lebih dari itu konten mentok tepi atas label dan berisiko
terpotong lagi. **Kalau mau ubah, ubah di DUA tempat** (CSS layar dan CSS
`@media print`) supaya preview tetap sama dengan hasil cetak.
### Yang sengaja TIDAK diubah
Semua properti yang berpengaruh ke **layout horizontal** dibiarkan apa adanya,
sesuai permintaan (kiri-kanan tidak boleh bergeser):
- `.page-cell` → `width: 53mm`, `text-align: center`
- `.barcode-img` → `margin: 0 auto` (bagian `auto`-nya), `width: auto`
- tinggi barcode → tetap `22mm` (layar) / `24mm` (print)
*(tinggi ikut menentukan lebar karena `width: auto`, jadi diubah pun akan
menggeser tampilan horizontal — makanya dibiarkan)*
- `.page` → tetap seperti semula
- padding kiri-kanan `.page-cell` → tetap `0`
---
## 4. Catatan: Versi Lama di File yang Sama
Di file ini ada **dua versi lama** method yang sama, masih dalam bentuk
comment. Berguna sebagai konteks, tapi **jangan dipakai ulang mentah-mentah**:
| Versi | Baris | Pendekatan | Status |
|---|---|---|---|
| V1 (paling lama) | ~2822–3009 | flexbox: `.label-container` `display:flex` + `flex-direction:column` + `justify-content:center`. Ukuran inch (`4.3in × 1.2in`), barcode `0.95in` | **Vertikalnya sudah benar** — tanpa padding manual, tanpa negative margin |
| V2 (tengah) | ~2543–2820 | nested table, `.barcode-row {height:85%}` / `.text-row {height:15%}` | **Cacat** — di loop `pages` variabel `barcode_src`/`asset_number` bocor dari loop sebelumnya (semua label isinya sama) dan sel kanan diisi literal `...` |
| V3 (aktif) | ~2286–2539 | table flat + `vertical-align: top` + padding/negative margin manual | Versi yang diperbaiki dokumen ini |
Perbaikan ini pada dasarnya **mengembalikan prinsip V1** (centering otomatis,
tanpa angka manual) tapi memakai mekanisme table — `vertical-align: middle`
pada `<td>` itu ekuivalennya `justify-content: center` pada flex column.
Struktur `<table>` sengaja dipertahankan; kalau ikut V1 pakai CSS grid
`1fr 1fr`, layout horizontal ikut berubah.
**Sisa dari eksperimen V3 yang belum dibereskan:** di blok `@media print`,
`.page` masih `width: 107mm !important` padahal `@page` = `106mm`
(di V1 dua-duanya konsisten `4.3in`). Tidak berpengaruh ke margin atas karena
ini horizontal, tapi **kalau kolom kanan terlihat geser atau terpotong,
samakan jadi `106mm`.**
---
## 5. Deploy
Hanya controller Python — **tidak ada** perubahan field/model/struktur DB.
Jadi **tidak perlu** naik `version` di `__manifest__.py`, tidak perlu migration
script, tidak perlu `-u pj_easset`.
Cukup **restart service Odoo**:
```bash
docker restart easet-web-1
```
Sudah diverifikasi setelah restart: `pj_easset loaded`, `Registry loaded`,
tanpa error di log.
---
## 6. Cara Tes (via UI)
1. Buka menu **Aset** → pilih **beberapa** aset (minimal 2, biar kelihatan
pasangan kiri-kanan dalam satu lembar).
2. Klik tombol **Print Barcode**. Tab baru terbuka berisi preview label.
3. **Hard refresh** dulu: `Cmd/Ctrl + Shift + R` (CSS lama bisa ke-cache).
4. Tekan `Ctrl + P`, lalu di dialog print set:
- Printer: **Zebra ZD230**
- Paper: **53mm × 33mm**
- Margin: **None**
- Scale: **100%**
- **Uncheck** *Headers and footers*
5. Yang dicek di preview:
- [ ] Jarak dari tepi atas label ke barcode **sama di semua label**
- [ ] Bagian atas barcode **tidak terpotong**
- [ ] Nomor aset di bawah barcode tidak menempel/menabrak barcode
- [ ] Posisi kiri-kanan **sama seperti sebelum perbaikan** (tidak bergeser)
6. Print satu lembar ke label asli, pastikan die-cut-nya pas.