Modular Monolith — Senior chuqurlik

Modul = bounded context

Modul chegarasi tasodifan emas — u biznes subdomeni / bounded context (15-mavzu) bo‘yicha o‘tadi: Buyurtma, To‘lov, Inventar. Bu — mikroservis chegarasi bilan bir xil (6-bo‘limda ko‘ramiz: shuning uchun ko‘chirish oson).

Public API — barrel export

Har modul faqat o‘z shartnomasini ochadi (bitta index.ts), ichki fayllarini yashiradi. Boshqa modul faqat shu ochiq yuzaga murojaat qiladi:

// Har modul FAQAT o'z public shartnomasini ochadi (barrel: index.ts)
// payments/index.ts  <-- yagona kirish nuqtasi
export { PaymentApi } from "./payment.api";      // ochiq interfeys
export type { PaymentResult } from "./contracts"; // ochiq DTO
// payment.service.ts, payment.entity.ts -> EKSPORT QILINMAYDI (ichki)

Architectural fitness function — buzilishni avtomatik ushlash

Chegarani lint qoidasi/arxitektura testi bilan majburla — kimdir boshqa modulning ichki qismiga kirsa, CI buzadi:

// ESLint bilan modul chegarasini MAJBURLASH (eslint-plugin-boundaries)
// .eslintrc — modul ICHKI qismiga to'g'ridan-to'g'ri kirish TAQIQLANADI
"rules": {
  "boundaries/element-types": ["error", {
    "default": "disallow",
    "rules": [
      { "from": "orders", "allow": ["orders", "shared", "payments-api"] }
      //  Buyurtma faqat To'lovning PUBLIC API'siga kira oladi,
      //  uning ichki fayllariga (payments/internal/*) EMAS
    ]
  }]
}

// 1) TO'G'RIDAN-TO'G'RI — public interfeys orqali (sinxron, oddiy)
class OrderService {
  constructor(private payments: PaymentApi) {}   // faqat PUBLIC API'ga bog'liq
  async confirm(id: string) {
    await this.payments.charge(id);               // to'g'ridan-to'g'ri chaqiruv (bir jarayon)
  }
}

// 2) ICHKI EVENT — bo'shashtirish uchun (async, in-process event bus)
this.eventBus.publish(new OrderConfirmed(order.id));   // Buyurtma e'lon qiladi
@OnEvent("order.confirmed")                            // Yetkazish tinglaydi
handle(e: OrderConfirmed) { this.scheduleDelivery(e.orderId); }
// modullar bir-birini BILMAYDI -> keyin mikroservisga ko'chirish oson

Bitta DB, alohida sxema

• Har modul o‘z jadvallariga egalik qiladi — boshqa modul ularga to‘g‘ridan-to‘g‘ri tegmaydi (sxema/nom-fazo bilan ajrat).
• Modullar aro FK yo‘q (yoki faqat mantiqiy) — jadval bog‘liqligi chegarani buzadi va kelajakda ajratishni imkonsiz qiladi.
• Cross-module JOIN qilma — boshqa modul ma’lumoti kerak bo‘lsa, uning public APIsidan so‘ra.

Har modul — o‘z ichida to‘liq (domain + application + infrastructure), va o‘z index.ts public API’si bilan. Bu tuzilma modul mustaqilligini ko‘rsatadi va ajratishni osonlashtiradi:

src/
  modules/
    orders/               # <-- MODUL = vertical slice (o'z mini clean-arch, 15-mavzu)
      domain/       # Order entity, qoidalar
      application/  # use case'lar
      infrastructure/ # repo, controller
      index.ts      # <-- PUBLIC API (barrel) — faqat shu ochiq
    payments/
      domain/ application/ infrastructure/ index.ts
    inventory/
      ...
  shared/                 # umumiy kernel (juda kam, ehtiyotkorlik bilan)

Strangler fig — bosqichma-bosqich ajratish

Butun tizimni qayta yozish o‘rniga — bitta modulni o‘z chegarasi bo‘yicha ajratib, uning trafigini asta yangi servisga yo‘naltirasan. Modul chegarasi aniq bo‘lgani uchun (2, 4-bo‘limlar) — bu mexanik jarayon:

Modular monolith — yig‘ma reference

Senior tayyorlik cheklisti