📋 PM Board
Epic EP-03 Kritik 01_suppliers erpbom-backend backend

01_suppliers — Ta'minotchilar (anketa, shartnoma versiyalash, hujjatlar, hamkor akkaunti)

Bajarildi
100% 26/26
Status:

Tavsif

Ta'minotchi (hamkor) katalogi: anketa (`suppliers`), **versiyalangan** shartnoma (`supplier_contracts` — to'lov muddati/turi/limit/PDF, bir vaqtda aynan bitta `active`), yuridik hujjatlar (`supplier_documents` — ID/pasport PDF) va hamkorning **mobil akkaunti** (`suppliers.user_id` → `users` role=`partner`, `audience='supplier'`). Bu modul 03_warehouse ning kirim faktura oqimi uchun **poydevor**: u `supplier_id` lookup'ini va **to'lov shartlarining yagona manbaini** (faol shartnoma) beradi. Kirim fakturaning o'zi (`purchase_receipts`), snapshot va `due_date` hisobi — 03_warehouse epicida. Backend'da to'liq data-model + REST API; web'da ichki foydalanuvchi ekranlari; mobil ilovada *Ta'minotchi* rolining anketa/shartnoma oynasi (ko'rish + tasdiqlash/tahrir → yangi versiya).

Texnik ko'rsatma

Agent uchun

Majburiy o'qish: erp/docs/modules/01_suppliers.md (to'liq), erp/docs/00_CROSS_CUTTING.md (A valyuta, H soft-delete/toggle, K nomlash, L RBAC, N tenant setting, P scoping), .claude/skills/coding/java-spring-coder/SKILL.md (backend), .claude/skills/coding/vuejs-coder/SKILL.md (web), .claude/skills/coding/flutter-coder/SKILL.md (mobil), .claude/skills/coding/postgresql/SKILL.md, .claude/skills/coding/swagger/SKILL.md (T00 uchun). 🔴 SCOPING (§3 p.1, CROSS_CUTTING P): uchala jadval ham **tenant-umumiy** — `organization_id` ustuni HECH BIRIDA YO'Q va qo'shilmaydi. Ko'rinish chegarasi = butun DB (AR-1), ilova filtri emas. `UNIQUE(inn)` — butun DB bo'ylab (org kesimisiz). 🔴 YAGONA MANBA (§5 qoida 5): `term_days`/`payment_method`/`debt_limit` haqiqat manbai = `supplier_contracts` (`status='active'`). `suppliers.default_term_days`/`default_payment_method`/`debt_limit` — **read-only cache**, faqat tizim yozadi (shartnoma yaratilganda/ versiyalanganda bir tranzaksiyada yangilanadi). API orqali to'g'ridan- to'g'ri tahrirlanmaydi. Alohida `*_logs` jadvali YARATILMAYDI — versiya tarixi = `supplier_contracts` qatorlari (Q23-A). Flyway: yangi migratsiya `V12__suppliers.sql` dan boshlanadi (mavjud oxirgisi — V11). Bitta `public` schema, `tenant_id` yo'q. Fayl maydonlari nomlanishi (09_auth R43a/R43b): `contract_file_key` / `contract_mime_type` / `contract_size_bytes` (shartnoma PDF), `file_key` / `mime_type` / `size_bytes` (hujjat). ⚠️ Fayl **original nomi saqlanmaydi** (Q29 = C — ongli qaror, ustun qo'shilmaydi).

Qabul mezonlari (DoD)

