Series: React Basics Lesson 88

Feature-based project structure — Kodni feature, komponent, hook, API va type’lar bo‘yicha tartiblash

React loyihalarida kengayuvchan (scalable) arxitektura: Layer-based va Feature-based tuzilmalar farqi, features/ papkasi ierarxiyasi, Public API (index.ts) va jamoaviy ishlash qulayliklari.

88-dars

Feature-based project structure — Kodni feature, komponent, hook, API va type’lar bo‘yicha tartiblash

React loyihasi endigina boshlanganda yoki kichik landing page bo'lganda barcha fayllarni 3-4 ta umumiy papkaga (components/, hooks/, utils/) joylash yetarli tuyuladi. Ammo loyiha kattalashib, o'nlab sahifalar, yuzlab komponentlar va murakkab biznes mantiq paydo bo'lgach, oddiy o'zgarish kiritish ham haqiqiy boshog'rig'iga aylanadi.

Katta va uzoq muddatli dasturlarni tartibli ushlab turish uchun zamonaviy frontend arxitekturasida Feature-based project structure (Xususiyatlarga asoslangan tuzilma) qo'llaniladi.


Ikki xil arxitektura taqqosi

1. Layer-based (Qatlamli / Fayl turiga asoslangan — Eski usul)

Barcha fayllar o'zining "texnik turi" bo'yicha saralanadi:

  • Hamma komponentlar components/ papkasida (bemorlar ro'yxati ham, oddiy tugma ham).
  • Hamma so'rovlar api/ papkasida.
  • Hamma turlar types/ papkasida.

[!WARNING] "Shotgun Surgery" muammosi: Agar siz "Mahsulotlar" qismiga bitta kichik o'zgarish kiritmoqchi bo'lsangiz, loyihaning 5 ta turli burchagidagi papkalarni ochib yurishingizga to'g'ri keladi (components/ProductCard.tsx, api/productApi.ts, hooks/useProduct.ts, types/product.ts). Bir feature'ni butunlay o'chirish esa undan ham qiyin bo'ladi.


2. Feature-based (Biznes xususiyatlariga asoslangan — Zamonaviy usul)

Kod dasturning mustaqil biznes yo'nalishlari (features: auth, products, cart, profile, billing) bo'yicha bo'linadi.

Har bir feature o'zining ichida o'ziga kerakli komponentlar, hook'lar, API so'rovlari va turlarini saqlaydi. U go'yo kichik mustaqil mini-ilova kabi yashaydi.


Standart va Kengayuvchan Papkalar Daraxti

Quyida katta korporativ React loyihalarida eng ko'p qo'llaniladigan mukammal src/ tuzilmasi keltirilgan:

src/
├── app/                  # Ilovaning global sozlamalari, provayderlar, Router
│   ├── App.tsx
│   ├── router.tsx
│   └── providers.tsx
│
├── components/           # Butun ilova bo'ylab qayta ishlatiladigan umumiy (Dumb/UI) komponentlar
│   ├── Button/
│   ├── Input/
│   ├── Modal/
│   └── Card/
│
├── hooks/                # Global yordamchi custom hook'lar (useDebounce, useMediaQuery)
├── lib/                  # Tashqi kutubxonalarning umumiy konfiguratsiyasi (axios, queryClient, dayjs)
├── types/                # Butun ilova uchun umumiy turlar (User, Pagination, ApiResponse)
├── utils/                # Umumiy formatlash va hisob-kitob funksiyalari
│
├── features/             # ⭐️ ASOSIY YURAK: Biznes yo'nalishlar modullari
│   │
│   ├── auth/             # Kirish, ro'yxatdan o'tish va sessiyani boshqarish
│   │   ├── api/          # loginUser.ts, registerUser.ts
│   │   ├── components/   # LoginForm.tsx, RegisterForm.tsx, SocialAuthButtons.tsx
│   │   ├── hooks/        # useAuth.ts, useLogin.ts
│   │   ├── types/        # auth.types.ts
│   │   └── index.ts      # 🔑 PUBLIC API (tashqariga faqat kerakli narsalarni ochish)
│   │
│   ├── products/         # Mahsulotlar katalogi
│   │   ├── api/          # getProducts.ts, getProductById.ts
│   │   ├── components/   # ProductCard.tsx, ProductGrid.tsx, ProductFilter.tsx
│   │   ├── hooks/        # useProducts.ts
│   │   ├── types/        # product.types.ts
│   │   └── index.ts      # Public API
│   │
│   └── cart/             # Savatcha mantiqi
│       ├── api/
│       ├── components/
│       ├── hooks/
│       ├── types/
│       └── index.ts
│
└── pages/                # Sahifalar qatlami (faqat feature'larni yig'ib ko'rsatadi)
    ├── HomePage.tsx
    ├── LoginPage.tsx
    └── ProductsPage.tsx

Public API (index.ts / Barrel export) Tamoyili

Har bir feature o'zining shaxsiy ichki sirlariga ega bo'lishi kerak. Tashqaridagi sahifalar yoki boshqa modullar feature ichidagi hamma mayda komponentlarga to'g'ridan-to'g'ri murojaat qilmasligi lozim.

Buning uchun har bir feature papkasida bitta index.ts fayli ochiladi:

// src/features/auth/index.ts

// 1. Tashqariga ruxsat berilgan asosiy komponentlar
export { LoginForm } from './components/LoginForm';
export { RegisterModal } from './components/RegisterModal';

// 2. Tashqariga kerak bo'ladigan hook va metodlar
export { useAuth } from './hooks/useAuth';

// 3. Umumiy turlar
export type { AuthUser, LoginCredentials } from './types/auth.types';

// DIQQAT: Ichki yordamchi SocialButton yoki PasswordStrengthBar kabi
// mayda detallar tashqariga eksport qilinmaydi! Ular shaxsiy (private).

Sahifada ishlatilishi:

// src/pages/LoginPage.tsx
import React from 'react';
// Toza, qisqa va qulay import:
import { LoginForm, useAuth } from '@/features/auth';

export function LoginPage() {
  const { isAuthenticated } = useAuth();

  return (
    <div className="login-page">
      <h2>Tizimga kirish</h2>
      <LoginForm />
    </div>
  );
}

Feature-based tuzilmaning afzalliklari

Afzallik Nima beradi?
Yuqori izolyatsiya (High Cohesion) Muayyan funksiyaga tegishli hamma narsa bitta papkada yonma-yon turadi
Past bog'liqlik (Low Coupling) Bitta feature'ni o'chirish yoki yangilash boshqa modullarga zarar yetkazmaydi
Jamoaviy qulaylik 5 nafar dasturchi bir vaqtda 5 xil feature ustida Git conflictlarsiz ishlay oladi
Onboarding qulayligi Yangi kelgan dasturchi mahsulotlar kodini qayerdan qidirishni darhol biladi

Real hayotiy analogiya: Supermarketdagi bo'limlar

Tasavvur qiling, ulkan gipermarket bor:

  • Layer-based (Eski yondashuv): Do'konda hamma narsa turlariga qarab ajratilgan: butun do'konning barcha "Qutilari" 1-qavatda, barcha "Narxnomalari" 2-qavatda, barcha "Muzlatkichlari" 3-qavatda. Agar sut sotib olmoqchi bo'lsangiz, 1-qavatdan qutisini, 2-qavatdan narxini bilib, 3-qavatdan sutni olishingiz kerak.
  • Feature-based (Zamonaviy yondashuv): Do'kon bo'limlarga ajratilgan: Sut mahsulotlari bo'limi, Non bo'limi, Elektronika bo'limi. Sut bo'limiga kirsangiz, o'sha yerning o'zida javon ham, narxnoma ham, sotuvchi xodim ham bor.

Qoidalar va Best Practices

[!TIP] Umumiy UI komponentlar (src/components/): Bu papkaga faqat biznes mantig'iga ega bo'lmagan toza UI elementlar (masalan, Button, Modal, Input, Spinner) qo'yiladi. Hech qachon umumiy papkaga UserProfileCard kabi ma'lumotga bog'liq komponentlarni aralashtirmang.

[!CAUTION] Feature'lar o'rtasidagi qattiq bog'liqlikdan saqlaning: features/products hech qachon features/cartning ichki chuqur faylini to'g'ridan-to'g'ri import qilmasligi kerak. Agar ikkala feature'ga ham bitta ma'lumot yoki logika kerak bo'lsa, uni yuqoriga — src/components/ yoki src/hooks/ darajasiga ko'taring (Lift up).


Xulosa

Feature-based loyiha tuzilishi — dasturning kattalashib, nazoratdan chiqib ketmasligini ta'minlovchi eng xavfsiz me'moriy poydevordir. Kodni biznes funksionallik bo'yicha modullarga bo'lish orqali jamoangiz bilan yillar davomida kengaytirsa bo'ladigan toza, professional React ilovalarini qurasiz!