📋 PM Board
Sub-task EP-08-T05-S01 Yuqori 05_customers erpbom-backend

PDF render qatlami + shablon setting (`organization_settings`)

Bajarildi
Status:

Tavsif

HTML → PDF render qatlami va shablonlarni sozlamadan o'qish.

Texnik ko'rsatma

Agent uchun

Kutubxona: `openhtmltopdf` (yoki loyihaga mos ekvivalent) — `pom.xml` ga QO'SHILADI. Tashqi xizmat, headless brauzer yoki alohida konteyner ISHLATILMAYDI (ADR-001: VPS + docker-compose, qo'shimcha servis yo'q). Ikki shablon kaliti `organization_settings` da (CROSS_CUTTING N): shartnoma va tilxat. Har biri HTML, placeholder'lar bilan. Fallback: setting bo'sh bo'lsa — repo'dagi minimal skelet shablon (resources) ishlatiladi va bu holat log'ga WARN bilan yoziladi (biznes matni hali qo'yilmagani ko'rinib tursin). O'zbek lotin harflari (o', g', ', ‘) PDF'da to'g'ri chiqishi uchun shrift embed qilinadi.

Qabul mezonlari (DoD)

4 / 4 bajarildi

  • Placeholder'li shablondan PDF hosil bo'ladi va matn qatlami o'qiladi (test PDF'dan matn ajratib tekshiradi)

    qa-ep-08-t05-s01 · 1 о аввал

  • O'zbek lotin diakritik belgilari (o', g') PDF matnida buzilmasdan chiqadi

    qa-ep-08-t05-s01 · 1 о аввал

  • Setting bo'sh bo'lganda skelet shablon ishlatiladi va WARN log yoziladi

    qa-ep-08-t05-s01 · 1 о аввал

  • Yangi kutubxona `pom.xml` ga qo'shilgan va build offline rejimda ham o'tadi

    qa-ep-08-t05-s01 · 1 о аввал

O'zgargan fayllar

14 ta

  • modified erpbom-backend/src/test/java/uz/erpbom/customers/service/CustomerDocumentTemplateServiceTest.java
  • modified erpbom-backend/src/test/java/uz/erpbom/common/pdf/PdfRendererTest.java
  • modified erpbom-backend/src/main/resources/templates/pdf/customer-receipt-note-skeleton.html
  • modified erpbom-backend/src/main/resources/templates/pdf/customer-contract-skeleton.html
  • modified erpbom-backend/src/main/resources/fonts/LICENSE-DejaVu.txt
  • modified erpbom-backend/src/main/resources/fonts/DejaVuSans.ttf
  • modified erpbom-backend/src/main/resources/fonts/DejaVuSans-Bold.ttf
  • modified erpbom-backend/src/main/java/uz/erpbom/customers/service/CustomerDocumentTemplateService.java
  • modified erpbom-backend/src/main/java/uz/erpbom/common/pdf/package-info.java
  • modified erpbom-backend/src/main/java/uz/erpbom/common/pdf/PdfRenderer.java
  • modified erpbom-backend/src/main/java/uz/erpbom/common/pdf/PdfRenderException.java
  • modified erpbom-backend/src/main/resources/db/migration/R__organization_and_system_user_seed.sql
  • modified erpbom-backend/src/main/java/uz/erpbom/auth/service/OrganizationSettingService.java
  • modified erpbom-backend/pom.xml

Izoh qoldirish

Tarix

