A12

12-amaliy mashg‘ulot · 12-mavzu · 2 soat · Korxona ilovalarini dasturlash

Pest testlari va kod tahlili

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.

Mashg‘ulot maqsadi

  • Sozlash — PostgreSQL test bazasini, tests/Pest.php va qamrov o‘lchash (PCOV) muhitini
  • Yozish — biznes-qoidalar uchun unit va integratsion testlarni: holat o‘tishlari, rezerv, jo‘natish
  • Tekshirish — REST API ni: 201/401/403/422, JSON tuzilmasi va rollar matritsasi
  • O‘lchash — qamrovni va uni kamida 70 % ga (servislar — 85 %) yetkazishni
  • Joriy qilish — pre-commit hook, PR shabloni va main uchun branch himoyasini

1. Test muhiti va biznes-qoida testlari

omborpro_test · phpunit.xml · tests/Pest.php · StockService va OrderStatus testlari

Avval alohida test bazasini yarating: docker compose exec db createdb -U omborpro omborpro_test (foydalanuvchi nomi 2-mavzudagi .env ga mos). phpunit.xml dagi <php> bo‘limida DB_CONNECTION=pgsql, DB_DATABASE=omborpro_test, CACHE_STORE=array, QUEUE_CONNECTION=sync, MAIL_MAILER=array qiymatlarini o‘rnating — testlar hech qachon ishchi bazaga yoki real pochtaga tegmasin. tests/Pest.php da uses(TestCase::class, RefreshDatabase::class)->in('Feature') va umumiy yordamchi validOrderPayload() funksiyasini yozing.

Biznes-qoidalar ro‘yxatini 4-mavzudagi invariantlardan oling va har biriga kamida bitta test yozing: OrderStatus — barcha ruxsat etilgan va taqiqlangan o‘tishlar (dataset); StockService::reserve — yetarli qoldiqda rezerv va reserve harakati, yetarli bo‘lmaganda istisno va o‘zgarishsiz holat; ship — quantity va reserved kamayadi, out harakati yoziladi; cancel — rezerv bo‘shatiladi; hisob-faktura — QQS 12 % va chegaraviy yaxlitlash.

Har bir test nomi biznes tilida bo‘lsin va o‘qituvchi test ro‘yxatidan (php artisan test --list-tests yoki chiqish) tizim qoidalarini tushuna olsin. Testlarni yozishda avval testni qizil holatda ko‘ring (masalan, invariantni vaqtincha buzib), keyin yashilga qaytaring — bu testning haqiqatan nimanidir tekshirayotganini isbotlaydi. Kod ichidagi jamoangizga xos metod nomlari (masalan, reserve() parametrlari) slayddagilardan farq qilsa, o‘zingiznikiga moslang.

PHPUNIT.XML

Test muhiti o‘zgaruvchilari

<php>
    <env name="APP_ENV" value="testing"/>
    <env name="BCRYPT_ROUNDS" value="4"/>
    <env name="DB_CONNECTION" value="pgsql"/>
    <env name="DB_DATABASE" value="omborpro_test"/>
    <env name="CACHE_STORE" value="array"/>
    <env name="QUEUE_CONNECTION" value="sync"/>
    <env name="MAIL_MAILER" value="array"/>
    <env name="SESSION_DRIVER" value="array"/>
</php>
▶ Natija
$ docker compose exec db createdb -U omborpro omborpro_test
$ docker compose exec app php artisan test
  Tests:    46 passed (131 assertions)
  Duration: 3.82s
  • omborpro_test — alohida baza — ishchi ma’lumotga tegmaydi
  • CACHE_STORE=array — har test toza kesh bilan
  • MAIL_MAILER=array — xatlar hech qayerga ketmaydi
  • BCRYPT_ROUNDS=4 — parol xeshlash tezlashadi — testlar tezroq
TESTS/PEST.PHP

Umumiy sozlama va yordamchi

use Illuminate\Foundation\Testing\RefreshDatabase;
use Tests\TestCase;

uses(TestCase::class, RefreshDatabase::class)->in('Feature');

