Yakuniy loyiha himoyasi
Amaliy mashg‘ulot oxirida siz quyidagilarni bajara olasiz...
v1.0.0 relizini: CHANGELOG, izohli git teg, GitHub Release va ishlayotgan production URLQanday bajariladi va qanday baholanadi?
Ish tartibi
- Saytga login va parolingiz bilan kiring: emro.uz/korxona/kirish.html
- 15-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.
Himoya formati va reliz
Himoya: ~20 daqiqa
| 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 |
Himoyaga olib kelinadigan hujjatlar to‘plami
| 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.Himoyadan oldingi kun: tezkor tekshiruv
# 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"}
200-f xato kodda muvaffaqiyatsiz tugaydiBaholash mezonlari va kod tahlili
Mezonlar va ballar (100 ball)
| 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 |
O‘z PR ingizni qanday tushuntirasiz
1Muammo
2Yechim
3Nega shunday
4Testlar
5Review
Komissiya savoliga javob
✗ Zaif javob
- “Laravel o‘zi qiladi”
- “Buni boshqa a’zo yozgan”
- “Ishlaydi-ku” — testsiz
- Xatoni yashirish yoki mavzuni chetlab o‘tish
✓ Kuchli javob
- Aniq joy:
StockService::reserve,lockForUpdate - Dalil: test nomi, CI natijasi, Sentry hisoboti
- Sabab: ADR yoki o‘lchov (EXPLAIN, Debugbar)
- Cheklovni tan olish va v1.1 rejasi
Retrospektiva va zaxira reja
Ikki format — bitta maqsad
1Start
2Stop
main ga to‘g‘ridan-to‘g‘ri push.3Continue
44L
docs/retro.md
# 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
Demo ishlamasa nima qilamiz
Server ishlamaydi
docker compose up -d, seed ma’lumotlarInternet yo‘q
Ma’lumot buzildi
Vaqt yetmayapti
Natija va topshirish
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.Baholash mezonlari
- GitHub da
v1.0.0teg va Release bor; CHANGELOG da[1.0.0]bo‘limi Keep a Changelog formatida - Production URL ishlaydi,
/up200 qaytaradi; to‘rt rol uchun demo foydalanuvchilar tayyor - README: tavsif, Docker bilan ishga tushirish, testlar, muhit o‘zgaruvchilari va deploy bo‘limlari bor
docs/adr/da kamida 3 ta ADR (Holat, Kontekst, Qaror, Oqibatlar)- API hujjati (Scribe) yangilangan va
/docsda ochiladi; foydalanuvchi qo‘llanmasi to‘rt rolni qamraydi mainda CI yashil (Pint, Larastan, Pest); har bir a’zoning kamida bitta ko‘rib chiqilgan PR i bor- Demo zaxirasi tayyor: lokal Docker stek, 3–5 daqiqalik video, seed ma’lumotlar
docs/retro.md: Start/Stop/Continue (yoki 4L), metrikalar va v1.1 uchun 3–5 vazifa
.../releases/tag/v1.0.0) va production URL. Release tavsifida hujjatlar, demo video (zaxira) va har bir a’zoning tanlangan PR havolalari ko‘rsatilsin.4-topshiriq: Reliz cheklistini tekshirish
Himoyadan oldin v1.0.0 relizi tayyorligini tekshiring. Kirish: ['tests' => bool, 'coverage' => int, 'changelog' => bool, 'tag' => string, 'adr' => int]. Mezonlar (shu tartibda): tests — true; coverage — kamida 70 (%); changelog — true; tag — vX.Y.Z ko‘rinishida (pre-release -rc.1 relizga yaroqsiz); adr — kamida 3 ta. Kalit yo‘q bo‘lsa — mezon bajarilmagan hisoblanadi.
Imzo: function release_ready(array $r): array
Qaytaradi: ['ready' => bool, 'missing' => [...]] — bajarilmagan mezonlar nomlari yuqoridagi tartibda.
release_ready(['tests' => true, 'coverage' => 82, 'changelog' => true, 'tag' => 'v1.0.0', 'adr' => 4])
{"ready":true,"missing":[]}5-topshiriq: Feature flag: kimga yoqilgan?
Feature flag ['name' => string, 'enabled' => bool, 'users' => [id...], 'roles' => [rol...], 'percent' => int] va foydalanuvchi ['id' => int, 'role' => string] berilgan. Avval percent 0–100 oralig‘ida ekanini tekshiring, aks holda InvalidArgumentException. Keyin: enabled false bo‘lsa — false; id users ro‘yxatida yoki roli roles da bo‘lsa — true; aks holda bosqichma-bosqich yoqish: crc32(name . ':' . id) % 100 < percent. users/roles kaliti bo‘lmasa — bo‘sh ro‘yxat.
Imzo: function feature_active(array $flag, array $user): bool
Qaytaradi: true yoki false — bir xil foydalanuvchi uchun har doim bir xil natija (deterministik).
feature_active(['name' => 'invoice-pdf-v2', 'enabled' => true, 'users' => [], 'roles' => ['buxgalter'], 'percent' => 0], ['id' => 5, 'role' => 'buxgalter'])
true
6-topshiriq: ADR holatlari mashinasi
Har bir ADR proposed (taklif qilingan) holatida tug‘iladi. Ruxsat etilgan o‘tishlar: proposed → accepted, proposed → rejected, accepted → deprecated, accepted → superseded. rejected, deprecated, superseded — yakuniy holatlar. Hodisalar ro‘yxati (yangi holatlar ketma-ketligi) berilgan — yakuniy holatni qaytaring. Noma’lum holat nomi — InvalidArgumentException; ruxsat etilmagan o‘tish (shu jumladan o‘ziga o‘tish) — DomainException.
Imzo: function adr_status(array $events): string
Qaytaradi: Yakuniy holat nomi: 'proposed', 'accepted', 'rejected', 'deprecated' yoki 'superseded'.
adr_status(['accepted'])
"accepted"
7-topshiriq: CHANGELOG: [Unreleased] bo‘limini tahlil qilish
Keep a Changelog formatidagi Markdown matn berilgan (qatorlar \n bilan ajratilgan). ## [Unreleased] qatoridan keyingi ## bilan boshlanuvchi qatorgacha bo‘lgan qismni tahlil qiling: ### Tur — toifa (faqat Added, Changed, Deprecated, Removed, Fixed, Security, aks holda DomainException), - matn — shu toifaga yozuv. Toifadan oldin kelgan yozuv ham DomainException. Bo‘sh va boshqa qatorlar e’tiborga olinmaydi; qator boshidagi/oxiridagi bo‘sh joylar olib tashlanadi. [Unreleased] bo‘limi bo‘lmasa — bo‘sh massiv.
Imzo: function parse_unreleased(string $md): array
Qaytaradi: Toifa → yozuvlar ro‘yxati; toifalar standart tartibda (Added, Changed, Deprecated, Removed, Fixed, Security), faqat kamida bitta yozuvi borlari.
parse_unreleased("# Changelog\n\n## [Unreleased]\n### Fixed\n- QQS yaxlitlash\n### Added\n- Excel eksport\n\n## [1.0.0] - 2026-12-21\n### Added\n- Birinchi reliz"){"Added":["Excel eksport"],"Fixed":["QQS yaxlitlash"]}8-topshiriq: SemVer bo‘yicha tartiblash (pre-release bilan)
Versiyalar ro‘yxatini semver.org qoidalari bo‘yicha o‘sish tartibida saralang. Format: MAJOR.MINOR.PATCH[-pre][+build]; asosiy raqamlarda boshida ortiqcha 0 bo‘lmaydi (01.0.0 — xato), v prefiksi yo‘q; aks holda InvalidArgumentException. Avval MAJOR, MINOR, PATCH sonlar sifatida; pre-release li versiya o‘sha relizdan kichik (1.0.0-rc.1 < 1.0.0). Pre-release identifikatorlari nuqta bo‘yicha birma-bir: ikkalasi raqam — son sifatida, aks holda satr (ASCII) sifatida; raqamli identifikator harflisidan kichik; hammasi teng bo‘lsa, identifikatori ko‘prog‘i katta. +build tartibga ta’sir qilmaydi (teng bo‘lsa — kirish tartibi saqlanadi).
Imzo: function semver_sort(array $versions): array
Qaytaradi: Saralangan versiyalar ro‘yxati (asl satrlar o‘zgarishsiz).
semver_sort(['1.10.0', '1.2.0', '1.0.0', '1.0.0-rc.1'])
["1.0.0-rc.1","1.0.0","1.2.0","1.10.0"]