Loyiha xartiyasi: jamoa, soha, backlog va ER-sxema
Amaliy mashg‘ulot oxirida siz quyidagilarni bajara olasiz...
Qanday bajariladi va qanday baholanadi?
Ish tartibi
- Saytga login va parolingiz bilan kiring: emro.uz/korxona/kirish.html
- 1-amaliy sahifasini oching (oxirgi slayddagi QR kod).
- Yo‘riqnoma bo‘yicha jamoa loyihasida bosqichni bajaring, commit va push qiling.
- PHP topshiriqlarni yeching: ▶ Sinab ko‘rish → ✓ Topshirish (yashirin testlar).
- Loyiha havolasini (GitHub repo, PR yoki tag) topshiring — o‘qituvchi baho qo‘yadi.
Baholash mezonlari
- Natija — loyiha bosqichi mezonlar ro‘yxati bo‘yicha bajarilgan.
- Topshiriqlar — PHP topshiriqlar testlardan o‘tgan.
- Kod sifati — tushunarli nomlar, PSR-12, kichik va mazmunli commitlar.
- Jamoaviy hissa — har bir a’zo o‘z qismini tushuntira oladi; ko‘chirilgan ish baholanmaydi.
- Muddat — muddatdan keyin topshirilgan ish “kechikkan” deb belgilanadi.
Jamoa, soha va loyiha xartiyasi
Loyiha xartiyasi bo‘limlari
| Bo‘lim | Savol | OmborPro misoli |
|---|---|---|
| Maqsad | Kim uchun, qanday muammo? | Ulgurji firma qoldiq va buyurtmalarni bitta tizimda yuritadi |
| Ko‘lam: kiradi | Qaysi jarayonlar? | Katalog, ombor, buyurtma, hisob-faktura, to‘lov, hisobot |
| Ko‘lam: kirmaydi | Nimani ataylab qilmaymiz? | Ish haqi, ishlab chiqarish, mobil ilova |
| Rollar | Kim foydalanadi? | admin, menejer, omborchi, buxgalter |
| Xavflar | Nima xalaqit berishi mumkin? | Docker tajribasi yo‘q → 2-haftada birga sozlash |
| Mezonlar | Muvaffaqiyatni qanday o‘lchaymiz? | Buyurtma oqimi testlar bilan qoplangan, demo ishlaydi |
Xartiya fayli namunasi
# OmborPro — loyiha xartiyasi Jamoa: "Ombor-3" (sardor: A., backend: B., UI: C., QA/DevOps: D.) Maqsad: ulgurji firma qoldiq, buyurtma va to‘lovlarni bitta tizimda yuritadi; qoldiq hech qachon manfiy bo‘lmaydi. Kiradi: katalog, kontragentlar, ombor, buyurtma, hisob-faktura, to‘lov, hisobotlar, import, audit. Kirmaydi: ish haqi, ishlab chiqarish, mobil ilova. Rollar: admin, menejer, omborchi, buxgalter. Xavflar: Docker tajribasi kam -> 2-hafta juft dasturlash. Mezonlar: buyurtma oqimi Pest testlari bilan, demo 10 daqiqa.
docs/CHARTER.md — repozitoriyda, birinchi PR bilan qo‘shiladi
Mashg‘ulotning birinchi yarmi
10 daqiqa
15 daqiqa
25 daqiqa
10 daqiqa
User stories, modullar va backlog
Yomon va yaxshi user story
Noto‘g‘ri
- “products jadvalini yaratish” — texnik vazifa
- “Tizim qulay bo‘lsin” — tekshirib bo‘lmaydi
- “Butun ombor moduli” — juda katta
- Rol va foyda ko‘rsatilmagan
To‘g‘ri
- Men omborchi sifatida kirimni skaner bilan kiritishni xohlayman, toki qoldiq aniq bo‘lsin
- Qabul mezoni: Given / When / Then
- Baho: 3 ball, bir haftada bajariladi
- Modul: Ombor, ustuvorlik: Must
MoSCoW bo‘yicha saralangan backlog (parcha)
| ID | Story (qisqa) | Modul | MoSCoW / ball |
|---|---|---|---|
| US-01 | Menejer buyurtma yaratadi | Savdo | Must / 5 |
| US-02 | Menejer buyurtmani tasdiqlaydi va rezerv qiladi | Savdo, Ombor | Must / 8 |
| US-03 | Omborchi kirim kiritadi | Ombor | Must / 3 |
| US-04 | Buxgalter hisob-faktura chiqaradi | Moliya | Must / 5 |
| US-05 | Buxgalter debitorlik hisobotini ko‘radi | Hisobotlar | Should / 5 |
| US-06 | Admin mahsulotlarni Excel dan import qiladi | Katalog | Should / 5 |
| US-07 | Menejer mijozga PDF hisob-faktura yuboradi | Moliya | Could / 3 |
| US-08 | Mobil ilova | — | Won’t / — |
Story Issue sifatida
Sarlavha: US-02 Buyurtmani tasdiqlash va rezerv Label: must, savdo, ombor Baho: 8 Men menejer sifatida buyurtmani tasdiqlashni xohlayman, toki tovar mijoz uchun band qilinsin. Qabul mezonlari: - Given: UN-001 mavjud qoldig‘i 10, buyurtmada 4 dona When: menejer "Tasdiqlash" ni bosadi Then: holat reserved, stocks.reserved +4, jurnalda 'reserve' - Given: mavjud qoldiq 3, buyurtmada 5 dona When: tasdiqlash Then: xato xabari, holat va qoldiq o‘zgarmaydi
Issue #12 yaratildi → doskada “Todo” ustunida
ER-sxema, GitHub repozitoriysi va loyiha doskasi
Atributlari bilan ER-sxema (parcha)
```mermaid erDiagram PRODUCTS { bigint id PK string sku UK "UN-001" string name bigint category_id FK decimal price "14,2" } STOCKS { bigint warehouse_id FK bigint product_id FK int quantity int reserved } PRODUCTS ||--o{ STOCKS : "qoldiqlar" ```
GitHub fayl sahifasida jadvallar va bog‘lanishlar rasm bo‘lib chiziladi
Repozitoriy, label va Issue
gh repo create ombor-3/omborpro --private --clone cd omborpro mkdir docs && touch docs/CHARTER.md docs/er.md git add . && git commit -m "docs: xartiya va ER-sxema" git push -u origin main gh label create must --color B60205 gh issue create --title "US-02 Buyurtmani tasdiqlash" \ --label must --body-file docs/stories/us-02.md gh project create --owner ombor-3 --title OmborPro
✓ Created repository ombor-3/omborpro on GitHub https://github.com/ombor-3/omborpro/issues/12 https://github.com/orgs/ombor-3/projects/1
Loyiha doskasi ustunlari
Backlog
Todo
In progress
Review
Done
Natija va topshirish
Baholash mezonlari
docs/CHARTER.md: maqsad, ko‘lam (kiradi / kirmaydi), rollar, xavflar va o‘lchanadigan mezonlar bor- Kamida 15 ta user story Issue: “Men … sifatida … xohlayman, toki …” formatida, ID va label bilan
- Har bir Must story da kamida bitta ijobiy va bitta salbiy Given/When/Then qabul mezoni bor
- Backlog MoSCoW bo‘yicha saralangan va story ballari qo‘yilgan; Must ulushi taxminan 60 % dan oshmaydi
docs/er.mdda Mermaid ER-sxema: kamida 8 jadval, PK/FK/UK, kardinallik, pul ustunlari decimal- GitHub Projects doskasi: Backlog, Todo, In progress, Review, Done ustunlari, birinchi hafta vazifalari Todo da
maintarmog‘i himoyalangan, barcha jamoa a’zolari Collaborator sifatida qo‘shilgan
4-topshiriq: SKU ni normallashtirish
Katalog qoidasi: SKU — aniq 2 ta katta lotin harfi, chiziqcha va aniq 3 ta raqam (UN-001). Excel dan kelgan qiymatlar esa turlicha: ' un-7 ', 'Un-12'. Normallashtiring: chetdagi bo‘sh joylarni olib tashlang, harflarni katta qiling, raqam qismini chapdan 0 bilan 3 xonagacha to‘ldiring. Kirish 2 harf, chiziqcha va 1–3 raqamdan iborat bo‘lmasa (3 harf, 4 raqam, boshqa belgi, bo‘sh satr) — InvalidArgumentException.
Imzo: function sku_normallashtir(string $sku): string
Qaytaradi: Normallashtirilgan SKU satri, masalan 'UN-007'.
sku_normallashtir(' un-7 ')"UN-007"
5-topshiriq: User story tahlili
User story Men <rol> sifatida <harakat> xohlayman, toki <foyda>. formatida yoziladi. Matndan uch qismni ajrating. So‘zlar orasida bir nechta bo‘sh joy bo‘lishi mumkin, matn boshi va oxiridagi bo‘sh joylar hamda oxiridagi nuqta hisobga olinmaydi; Men so‘zi kichik harf bilan ham yozilishi mumkin. Format mos kelmasa yoki biror qism bo‘sh bo‘lsa — InvalidArgumentException.
Imzo: function story_tahlil(string $matn): array
Qaytaradi: ['rol' => string, 'harakat' => string, 'foyda' => string] — shu tartibda; ichki ortiqcha bo‘sh joylar bittaga qisqartiriladi.
story_tahlil('Men menejer sifatida buyurtmani tasdiqlashni xohlayman, toki tovar band qilinsin.'){"rol":"menejer","harakat":"buyurtmani tasdiqlashni","foyda":"tovar band qilinsin"}6-topshiriq: Backlog ni MoSCoW bo‘yicha saralash
Backlog elementlari ['id' => 'US-03', 'moscow' => 'must', 'ball' => 5] ko‘rinishida. Saralash tartibi: avval moscow (must → should → could → wont), bir xil guruhda — ball o‘sish tartibida (kichik story oldin), ular ham teng bo‘lsa — id bo‘yicha alifbo tartibida. moscow qiymati noma’lum bo‘lsa — InvalidArgumentException.
Imzo: function backlog_tartibla(array $stories): array
Qaytaradi: Saralangan id lar ro‘yxati (list<string>).
backlog_tartibla([['id' => 'US-01', 'moscow' => 'should', 'ball' => 3], ['id' => 'US-02', 'moscow' => 'must', 'ball' => 8], ['id' => 'US-03', 'moscow' => 'must', 'ball' => 2]])
["US-03","US-02","US-01"]
7-topshiriq: Backlog ni sprintlarga bo‘lish
Saralangan backlog (['id' => ..., 'ball' => int, 'moscow' => ...]) va bitta sprint sig‘imi (ballarda) berilgan. Story lar tartib bilan sprintlarga joylanadi: joriy sprintga sig‘sa (yig‘indi + ball ≤ sig‘im) — shu sprintga, aks holda yangi sprint ochiladi; tartib o‘zgarmaydi. wont story lar o‘tkazib yuboriladi. sig‘im ≤ 0 — InvalidArgumentException; biror story balli sig‘imdan katta bo‘lsa (uni bo‘lish kerak) — DomainException.
Imzo: function sprintlarga_bol(array $stories, int $sigim): array
Qaytaradi: Sprintlar ro‘yxati: har biri ['ids' => list<string>, 'ball' => int]. Story bo‘lmasa — [].
sprintlarga_bol([['id' => 'US-01', 'ball' => 5, 'moscow' => 'must'], ['id' => 'US-02', 'ball' => 3, 'moscow' => 'must'], ['id' => 'US-03', 'ball' => 5, 'moscow' => 'should']], 8)
[{"ids":["US-01","US-02"],"ball":8},{"ids":["US-03"],"ball":5}]8-topshiriq: Loyiha doskasi va WIP limiti
Doska sinfi ustunlari: backlog → todo → progress → review → done. qosh($id) story ni backlog ga qo‘shadi (takroriy id — DomainException). kochir($id, $ustun) story ni faqat qo‘shni ustunga (bir qadam oldinga yoki orqaga) ko‘chiradi; done dan chiqib bo‘lmaydi; progress dagi story lar soni WIP limitiga yetgan bo‘lsa, unga qo‘shib bo‘lmaydi — bu hollarda DomainException. Noma’lum id yoki ustun — InvalidArgumentException. ustun($nom) — shu ustundagi id lar (kelish tartibida), holat() — har bir ustundagi soni.
Imzo: final class Doska
Qaytaradi: ustun() — list<string>; holat() — ['backlog' => int, 'todo' => int, 'progress' => int, 'review' => int, 'done' => int].
(function () { $d = new Doska(2); $d->qosh('US-01'); $d->qosh('US-02'); $d->kochir('US-01', 'todo'); return $d->holat(); })(){"backlog":1,"todo":1,"progress":0,"review":0,"done":0}