function validOrderPayload(array $override = []): array
{
    $product = Product::factory()->create(['price' => '100000.00']);
    $stock = Stock::factory()->for($product)
        ->create(['quantity' => 50]);

    return array_replace([
        'counterparty_id' => Counterparty::factory()->create()->id,
        'warehouse_id' => $stock->warehouse_id,
        'items' => [['product_id' => $product->id, 'quantity' => 2]],
    ], $override);
}
▶ Natija
validOrderPayload(['items' => []])
→ ['counterparty_id' => 12, 'warehouse_id' => 3, 'items' => []]
  • ->in('Feature') — Feature testlar Laravel TestCase va toza baza bilan
  • validOrderPayload() — har test o‘z ma’lumotini yaratadi — bog‘liqlik yo‘q
  • array_replace — kerakli maydonni almashtirib, xato so‘rov yasash oson
INTEGRATSION TEST

ship(): qoldiq, rezerv va jurnal

beforeEach(function () {
    $this->stock = Stock::factory()->create([
        'quantity' => 10, 'reserved' => 4,
    ]);
});

it('jo‘natish quantity va reserved ni kamaytiradi', function () {
    $s = $this->stock;
    app(StockService::class)->ship($s->warehouse_id, $s->product_id, 4);

    expect($s->fresh())
        ->quantity->toBe(6)
        ->reserved->toBe(0);
    $this->assertDatabaseHas('stock_movements', [
        'product_id' => $s->product_id,
        'type' => 'out', 'quantity' => 4,
    ]);
});
▶ Natija
   PASS  Tests\Feature\StockServiceTest
  ✓ it jo‘natish quantity va reserved ni kamaytiradi     0.07s
  • beforeEach — har test uchun yangi qoldiq yozuvi
  • ->quantity->toBe(6) — Pest higher-order tasdiqlari: xossalar zanjiri
  • 'type' => 'out' — har bir qoldiq o‘zgarishi jurnalga yoziladi — invariant

2. API testlari va qamrov

OrderApiTest · 201/401/403/422 · rollar matritsasi · PCOV · --min

tests/Feature/Api/OrderApiTest.php faylida 7-mavzudagi buyurtmalar API si uchun kamida quyidagilarni yozing: menejer buyurtma yaratadi (201, data.status = draft, order_items da qatorlar); tokensiz so‘rov — 401; rollar matritsasi dataset bilan (admin, menejer — 201; omborchi, buxgalter — 403); validatsiya — bo‘sh items, mavjud bo‘lmagan product_id, manfiy miqdor — 422 va aniq maydon; mass assignment — yaratishda status => 'shipped' yuborilsa ham buyurtma draft. Mahsulotlar ro‘yxati uchun sahifalash va JSON tuzilmasi testi.

Qamrov uchun dev obraziga PCOV qo‘shing (pecl install pcov && docker-php-ext-enable pcov) va php artisan test --coverage --min=70 ni ishga tushiring. Natijadagi eng past foizli servis fayllarini toping va ular uchun test qo‘shing: maqsad — app/Services da kamida 85 %, jami kamida 70 %. HTML hisobotni (--coverage-html coverage) ochib, qizil qatorlar qaysi tarmoqlar ekanini ko‘ring — odatda bular xato holatlari. coverage/ papkasini .gitignore ga qo‘shing.

Composer skriptlari bilan buyruqlarni standartlashtiring: composer test — testlar, composer test:cov — qamrov bilan, composer lint — Pint va Larastan. Shunda har bir jamoa a’zosi va keyinchalik CI bir xil buyruqlarni ishlatadi. Natijalarni (testlar soni, qamrov foizi) README ga yozing.

API TEST

Menejer buyurtma yaratadi; mass assignment ishlamaydi

it('menejer buyurtma yaratadi', function () {
    $manager = User::factory()->create()->assignRole('menejer');

    $this->actingAs($manager, 'api')
        ->postJson('/api/v1/orders', validOrderPayload([
            'status' => 'shipped',          // e’tiborsiz qolishi kerak
        ]))
        ->assertCreated()
        ->assertJsonPath('data.status', 'draft');

    $this->assertDatabaseCount('order_items', 1);
});

