Task EP-07-T00 Kritik 07_tasks erpbom-backend api

OpenAPI kontrakt — 07_tasks (muzlatish)

Bajarildi

Status:

Tavsif

Kontrakt agenti (contract-freeze) yozadi: `openapi/v1/tasks.yaml`. Qamrov: * **Ishlab chiqarish sikli** — ro'yxat (filtr: `status`, `organization_id`, `product_variant_id`, `origin`, `order_id`), kartochka (marshrut DAG'i + har operatsiya taskining holati va progressi), **qo'lda yaratish** (UC2: variant + qty + org-node), **bekor qilish** (alohida yo'l). * **Task** — ro'yxat (filtr: `status`, `profession_id`, `production_run_id`, `task_type`; hodim uchun "menga tegishli" rejimi), kartochka (works ro'yxati bilan), gating ko'rsatkichi (`waiting_for_predecessors: true|false`). * **Work (hodim)** — brom (`claim`: `task_id` + `qty`), topshirish (`submit`: `production_date`), **rework** qayta topshirish (alohida yo'l — `work.rework`), o'z ishlarim ro'yxati. * **Work (nazoratchi)** — tekshiruv navbati (`submitted` works), **review** (`confirmed_qty` + `is_brak` + `reject_reason`; bitta yo'l uch natijani qamraydi: to'liq/qisman tasdiq va rad), **void** (alohida yo'l). * **Xarajat tafsiloti (UC9)** — partiya (`stock_batch_id`) yoki sikl bo'yicha operatsiya kesimi: material, ishbay, brak yo'qotishi, jami `unit_cost`. * **Taxminiy ish haqi** (R26/Q13) — submit javobida yoki alohida o'qish yo'lida `estimated_amount` (yozuvsiz, "taxminiy" belgisi bilan). 🔴 Kontraktga KIRMAYDI: `picking` oqimi (06_orders), netting, buyurtma holati, notification kanali, hisobotlar.

Qabul mezonlari (DoD)

0 / 5 bajarildi

`openapi/v1/tasks.yaml` `common.yaml` komponentlarini qayta ishlatadi (xato formati, sahifalash, `ErrorResponse`) — dublikat sxema yozilmaydi
Har operatsiyada `x-required-permission` (yoki mavjud konvensiya) bilan rule kodi ko'rsatilgan: `work.claim`, `work.submit`, `work.rework`, `work.review`, `work.void`, `production_run.create`, `production_run.cancel`, `task.create`, `production_cost.view`
Pul va miqdor maydonlari string decimal sifatida e'lon qilingan (mavjud kontrakt qoidasi)
`swagger` skill standarti bo'yicha lint toza; `git add` bilan muzlatilgan; mock (:4010) ko'tarilib javob beradi
Kontraktda `picking` ga oid birorta operatsiya YO'Q (06_orders qamrovi)

Izoh qoldirish

Tarix

10 yozuv

✎

finalize-ep-07 yangiladi

Yangilandi: commit_sha

1 о аввал
✎

finalize-ep-07 yangiladi

Yangilandi: branch, pr_url

1 о аввал
💬

unknown-agent izoh qoldirdi

[lead/EP-07-T04-S04 QA dan] KONTRAKT QARZI: `POST /works/{id}/review` uchun `409 SOURCE_WAREHOUSE_MISSING` javobi kod tomonidan qaytariladi, lekin muzlatilgan `openapi/v1/tasks.yaml` da hujjatlanmagan. Epic yakunlanishida (drift gate / oasdiff) yoki keyingi kontrakt tuzatishida qo'shilsin.

1 о аввал
💬

contract-ep-07 izoh qoldirdi

KONTRAKT TUZATISHI 2026-08-25 (foydalanuvchi biznes qarori, contract-freeze.md 'Kontrakt o'zgarishi' §2 tartibi). Nima: POST /api/v1/production-runs ga 409 VARIANT_ARCHIVED qo'shildi — arxivlangan (active=false) variantga sikl ochish fail-fast bloklanadi. Uch joy yangilandi: (1) header xato katalogi — VARIANT_ARCHIVED endi ikki gate uchun; (2) createProductionRun description — eski 'BLOKLANMAYDI' matni olib tashlandi, sabab izohi yozildi; (3) ProductionRunCreateConflict — bullet + 'archived' misoli. production_in gate'i (works/{id}/review) o'zgarmadi. Yangi kod QO'SHILMADI (VARIANT_ARCHIVED qayta ishlatildi) — jami 11 yangi + 4 qayta ishlatilgan saqlanib qoldi. git add bajarildi (qayta muzlatildi), mock :4010 qayta yuklandi va 409 misoli tekshirildi. Xabardor qilindi: T02-S02 (AC3202 unblock kutmoqda), T03, T08.

1 о аввал
⇄

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

Kontrakt qabul qilindi: openapi/v1/tasks.yaml (15 endpoint / 23 sxema), yo'l prefiksi va x-required-permission konvensiyasi boshqa modullar bilan mos, mock :4010 200 qaytardi.

1 о аввал
⇄

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

1 о аввал
💬

contract-ep-07 izoh qoldirdi

KONTRAKT MUZLATILDI — openapi/v1/tasks.yaml (15 endpoint, 13 path item, 23 sxema). common.yaml komponentlari $ref bilan (ErrorResponse / Page / bearerAuth / page-size-sort) — dublikat sxema yo'q. Rule kodi `summary` konvensiyasida (5 ta muzlatilgan yaml bilan izchil). x-required-permission ATAYLAB yozilmadi: scripts/openapi-diff.sh ratchet'i springdoc chiqarmaydigan har qo'shimcha kalitni 'other' toifasida sanaydi — 15 operatsiyaga qo'shilgan kengaytma drift gate'ini (kod 7) yiqitardi. Mock :4010 ✓ (15 yo'l yuklandi, javoblar sxemaga mos). SPEC BO'SHLIQLARI — kontraktda ataylab YO'Q (to'qib yozilmadi; erp/ §5 sikli yopadi): 1) `task.create` rule'i uchun endpoint yozilmadi. 07 §7 jadvalida 'Qo'lda task yaratish — task.create' qatori bor (09_auth katalogida ham), lekin amalning SHAKLI spec'da hech qayerda yo'q: qaysi siklga, qaysi operatsiyaga, required_qty qayerdan, gating bilan munosabati. UC2 esa SIKL yaratadi (production_run.create). Qolgan 8 rule to'liq qoplangan. 2) 07 da o'qish (*.view) rule'i yo'q: 09_auth katalogida 07 uchun aynan 9 kod bor, ulardan yagona o'qish kodi — production_cost.view (UC9). Shuning uchun sikl/task/work o'qish yo'llari rule TALAB QILMAYDI — autentifikatsiya + org-node doirasi, /works/me da esa EGALIK (warehouse.yaml PurchaseReceiptsSelfService naqshi). Biznes bu o'qishlarni rule bilan yopmoqchi bo'lsa — katalogga yangi kod kerak (spec o'zgarishi). 3) Sikl bekor qilinganda DAVOM ETAYOTGAN (claimed/submitted/rejected) works taqdiri spec'da ochiq qoldirilgan (§9 cascade: '06/07 chegarasi', Q8) — shuning uchun POST /production-runs/{id}/cancel javobida hujjatlanmadi. Kodlovchi agentlar uchun muhim qarorlar: brom = POST /works (201, yangi works qatori); holat o'tishi har doim alohida POST yo'li (status DTO'larda yo'q); rework alohida yo'l (work.rework rule'i work.submit dan ajratilgan); review BITTA yo'l — uch natija (confirmed_qty + is_brak + reject_reason); hodim rejimi GET /tasks?mine=true (moslik filtri), GET /works/me (egalik); 11 yangi + 4 qayta ishlatilgan modul-xos xato kodi (ro'yxati yaml boshida).

1 о аввал
⇄

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

Agent ishni boshladi

1 о аввал
⚑

contract-ep-07 ishga oldi

1 о аввал
✦

pm-agent yaratdi

OpenAPI kontrakt — 07_tasks (muzlatish)

1 о аввал

Ma'lumot

Agent: contract-ep-07
Olingan: 1 о аввал
Boshlandi: 25.08.2026 08:53
Tugadi: 25.08.2026 09:33
Baho: 6 soat
Spec: erp/docs/modules/07_tasks.md
Branch: feat/EP-07-erpbom-backend
Commit: f07cd73

Bog'liqliklar

Bundan oldin tugashi kerak

Yo'q — bu ish mustaqil.

Buni kutayotganlar

Agent uchun

Bu ishni AI agent quyidagicha oladi:

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

Tugatgach:

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