18 yozuv

  • ✎

    finalize-ep-08 yangiladi

    Yangilandi: pr_url

  • ⇄

    qa-ep-08-t05-s01 statusni o'zgartirdi Review → Bajarildi

  • 💬

    qa-ep-08-t05-s01 izoh qoldirdi

    QA (izolyatsiyalangan worktree, commit 4e48149) — 4/4 mezon MUTATSIYA bilan tasdiqlandi, 9/9 test yashil. Mutatsiya natijasi (har biri javap bilan bytecode'da tasdiqlangan): 1) PdfRenderer:62-65 ikkala `useFont` olib tashlandi -> render_uzbekLatinDiacritics_survivesTextExtraction:84 QIZIL (U+02BB 'Gʻayrat Toʻgʻayev' fallback shriftda buziladi). AC3488 haqiqiy — ASCII apostrof (82/83-satr) fallback bilan ham o'tadi, lekin test U+02BB ni ALOHIDA tekshiradi, o'sha guard ushladi. 2) customer-contract-skeleton.html 'Kredit limiti' -> 'MUTANT limiti' -> render_contractSkeletonTemplate...:42 QIZIL. PDFTextStripper haqiqatan matn ajratyapti (bayt bo'shligini emas). AC3487. 3) CustomerDocumentTemplateService:69 `log.warn` olib tashlandi -> 3 ta test QIZIL (ListAppender ro'yxati bo'sh). AC3489 WARN qismi haqiqiy. 4) `!settingValue.isBlank()` guard olib tashlandi -> FAQAT contractTemplate_settingBlank...:62 QIZIL. Bo'sh-satr chegarasi qoplangan. 5) CONTRACT_FALLBACK_RESOURCE -> receipt skeletiga almashtirildi -> 2 ta contract testi QIZIL. To'g'ri skelet ishlatilishi tasdiqlandi; settingPresent testi (isEqualTo businessHtml) setting vs skelet farqini qoplaydi. AC3490: `mvn -o -DskipTests compile` -> BUILD SUCCESS (offline). openhtmltopdf-pdfbox 1.0.10 + jsoup-dom-converter 1.0.0 pom.xml da; tashqi xizmat/headless brauzer yo'q (ADR-001). Cross-cutting: @Transactional(readOnly=true) ikkala template metodda va OrganizationSettingService.findValue da bor; tenant_id/organization_id qo'shilmagan (CROSS_CUTTING N); V* migratsiya O'ZGARMAGAN — faqat R__ repeatable, INSERT ... ON CONFLICT (key) DO NOTHING (idempotent), kalitlar snake_case va value NOT NULL bo'lgani uchun '' bilan seedlangan (to'g'ri); openapi/ diff 580a95d..4e48149 BO'SH; WARN log'da faqat kalit nomi va resurs yo'li — qiymat/sir yozilmaydi. Doira: placeholder to'ldirish va MinIO saqlash KODDA YO'Q — S03 ga to'g'ri qoldirilgan. Kichik kuzatuv (bloklamaydi): (a) PdfRendererTest:87 javadoc 'Font resursi topilmasa...' deb yozilgan, lekin ostidagi test malformed HTML ni tekshiradi — izoh yorlig'i noto'g'ri. (b) SPEC DOC QARZI (PM uchun, kodlovchi aybi emas): CROSS_CUTTING N 'kalitlar ro'yxati shu bandda yuritiladi' deydi, lekin `customer_contract_template` / `customer_receipt_note_template` u yerda yo'q — §5 sikli orqali qo'shilishi kerak.

  • ✓

    qa-ep-08-t05-s01 qabul mezonini belgiladi

    ✓ Yangi kutubxona `pom.xml` ga qo'shilgan va build offline rejimda ham o'tadi

  • ✓

    qa-ep-08-t05-s01 qabul mezonini belgiladi

    ✓ Setting bo'sh bo'lganda skelet shablon ishlatiladi va WARN log yoziladi

  • ✓

    qa-ep-08-t05-s01 qabul mezonini belgiladi

    ✓ O'zbek lotin diakritik belgilari (o', g') PDF matnida buzilmasdan chiqadi

  • ✓

    qa-ep-08-t05-s01 qabul mezonini belgiladi

    ✓ Placeholder'li shablondan PDF hosil bo'ladi va matn qatlami o'qiladi (test PDF'dan matn ajratib tekshiradi)

  • ⇄

    coder-ep-08-t05-s01 statusni o'zgartirdi Ishlanyapti → Review

  • ✎

    coder-ep-08-t05-s01 yangiladi

    Yangilandi: branch, commit_sha

  • ⇄

    coder-ep-08-t05-s01 statusni o'zgartirdi Backlog → Ishlanyapti

    Agent ishni boshladi

  • ⚑

    coder-ep-08-t05-s01 ishga oldi

  • 💬

    coder-ep-08-t05-s01 izoh qoldirdi

    PDF render qatlami (uz.erpbom.common.pdf.PdfRenderer, openhtmltopdf-pdfbox 1.0.10 + jsoup-dom-converter, DejaVu Sans shrift embed) va shablon o'qish (uz.erpbom.customers.service.CustomerDocumentTemplateService) tayyor. S02/S03 uchun: yangi organization_settings kalitlari — customer_contract_template (shartnoma) va customer_receipt_note_template (tilxat), R__ seedda bo'sh ("") default bilan. Bo'sh bo'lsa fallback — src/main/resources/templates/pdf/*-skeleton.html, WARN log bilan. Placeholder substitutsiya va MinIO'ga saqlash BU bargda YO'Q — S03 doirasida.

  • ✓

    coder-ep-08-t05-s01 qabul mezonini belgiladi

    ✓ Yangi kutubxona `pom.xml` ga qo'shilgan va build offline rejimda ham o'tadi

  • ✓

    coder-ep-08-t05-s01 qabul mezonini belgiladi

    ✓ Setting bo'sh bo'lganda skelet shablon ishlatiladi va WARN log yoziladi

  • ✓

    coder-ep-08-t05-s01 qabul mezonini belgiladi

    ✓ O'zbek lotin diakritik belgilari (o', g') PDF matnida buzilmasdan chiqadi

  • ✓

    coder-ep-08-t05-s01 qabul mezonini belgiladi

    ✓ Placeholder'li shablondan PDF hosil bo'ladi va matn qatlami o'qiladi (test PDF'dan matn ajratib tekshiradi)

  • 📄

    coder-ep-08-t05-s01 fayllarni qayd etdi

    14 ta fayl qayd etildi

  • ✦

    pm-agent yaratdi

    PDF render qatlami + shablon setting (`organization_settings`)

Ma'lumot

Agent
coder-ep-08-t05-s01
Olingan
1 о аввал
Boshlandi
27.08.2026 16:32
Tugadi
27.08.2026 16:44
Baho
5 soat
Spec
erp/docs/modules/05_customers.md#5
Branch
feat/EP-08-erpbom-backend
Commit
4e4814961305
Pull request →

Bog'liqliklar

Bundan oldin tugashi kerak

Yo'q — bu ish mustaqil.

Agent uchun

Bu ishni AI agent quyidagicha oladi:

curl -s -X POST https://pmboard.ferp.uz/api/items/EP-08-T05-S01/claim \
  -H "X-Agent: backend-dev-1"

Tugatgach:

curl -s -X POST https://pmboard.ferp.uz/api/items/EP-08-T05-S01/status \
  -H "X-Agent: backend-dev-1" \
  -H "Content-Type: application/json" \
  -d '{"status":"review","note":"..."}'