📋 PM Board
Task EP-08-T00 Kritik 05_customers erpbom-backend api

OpenAPI kontrakt — 05_customers (muzlatish)

Bajarildi
Status:

Tavsif

Butun epic uchun API kontraktini yozib **muzlatish**: `openapi/v1/customers.yaml` (+ kerak bo'lsa `common.yaml` ga faqat QO'SHIMCHA — breaking change YO'Q). Kontrakt backend, web va (kelajakda 06_orders) uchun yagona kelishuv nuqtasi. Muzlatilgach `git commit` bilan qotiriladi (`git add` YETARLI EMAS — EP-07 da indeksdagi kontrakt `git stash` bilan yo'qolgan). Mock `:4010` da ko'tariladi — web coder'lari DB'ni kutmasdan shunga uradi.

Texnik ko'rsatma

Agent uchun

Qamrab olinadigan operatsiya guruhlari (spec §8 UC1–UC5 dan): * Mijozlar: ro'yxat (filtr: `active`, `sector_id`, qidiruv nom/telefon; sahifalash), kartochka, yaratish, tahrir, `active` toggle. * Shartnomalar: versiyalar ro'yxati (tarix), yangi versiya yaratish, bekor qilish (sabab majburiy), shartnoma PDF imzolangan havolasi. * Hujjatlar: yuklash (multipart, R42 proxy), ro'yxat, imzolangan havola, soft-delete. * Yuk node'lari: mijoz node'lari ro'yxati, biriktirish, olib tashlash. * Akkaunt: mijozga login berish, uzish. Xato modeli va `fields` semantikasi — `common.yaml` dagi mavjud naqsh (`400`/`403`/`404`/`409`/`422`). 🔴 06_orders operatsiyalari (buyurtma, narx turi tanlash, ombor hosilasi) bu kontraktga KIRMAYDI.

Qabul mezonlari (DoD)

0 / 4 bajarildi

  • `openapi/v1/customers.yaml` `swagger` skill standarti bo'yicha yozilgan va lint toza

  • `common.yaml` ga faqat qo'shimcha kiritilgan — mavjud sxema/operatsiya o'zgarmagan (breaking change yo'q)

  • Kontrakt `git commit` bilan muzlatilgan (indeksda qolmagan)

  • Mock `:4010` da ko'tariladi va har operatsiya namuna javob qaytaradi

Izoh qoldirish

Tarix

8 yozuv

  • 💬

    finalize-ep-08 izoh qoldirdi

    finalize-EP-08 drift tekshiruvi (HEAD 2f6bcb3, jonli ilova HEAD jar'idan, prism mock o'chirilgan): A (bloklovchi) toifasi BO'SH — yo'l qo'shilishi/o'chishi yo'q (kontraktdagi 13 yo'lning hammasi amalga oshirilgan), tip o'zgarishi yo'q, so'rovda yangi `required` yo'q. Mavjud 6 modul gate'i exit 0, ratchet buzilmagan. Ikki narsa QARORGA qoldirildi (finalize o'zi hal qilmadi): 1. `openapi/drift-baseline.json` da `customers` satri YOZILMADI va CI MODULES ro'yxatiga `customers` qo'shilmadi — ya'ni CI bu modulni hozircha tekshirmaydi. Sabab: baseline yozish 2-bandni qabul qilingan shovqin sifatida abadiy muzlatib qo'yardi. 2. `DocumentType` global sxema nomi to'qnashuvi: suppliers.yaml (`identity|other`) va customers.yaml (`passport|receipt_note|other`) bir nomni ishlatadi; springdoc birlashtirgan hujjatda suppliers varianti g'olib. Runtime to'g'ri (POST /customers/{id}/documents inline enum passport|receipt_note|other), ta'sir faqat generatsiya qilingan hujjat nomlar fazosida. Yechim kontrakt nomlash qarori (CROSS_CUTTING K) — kod tuzatilmadi. 3 ta "yangi weaker" fingerprint tekshirildi va artefakt ekani tasdiqlandi: `reason` maydonida kodda @NotBlank + @Size(max=500) BOR (springdoc @NotBlank uchun minLength chiqarmaydi), `sort` pattern esa oldingi 6 modulda allaqachon qabul qilingan aynan o'sha artefakt. Ya'ni kod kontraktdan zaif emas. PR: https://github.com/AbdullayevDilshodbek/erpbom-backend/pull/11

  • ✎

    finalize-ep-08 yangiladi

    Yangilandi: branch, commit_sha, pr_url

  • ⇄

    team-lead-pm statusni o'zgartirdi Review → Bajarildi

    Kontrakt tasdiqlandi: openapi/v1/customers.yaml (19 endpoint, 18 sxema), commit e114543. Lead tekshiruvi: commit qamrovi toza, common.yaml tegilmagan, customers/me yoqligi 10-bolimga mos. 3 ta doc qarzi qayd etildi: deleted_at, cancel_reason, re-print.

  • 💬

    contract-ep-08 izoh qoldirdi

    Kontrakt muzlatildi: openapi/v1/customers.yaml — 19 endpoint / 18 sxema / 7 modul-xos javob, 10 nomlangan xato kodi. Commit e114543 (feat/EP-08-erpbom-backend), common.yaml TEGILMADI (breaking change yo'q). Lint (redocly): faqat security-defined (bearerAuth common.yaml da) + info-license — barcha muzlatilgan modul kontraktlarida bir xil; suppliers baseline'idan toza. Mock :4010 da ishlayapti, 19/19 operatsiya namuna javob qaytardi.

  • ⇄

    contract-ep-08 statusni o'zgartirdi Ishlanyapti → Review

  • ⇄

    contract-ep-08 statusni o'zgartirdi Backlog → Ishlanyapti

    Agent ishni boshladi

  • ⚑

    contract-ep-08 ishga oldi

  • ✦

    pm-agent yaratdi

    OpenAPI kontrakt — 05_customers (muzlatish)

Ma'lumot

Agent
contract-ep-08
Olingan
1 о аввал
Boshlandi
26.08.2026 19:46
Tugadi
26.08.2026 20:01
Baho
6 soat
Spec
erp/docs/modules/05_customers.md
Branch
feat/EP-08-erpbom-backend
Commit
e114543
Pull request →

Bog'liqliklar

Agent uchun

Bu ishni AI agent quyidagicha oladi:

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

Tugatgach:

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