it('tokensiz so‘rov 401', function () {
    $this->postJson('/api/v1/orders', [])->assertUnauthorized();
});
▶ Natija
  ✓ it menejer buyurtma yaratadi                   0.18s
  ✓ it tokensiz so‘rov 401                        0.02s
  • 'status' => 'shipped' — mass assignment hujumi — holat draft qolishi shart
  • assertCreated() — 201 — yangi resurs
  • assertDatabaseCount — javob bilan birga baza holati
COMPOSER SKRIPTLARI

Bir xil buyruqlar: test, qamrov, lint

{
    "scripts": {
        "test": "pest --parallel",
        "test:cov": "pest --coverage --min=70",
        "lint": [
            "pint --test",
            "phpstan analyse --no-progress --memory-limit=1G"
        ],
        "hooks": "git config core.hooksPath .githooks"
    }
}
▶ Natija
$ composer test:cov
  Services/OrderService ............................ 91.3 %
  Services/StockService ............................ 96.0 %
  Total: 78.4 %
  • "test:cov" — chegaradan past — chiqish kodi xato
  • "lint" — massiv — buyruqlar ketma-ket, birinchi xatoda to‘xtaydi
  • "hooks" — yangi a’zo bir buyruq bilan hookni ulaydi
MAQSADLAR

Qamrov va testlar bo‘yicha minimal talablar

QismMinimal talabTekshiruv
app/Services≥ 85 % qamrov--coverage hisoboti
Jami loyiha≥ 70 % qamrovcomposer test:cov yashil
Holat o‘tishlariBarcha ruxsat va taqiqlar dataset daUnit test
Qoldiq invariantlarireserve, ship, cancel + yetmaslik holatiIntegratsion test
Buyurtmalar API201, 401, 403 (matritsa), 422 (3 holat)Feature test
ArxitekturaControllerlarda DB yo‘q, dd() yo‘qArch test

3. Pre-commit hook va Pull Request orqali kod tahlili

.githooks · PR shabloni · branch himoyasi · jamoaviy review

Ma’ruzadagi .githooks/pre-commit skriptini loyihaga qo‘shing, chmod +x qiling va composer hooks bilan ulang. Docker ichida ishlayotgan bo‘lsangiz, skriptdagi buyruqlarni docker compose exec -T app ./vendor/bin/pint ... ko‘rinishiga o‘zgartiring. Tekshiring: faylga ataylab ortiqcha use qo‘shib commit qiling — hook commitni to‘xtatishi kerak; ./vendor/bin/pint dan keyin commit o‘tadi.

.github/pull_request_template.md faylida PR shablonini yarating: nima o‘zgardi va nima uchun, bog‘langan issue, qanday tekshirildi (testlar, qamrov, skrinshot), ko‘rib chiquvchi uchun tekshiruv ro‘yxati (biznes-qoidalar, tranzaksiya, Policy/validatsiya, N+1, migratsiya). GitHub repozitoriy sozlamalarida main uchun branch himoyasini yoqing: PR orqali merge, kamida 1 tasdiq, yangi commitdan keyin eski tasdiqlarni bekor qilish.

Jamoaviy kod tahlili: har bir a’zo bugungi testlarini alohida PR qilib ochadi va boshqa a’zoning PR ini ko‘rib chiqadi. Kamida 3 ta mazmunli izoh qoldiring (blocking:, question: yoki nit: belgisi bilan), ulardan biri “suggested change” bo‘lsin. Muallif har bir izohga javob beradi yoki tuzatadi, keyin approve va squash merge. O‘qituvchi PR tarixidan izohlar sifati va javoblarni baholaydi.

O‘RNATISH

Hookni ulash va sinab ko‘rish

mkdir -p .githooks
cp docs/pre-commit.sh .githooks/pre-commit
chmod +x .githooks/pre-commit
composer hooks              # git config core.hooksPath .githooks

