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

361 lines
7.8 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters!

This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.

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