0 / 7 bajarildi

  • docs/modules/01_suppliers.md §12 dagi qamrovga kirgan AC lar mos test bilan qoplangan (§6.4 qarz limiti AC lari — 3 ta — bu epicda EMAS, 08_finance/03_warehouse ga qoldirilgan)

  • Uchala jadvalda ham `organization_id` ustuni yo'q (grep 0) — tenant-umumiy scoping (§3 p.1)

  • Har himoyalangan endpoint mavjud katalog rule'i bilan `@RequirePermission` qilingan (`permitAll` grep 0); huquq katalogiga YANGI qator qo'shilmagan (V3/R__permissions seed diff bo'sh)

  • `audience='supplier'` bilan login endi ISHLAYDI (faol ta'minotchiga bog'langan `partner` user uchun) — `StubAudienceOwnershipPort` supplier qismi haqiqiy implementatsiya bilan almashtirilgan

  • `users` jadvaliga `active=false` oqimida TEGILMAYDI (§5 qoida 14(c) — tasdiqlanmagan taklif)

  • openapi drift toza (T00 muzlatgan kontrakt bilan)

  • erpbom-web ekranlari Prism mock (:4010) ga qarshi ishlaydi

Ichki ishlar

13 ta

EP-03-T00 OpenAPI kontrakt — 01_suppliers (muzlatish) contract-ep-03
Bajarildi EP-03-T01 Migratsiya — 01_suppliers data model (Flyway V12)
Bajarildi EP-03-T02 Backend — ta'minotchi CRUD + v1 shartnoma avto-seed + cache
Bajarildi EP-03-T03 Backend — shartnoma versiyalash + shartnoma PDF
Bajarildi EP-03-T04 Backend — yuridik hujjatlar (`supplier_documents`)
Bajarildi EP-03-T05 Backend — hamkor (partner) akkaunti va `audience='supplier'` egalik tekshiruvi
Bajarildi EP-03-T06 Web — ta'minotchi ro'yxati, kartochka, yaratish/tahrir
Bajarildi EP-03-T07 Web — shartnoma versiyalari va hujjatlar
Bajarildi EP-03-T08 Mobil — *Ta'minotchi* roli: login + anketa/shartnoma oynasi
Bajarildi EP-03-T09 Migratsiya — hamkor tasdig'i va tahrir taklifi (Flyway V13)
Bajarildi EP-03-T10 Backend — hamkor tasdig'i + tahrir taklifi oqimi
Bajarildi EP-03-T11 Web — hamkor tahrir takliflari: ro'yxat, diff, qabul/rad
Bajarildi EP-03-T12 🔴 Tuzatish (EP-09 drifti) — `viewer` istisno ro'yxati 10 → 14
Bajarildi

Izoh qoldirish

Tarix

20 yozuv

  • 💬

    team-lead-pm izoh qoldirdi

    EP-08 QA topilmasi (2026-08-26) — EP-03 kodida QOLGAN NUQSON, alohida ish birligi kerak. Tozalangan filtr so'rovdan chiqmaydi: erpbom-web/src/modules/suppliers/views/SupplierListView.vue:75 (active: activeFilter.value ?? undefined) + src/modules/suppliers/store/suppliers.store.ts:50. Foydalanuvchi sektor/holat filtrini tozalasa, parametr keyingi so'rovda ham yuboriladi. EP-08 da aynan shu nuqson customers modulida topilib tuzatilgan (commit 27e5d46): store'da undefined = saqla, null = tozala semantikasi. Suppliers ham shu naqshga o'tkazilishi kerak.

  • ⇄

    system statusni o'zgartirdi Ishlanyapti → Bajarildi

    Bolalardan avtomatik hisoblandi

  • 🔗

    team-lead-pm bog'liqlik qo'shdi

    → EP-09

  • 🔗

    team-lead-pm bog'liqlik qo'shdi

    → EP-01

  • ✎

    team-lead-pm yangiladi

    Yangilandi: estimate_hours, meta

  • 🔗

    team-lead-pm bog'liqlik qo'shdi

    → EP-09

  • 🔗

    team-lead-pm bog'liqlik qo'shdi

    → EP-01

  • ✎

    team-lead-pm yangiladi

    Yangilandi: estimate_hours, meta

  • 🔗

    team-lead-pm bog'liqlik qo'shdi

    → EP-09

  • 🔗

    team-lead-pm bog'liqlik qo'shdi

    → EP-01

  • ✎

    team-lead-pm yangiladi

    Yangilandi: estimate_hours, meta

  • 💬

    team-lead-pm izoh qoldirdi

    SESSIYA PAUZA (limit) — 2026-08-19. Holat: 15/18 barg done (83%). Hamma agent toxtatildi. QOLGAN ISH: 1) EP-03-T03-S02 (shartnoma PDF proxy) — `review` da, QA verdikti OLINMAGAN (QA agenti pauza paytida toxtatildi). Yangi sessiyada T03 uchun worker-pm ochilib QA qayta yurgizilsin. 2) EP-03-T05-S02 (AudienceOwnershipPort supplier impl) — `review` da, QA mutatsiya sinovi yarmida toxtadi. DIQQAT: QA qoldirgan mutatsiya (SupplierAudienceOwnershipAdapter.java:56 `default -> true`) team-lead tomonidan `git checkout` bilan QAYTARILDI, ish daraxti toza. QA qayta yurgizilsin. 3) EP-03-T08-S02 — blocked (biznes boshligi, 01_suppliers §8.4) — ozgarmaydi. FAZA D (hali boshlanmagan): drift+push+PR. Uchta eslatma: (a) openapi/v1/suppliers.yaml hamon STAGED, commit qilinmagan — yakunlovchi commit qilsin; (b) feat/EP-03-erpbom-web branch main dan emas feat/EP-02-erpbom-web ustida; (c) feat/EP-03-erpbom-mobile branch feat/EP-09-erpbom-mobile ustida — merge tartibi shuni hisobga olsin. Ish daraxtlari: backend toza (faqat staged yaml), web toza, mobile toza. Push hech qaysi repoda qilinmagan.

  • 💬

    team-lead-pm izoh qoldirdi

    CROSS-CUTTING QAYD-2 (T02 workeridan, EP-03 ni bloklamaydi): `?sort=<maydon>,<yonalish>` (OpenAPI SortParam ning OZ misoli) 400 qaytaradi — Spring bitta qiymatni vergul boyicha bolib yuboradi. Suppliers da tor doirali `@RawQueryValues` resolver bilan yechildi (commit 64c4467/3b68c88). AYNAN SHU nuqson yana ~14 controllerda bor: PriceType, ProductVariant, ProductCategory, Brand, Sector, SellingPrice, PermissionGroup, Organization, Session, AuthLog, User va b. — ular hamon oddiy @RequestParam ishlatadi, ya`ni kontraktdagi sort misoli ular uchun ham 400 beradi. Tuzatish arzon (tayyor resolverga annotatsiya), lekin EP-03 doirasidan tashqari — keyingi epic yoki alohida texnik barg uchun.

  • 💬

    team-lead-pm izoh qoldirdi

    CROSS-CUTTING QAYD (T04 workeridan, EP-03 ni bloklamaydi): muzlatilgan kontrakt (openapi/v1/suppliers.yaml:690) rad etilgan download so'rovi auth_logs ga result=deny VA object_type=document bilan yozilishini talab qiladi. RequirePermissionAspect.java:52-58 deny yozadi, lekin objectType ni hech qachon to'ldirmaydi (maydon AuditLogEntry.java:48 da bor, kod bazasida bironta endpoint to'ldirmaydi). Umumiy aspekt — 09_auth hududi, EP-03 doirasidan tashqari. KEYINGI ISH: 09_auth tomonida alohida barg kerak. Ikkinchi qayd (texnik, bloklamaydi): 5 daq presigned TTL ikki joyda dublikat — FileDownloadService.java:48 (haqiqiy imzo muddati) va SupplierDocumentService.java:50 (javobdagi expires_at); hozir mos, lekin ikkinchisi o'zgarsa bironta test yiqilmaydi.

  • ⇄

    system statusni o'zgartirdi Backlog → Ishlanyapti

    Bolalardan avtomatik hisoblandi

  • ⇄

    system statusni o'zgartirdi Ishlanyapti → Backlog

    Bolalardan avtomatik hisoblandi

  • ⇄

    system statusni o'zgartirdi Backlog → Ishlanyapti

    Bolalardan avtomatik hisoblandi

  • 🔗

    pm-agent bog'liqlik qo'shdi

    → EP-09

  • 🔗

    pm-agent bog'liqlik qo'shdi

    → EP-01

  • ✦

    pm-agent yaratdi

    01_suppliers — Ta'minotchilar (anketa, shartnoma versiyalash, hujjatlar, hamkor akkaunti)

Ma'lumot

Agent
—
Olingan
—
Boshlandi
19.08.2026 13:11
Tugadi
20.08.2026 06:28
Baho
68 soat
Spec
erp/docs/modules/01_suppliers.md
Branch
—
Commit
—

Bog'liqliklar

Agent uchun

Bu ishni AI agent quyidagicha oladi:

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

Tugatgach:

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