{"canonical_url":"https://engineer.company/uk/glossary/technical-debt/","content_markdown":"# Технічний борг\n\n## Що це таке\n\nТехнічний борг — це майбутня ціна спрощення в дизайні або коді системи: рішення,\nяке заощаджує час сьогодні, а пізніші зміни робить повільнішими, ризикованішими\nчи взагалі неможливими, доки це спрощення не приберуть. Англійською це називають\ntechnical debt, часто скорочено tech debt. Назва — метафора, і її обрали тому,\nщо таке спрощення поводиться як позика: воно купує щось зараз і бере за це плату\nзгодом, поки лишається на місці.\n\nІдея походить зі звіту Ворда Каннінгема про досвід розробки WyCash, системи для\nкерування інвестиційними портфелями, написаної на Smalltalk. Звіт він представив\nна конференції OOPSLA 1992 року. Невелика команда мала загальне уявлення про\nблизько чотирьох мегабайтів вихідного коду, а зрілі частини програми багато\nразів переглядали чи переписували. Саме ця консолідація, стверджує звіт, зробила\nможливим рівномірне поступове зростання, а її відсутність і є серйозною пасткою:\nкод, який працює і задовольняє клієнта, але так і не був доведений до ладу.\nКаннінгем висловив це одним рядком: «Shipping first time code is like going into\ndebt». Сам звіт говорить лише про борг і про свою боргову аналогію. Пізніші\nпраці вживають повну назву, а стаття Google 2015 року називає технічний борг\nметафорою, яку Ворд Каннінгем запровадив 1992 року.\n\nДослідники, які зібралися в Дагштулі у квітні 2016 року, щоб домовитися, що\nохоплює це поняття, сформулювали робоче визначення: сукупність проєктних або\nреалізаційних конструкцій, зручних у короткій перспективі, які, однак, створюють\nтехнічний контекст, здатний зробити майбутні зміни дорожчими або неможливими.\nВплив вони обмежують якостями всередині системи, передусім тим, наскільки легко\nїї супроводжувати й розвивати. Це відрізняє борг від функції, якої ніхто не\nзбудував: ціну боргу платять ті, хто змінює систему, а до користувачів вона\nдоходить лише через них. Той самий звіт зберігає фінансову лексику. Основна\nсума — це те, що заощадило спрощення, або скільки сьогодні коштувало б краще\nрішення. Відсотки бувають двох видів: поточні (recurring interest), які\nсплачують нижчою швидкістю, похідними дефектами й утраченою якістю, і\nнакопичувальні (accruing interest), тобто додаткова ціна кожної нової частини\nпрограмного забезпечення, збудованої поверх коду, який не зовсім правильний.\nБорг живе переважно в коді, але також у документації, тестах і відомих дефектах.\n\n## Чому це важливо\n\nБорг, узятий свідомо, може бути добрим рішенням. Звіт Каннінгема каже, що\nневеликий борг пришвидшує розробку, якщо його швидко повернути переписуванням, і\nстаття Google погоджується, що для позики часто є вагомі стратегічні причини.\nОбидва застерігають від боргу, який лишається неповерненим. У звіті кожна\nхвилина, витрачена на код, що не зовсім правильний, рахується як відсотки, а\nцілі організації розробників можуть зупинитися під вагою реалізації, яку ніхто\nне консолідував. Ще до того програма стає чимось, що жодна окрема людина не\nздатна осягнути, а це веде до програмістів, кожен з яких знає свій куток, і\nзрештою до продукту, який не може змінити напрям.\n\nПроблема в тому, що борг часто не є свідомим вибором. Звіт із Дагштуля зазначає,\nщо він часто виникає ненавмисно й застає розробників зненацька, тож виявляють\nйого здебільшого під час супроводу, через тривалий час після рішення, яке його створило.\nПричини буденні: тиск термінів, ключова людина, яка недоступна, або брак знань\nпро якусь технічну властивість на той момент. Стаття Google додає, що прихований\nборг небезпечний, бо росте непомітно.\n\nМетафора також дає розробникам і керівникам спільну мову. Звіт із Дагштуля\nназиває її потужним механізмом комунікації, а бачення, яке описують учасники,\nпередбачає керувати боргом так само ретельно, як дефектами й новими функціями, і\nмати спосіб перекладати між тим, що турбує розробників, і тим, що вирішують\nкерівники. Дослідження, представлене на семінарі, показує, що це може означати\nдля команди. Граціела Тонін, Альфредо Голдман і Керолін Сіман попросили\nстудентів у командах, де загалом було 60 людей, явно виявляти й відстежувати\nсвій борг. Видимий список дав командам змогу домовлятися із замовником про час\nна рефакторинг, слугував пам'яттю про незрілі частини проєкту й показував, чи\nпокращується якість коду. Більшість учасників команд сказали, що стали більше\nспілкуватися, ретельніше зважувати, чи справді потрібен той чи інший борг, і\nчастіше робити рефакторинг. Оскільки рішення взяти борг обговорювали, додають\nавтори, у деяких командах стало менше експертів, яких ніхто інший не міг\nзамінити.\n\n## Як це виглядає на практиці\n\nБорг стає керованим, коли його записують там, де команда планує свою роботу.\nЗапис у реєстрі, складений для цієї статті, може бути таким коротким:\n\n```text\nTD-14         Підсумки рахунків обчислюються у трьох місцях\nАртефакти:    billing/web, billing/export, reports/monthly\nПричина:      фіксована дата запуску; скопіювати правило було швидше,\n              ніж перенести його до спільного модуля\nОсновна сума: близько 2 днів, щоб перенести правило в один модуль\n              разом із тестами\nВідсотки:     кожну зміну податкових правил вносять і тестують тричі, і\n              одна з п'яти останніх змін пропустила одну з копій\nДалі:         погасити разом із наступною зміною податкових правил;\n              експорт електронних рахунків, запланований на цей\n              квартал, не має стати четвертою копією\nВласник:      команда білінгу\n```\n\nПоля відповідають моделі зі звіту Дагштуля: запис, прив'язаний до конкретних\nартефактів, із причиною, основною сумою й відсотками. Корисним запис робить саме\nполе відсотків, бо воно перетворює відчуття, що код білінгу заплутаний, на ціну,\nяку хтось може зважити. Якщо податкові правила змінюються чотири рази на рік і\nкожна зміна коштує зайвого дня роботи й тестування, два дні основної суми\nокупаються за пів року. Запланований експорт — це накопичувальні відсотки в\nсенсі Дагштуля: кожна нова частина, збудована на скопійованому правилі, робить\nпізніше виправлення дорожчим. А якби код був заморожений і ніхто не збирався\nйого чіпати, той самий запис був би аргументом залишити борг як є.\n\nБорг стосується не лише коду. Запис у портфоліо на цьому сайті про те, як\n[реорганізувати процеси й заощадити 8 000 годин](/uk/portfolio/overhauled-internal-processes-saving-8000-hours/),\nдокументує попередню роботу засновниці у Mappitall. Він питає читача, чи не гальмує його технічний борг, і описує той його різновид, що\nнакопичується навколо самої організації роботи: архітектуру програмного\nзабезпечення, яка розросталася стихійно, а не за задумом, системи, які\nпрацювали, але неефективно, і планування, через яке люди то чекали без діла, то\nбули перевантажені. Нічого з цього не «горіло», саме тому його й не чіпали. За\nроки роботи з 2015 до 2022 перебудова архітектури, систем і планування заощадила\nблизько 8 000 годин, а запис наголошує, що зміни вбудували в повсякденну роботу\nкоманди, бо покращення процесів, які не закріплено назавжди, з часом сповзають\nдо старого способу роботи.\n\n## Де виникають проблеми\n\n**Технічним боргом називають усе.** Щойно вираз стає популярним, цю етикетку\nотримує будь-яке подразнення, від старої бібліотеки й відсутньої функції до\nстилю колеги. Звіт із Дагштуля прямо називає цей ризик і у відповідь просить\nчітких визначень. Вживайте це поняття лише для спрощень, ціна яких лягає на\nмайбутні зміни, реєструйте дефекти як дефекти, а побажання як функції, і\nвідхиляйте запис у реєстрі, який не може назвати свою причину й свої відсотки.\n\n**Борг існує лише в головах.** Борг, який ніхто не записав, сплачує той, хто\nнаступним торкнеться коду, зазвичай не знаючи, чому робота триває так довго.\nВедіть реєстр поруч із беклогом і перевіряйте його, перш ніж змінювати частину\nсистеми, як студентські команди в дослідженні Тонін використовували свій список.\nЗапис стає видимим для тих, хто вирішує, на що витрачати час, лише тоді, коли\nвін стоїть там, куди вони дивляться.\n\n**Основну суму гасять там, де відсотки не нараховуються.** Прибирання в модулі,\nякого ніхто не змінює, здається продуктивним і нічого не повертає, тоді як код,\nщо змінюється щотижня, і далі коштує. Відсотки нараховуються лише там, де люди\nпрацюють, тож сортуйте реєстр за тим, як часто змінюється кожна частина і що\nнезабаром будуватимуть поверх неї, і гасіть найдорожчі записи першими.\n\n**Погашення відкладають до одного великого переписування.** На борг, що лежить\nроками, часто відповідають проєктом, який має замінити всю систему й сам набирає\nнового боргу, тоді як стара система і далі коштує. Каннінгем радив повертати\nборг швидко, а стаття Google перелічує звичні способи його гасити: рефакторинг\nкоду, кращі модульні тести, видалення мертвого коду, менше залежностей, суворіші\nAPI і краща документація. Жоден із них не додає функції; суть у тому, щоб\nнаступна зміна стала дешевшою. Плануйте їх як частину звичайної роботи, поруч зі\nзміною, якій вони потрібні.\n\n**Експерименти лишаються в робочому коді.** Перевірити альтернативу як умовну\nгілку в робочому коді дешево для кожного окремого експерименту, і стаття Google\nописує, як такі гілки накопичуються, доки перевірити всі комбінації не стає\nважко або неможливо. Вона згадує Knight Capital, чия система, за даними статті,\nвтратила 465 мільйонів доларів за 45 хвилин, судячи з усього, через те, що\nзастарілі експериментальні шляхи коду повелися неочікувано. Переглядайте кожну\nекспериментальну гілку й кожен прапорець за сталим графіком, видаляйте те, що\nвже не використовується, і цінуйте видалення коду так само, як додавання.\n\n**Оцінку інструмента сприймають за сам борг.** Статичний аналіз може порахувати\nдубльовані рядки й довгі функції, а дашборд робить це число схожим на залишок на\nбанківському рахунку. Стаття Google прямо каже, що метафора не дає суворої міри,\nяку можна відстежувати з часом, і що команда, яка досі рухається швидко, ще не\nдоводить, що боргу мало. У Дагштулі Форрест Шалл розповів, що жоден окремий\nнабір правил для пошуку боргу не корелював послідовно з його симптомами, як-от\nзростанням вартості змін і падінням швидкості, у різних проєктах. Звіряйте\nзнахідки інструмента з власною історією змін і дефектів, залишайте правила, які\nпередбачають витрати, а решту відкиньте. Кращою перевіркою є власні запитання\nстатті, зокрема те, як швидко новий учасник команди може ввійти в курс справи.\n\n## Що почитати далі\n\n- [The WyCash Portfolio Management System](https://c2.com/doc/oopsla92.html)\n  — звіт Ворда Каннінгема про досвід, представлений на OOPSLA '92, де вперше\n  з'являється боргова аналогія.\n- [Managing Technical Debt in Software Engineering](https://drops.dagstuhl.de/entities/document/10.4230/DagRep.6.4.110)\n  — звіт семінару Дагштуль 16162 із робочим визначенням, основною сумою й\n  відсотками та дослідженням явних списків боргу.\n- [Hidden Technical Debt in Machine Learning Systems](https://proceedings.neurips.cc/paper_files/paper/2015/hash/86df7dcfd896fcaf2674f757a2463eba-Abstract.html)\n  — стаття Скаллі та колег із Google 2015 року про те, як борг накопичується, як\n  його гасити і чому його важко виміряти.\n- [Refactoring](https://refactoring.com/) — сайт Мартіна Фаулера про невеликі\n  зміни, що зберігають поведінку, які стаття Google називає першими серед\n  способів гасити борг.\n\n\u003chttps://engineer.company/uk/glossary/technical-debt/\u003e\n","date_modified":"2026-11-09T21:50:25Z","description":"Звідки береться технічний борг, як рахують його основну суму й відсотки, як вести його реєстр і чому погашення боргу йде не так.","formats":{"gemtext":"https://engineer.company/uk/glossary/technical-debt/index.gmi","gopher":"https://engineer.company/uk/glossary/technical-debt/gophermap","html":"https://engineer.company/uk/glossary/technical-debt/","json":"https://engineer.company/uk/glossary/technical-debt/index.json","markdown":"https://engineer.company/uk/glossary/technical-debt/index.md","pdf":"https://engineer.company/uk/glossary/technical-debt/index.pdf"},"kind":"page","language":"uk","title":"Що таке технічний борг?","url":"https://engineer.company/uk/glossary/technical-debt/","version":1}