`stock_returns` — qaytgan tovar qabuli (§8.5)

finalize-ep-04 yangiladi

Yangilandi: commit_sha, pr_url

qa-ep-04-t06-s01 izoh qoldirdi

QA (qa-EP-04-T06-S01) — QABUL QILINDI. Test: `mvn -Dtest=StockReturnConfirmedPostingTest test` -> Tests run: 4, Failures: 0, Errors: 0 (Testcontainers postgres:16, real HTTP). Mezonlar (har biri alohida tekshirildi): * AC2487 — 3 good + 2 defective ikki qatorda: stock.qty_on_hand good=3.0000, defective=2.0000; source_type='return' partiyalari har condition uchun 1 tadan (jami 2); return_in movement 2 ta. StockReturnService.confirm har qator uchun postIn(condition = qator condition) chaqiradi. * AC2488 — good qatori aynan 3.0000 (5 EMAS) — defective sotuvga ochiq qoldiqqa qo'shilmaydi. * AC2489 — ikkinchi qator varianti arxivlangan holatda confirm -> 409 VARIANT_ARCHIVED, hujjat draft qoladi, BIRINCHI qatorning qoldig'i/partiyasi/movement'i ham 0 (yarim yozilish yo'q). * AC2490 — confirmed hujjatga PUT va DELETE -> 409 INVALID_STATUS_TRANSITION (EDITABLE_STATUSES = {draft}); stock_return.confirm rule'siz token bilan /confirm -> 403. Mutatsiya tekshiruvi (4/4 mutant o'ldi, keyin git checkout -- <fayl> bilan tiklandi, ishchi daraxt toza): 1. confirm'da condition -> qattiq "good": AC2487 yiqildi (expected 3.0000, was 5.0000). 2. confirm'dan @Transactional olib tashlandi: AC2489 yiqildi (expected 0, was 3.0000) — rollback HAQIQATAN sinaladi, tautologiya emas. 3. @RequirePermission("stock_return.confirm") -> ".create": AC2490 403 testi yiqildi (was 200 OK). 4. EDITABLE_STATUSES ga confirmed qo'shildi: AC2490 tahrir testi yiqildi (was 200 OK). Bytecode yangilangani javap/strings bilan tasdiqlandi (soxta "survived" yo'q). Kontrakt (openapi/v1/warehouse.yaml): yo'llar, query filtrlari (status/warehouse_id/organization_id/return_source/date_from/date_to), sort (document_date|created_at|status, default document_date,desc), 201/200/204/403/409 kodlari mos. `status` HECH BIR request DTO'da yo'q (Create/Update) — o'tish faqat POST /confirm. StockReturnResponse maydonlari kontrakt bilan aynan (lines ro'yxatda bo'sh, kartochkada to'liq). qty/unit_cost javobda string ko'rinishida ('1.0000' / '10000.00') — JacksonConfig konvensiyasi, kontrakt type: string bilan mos. Cross-cutting: har DB metodi @Transactional (list/get — readOnly=true); tenant_id yo'q (AR-1); FK'lar to'liq nomda (fk_stock_returns_*, ON DELETE CASCADE faqat lines); qty numeric(18,4), unit_cost numeric(18,2); hujjat soft-delete (deleted_at, faqat draft), fizik DELETE faqat draft qatorlarini to'liq almashtirishda (stock_return_lines'da deleted_at yo'q — PurchaseReceipt bilan bir xil naqsh); log'da token/parol yo'q; asinxron ish yo'q (outbox talab qilinmaydi). Kuzatuv (defekt emas, bloklamaydi): qatorsiz (lines: []) hujjatni confirm qilish mumkin — bo'sh confirmed hujjat hosil bo'ladi. Spec §8.5 ham, kontrakt ham RETURN_NO_LINES kabi kodni talab qilmaydi (purchase_receipt'dagi RECEIPT_NO_LINES qoida 13 faqat fakturaga tegishli). Kerak bo'lsa — spec savoli, kod nuqsoni emas.

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

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

✓ `confirmed` hujjatni tahrir qilishga urinish rad etiladi; `stock_return.confirm` rule'siz yakunlash 403 beradi

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

✓ Posting o'rtasida xato bo'lsa hujjat `draft` qoladi va qoldiq tegilmaydi

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

✓ `defective` qaytgan tovar sotuvga ochiq qoldiqqa (`good`) tushmaydi

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

✓ 5 ta tovar (3 `good` + 2 `defective`) ikki qatorda qaytarilganda `good` qoldiq +3, `defective` qoldiq +2 bo'ladi va ikkita alohida partiya yaratiladi

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

coder-ep-04-t06-s01 yangiladi

Yangilandi: branch, commit_sha

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

✓ `confirmed` hujjatni tahrir qilishga urinish rad etiladi; `stock_return.confirm` rule'siz yakunlash 403 beradi

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

✓ Posting o'rtasida xato bo'lsa hujjat `draft` qoladi va qoldiq tegilmaydi

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

✓ `defective` qaytgan tovar sotuvga ochiq qoldiqqa (`good`) tushmaydi

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

✓ 5 ta tovar (3 `good` + 2 `defective`) ikki qatorda qaytarilganda `good` qoldiq +3, `defective` qoldiq +2 bo'ladi va ikkita alohida partiya yaratiladi

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

13 ta fayl qayd etildi

coder-ep-04-t06-s01 statusni o'zgartirdi Backlog → Ishlanyapti

Agent ishni boshladi

coder-ep-04-t06-s01 ishga oldi

pm-agent yaratdi

`stock_returns` — qaytgan tovar qabuli (§8.5)