Dasturiy arxitektura nima: trade-off tafakkuri va sifat atributlari
Qisqacha: Dasturiy arxitektura — keyin o'zgartirish qimmatga tushadigan qarorlar yig'indisi: qaysi baza, qanday modullar, qayerda tekshiruv, nima qayerda saqlanadi. Bu qarorlarda "eng yaxshi" variant bo'lmaydi. Har biri bir sifatni (tezlik, xavfsizlik, soddalik) yaxshilab, boshqasidan narx oladi. Bu darsda
vazifalar-apining 4.4.0 versiyasidagi oltita tuzatishni shunday o'qiymiz: nima yutdik, nima to'ladik va qachon bu yechim kerak emas.
Bu darsda
- Arxitektura nima ekanini va u oddiy kod dizaynidan qanday farq qilishini tushuntirasiz.
- Sifat atributlarini (performance, scalability, maintainability, security) loyihadagi aniq misol bilan ayta olasiz.
- Har texnik qarorni "yutuq — narx — qachon kerak emas" uchligi bilan baholaysiz.
- Zaruriy va tasodifiy murakkablikni farqlaysiz.
- Loyihani 4.4.0 ga yangilaysiz: 35-qismdan qolgan beshta qoldiq xavf yopiladi, har biri regressiya testi bilan.
Oldin bilishingiz kerak: Xavfsizlik audit checklisti, Fail-open va fail-closed, Xavfsizlik incidentiga javob, Modular monolit va hexagonal arxitektura NestJS'da.
1. Nega bu kerak?
35-qism oxirida audit ro'yxatini yopdik (Xavfsizlik audit checklisti). Lekin ro'yxat oxirida "qoldiq xavflar" qolgan edi. Masalan, /health/ready Postgres o'chiq bo'lsa ham "tayyorman" deydi. Production'da ILOVA_SIRI berilmasa, ilova jim turib vaqtinchalik sir bilan ishga tushadi. API kalitlari soni cheksiz.
Har birini tuzatish bir necha qator kod. Qiyin savol — kod emas, tanlov. Readiness bazani har safar so'rasin, bu bazaga qo'shimcha yuk emasmi? Sirsiz ilova ishga tushmasin — ertalab deploy yiqilsa-chi? Rad etilgan har login urinishini jurnalga yozaylik — hujum paytida baza INSERT bilan to'lib qolmaydimi?
Bu savollarning hech biriga "to'g'ri javob" yo'q. Har javob nimadir beradi va nimadir oladi. Shunday tanlovlar ustida o'ylash — arxitektorning asosiy ishi. Bu qism shu tafakkurni o'rgatadi: avval o'z vazifalar loyihangizda, keyin katta tizimlarda.
Hayotiy o'xshatish: uy qurish. Xonalardagi mebelni har hafta o'zgartirish mumkin — bu dizayn. Poydevor, yuk ko'taruvchi devorlar va quvurlar o'rnini esa uy qurilgandan keyin o'zgartirish juda qimmat. Bu — arxitektura. Katta derazalar yorug'lik beradi, lekin qishda issiqlik ketadi. Ikkalasini birdan maksimal qilib bo'lmaydi.
2. Arxitektura nima
2.1 Muhim va qimmat qarorlar
Dasturiy arxitektura (software architecture) — tizimning asosiy qismlari, ular orasidagi aloqa va bu tuzilmani belgilagan qarorlar. Ta'riflar ko'p. Amaliyotda eng foydalisini Martin Fowler 2003-yilgi "Who Needs an Architect?" maqolasida Ralph Johnson'ga tayanib bergan: arxitektura — "muhim narsalar". Keyin u buni aniqroq aytadi: arxitektura — odamlar keyin o'zgartirish qiyin deb biladigan narsalar.
Qaysi qaror "qiyin o'zgaradi"? Oddiy sinov bor: shu qarorni bir yildan keyin o'zgartirsak, nechta fayl, nechta jadval va nechta foydalanuvchiga ta'sir qiladi? Funksiya nomini almashtirish — bitta PR. Bazani Postgres'dan MongoDB'ga ko'chirish — oylar.
2.2 Arxitektura va dizayn
Arxitektura bilan dizayn orasida aniq chiziq yo'q. Ular bitta o'qning ikki uchi:
| Dizayn | Arxitektura | |
|---|---|---|
| Ko'lami | bitta funksiya, klass, fayl | modullar, jarayonlar, bazalar |
| O'zgartirish narxi | daqiqalar, bitta PR | haftalar, ko'p jamoa |
| Misol | yarat() ichidagi if tartibi |
auth Postgres'da, sessiya cookie'da |
| Xato oqibati | bitta xato | butun tizim sekin yoki xavfli |
Bu qismda ikkalasini ham ko'ramiz. Asosiy tamoyillar va SOLID darslari dizaynga yaqin. Mikroservislar, kesh va masshtablash — arxitekturaga.
2.3 vazifalar dagi arxitektura qarorlari
Siz 25-qismdan beri arxitektura qarorlarini qabul qilib keldingiz, faqat ularni shunday atamagansiz. Bir nechtasi:
| Qaror | Qachon | Almashtirish narxi |
|---|---|---|
saqlash VazifaOmbori porti orqali |
25–26-qism | past: 5 adapter, xizmat o'zgarmadi |
| ma'lumot ajratish — Postgres RLS | 27-qism | yuqori: har jadval, har rol |
| sessiya — cookie, JWT emas | 28-qism | yuqori: web, API, testlar |
| HTTP qatlami — NestJS | 30-qism | o'rta: domen o'zgarmadi |
| bitta VPS, Docker Compose | 33–34-qism | o'rta: CI/CD, zaxira, kuzatuv |
Birinchi qatorga qarang. Modular monolit va hexagonal arxitektura darsida ko'rganingizdek, saqlash usuli to'rt marta almashdi. Xizmat va controller esa o'zgarmadi. Ya'ni 25-qismdagi bitta qaror ("ombor interfeys orqali") keyingi o'zgarishlarni arzon qildi. Yaxshi arxitektura — keyingi qarorlarni arzonlashtiradigan arxitektura.
Ikkinchi qator teskari misol. RLS ma'lumotni bazaning o'zida himoya qiladi (IDOR darsida bu ikkinchi qatlam ekanini o'lchagansiz). Lekin undan voz kechish har jadval va har rolni qayta yozish degani. Bu qaror ataylab "qimmat" qilingan — xavfsizlik uchun.
Tekshirib ko'ring: Jamoa API javobidagi sanani
2026-11-09dan09.11.2026formatiga o'tkazmoqchi. Bu dizayn qarorimi yoki arxitektura qarorimi?
Javob
Kodda bu bitta funksiya. Lekin API ochiq shartnoma: undan web, mobil ilova va begona integratsiyalar foydalanadi. Format o'zgarsa, ular buziladi. Shuning uchun bu arxitektura qaroriga yaqin: almashtirish narxi kodning hajmi bilan emas, unga bog'liq tashqi foydalanuvchilar bilan o'lchanadi. Bunday o'zgarish API versiyasi orqali qilinadi (API versiyalash va deprecation).
3. Sifat atributlari
3.1 Tizim "yaxshi" bo'lishining o'lchovlari
Funksional talab — tizim nima qiladi: "vazifa yaratadi", "eksport qiladi". Sifat atributi (quality attribute) — tizim buni qanday qiladi: qanchalik tez, ishonchli, xavfsiz. Arxitektura asosan sifat atributlari uchun quriladi. Funksiyani istalgan tuzilmada yozish mumkin, tezlik va xavfsizlikni esa keyin "qo'shib" bo'lmaydi.
Eng ko'p tilga olinadiganlari:
| Atribut | Savol | vazifalar da o'lchov |
|---|---|---|
| Performance (unumdorlik) | qancha tez javob beradi | p50, p99 kechikish |
| Scalability (masshtablanish) | yuk oshsa nima bo'ladi | so'rov/s, nusxalar soni |
| Availability (mavjudlik) | qancha vaqt ishlaydi | SLO, readiness |
| Security (xavfsizlik) | kim nimaga kira oladi | tahdid modeli, audit |
| Maintainability (o'zgartiriluvchanlik) | o'zgartirish qancha turadi | fayllar soni, testlar |
| Testability (testlanuvchanlik) | qanchalik oson sinaladi | test vaqti |
Bu ro'yxat to'liq emas. ISO/IEC 25010 standartining 2023-yilgi tahriri sifatni to'qqizta asosiy xususiyatga (2011-yilgisida sakkizta edi) va o'nlab kichik xususiyatlarga bo'ladi. Boshlash uchun yuqoridagi oltita yetarli. Har biri bilan oldingi qismlarda ishlagansiz: performance — 27-qism keshi, availability — 34-qism SLO'si (SLI/SLO, incident va postmortem), security — butun 35-qism.
3.2 Atributlar bir-biriga zid
Muammo shundaki, atributlar bir-birini "itaradi":
- Kesh performance'ni oshiradi, lekin ma'lumot eskirishi mumkin. Bu to'g'rilikka zarar.
- Shifrlash va ikki faktorli kirish security'ni oshiradi, lekin foydalanuvchiga qadam qo'shadi.
- Mikroservislar mustaqil scalability beradi, lekin maintainability va debugging qiyinlashadi.
- Har urinishni jurnalga yozish tergovni osonlashtiradi, lekin hujum paytida bazaga yuk qo'shadi.
Shuning uchun arxitektor "eng yaxshi" emas, eng mos variantni qidiradi. Mos — shu loyiha, shu jamoa va shu yukda eng muhim atributlarni yetarli darajada beradigan variant.
4. Trade-off: "eng yaxshi" yo'q
4.1 Uch savol
Trade-off (murosali tanlov) — bitta narsani olish uchun boshqasidan ongli ravishda voz kechish. Mark Richards va Neal Ford buni "dasturiy arxitekturaning birinchi qonuni" deb atashadi: arxitekturadagi hamma narsa trade-off. Kimdir "bu yechimning kamchiligi yo'q" desa, u hali kamchilikni topmagan.
Har qarorga uchta savol beramiz:
- Nima yutamiz? — qaysi atribut yaxshilanadi, raqam bilan.
- Nima to'laymiz? — qaysi atribut yomonlashadi, qancha kod, qancha yuk.
- Qachon bu kerak emas? — qaysi sharoitda narx foydadan oshadi.
Uchinchi savolni ko'pchilik unutadi. Holbuki u eng foydalisi: u yechimning chegarasini ko'rsatadi. Endi vazifalar-api ning 4.4.0 versiyasidagi tuzatishlarni shu uch savol bilan o'qiymiz.
4.2 Readiness keshsiz
Avval eslatma. Readiness (tayyorlik tekshiruvi) — nginx yoki Kubernetes "bu nusxaga trafik yuborsam bo'ladimi?" deb so'raydigan manzil. U Health check endpoint'lari darsida o'tilgan.
Fail-open va fail-closed darsida bitta topilma bor edi: Postgres to'xtatilgan, lekin /health/ready baribir 200 qaytaradi. Sabab — tekshiruv VazifaOmbori.soni() ni chaqirardi. Ombor esa Redis keshi bilan o'ralgan (Caching naqshlari darsidagi KeshliOmbor). Soni keshda bor, demak "baza javob berdi":
flowchart LR
LB[nginx] --> R["/health/ready"]
R -->|4.3.2| K[KeshliOmbor]
K --> RD[(Redis: soni bor)]
K -.-> PG[(Postgres o'chiq)]
R -->|4.4.0| P[pool: SELECT 1]
P --> PGDiagrammada ikki yo'l bor. Eski yo'l (4.3.2) keshda to'xtaydi va Postgres'ga yetib bormaydi — shuning uchun o'chiq baza ko'rinmaydi. Yangi yo'l (4.4.0) to'g'ridan bazaga boradi. Tuzatish (salomatlik.module.ts, telefon uchun qisqartirildi):
try {
- await Promise.race([this.ombor.soni({}), kutish]);
+ const pool = this.saqlash?.pool;
+ const sorov = pool === undefined
+ ? this.ombor.soni({})
+ : pool.query("SELECT 1");
+ await Promise.race([sorov, kutish]);
return seans.up({ ms: Math.round(performance.now() - t) });kutish — kanonda shu qatorning o'zida yozilgan 2 soniyalik taymer. Uzun qatorni telefonda o'qish uchun unga nom berdik. Pool bo'lmasa (xotira yoki fayl rejimi), eski usul qoladi: u yerda kesh ham yo'q.
Uch savol:
- Yutuq: to'g'rilik. Postgres o'chsa — 503, nginx yoki Kubernetes trafikni o'lik nusxaga yubormaydi. Regressiya testi: eski kodda
expected 503 "Service Unavailable", got 200 "OK", yangisida o'tadi. - Narx: har tekshiruv bazaga bitta
SELECT 1. Readiness har bir necha soniyada so'raladi — bu sezilmaydigan yuk. Lekin baza vaqtincha sekinlashsa, hamma nusxa birdan "tayyor emas" bo'lib qolishi mumkin. - Qachon kerak emas: ilova bazasiz ham foydali ish qila olsa (masalan, faqat keshdan o'qiydigan katalog). Unda readiness bazaga bog'lanmaydi, aks holda baza bir daqiqa o'chsa, butun sayt o'chadi.
4.3 Sirsiz ishga tushmaslik
ILOVA_SIRI dan API kalitlari, TOTP shifri va zaxira kodlar uchun kalitlar hosil qilinadi. 4.3.2 da u berilmasa, ilova har ishga tushishda tasodifiy sir yaratardi. Dasturchi kompyuterida bu qulay. Production'da esa har restartdan keyin barcha API kalitlari jim "o'ladi", 2FA ishlamay qoladi. Tuzatish — config.ts dagi Zod sxemasiga bitta qoida (qatorga bo'lindi, xabar qisqartirildi):
+ .refine(
+ (e) => e.NODE_ENV !== "production"
+ || e.ILOVA_SIRI !== undefined,
+ { error: "production'da ILOVA_SIRI majburiy …",
+ path: ["ILOVA_SIRI"] })
.refine((e) => e.NODE_ENV !== "production" || …Pastdagi qator — 35-qismdan beri bor CORS_ORIGINS qoidasi. Ular orasidagi ikkinchi yangi qoidani tushirib qoldirdik: ILOVA_SIRI_ESKI faqat yangi, boshqa sir bilan birga beriladi. Bu yopiq yiqilish (fail closed) tamoyili: noto'g'ri sozlamada ilova umuman ishga tushmaydi.
- Yutuq: xavfsizlik va ishonchlilik. Xato deploy paytida darhol ko'rinadi, uch kundan keyin foydalanuvchi shikoyatida emas.
- Narx: operatsion qattiqlik. Sirni unutgan deploy yiqiladi. 34-qismdagi blue-green deploy (Zero-downtime deploy strategiyalari) yangi nusxa sog'lom bo'lmaguncha eskisini o'chirmaydi. Shuning uchun bu narx foydalanuvchiga emas, deploy qiluvchiga tushadi.
- Qachon kerak emas: dasturchi kompyuterida va testda. Shuning uchun qoida faqat
NODE_ENV=productionda ishlaydi.
4.4 Ikki kalitli sir almashtirish
Xavfsizlik incidentiga javob darsida sirni almashtirdik va narxini o'lchadik: hamma API kalitlari 401 berdi, TOTP'li foydalanuvchilar esa login'da 500 oldi. Rejali almashtirishda bu ortiqcha og'riq. 4.4.0 da ikkinchi o'zgaruvchi qo'shildi — ILOVA_SIRI_ESKI:
export class Sirlar {
readonly #asos: Buffer;
readonly #eski: Buffer | undefined;
kalit(maqsad: KalitMaqsadi): Buffer {
return Sirlar.#hkdf(this.#asos, maqsad);
}
/** eski sirdan o'sha maqsad kaliti yoki undefined */
eskiKalit(maqsad: KalitMaqsadi): Buffer | undefined {
return this.#eski === undefined
? undefined
: Sirlar.#hkdf(this.#eski, maqsad);
}
}Bu umumiy/sir.ts dan bo'lak: konstruktor va #hkdf tushirib qoldirildi. Yangi yozuvlar doim yangi kalit bilan. O'qishda eski kalit faqat uzoq yashaydigan ma'lumot uchun sinaladi: API kalit HMAC'i, TOTP shifri, zaxira kodlar. TOTP eski kalit bilan ochilsa, o'sha zahoti yangi kalit bilan qayta yoziladi — o'tish davri o'z-o'zidan tugaydi. Eski kalit ham ochmasa — 500 emas, 409 totp-qayta-sozlash: foydalanuvchi 2FA'ni qayta yoqadi.
- Yutuq: mavjudlik. Rejali almashtirishda integratsiyalar uzilmaydi.
- Narx: xavfsizlik oynasi va murakkablik. O'tish davrida eski sir ham kuchda. Kodda esa har tekshiruv joyi ikki kalitni biladi.
- Qachon kerak emas: sir sizganda. Runbook'ga aniq yozildi: sizishda
ILOVA_SIRI_ESKIqo'yilmaydi, aks holda hujumchining kaliti ham ishlab qoladi.
Bitta joyga ESKI ataylab qo'shilmadi: xatlardagi obunadan chiqish havolalari. Natijada almashtirishdan oldin yuborilgan xatdagi "obunadan chiqish" havolasi ishlamaydi. Bu qoldiq xavf sifatida yozildi. Sir kamdan-kam almashadi, buziladigan narsa esa bitta qulaylik. Uni ham qamrab olish yana bir tekshiruv joyini ikki kalitli qilardi — foyda kichik, murakkablik doimiy. Bu ongli "kerak emas".
4.5 API kalitlari chegarasi
Har API kalit — alohida hisob ma'lumoti, sizishi mumkin bo'lgan yana bitta narsa. 4.3.2 da ularning soni cheksiz edi. Endi bitta foydalanuvchida ko'pi bilan 10 ta faol kalit (MAKS_API_KALIT = 10). O'n birinchisi — 409.
Biznes mantiq zaifliklari darsida webhook limitida poyga holatini topgan edik: 20 ta parallel so'rov limitni aylanib o'tardi. Xuddi shu xato bu yerda takrorlanmasligi uchun sanash va INSERT bitta tranzaksiyada, foydalanuvchi bo'yicha qulf (pg_advisory_xact_lock) ostida bajariladi. Regressiya testi: parallel 20 so'rov — bazada 10 ta kalit.
- Yutuq: hujum yuzasi kichrayadi, poyga yo'q.
- Narx: har yaratishda tranzaksiya va qulf; ko'p kalit kerak bo'lgan halol foydalanuvchi keraksizini bekor qilishi kerak.
- Qachon kerak emas: kalit yaratish juda tez-tez bo'ladigan tizimda (masalan, har qurilmaga avtomatik kalit). U yerda chegara boshqacha quriladi — muddat va avtomatik bekor qilish bilan.
4.6 429 jurnali: har birini emas, namunasini
Xavfsizlik loglari va alertlar darsida bo'shliq topildi: tezlik cheklovi rad etgan login urinishlari (429) auth jurnaliga tushmasdi. Tergovchi faqat HTTP loglariga qarab qolardi. Oddiy yechim — har 429 da jurnalga INSERT. Lekin parol tanlash hujumida soniyasiga yuzlab urinish keladi. Har biriga yozuv — bazaga hujumchi xohlagan yuk.
Kanon boshqacha tanladi: oynadagi birinchi rad va keyin har 10-chisi yoziladi. CheklovGuard dagi shart shunday ishlaydi. Uni modelda sinaymiz:
// oynadagi birinchi rad (limit + 1) va har 10-chi urinish
function jurnalgami(son, limit) {
return son === limit + 1 || son % 10 === 0;
}
function hujum(urinishlar, limit) {
const yozilgan = [];
let rad = 0;
for (let son = 1; son <= urinishlar; son++) {
if (son <= limit) continue; // hali ruxsat bor
rad++;
if (jurnalgami(son, limit)) yozilgan.push(son);
}
return { rad, yozilgan };
}
const kichik = hujum(12, 5);
console.log(`12 urinish: rad ${kichik.rad},`,
`jurnalga ${kichik.yozilgan.length}`,
`(${kichik.yozilgan.join(", ")})`);
const katta = hujum(1000, 5);
console.log(`1000 urinish: rad ${katta.rad},`,
`jurnalga ${katta.yozilgan.length}`);Konsolda:
12 urinish: rad 7, jurnalga 2 (6, 10)
1000 urinish: rad 995, jurnalga 101Birinchi qator kanon regressiya testi bilan aynan. Test 5 ta ruxsatli qoidaga 12 marta noto'g'ri parol yuboradi: 401 × 5, 429 × 7, jurnalda esa ikkita yozuv — son: 6 va son: 10. Ikkinchi qator — narxning o'zi: 995 ta INSERT o'rniga 101 ta, taxminan o'n barobar kam.
console.log ga bir nechta argument berilsa, ular bo'shliq bilan ulanadi — shuning uchun uzun satrni uch bo'lakka bo'ldik.
- Yutuq: jurnal hujumni ko'radi (birinchi rad aniq vaqt bilan), baza esa hujumchi uchun "kuchaytirgich" bo'lmaydi.
- Narx: jurnaldagi son aniq emas. "Nechta urinish bo'ldi?" degan savolga jurnal taxminiy javob beradi. Aniq son metrikadan olinadi (Metrikalar: Prometheus va Grafana).
- Qachon kerak emas: urinishlar kam va har biri qimmatli bo'lgan joyda. Masalan, admin paneliga kirish yoki to'lovni tasdiqlash. U yerda har urinish yoziladi.
Yana bir tafsilot: jurnalga email yozilmaydi, faqat qoida nomi, IP va user-agent. Hujumchi boshqalarning emailini sinab ko'rayotgan bo'lsa, jurnal o'zi shaxsiy ma'lumot ombori bo'lib qolmasin.
4.7 CSP qayerda turadi
Web tomonda ham bitta qaror bor edi. index.html da qo'lda yozilgan <meta> CSP turardi, ichida eski production manzili va dasturchi kompyuterining manzili bor edi. Qoida oddiy: CSP — HTTP sarlavhada (CSP chuqur). Lekin GitHub Pages sarlavha qo'ya olmaydi.
Kanon yechimi: <meta> faqat Pages build'ida (META_CSP=1) Vite plagini orqali qo'yiladi, connect-src ga esa faqat VITE_API_URL manzili tushadi. nginx yoki Vercel'da esa sarlavha. Narxi: meta CSP'da frame-ancestors ishlamaydi va sozlama ikki joyda yashaydi.
4.8 Hammasi bitta jadvalda
| O'zgarish | Yutuq | Narx |
|---|---|---|
| readiness keshsiz | o'lik nusxaga trafik yo'q | har tekshiruvda SELECT 1 |
ILOVA_SIRI majburiy |
kalitlar jim o'lmaydi | sirsiz deploy yiqiladi |
ILOVA_SIRI_ESKI |
rejali almashtirishda uzilish yo'q | o'tish davrida eski sir kuchda |
| 10 ta API kalit | sizish yuzasi kichik | tranzaksiya va qulf |
| 429 namunasi | baza hujumda to'lmaydi | jurnaldagi son taxminiy |
| meta CSP faqat Pages'da | ikki siyosat yo'q | frame-ancestors yo'q |
Bu jadval — darsning asosiy natijasi. Har qatorning o'ng ustuni bo'sh bo'lsa, qaror hali to'liq o'ylanmagan.
Tekshirib ko'ring: Hamkasbingiz taklif qiladi: "429 larni umuman jurnalga yozmaylik, metrika yetarli". Bu variantning narxi nima?
Javob
Metrika "nechta" degan savolga javob beradi, lekin "qaysi IP, qachon boshladi, qaysi qoida" degan tergov savollariga emas. Incident paytida jurnalda hujumning izi umuman qolmaydi. Kanon o'rtadagi variantni tanladi: hujumni ko'rish uchun yetarli namuna yoziladi, aniq son esa metrikada. Uch variant — "hammasi", "namuna", "hech narsa" — 3-mashqda raqam bilan solishtiriladi.
5. Zaruriy va tasodifiy murakkablik
5.1 Brooks'ning ikki turi
Fred Brooks 1986-yildagi "No Silver Bullet" maqolasida murakkablikni ikkiga ajratgan:
- Zaruriy murakkablik (essential complexity) — masalaning o'zida bor qiyinlik. Ko'p foydalanuvchi bitta bazada ishlasa, ma'lumotni ajratish kerak. Parallel so'rovlar bo'lsa, poyga holatini hal qilish kerak. Buni yo'qotib bo'lmaydi, faqat yaxshi tashkil qilish mumkin.
- Tasodifiy murakkablik (accidental complexity) — biz o'zimiz qo'shgan qiyinlik: vositalar, formatlar, eski qarorlar, keraksiz qatlamlar. Buni kamaytirish mumkin va kerak.
Arxitektorning vazifasi — zaruriyni to'g'ri joylashtirish va tasodifiyni kamaytirish. Yomon arxitektura tasodifiy murakkablikni ko'paytiradi. Masalan, ikki dasturchili loyihada 12 ta mikroservis.
5.2 Yangi versiyadagi ikkala tur
Zaruriy: advisory lock. Parallel so'rovlar bor — bu masalaning o'zi. Qulfsiz cheklov ishlamaydi, 35-qism buni o'lchagan.
Tasodifiy — ikkita kichik, lekin ibratli misol:
.gitignorega.env.*qo'shildi. Lekin loyihada ikkita namuna fayl bor:.env.exampleva.env.compose.example. Ikkinchisini unutsangiz, u ham yashirinib qoladi. Shuning uchun ikkita istisno qatori yozildi. Agar namuna bitta bo'lganda, qoida ham soddaroq bo'lardi.xavfsizlik.ymldagi qadam nomida#bor edi. YAML'da bo'shliqdan keyingi#— izoh boshlanishi. Natijada nomning qolgan qismi jim kesilib ketardi. Tuzatish — nomlar qo'shtirnoqda. Masalada bunday qiyinlik yo'q, uni format qo'shgan. Bu tuzatishactbilan qayta sinalmadi — sinalmagan.
Tekshirib ko'ring:
vazifalar-apida beshta ombor adapteri bor: xotira, fayl, pg, Prisma va kesh. Bu zaruriy murakkablikmi yoki tasodifiymi?
Javob
Kontekstga bog'liq. Kursda bu ataylab qilingan: har adapter bitta qismda o'rgatilgan va bitta shartnoma testi bilan sinalgan. Real mahsulotda esa beshtasi kerak emas — odatda bitta asosiy ombor va testlar uchun xotira varianti yetadi. Qolganlari mahsulot uchun tasodifiy murakkablik bo'lardi: har yangi metodni besh joyda yozish kerak. Bitta kod ikki kontekstda ikki xil baholanishi — trade-off tafakkurining o'zi.
6. Loyiha qadami: 4.4.0
6.1 Avval eski kodda yiqilsin
Har tuzatishdan oldin regressiya testi yozildi: test/qoldiq-xavflar.test.ts, 9 ta test. U faqat xulqqa tayanadi, yangi eksportlarga emas. Shuning uchun uni 35-qism kodida ham ishga tushirish mumkin bo'ldi. Natija — 9 testdan 9 tasi yiqildi. Xatolardan bir bo'lak:
TypeError: yangi.eskiKalit is not a function
Error: Unsupported state or unable to authenticate data
Error: expected 503 "Service Unavailable", got 200 "OK"
Tests 9 failed (9)Tarjimasi: birinchisi — "eskiKalit funksiya emas": eski kodda bu metod umuman yo'q. Ikkinchisi — "holat qo'llab-quvvatlanmaydi yoki ma'lumotni tasdiqlab bo'lmadi": Node'ning AES-GCM shifri boshqa kalit bilan ochilmaganda shunday deydi. Aynan shu xato eski kodda foydalanuvchiga 500 bo'lib chiqardi. Uchinchisi — "503 kutilgan edi, 200 keldi": readiness keshdan "tayyorman" degan.
Yangi kodda (4.4.0) xuddi shu fayl: Tests 9 passed (9). "Avval eski kodda yiqilsin" qoidasi testning o'zini tekshiradi. Eski kodda o'tib ketadigan test hech narsani isbotlamaydi.
6.2 Biz shunday xato qildik: istisno sizishni yashirgan
35-qismda gitleaks hujjatlardagi jadvallarni kalit deb o'ylab, soxta ijobiy natija bergan edi (Xavfsizlik testlari). Shunda biz docs/ papkasidagi hamma .md faylni hamma qoidalardan ozod qilgandik. Tez yechim edi — va noto'g'ri.
Uni tekshirish uchun docs/sizgan.md ga sintetik AWS kaliti qo'yib, gitleaks v8.30.1 ni CI'dagidek ishga tushirdik. Eski sozlama:
7:03AM INF no leaks foundHujjatga tushgan haqiqiy ko'rinishdagi kalitni ham ko'rmadi. Yangi sozlamada istisno torroq: faqat generic-api-key qoidasi va faqat tekshirilgan ikkita fayl:
-[allowlist]
-paths = ['''^docs/.*\.md$''']
+[[allowlists]]
+targetRules = ["generic-api-key"]
+paths = ['''^docs/XAVFSIZLIK\.md$''', '''^docs/OWASP-API\.md$''']description qatorlarini tushirib qoldirdik. Natija:
RuleID: generic-api-key
File: docs/sizgan.md
RuleID: aws-access-token
File: docs/sizgan.md
7:03AM WRN leaks found: 2Saboq trade-off haqida: soxta ijobiyni kamaytirish va haqiqiy topilmani ko'rish bir-biriga zid. Keng istisno shovqinni o'chiradi, lekin sizishni ham. Tor istisnoning narxi — kelajakda yangi soxta ijobiy chiqsa, uni alohida tahlil qilib, yangi qator qo'shish.
6.3 Tekshiruv va commit
To'liq tekshiruv (Windows 11, Node 24.21.0, PostgreSQL 18.6): tip 0, lint 0, build 0; Vitest — 370 test o'tdi, 1 o'tkazib yuborildi; e2e 10/10. Jonli tekshiruvdagi status kodlari 35-qism yakuni bilan aynan. Web tomonda CSP testi: eski index.html da 4 testdan 2 tasi yiqildi, yangisida 4/4.
Hujjatga docs/qanday/sir-sizdi.md yangilandi: ILOVA_SIRI_ESKI qachon qo'yiladi (rejali almashtirish) va qachon yo'q (sizish). Versiya — 4.4.0: yangi imkoniyatlar bor (feat), shuning uchun minor (CHANGELOG va reliz avtomatikasi). Commit xabari:
feat(sir): ILOVA_SIRI_ESKI bilan ikki kalitli almashtirish; fix: production'da ILOVA_SIRI majburiy, TOTP 409, /health/ready keshsiz; feat(auth): API kalit limiti, 429 jurnalga; ci: gitleaks istisnosi toraytirildiWeb uchun alohida commit: fix(csp): meta CSP faqat Pages build'ida (Vite plagini), dev manzili olib tashlandi.
7. Ko'p uchraydigan xatolar
7.1 "Bu yechimning kamchiligi yo'q"
Har yechimning narxi bor. Topilmagan bo'lsa — hali qidirilmagan. "Narx" ustuni bo'sh qaror qabul qilinmaydi.
7.2 Sifat atributini o'lchamasdan tanlash
"Kesh tezlashtiradi" — taxmin. Readiness misoli ko'rsatdi: kesh to'g'rilikni buzishi mumkin. Atribut raqam bilan baholansin: p99, 503 lar soni, INSERT soni.
7.3 Kontekstsiz "eng yaxshi amaliyot"
"Har urinishni jurnalga yozish kerak" — admin paneli uchun to'g'ri, ommaviy login uchun xavfli. Amaliyot kontekst bilan birga keladi.
7.4 "Qachon kerak emas" ni yozmaslik
Bir yildan keyin kimdir 429 namunasini ko'rib, "xato" deb tuzatib qo'yadi. Sababi va chegarasi yozilmagan qaror qayta-qayta bahsga aylanadi. Bunday yozuvlarni ADR va C4 darsida tizimli qilamiz.
7.5 Tasodifiy murakkablikni zaruriy deb oqlash
"Loyihamiz murakkab, shuning uchun 12 servis" — ko'pincha teskarisi. Avval masalaning o'zi qanchalik murakkabligini so'rang.
8. Mashqlar
Mashqlar kurs/mashqlar/36/01-trade-off/ da. 2- va 3-mashq yechimlari Node 24.21.0 da tekshirilgan (biz ishga tushirdik).
1-mashq (oson): bo'shliqlarni to'ldiring
- Keyin o'zgartirish qimmat bo'lgan qarorlar yig'indisi —
- Noto'g'ri sozlamada ilova umuman ishga tushmasligi — fail
- Postgres o'chiq bo'lsa, yangi readiness qaytaradigan status —
- Bitta foydalanuvchida ko'pi bilan nechta faol API kalit —
- Masalaning o'zida bor, yo'qotib bo'lmaydigan qiyinlik — murakkablik
Yechim
- arxitektura — Fowler va Johnson ta'rifi: muhim va qiyin o'zgaradigan qarorlar.
- closed — sir yo'q bo'lsa ishga tushmaslik xavfsizroq.
- 503 — nginx yoki orkestrator trafikni boshqa nusxaga yuboradi.
- 10 —
MAKS_API_KALIT; o'n birinchisi 409. - zaruriy — tasodifiyni esa kamaytirish mumkin.
2-mashq (o'rta): namuna qadami
jurnalHajmi(urinishlar, limit, qadam) funksiyasini yozing. U ham "birinchi rad va har qadam-chi urinish" qoidasini ishlatsin. Natija: { rad, yozuv, ulush }, bu yerda ulush — yozuvlarning raddagi foizi, bitta kasr xonasi bilan (satr). 1000 urinish va limit 5 uchun qadam 1, 10 va 100 ni solishtiring.
Ishora: «429 jurnali» bo'limidagi hujum funksiyasidan boshlang. Foizni (a / b * 100).toFixed(1) bilan hisoblang (Matn, son va sonni tekshirish).
Yechim
function jurnalHajmi(urinishlar, limit, qadam) {
let rad = 0;
let yozuv = 0;
for (let son = limit + 1; son <= urinishlar; son++) {
rad++;
if (son === limit + 1 || son % qadam === 0) yozuv++;
}
const ulush = (yozuv / rad * 100).toFixed(1);
return { rad, yozuv, ulush };
}
for (const qadam of [1, 10, 100]) {
const n = jurnalHajmi(1000, 5, qadam);
console.log(`qadam ${qadam}: ${n.yozuv} ta yozuv (${n.ulush}%)`);
}Konsolda:
qadam 1: 995 ta yozuv (100.0%)
qadam 10: 101 ta yozuv (10.2%)
qadam 100: 11 ta yozuv (1.1%)Qadam o'sgani sari bazaga yuk kamayadi, tergov ma'lumoti ham kamayadi. Qadam 100 da 1000 urinishdan bor-yo'g'i 11 ta iz qoladi: hujum boshlangani ko'rinadi, lekin uning shakli (qaysi daqiqada kuchaygani) deyarli yo'qoladi. Kanon 10 ni tanladi — o'rtadagi nuqta. Sikl limit + 1 dan boshlanadi: undan oldingi urinishlar rad etilmaydi.
3-mashq (qiyin): qaror matritsasi
Uch variantni solishtiring: "har rad", "namuna", "hech narsa". Har birida uchta atributga 1 dan 5 gacha taxminiy ball bor: tergov, yuk (5 — bazaga eng kam yuk), soddalik. tanla(variantlar, vaznlar, minimal) funksiyasini yozing:
minimaldagi chegaradan past atributi bor variant — rad etiladi (veto), sababi bilan;- qolganlarida
ball = Σ (atribut × vazn); - natija — kamayish tartibida satrlar ro'yxati.
Ikki kontekstni sinang: hujumga ochiq login (yuk vazni 2) va ichki admin paneli (yuk vazni 0). Ikkalasida ham tergov vazni 2, soddalik vazni 1, minimal tergov — 2.
Ishora: Object.entries bilan atributlarni aylaning (Object.* metodlari), toSorted bilan tartiblang (Nusxa bilan o'zgartirish).
Yechim
const variantlar = [
{ nom: "har rad", tergov: 5, yuk: 1, soddalik: 5 },
{ nom: "namuna", tergov: 4, yuk: 4, soddalik: 4 },
{ nom: "hech narsa", tergov: 1, yuk: 5, soddalik: 5 },
];
function tanla(royxat, vaznlar, minimal) {
const natija = [];
for (const v of royxat) {
const past = Object.entries(minimal)
.find(([k, chegara]) => v[k] < chegara);
if (past) {
natija.push({ nom: v.nom, ball: -1, izoh: `rad: ${past[0]}` });
continue;
}
let ball = 0;
for (const [k, vazn] of Object.entries(vaznlar)) {
ball += v[k] * vazn;
}
natija.push({ nom: v.nom, ball, izoh: `${ball}` });
}
return natija.toSorted((a, b) => b.ball - a.ball)
.map((x) => `${x.nom}: ${x.izoh}`);
}
const minimal = { tergov: 2 };
console.log(tanla(variantlar,
{ tergov: 2, yuk: 2, soddalik: 1 }, minimal).join(" | "));
console.log(tanla(variantlar,
{ tergov: 2, yuk: 0, soddalik: 1 }, minimal).join(" | "));Konsolda:
namuna: 20 | har rad: 17 | hech narsa: rad: tergov
har rad: 15 | namuna: 12 | hech narsa: rad: tergovBir xil variantlar, ikki xil javob. Hujumga ochiq loginda bazaga yuk muhim — "namuna" yutadi. Ichki admin panelida hujum kam, har urinish qimmatli — "har rad" yutadi. Bu «Qachon kerak emas» savolining raqamli ko'rinishi. "Hech narsa" ikkalasida ham veto bilan chiqdi: tergov minimaldan past variant ballari qanchalik yuqori bo'lmasin, tanlanmaydi. Ballar o'lchov emas, kelishilgan taxmin — haqiqiy jamoada ular muhokamada qo'yiladi.
9. Real ishda
- Arxitektura ko'rib chiqishi. Katta kompaniyalarda yangi xizmat dizayn hujjati bilan boshlanadi. Unda "ko'rib chiqilgan muqobillar" va "narx" bo'limi majburiy. Bu hujjatni Design doc (RFC), runbook va postmortem darsida yozamiz.
- ATAM. Carnegie Mellon'ning SEI instituti arxitekturani sifat atributlari bo'yicha baholash usulini ishlab chiqqan — ATAM (Architecture Tradeoff Analysis Method). Uning markazida ham trade-off va "sezgir nuqtalar" turadi.
- Intervyu. System design intervyusida "eng yaxshi" javob kutilmaydi. Kutiladigani — har tanlovning narxini aytish: "kesh qo'yaman, lekin eskirish oynasi 60 soniya, bu yerda bunga chidash mumkin, chunki…".
- Bu qism. Oldinda SOLID, patternlar, monolit va mikroservis, kesh, masshtablash. Har mavzuni shu uch savol bilan o'qiymiz. Qism oxirida esa
jamoacapstone'i uchun dizayn hujjati yozasiz — diagramma va qarorlar yozuvi bilan.
Xulosa
- Arxitektura — keyin o'zgartirish qimmat bo'lgan qarorlar; yaxshi arxitektura keyingi qarorlarni arzonlashtiradi.
- Sifat atributlari (performance, scalability, availability, security, maintainability) bir-biriga zid — "eng yaxshi" emas, "eng mos" tanlanadi.
- Har qarorga uch savol: nima yutamiz, nima to'laymiz, qachon kerak emas.
- Zaruriy murakkablikni to'g'ri joylashtiring, tasodifiyni kamaytiring.
- 4.4.0: readiness keshsiz, sirsiz ishga tushmaslik, ikki kalitli almashtirish, 10 ta API kalit, 429 namunasi — har biri regressiya testi bilan (eski kodda 9/9 yiqildi, yangisida 9/9 o'tdi).
Keyingi dars: Loyiha papka tuzilmasi: layer-based va feature-based — vazifalar-api va web papkalarini o'lchaymiz: bitta o'zgarish nechta papkaga tegadi.
Manbalar
- Martin Fowler — Software Architecture Guide: https://martinfowler.com/architecture/ (tekshirildi, 2026-11)
- Martin Fowler — Who Needs an Architect? (IEEE Software, 2003): https://martinfowler.com/ieeeSoftware/whoNeedsArchitect.pdf (tekshirildi, 2026-11: "important stuff", "things that people perceive as hard to change")
- Frederick P. Brooks — No Silver Bullet: Essence and Accidents of Software Engineering (1986; IEEE Computer, 1987)
- Mark Richards, Neal Ford — Fundamentals of Software Architecture (O'Reilly, 2020) — "birinchi qonun": "Everything in software architecture is a trade-off" (O'Reilly sahifasi va mualliflar intervyusi bilan tekshirildi, 2026-11)
- ISO/IEC 25010:2023 — Product quality model: https://www.iso.org/standard/78176.html (tekshirildi, 2026-11: "nine characteristics" — sahifa avtomatik so'rovga 403 beradi, mazmuni qidiruv natijasidan)
- SEI — Architecture Tradeoff Analysis Method: https://www.sei.cmu.edu/library/architecture-tradeoff-analysis-method-collection/ (tekshirildi, 2026-11)
- Kurs tajribasi (IlmHamroh, 2026-11):
vazifalar-api4.4.0 — regressiya (35-qism kodida 9/9 yiqildi, 4.4.0 da 9/9), gitleaks v8.30.1 istisno sinovi, to'liq tekshiruv (Windows 11, Node 24.21.0, PostgreSQL 18.6). Mashq yechimlari — biz ishga tushirdik (2026-11-09).
Izohlar · 0
Izoh yozish uchun kiring.