15-amaliy mashg‘ulot · 15-mavzu · 2 soat · Korxona ilovalarini dasturlash
Jamoa loyihasi (OmborPro) bosqichi, 5 ta amaliy PHP topshiriq va 3 ta ma’ruzadagi mashq. Yo‘riqnoma bo‘yicha loyihada ishlang, havolani topshiring va PHP topshiriqlarni yeching — server yashirin testlar bilan tekshiradi, o‘qituvchi baho qo‘yadi.
v1.0.0 relizini: CHANGELOG, izohli git teg, GitHub Release va ishlayotgan production URL20 daqiqalik reglament · hujjatlar to‘plami · v1.0.0
Yakuniy himoya jamoa bo‘lib o‘tkaziladi, har bir jamoaga taxminan 20 daqiqa beriladi. Reglament: 2 daqiqa — muammo va maqsad (qaysi korxona, qaysi jarayon avtomatlashtirildi); 3 daqiqa — arxitektura (modullar, ER-sxema, asosiy ADR lar); 8 daqiqa — jonli demo rollar bo‘yicha; 3 daqiqa — sifat va ekspluatatsiya (testlar, CI, monitoring, zaxira nusxa); 4 daqiqa — komissiya savollari. Vaqtni bitta a’zo nazorat qiladi; har bir a’zo kamida bitta qismni taqdim etadi.
1-qadam: hujjatlar to‘plamini yig‘ing. Repozitoriy ildizida README.md (tavsif, texnologiyalar, Docker bilan ishga tushirish, testlar, muhit o‘zgaruvchilari, deploy), CHANGELOG.md (Keep a Changelog), docs/adr/ (kamida 3 ta ADR), docs/user-guide/ (to‘rt rol uchun qo‘llanma), docs/runbook.md (kamida 3 ta hodisa ssenariysi) va Scribe bilan generatsiya qilingan API hujjati bo‘lsin. Har bir hujjat alohida PR orqali qo‘shiladi va boshqa a’zo tomonidan ko‘rib chiqiladi.
2-qadam: relizni tayyorlang. [Unreleased] bo‘limini ## [1.0.0] - sana ga aylantiring, barcha tekshiruvlarni (Pint, Larastan, Pest, composer audit) lokal va CI da o‘tkazing, v1.0.0 izohli tegni qo‘ying va GitHub Release yarating. Release tavsifida: asosiy imkoniyatlar, production URL, demo foydalanuvchilar (parollarsiz — ular komissiyaga alohida beriladi), hujjatlar havolalari va ma’lum cheklovlar.
3-qadam: production ni tekshiring. /up 200 qaytaradi, /docs ochiladi, har bir rol bilan kirib asosiy jarayonni bir marta oxirigacha bajaring. Demo ma’lumotlari uydirma bo‘lsin (OmborPro misolidagi UN-001, TSH-1, BY-2026-000123 kabi), lekin realistik: 20–50 mahsulot, 2 ombor, bir nechta kontragent va turli holatdagi buyurtmalar.
| Qism | Vaqt | Nima ko‘rsatiladi |
|---|---|---|
| Muammo va maqsad | 2 daq | Korxona, jarayon, foydalanuvchilar, asosiy talablar |
| Arxitektura | 3 daq | Modullar, ER-sxema, 2–3 ta asosiy ADR |
| Jonli demo | 8 daq | Menejer → omborchi → buxgalter → hisobot; biznes-qoidalar |
| Sifat va ekspluatatsiya | 3 daq | CI, test qamrovi, Sentry/loglar, zaxira nusxa |
| Savol-javob | 4 daq | Har bir a’zo o‘z qismi bo‘yicha javob beradi |
| Fayl | Minimal tarkib | Tekshiruv |
|---|---|---|
README.md | Tavsif, ishga tushirish, testlar, .env, deploy | Yangi odam 30 daqiqada ko‘taradi |
CHANGELOG.md | [Unreleased], [1.0.0] - sana, toifalar | Keep a Changelog formati |
docs/adr/*.md | Kamida 3 ta: Kontekst, Qaror, Oqibatlar | Holati ko‘rsatilgan |
| API hujjati | Scribe: guruhlar, parametrlar, misollar | /docs ochiladi |
docs/user-guide/ | 4 rol: vazifalar, qadamlar, skrinshotlar | Texnik atamalarsiz |
docs/runbook.md | Kamida 3 hodisa: navbat, disk, tiklash | Buyruqlar tayyor |
v1.0.0 teg holatida repozitoriyda bo‘lishi kerak.# Hujjatlar joyidami? ls README.md CHANGELOG.md docs/adr docs/user-guide docs/runbook.md # API hujjati yangilanganmi? php artisan scribe:generate && git status --short # Teg va Release git tag --list "v1.*" gh release view v1.0.0 --json tagName,url # Production sog‘mi? curl -fsS -o /dev/null -w "%{http_code}\n" "$APP_URL/up"
v1.0.0
{"tagName":"v1.0.0","url":"https://github.com/jamoa/omborpro/releases/tag/v1.0.0"}
200git status --short — generatsiyadan keyin o‘zgarish chiqsa — hujjat eskirgan edicurl -w — faqat HTTP kodni chiqaradi; -f xato kodda muvaffaqiyatsiz tugaydiMezonlar va ballar · PR bo‘yicha tushuntirish · individual hissa
Loyiha 100 ballik shkala bo‘yicha baholanadi (pastdagi jadval). Ballarning katta qismi ishlaydigan funksionallik va kod sifatiga beriladi, lekin hujjatlar, joriy etish va jamoaviy ish ham alohida baholanadi — korxonada ham tizim faqat “ishlashi” bilan emas, qo‘llab-quvvatlanishi bilan qadrlanadi. Jamoaviy ball umumiy, individual ball esa har bir a’zoning kod tahlili va savollarga javobi asosida tuzatiladi.
Kod tahlili (code review) qismida har bir a’zo o‘zi muallifi bo‘lgan bitta muhim PR ni 2–3 daqiqada tushuntiradi: qaysi muammoni hal qildi, qaysi fayllar o‘zgardi, qaysi test yozildi va review jarayonida nima o‘zgartirildi. PR oldindan tanlanadi va uning havolasi Release tavsifiga qo‘shiladi. Komissiya kodning ixtiyoriy qatori haqida so‘rashi mumkin — shuning uchun “AI yozib berdi” yoki “ko‘chirib oldim” degan qism qolmasligi kerak.
Tushuntirishda “nima” emas, “nega” ga urg‘u bering: nega DB::transaction shu yerda, nega lockForUpdate, nega bu validatsiya qoidasi FormRequest da, nega bu so‘rovga indeks qo‘shildi. Yaxshi javob aniq faylga, testga yoki ADR ga tayanadi. Agar biror narsa qilinmagan bo‘lsa, buni yashirmang — ma’lum cheklov va uni hal qilish rejasi (v1.1 backlog i) halol aytilsa, bu ham baholanadi.
| Mezon | Ball | Nima tekshiriladi |
|---|---|---|
| Funksionallik va jonli demo | 30 | To‘liq jarayon, biznes-qoidalar, 4 rol |
| Arxitektura va kod sifati | 20 | Servis qatlami, tranzaksiyalar, Pint/Larastan, ADR |
| Testlar va CI | 15 | Pest: biznes-qoidalar va API, CI yashil |
| Hujjatlar | 10 | README, ADR, OpenAPI, qo‘llanma, CHANGELOG |
| Joriy etish va ekspluatatsiya | 10 | Production URL, /up, loglar, zaxira |
| Kod tahlili va savollar | 10 | Har a’zo o‘z PR ini tushuntiradi |
| Jamoaviy ish va retrospektiva | 5 | PR tarixi, review lar, docs/retro.md |
StockService::reserve, lockForUpdateStart/Stop/Continue · 4L · jamoa metrikalari · demo zaxirasi
Retrospektiva — jamoa 15 hafta davomida qanday ishlaganini tahlil qilish. Eng oddiy format — Start / Stop / Continue: nimani boshlashimiz kerak, nimani to‘xtatishimiz kerak, nima yaxshi ishladi va davom ettiramiz. Muqobil format — 4L: Liked (yoqdi), Learned (o‘rgandik), Lacked (yetishmadi), Longed for (orzu qildik). Retrospektiva ham aybsiz o‘tkaziladi: “kim aybdor” emas, “jarayonda nima yetishmadi” deb so‘raladi.
Fikrlarni raqamlar bilan qo‘llab-quvvatlang: birlashtirilgan PR lar soni va o‘rtacha review vaqti, test qamrovi, CI muvaffaqiyatsiz tugash ulushi, rejalashtirilgan va bajarilgan user story lar, production dagi hodisalar soni. Bu metrikalar GitHub (Insights, Actions), Pest coverage va Sentry dan olinadi. Natija docs/retro.md faylida yoziladi va v1.1 uchun 3–5 ta aniq vazifa (mas’ul bilan) bilan tugaydi.
Zaxira reja himoyadan bir kun oldin tekshiriladi. Jonli demo eng ishonchli dalil, lekin internet, server yoki proyektor ishlamay qolishi mumkin. Shuning uchun: lokal Docker stek (docker compose up) va seed ma’lumotlar, 3–5 daqiqalik demo video (butun jarayon), asosiy ekranlar skrinshotlari va barcha havolalar bitta sahifada. Demo bazani tiklash buyrug‘i faqat lokal yoki demo muhitda ishlatiladi.
main ga to‘g‘ridan-to‘g‘ri push.# OmborPro v1.0.0 retrospektivasi (2026-12-21) ## Metrikalar - PR: 64 ta, o'rtacha review vaqti 9 soat - Test qamrovi: 78 %, CI muvaffaqiyatsiz: 11 % - User story: 31 rejalashtirilgan, 27 bajarilgan ## Start - Har bir PR da Pest testi majburiy ## Stop - main ga to'g'ridan-to'g'ri push ## Continue - Har hafta demo va kod tahlili ## v1.1 vazifalari - [ ] Hisobotlarni navbatga o'tkazish (mas'ul: A.) - [ ] Runbook: zaxiradan tiklashni sinash (mas'ul: B.)
docs/retro.md — v1.0.0 teg ichida, Release tavsifida havola
Start/Stop/Continue — har birida 1–3 ta aniq fikrdocker compose up -d, seed ma’lumotlarNatija: jamoa OmborPro ning v1.0.0 relizini ishlayotgan URL, to‘liq hujjatlar to‘plami va jonli demo bilan himoya qiladi; har bir a’zo o‘z hissasini kod tahlili orqali tushuntiradi va retrospektiva hujjati topshiriladi.
v1.0.0 teg va Release bor; CHANGELOG da [1.0.0] bo‘limi Keep a Changelog formatida/up 200 qaytaradi; to‘rt rol uchun demo foydalanuvchilar tayyordocs/adr/ da kamida 3 ta ADR (Holat, Kontekst, Qaror, Oqibatlar)/docs da ochiladi; foydalanuvchi qo‘llanmasi to‘rt rolni qamraydimain da CI yashil (Pint, Larastan, Pest); har bir a’zoning kamida bitta ko‘rib chiqilgan PR i bordocs/retro.md: Start/Stop/Continue (yoki 4L), metrikalar va v1.1 uchun 3–5 vazifa📤 GitHub Release havolasi (.../releases/tag/v1.0.0) va production URL. Release tavsifida hujjatlar, demo video (zaxira) va har bir a’zoning tanlangan PR havolalari ko‘rsatilsin.
Qanday ishlaydi. Chapdan topshiriqni tanlang, shartni o‘qing va shartdagi imzo bo‘yicha sof PHP funksiya yoki sinf yozing (Laravelsiz). ▶ Sinab ko‘rish — pastdagi chaqiruv ifodasini kodingiz bilan bajaradi (baholanmaydi). ✓ Topshirish — server kodni namunaviy va yashirin testlar bilan tekshiradi; natija o‘qituvchiga ko‘rinadi.