{"canonical_url":"https://engineer.company/uk/glossary/architecture/","content_markdown":"# архітектура\n\n## Що це таке\n\nАрхітектура, яку в програмуванні часто називають архітектурою програмного забезпечення або\nархітектурою системи, — це сукупність фундаментальних понять і властивостей системи в її середовищі,\nвтілених у її елементах, у зв'язках між ними та в принципах, що визначають, як систему проєктують і\nяк вона змінюється. Це формулювання йде за визначенням із NIST SP 800-160 Volume 1 Revision 1,\nEngineering Trustworthy Secure Systems, опублікованого в листопаді 2022 року.\n\nКожна частина визначення має своє призначення. Елементи — це складники: сервіси, бази даних, черги,\nфронтенд, модулі всередині них. Зв'язки — це те, як складники залежать один від одного і що між ними\nпередається. Принципи — це правила, які вирішують, куди лягає нова робота, і не дають елементам і\nзв'язкам розповзатися, коли система росте. Слова «в її середовищі» роблять частиною архітектури\nкористувачів, сусідні системи й обмеження, а те, що визначення говорить і про розвиток у часі,\nозначає: опис, правдивий лише в день, коли його накреслили, неповний.\n\nНе кожне проєктне рішення архітектурне. Група, що підтримує формат Architectural Decision Record\n(ADR), називає архітектурним рішенням обґрунтований проєктний вибір, який відповідає на\nфункціональну чи нефункціональну вимогу, значущу для архітектури, а вимога значуща, коли має\nвимірний вплив на архітектуру та якість системи. Шаблон arc42 каже прямолінійніше: його розділ про\nрішення призначено для важливих, дорогих, ризикових або суперечливих рішень.\n\nОдне креслення ніколи не показує всього, тому архітектуру описують у кількох видах. Модель C4, яку\nстворив Simon Brown, пропонує діаграми, що працюють як карти, які можна наближати й віддаляти:\nдіаграму системного контексту, що показує, де система стоїть серед своїх користувачів і систем\nнавколо, діаграму контейнерів із застосунками та сховищами даних усередині неї, діаграму компонентів\nдля одного контейнера і, де це допомагає, діаграму коду. arc42 упорядковує письмовий опис у\nдванадцять розділів — від цілей і обмежень до рішень, ризиків і технічного боргу.\n\n## Чому це важливо\n\nРішення, яке архітектура ставить перед командою, стосується не так вибору структури, як того, які\nрішення ухвалити зараз, свідомо й письмово, а які лишити відкритими.\n\nЯкщо розв'язати структурне питання рано, платити доведеться ще до того, як багато відомо: вибір\nроблять, маючи найменше знань, які в проєкту колись будуть, і він сповільнює перші тижні. Якщо\nлишити його відкритим, структура все одно складеться — одна зручна зміна за раз, руками того, хто\nостаннім торкався коду. Вихід у тому, щоб розрізняти два види рішень. Небагато з них дорого\nзмінювати, щойно від них залежить код: як система ділиться на частини, якій частині належать\nбізнес-правила, як здійснюється доступ до даних, яку планку має долати кожна зміна. Їх варто\nухвалювати рано й навмисно. Більшість решти дешево переглянути, і вони можуть почекати, доки код\nпокаже, чого він потребує.\n\nЗапис — друга половина рішення, і саме в ньому виживає обґрунтування. ADR фіксує одне рішення з його\nобґрунтуванням, компромісами й наслідками, а сукупність ADR проєкту утворює його журнал рішень. Сайт\nADR приписує популяризацію ідеї допису Michael Nygard «Documenting Architecture Decisions» 2011\nроку. Ціна — сторінка тексту на кожне рішення. Віддача — пізніший читач може відрізнити свідомий\nкомпроміс від випадковості й перевірити, чи причина досі в силі.\n\nЦілі якості вирішують між структурами, які всі працювали б. arc42 просить назвати три найважливіші,\nщонайбільше п'ять, цілі якості для архітектури — ті, що найбільше важать для основних зацікавлених\nсторін, — і застерігає, що це не те саме, що цілі проєкту. Два дизайни з однаковими функціями можуть\nзовсім по-різному відмовляти, масштабуватися чи змінюватися, і лише цілі якості кажуть, яка різниця\nмає значення.\n\n## Як це виглядає на практиці\n\nРепозиторій платформи з'явився 25 листопада 2025 року зовсім порожнім, і сторінка про її\n[засадничі рішення](/uk/portfolio/set-the-platforms-founding-technical-decisions/)\nстверджує, що такі рішення «дешево ухвалити на третій день і майже неможливо переграти на шостому\nмісяці». Два з трьох рішень, ухвалених тоді, задали структуру. Стек поділено на рівні так, щоб кожна\nчастина мала одне завдання: фронтенд на Next.js, Go API, який перевіряє дані й передає їх далі, і\nрівень функцій PostgreSQL, якому належать бізнес-правила. Доступ до даних від самого початку сховано\nза збереженими функціями, бо «запровадити його згодом означало б переписати кожен обробник». Через\nдев'ять місяців і кілька тисяч комітів, за словами сторінки, рівні не розмилися й жоден обробник не\nзвертається до таблиці напряму. Перевірка засадничого рішення для неї — не те, чи звучало воно\nслушно, а те, чи витримало воно обсяг роботи, що надійшов потім.\n\nСтруктура, залишена на волю випадку, складається випадково, як показує сторінка про\n[GIS-карту](/uk/portfolio/directed-full-stack-gis-map-development/). Карта\nрозросталася частинами: просторові дані в PostgreSQL, малювання в Mapbox, ReactJS на фронтенді та\nNodeJS на бекенді. Кожна частина працювала сама по собі, але «їх не будували так, щоб вони пасували\nодна до одної». Роль охоплювала full-stack-розробку і технічне керівництво, і спочатку було\nвизначено архітектуру. Далі обов'язки «щоразу повертали на той рівень, де їм місце, щойно якийсь із\nних починав просочуватися в сусідній», а значна частина роботи полягала в тому, щоб «вчасно помічати\nдрібні неузгодженості, перш ніж вони встигали затвердіти в архітектурі».\n\nСторінка про\n[контейнерне середовище](/uk/portfolio/ran-containers-on-podman-and-quadlet/) вважає\nсправжнім результатом записану причину. Галузевий стандарт серед контейнерних рушіїв публікує порти\nконтейнерів із вищим пріоритетом, ніж правила брандмауера хоста, тож це середовище — контейнерний\nрушій без демона, що керує юнітами, згенерованими власним супервізором операційної системи, і зовсім\nбез опублікованих портів. Один компроміс записано саме як компроміс: юніти працюють на системному\nрівні, а не в rootless-режимі, що лишає автоматизацію нескладною ціною суворішої ізоляції, яку дав\nби rootless-режим, а в примітці сказано, у який бік рухатися, якщо втеча з контейнера колись\nважитиме більше. Саме це й містить ADR: рішення з його обґрунтуванням, компромісами й наслідками.\nСторінка ставить запис вибору разом із причиною вище за сам вибір, бо «наступній людині кожна\nстаття, яку вона прочитає, радитиме взяти стандартний».\n\n## Де виникають проблеми\n\n**Уважний новачок скасовує рішення, яке було свідомим.** Причина жила лише в чиїйсь голові, тож\nвибір схожий на помилку, а стандартний варіант, який радить кожен посібник, схожий на виправлення.\nПишіть ADR для кожного рішення, яке дорого скасувати: контекст, зважені варіанти, обраний, його\nнаслідки і те, що зробило б його вартим перегляду. Тримайте записи поруч із кодом, щоб зміну в\nодному переглядали разом з іншим.\n\n**Бізнес-правила з'являються одразу на трьох рівнях.** Кожна зміна клала свою логіку туди, де того\nдня було зручно, аж поки те саме правило не почали перевіряти у фронтенді, в API і в базі даних,\nщоразу трохи інакше. Назвіть, що належить кожному рівню, запишіть це й повертайте обов'язок на\nмісце, щойно він просочується, поки зайва копія ще мала. Де платформа дозволяє, закріпіть межу ще й\nтехнічно: наприклад, дозвольте API викликати функції бази даних, але не давайте йому прав на\nтаблиці.\n\n**Правило, запроваджене на шостому місяці, перетворюється на проєкт із прибирання.** Рішення, від\nякого залежить усе, лишили відкритим, і кожен коміт відтоді спирався на те, що випадково було\nправдою. Спершу ухваліть кілька дорогих рішень, а решту навмисно лишіть відкритими. Напишіть про це\nв журналі рішень, щоб відкрите питання було видимо відкритим, а не тихо розв'язаним наступною\nзміною.\n\n**Архітектурна діаграма нікому нічого не пояснює.** Одне креслення змішує користувачів, сервіси,\nкласи й таблиці, а лінії між блоками або не мають підпису, або підписані одним словом «Uses».\nМалюйте по одній діаграмі на кожен рівень масштабу, як це робить C4, і підписуйте кожну лінію\nвідповідно до напрямку й призначення зв'язку; між контейнерами називайте ще й технологію чи\nпротокол. Настанови C4 щодо нотації вимагають саме цього й радять уникати підписів з одного слова.\n\n## Що почитати далі\n\n- [architecture, NIST CSRC Glossary](https://csrc.nist.gov/glossary/term/architecture) — визначення,\n  використане вище, поряд із визначенням FIPS і визначенням архітектури безпеки, які ділять ту саму\n  статтю.\n- [NIST SP 800-160 Vol. 1 Rev. 1](https://csrc.nist.gov/pubs/sp/800/160/v1/r1/final) — Engineering\n  Trustworthy Secure Systems, публікація, з якої взято визначення.\n- [Architectural Decision Records](https://adr.github.io/) — що робить рішення архітектурним,\n  шаблони для його запису й інструменти, які в цьому допомагають.\n- [The C4 model](https://c4model.com/) — чотири рівні діаграм, від системного контексту до коду, з\n  порадами щодо нотації та чеклистом для рев'ю.\n- [arc42](https://docs.arc42.org/home/) — практичні поради й приклади до кожного з дванадцяти\n  розділів шаблону arc42.\n\n\u003chttps://engineer.company/uk/glossary/architecture/\u003e\n","date_modified":"2026-10-20T21:59:50Z","description":"Що таке архітектура програмного забезпечення, які проєктні рішення варто ухвалити рано й записати та як структура розповзається, коли її правила не записані.","formats":{"gemtext":"https://engineer.company/uk/glossary/architecture/index.gmi","gopher":"https://engineer.company/uk/glossary/architecture/gophermap","html":"https://engineer.company/uk/glossary/architecture/","json":"https://engineer.company/uk/glossary/architecture/index.json","markdown":"https://engineer.company/uk/glossary/architecture/index.md","pdf":"https://engineer.company/uk/glossary/architecture/index.pdf"},"kind":"page","language":"uk","title":"Що таке архітектура?","url":"https://engineer.company/uk/glossary/architecture/","version":1}