`draft` CRUD + qatorlar + valyuta konvertatsiyasi (§6.2)

finalize-ep-04 yangiladi

Yangilandi: branch, commit_sha, pr_url

worker-ep-04-t14 statusni o'zgartirdi Ishlanyapti → Bajarildi

Drift yopildi (EP-04-T14). Bu barg oz doirasini togri bajargan edi; blok epic darajasidagi implementatsiya-kontrakt driftining markeri edi. Yetishmayotgan GET /api/v1/exchange-rates/{currencyCode}/{date} EP-04-T14-S02 da qoshildi (commit ee5f312), QA 8/8 mezon + 2/2 mutatsiya killed. Shu sababli barg done ga qaytarildi.

worker-ep-04-t14 statusni o'zgartirdi Tayyor → Ishlanyapti

Agent ishni boshladi

worker-ep-04-t14 ishga oldi

system statusni o'zgartirdi Ishlanyapti → Tayyor

Avtomatik bo'shatildi: 60 daqiqa signal yo'q

system bo'shatdi

Avtomatik bo'shatildi: 60 daqiqa signal yo'q

worker-ep-04-t14 statusni o'zgartirdi Bloklangan → Ishlanyapti

finalize-ep-04 statusni o'zgartirdi Ishlanyapti → Bloklangan

🔴 BLOK SABABI EPIC DARAJASIDA: bu barg o'z doirasini (draft CRUD + valyuta konvertatsiyasi) TO'G'RI bajargan. Blok shu bargga qo'yildi, chunki kurs (exchange rate) mavzusi aynan shu bargga tegishli; ota-item statusi bolalardan hisoblangani uchun drift barg orqali ko'rsatiladi. FINALIZE DRIFT (EP-04, implementatsiya<->kontrakt). Muzlatilgan kontraktda e'lon qilingan operatsiya kodda YO'Q: - GET /api/v1/exchange-rates/{currencyCode}/{date} (openapi/v1/warehouse.yaml 2346-qator; 825-qatorda klient kursni AYNAN shu endpoint bilan tekshirishi ko'zda tutilgan) DALIL: springdoc /v3/api-docs da bu yo'l yo'q; butun src/main da birorta exchange-rate controller/mapping mavjud emas. DIQQAT: PurchaseReceiptService.java:642 izohi bu endpointni "bu kontraktda emas" deb yozadi — bu NOTO'G'RI, u kontraktda bor (2346-qator). Izoh ham tuzatilsin. TA'SIRI: erpbom-web PurchaseReceiptLinesEditor.vue getExchangeRate() ni chaqiradi (src/modules/warehouse/api/exchange-rates.api.ts:26) — real backend'da 404; kurs tekshiruvi ishlamaydi. TUZATISH KODDA (kontrakt muzlatilgan): kurs o'qish endpointi uchun yangi barg ochilsin. NATIJA: erpbom-backend PUSH QILINMADI, PR ochilmadi.

finalize-ep-04 statusni o'zgartirdi Bajarildi → Ishlanyapti

🔴 BLOK SABABI EPIC DARAJASIDA: bu barg o'z doirasini (draft CRUD + valyuta konvertatsiyasi) TO'G'RI bajargan. Blok shu bargga qo'yildi, chunki kurs (exchange rate) mavzusi aynan shu bargga tegishli; ota-item statusi bolalardan hisoblangani uchun drift barg orqali ko'rsatiladi. FINALIZE DRIFT (EP-04, implementatsiya<->kontrakt). Muzlatilgan kontraktda e'lon qilingan operatsiya kodda YO'Q: - GET /api/v1/exchange-rates/{currencyCode}/{date} (openapi/v1/warehouse.yaml 2346-qator; 825-qatorda klient kursni AYNAN shu endpoint bilan tekshirishi ko'zda tutilgan) DALIL: springdoc /v3/api-docs da bu yo'l yo'q; butun src/main da birorta exchange-rate controller/mapping mavjud emas. DIQQAT: PurchaseReceiptService.java:642 izohi bu endpointni "bu kontraktda emas" deb yozadi — bu NOTO'G'RI, u kontraktda bor (2346-qator). Izoh ham tuzatilsin. TA'SIRI: erpbom-web PurchaseReceiptLinesEditor.vue getExchangeRate() ni chaqiradi (src/modules/warehouse/api/exchange-rates.api.ts:26) — real backend'da 404; kurs tekshiruvi ishlamaydi. TUZATISH KODDA (kontrakt muzlatilgan): kurs o'qish endpointi uchun yangi barg ochilsin. NATIJA: erpbom-backend PUSH QILINMADI, PR ochilmadi.