# sinov: ataylab uslub xatosi
echo "<?php use Foo\Bar;" > app/Tmp.php
git add app/Tmp.php && git commit -m "hook sinovi"
rm app/Tmp.php && git restore --staged app/Tmp.php
▶ Natija
Pint...
  ⨯ app/Tmp.php   no_unused_imports, blank_line_after_opening_tag
Uslub xatosi: ./vendor/bin/pint ni ishga tushiring
(commit bekor qilindi)
  • chmod +x — bajariladigan bo‘lmasa Git hookni ishga tushirmaydi
  • composer hooks — har bir a’zo bir marta bajaradi
  • ataylab xato — hook haqiqatan ishlashini isbotlash
PR SHABLONI

.github/pull_request_template.md

## Nima o‘zgardi va nima uchun
Closes #

## Qanday tekshirildi
- [ ] Yangi qoida uchun Pest testlari bor
- [ ] `composer test:cov` yashil (qamrov pasaymadi)
- [ ] `composer lint` xatosiz

## Ko‘rib chiquvchi uchun
- [ ] Biznes-qoidalar va invariantlar (qoldiq, holatlar)
- [ ] Tranzaksiya, `lockForUpdate`, `afterCommit`
- [ ] Policy va validatsiya, `$fillable`
- [ ] N+1 yo‘q, kerakli indekslar bor
- [ ] Migratsiya qaytariladigan
▶ Natija
GitHub: har bir yangi PR tavsifi shu shablon bilan ochiladi
  • Closes # — issue avtomatik yopiladi va bog‘lanadi
  • Qanday tekshirildi — muallif o‘zi tekshirganini tasdiqlaydi
  • Ko‘rib chiquvchi uchun — ma’ruzadagi tekshiruv ro‘yxati
BRANCH HIMOYASI

GitHub da main ni himoyalash

  1. Settings → Branches — main uchun himoya qoidasini (ruleset) qo‘shish
  2. Require a pull request — to‘g‘ridan-to‘g‘ri push yo‘q; kamida 1 tasdiq
  3. Dismiss stale approvals — yangi commitdan keyin qayta ko‘rib chiqish
  4. Require conversation resolution — barcha izohlar hal qilinmaguncha merge yo‘q
  5. Status checks — CI ulangach (14-mavzu) — yashil tekshiruvlar majburiy

Loyiha bosqichi: natija va topshirish

Natija: loyiha biznes-qoidalari va API si Pest testlari bilan himoyalangan, qamrov o‘lchanadi va belgilangan chegaradan past emas, pre-commit hook uslub va tur xatolarini commitdan oldin ushlaydi, o‘zgarishlar Pull Request orqali kod tahlilidan o‘tadi.

Baholash mezonlari
  • Testlar alohida omborpro_test PostgreSQL bazasida; RefreshDatabase ulangan; php artisan test yashil.
  • OrderStatus uchun barcha ruxsat etilgan va taqiqlangan o‘tishlar dataset bilan testlangan.
  • StockService uchun reserve, ship, cancel va qoldiq yetmasligi (holat o‘zgarmasligi bilan) testlari bor.
  • Buyurtmalar API: 201, 401, rollar matritsasi (403), uchta 422 holati va mass assignment testi.
  • Qamrov: app/Services ≥ 85 %, jami ≥ 70 % — composer test:cov natijasi README da.
  • .githooks/pre-commit Pint, Larastan va unit testlarni ishlatadi; composer hooks bilan ulanadi.
  • PR shabloni va main uchun branch himoyasi sozlangan.
  • Har bir a’zo kamida bitta PR ni ko‘rib chiqqan: ≥ 3 mazmunli izoh va muallif javoblari.

📤 Squash merge qilingan Pull Request havolasini yuboring (testlar, hook va shablon bilan); PR da qamrov natijasi, ko‘rib chiquvchi izohlari va ularga javoblar ko‘rinib tursin.

?

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.

Yechildi 0 / 8
Ball 0

💡 Maslahat

PHP 8.3 kodi · avtomatik saqlanadi