qa-ep-04-t04-s01 statusni o'zgartirdi Review → Bajarildi

qa-ep-04-t04-s01 izoh qoldirdi

QA (qa-EP-04-T04-S01) — 5 mezon kod darajasida qayta tekshirildi (is_met belgilariga tayanmadim), testlarni o'zim yurgizdim. TEST: flock ostida `mvn -Dtest=PurchaseReceiptCreateAndUpdateTest test` → Tests run: 15, Failures: 0, Errors: 0 (40.8s, exit=0). Testcontainers PostgreSQL 16, real HTTP. MEZONLAR (fayl:qator — PurchaseReceiptService.java): - AC2452 ✓ :262 `unitCost = unitCostForeign × exchangeRate` (scale 2, HALF_UP); is_base bo'lsa :251-252 kurs majburan 1.000000 (qo'lda berilgan kurs ham bekor qilinadi — qoida 15). Test: 50 USD × 12800 = 640000.00; UZS qatori 1.000000 / 50000.00. - AC2453 ✓ update() (:187-191) qatorlarni to'liq almashtiradi va HAR qatorni JORIY document_date bo'yicha qayta hisoblaydi. Test: 2026-08-10 (12000) → 2026-08-20 (13000), unit_cost 120000.00 → 130000.00. - AC2454 ✓ (a) kurs yo'q sana bilan so'rov 201 qaytardi (400/404 emas); (b) qo'lda berilgan kurs avto-qidiruvdan ustun (:253-254, 13500.500000 saqlandi). Kuzatuv (bu bargda defekt EMAS): kurs topilmasa chet el valyutasi ham 1.000000 ga tushadi → unit_cost = unit_cost_foreign; V17:124 ustuni NOT NULL DEFAULT 1 bo'lgani uchun "noma'lum kurs" holatini saqlash imkoni yo'q. S02 (confirm/posting) shu qiymatni FIFO tannarxga o'tkazadi — o'sha bargda "chet el qatori kursi = 1" holatini ushlash ko'rib chiqilsin. - AC2455 ✓ :204-211 requireRawWarehouse → 409 RECEIPT_WAREHOUSE_NOT_RAW, create VA update ikkalasida chaqiriladi; V17 dagi enforce_purchase_receipt_raw_warehouse trigger — ikkinchi qatlam. Test semi_finished + finished + ijobiy raw yo'lini qamraydi. - AC2456 ✓ Controller'da faqat @RequirePermission("purchase_receipt.create") (:72, :80); SupplierService/ProductVariantService da rule tekshiruvi yo'q (grep bilan tasdiqlandi). Test creator token'ida faqat purchase_receipt.create/view — POST 201, PUT 200; rule'siz user 403. MUTATSIYA TEKSHIRUVI (4 ta; har biri testni yiqitdi, keyin fayl nusxadan tiklandi, final run yashil): A) unit_cost dan `× exchangeRate` olib tashlandi → AC2452 testi yiqildi (kutilgan 640000.00, olingan 50.00); AC2453 testi ham yiqildi. B) qoida 11 sharti doim-false qilindi → AC2455 testi yiqildi (kutilgan 409, olingan 500 — DB trigger ushladi). C) qo'lda berilgan exchange_rate e'tiborsiz qoldirildi → AC2454 testi yiqildi (kutilgan 13500.500000, olingan 1.000000). D) update kursni eski sana bo'yicha qidiradigan qilindi → AC2453 testi yiqildi (kutilgan 13000.000000, olingan 12000.000000). Ya'ni testlar tautologik emas — 4 ta yolg'onni ham ushladi. KONTRAKT / CROSS-CUTTING: - Create/Update request DTO'larida `status` YO'Q ✓ (holat o'tishlari S02+ da). - PUT `lines` = to'liq almashtirish, draft VA disputed uchun ✓ (DB qator soni bilan tasdiqlangan; confirmed/pending → 409 INVALID_STATUS_TRANSITION). - variant_name/variant_code entity'da ustun EMAS, javobda ProductVariantService orqali to'ldiriladi ✓. - §4.1 5 qiymat ALL_STATUSES konstantasida qotirilgan + DB CHECK noma'lum qiymatni rad etishi test bilan tasdiqlangan ✓. - Migratsiya qo'shilmagan — V15…V18 tegilmagan, openapi/ tegilmagan ✓ (git bilan tekshirildi). - @Transactional har DB metodida (list/get — readOnly) ✓; tenant_id/schema mexanikasi yo'q ✓; currency_code FK → currencies.code ✓; precision qty 18,4 · narx 18,2 · kurs 18,6 (entity ↔ V17 mos) ✓; snake_case + ko'plik ✓; parol/token log'ga yozilmaydi ✓. KEYINGI BO'G'INLARGA (bu bargda defekt emas, tuzatish so'ralmaydi): 1) payment_basis draft'da qat'iy 'on_receipt' — §2.5 default'iga mos; faol shartnomadan snapshot qoida 34 bo'yicha `confirmed` da (S02) bajarilishi kerak. Kontrakt POST tavsifi (warehouse.yaml:818-820) uni yaratishda snapshot deb yozadi — nomuvofiqlik S02 da yopilsin. 2) currencies.active tekshiruvi ilovada yo'q (§2.6 izohi "active tekshiruvi ilovada qoladi"); bu endpoint uchun kontraktda mos 409 kodi yo'q, shuning uchun bu bargda talab qilinmadi. VERDIKT: done.

qa-ep-04-t04-s01 qabul mezonini belgiladi

✓ Faktura yaratish/tahrir `supplier.*` rule'siz ishlaydi, faqat `purchase_receipt.create` talab qilinadi (Q6)

qa-ep-04-t04-s01 qabul mezonini belgiladi

✓ `semi_finished`/`finished` ombor bilan faktura yaratishga urinish rad etiladi (qoida 11)

qa-ep-04-t04-s01 qabul mezonini belgiladi

✓ So'ralgan sanaga `exchange_rates` da qator bo'lmasa javob ogohlantirish bilan qaytadi (400 emas) va qo'lda kiritilgan kurs qabul qilinadi

qa-ep-04-t04-s01 qabul mezonini belgiladi

✓ `document_date` o'zgartirilganda `draft` fakturaning barcha chet el valyuta qatorlarida kurs qayta hisoblanadi

qa-ep-04-t04-s01 qabul mezonini belgiladi

✓ USD qatori 12 800 kursda kiritilganda `unit_cost = unit_cost_foreign × 12 800` aniq hisoblanadi; UZS (asosiy) qatorida `exchange_rate = 1` va `unit_cost = unit_cost_foreign`

coder-ep-04-t04-s01 statusni o'zgartirdi Ishlanyapti → Review

coder-ep-04-t04-s01 qabul mezonini belgiladi

✓ Faktura yaratish/tahrir `supplier.*` rule'siz ishlaydi, faqat `purchase_receipt.create` talab qilinadi (Q6)

coder-ep-04-t04-s01 qabul mezonini belgiladi

✓ `semi_finished`/`finished` ombor bilan faktura yaratishga urinish rad etiladi (qoida 11)

coder-ep-04-t04-s01 qabul mezonini belgiladi

✓ So'ralgan sanaga `exchange_rates` da qator bo'lmasa javob ogohlantirish bilan qaytadi (400 emas) va qo'lda kiritilgan kurs qabul qilinadi

coder-ep-04-t04-s01 qabul mezonini belgiladi

✓ `document_date` o'zgartirilganda `draft` fakturaning barcha chet el valyuta qatorlarida kurs qayta hisoblanadi

coder-ep-04-t04-s01 qabul mezonini belgiladi

✓ USD qatori 12 800 kursda kiritilganda `unit_cost = unit_cost_foreign × 12 800` aniq hisoblanadi; UZS (asosiy) qatorida `exchange_rate = 1` va `unit_cost = unit_cost_foreign`

coder-ep-04-t04-s01 fayllarni qayd etdi

13 ta fayl qayd etildi

worker-ep-04-t04 statusni o'zgartirdi Backlog → Ishlanyapti

Agent ishni boshladi

worker-ep-04-t04 ishga oldi

pm-agent yaratdi

`draft` CRUD + qatorlar + valyuta konvertatsiyasi (§6.2)