{"canonical_url":"https://engineer.company/uk/glossary/codebase/","content_markdown":"# Кодова база\n\n## Що це таке\n\nКодова база, англійською codebase, — це сукупність коду, яку команда редагує,\nрецензує і випускає як одне ціле. Коли інженери кажуть «кодова база», вони мають\nна увазі місце, куди потрапляє кожна зміна застосунку: сам код, його тести,\nскрипти, які його збирають і перевіряють, зміни бази даних і документи, що\nпояснюють, як усе це складається докупи.\n\n[The Twelve-Factor App](https://12factor.net/), методологія побудови\nвебсервісів, дає найкорисніше робоче визначення, бо перетворює межу на те, що\nможна перевірити. У централізованій системі контролю версій, як-от Subversion,\nкодова база — це один репозиторій. У розподіленій, як-от Git, — будь-який набір\nрепозиторіїв зі спільним кореневим комітом, тобто першим комітом в історії,\nтим, що не має батьківського. Два репозиторії, що виросли з того самого першого\nкоміту, — одна кодова база, хоч би як далеко вони розійшлися. Два, що почалися\nокремо, — дві кодові бази, навіть якщо файли в них майже однакові.\n\nПоруч із цим визначенням той самий документ ставить друге правило: одна кодова\nбаза, багато розгортань. Розгортання — це запущений екземпляр застосунку, і\nзазвичай їх кілька одночасно. Продакшн — одне, staging — інше, і локальна копія\nкожного розробника теж рахується. Усі вони працюють на тій самій кодовій базі,\nчасто на різних комітах: у розробника є зміни, до яких staging ще не дійшов, а\nна staging — зміни, яких продакшн поки не бачив.\n\nЩо має бути всередині, випливає з цього. Код і все, що потрібно, щоб зробити з\nнього робочу програму, належать до кодової бази, зокрема маніфест, який називає\nкожну залежність і її версію. Самі залежності зазвичай лежать зовні, і їх\nзавантажує менеджер пакетів. Значення, що змінюються від одного розгортання до\nіншого, теж лишаються зовні, а понад усе — облікові дані: пароль, закомічений\nодин раз, далі мандрує з кожною копією історії.\n\nКодова база може містити кілька програм. Монорепозиторій тримає фронтенд, API і\nкод бази даних поруч в одному репозиторії, тож один коміт може змінити все це\nразом. За правилом кореневого коміту це все одно одна кодова база. Протилежний\nвибір розносить застосунок по репозиторіях з окремими історіями, і тоді кожен\nрепозиторій — окрема кодова база. Twelve-factor каже про наслідок прямо: якщо\nкодових баз кілька, це розподілена система, і кожен її компонент — окремий\nзастосунок.\n\n## Чому це важливо\n\nМежа визначає, що може змінюватися разом. У межах однієї кодової бази зміну API\nі екрана, який його викликає, можна написати, відрецензувати і злити як одну\nодиницю. Між двома кодовими базами та сама зміна перетворюється на два pull\nrequests, два релізи й період, коли один бік випереджає інший. Обидва варіанти\nробочі; ціну визначає те, де провели межу.\n\nКодова база — це ще й одиниця, на яку поширюються стандарти. Набір тестів,\nлінтер, форматер, правило для повідомлень комітів і task runner беруть «кодову\nбазу» за свою область дії, а все, що лежить поза нею, лишається поза їхньою\nувагою.\n\nРанні рішення застигають у кодовій базі швидше, ніж будь-де. Кожен рядок,\nнаписаний після вибору, спирається на цей вибір, тож правило шарів чи планка\nякості, встановлені в перші тижні, стають формою всього, що з'являється далі.\nСкасувати їх пізніше означає переписати код, який наріс довкола.\n\nДля людей кодова база — це те, що отримує новачок. Якщо в ній є все потрібне,\nщоб зібрати, протестувати й запустити застосунок, новій людині вистачить одного\nклонування й однієї команди. Якщо знання живуть частково в коді, а частково в чиїйсь\nпам'яті, перший тиждень іде на те, щоб розібратися, що де.\n\n## Як це виглядає на практиці\n\nНа одній платформі\n[кодова база — це багатомовний монорепозиторій](/uk/portfolio/authored-578-go-task-automation-targets/)\nна Go, TypeScript, SQL, Python і shell, і кожна мова приносить власний спосіб\nзбирати, тестувати й лінтити. Відповіддю стала єдина точка входу: шар go-task,\nщо виріс до 578 іменованих цілей, 50 у кореневому файлі й 528 у файлах із\nпросторами імен під ним, із режимами розробки native, Docker і HTTPS, якістю\nкоду, керуванням базою даних і розгортанням. Будь-хто може виконати `task\n--list` і побачити весь інструментарій. Сторінка читає це число й як\nпопередження: 578 цілей — більше, ніж будь-хто здатен тримати в голові, тож саме\nнайменування і простори імен роблять усе це придатним до використання.\n\nІнший проєкт почався 25 листопада 2025 року з репозиторію без єдиного файлу, і\n[три рішення перших тижнів](/uk/portfolio/set-the-platforms-founding-technical-decisions/)\nтрималися й через дев'ять місяців і кілька тисяч комітів: шарова архітектура,\nдоступ до даних через збережені функції і планка нуля попереджень, встановлена\nще до того, як з'явилося багато коду. Міркування зі сторінки — серце цієї\nстатті: стандарт, запроваджений на коміті 5 000, — це проєкт із прибирання, а\nтой самий стандарт на коміті 50 — просто те, як працює репозиторій.\n\nВнутрішні стіни кодової бази можуть бути самим дизайном. В [описі архітектурного внеску засновниці компанії в межах роботи над NextMariner](/uk/portfolio/a-maritime-platform-built-in-clean-layers/) йдеться про морську платформу, побудовану у три шари: фронтенд на Next.js відповідає за відображення й нічого більше, навмисно тонкий Go API на Huma поверх Fiber маршрутизує, перевіряє й оркеструє, а бізнес-логіка живе у функціях PostgreSQL. Коли правило змінюється, воно змінюється в одному шарі, у SQL. Межі записали й забезпечили їх дотримання під час рев'ю, бо конвенція, за якою ніхто не стежить, перестає бути конвенцією.\n\nВласна кодова база цього сайту проводить межу іншого роду. Сторінки проєктів\nпишуться в окремому репозиторії, експортуються сюди скриптом і комітяться, щоб\nсайт збирався самостійно. Усередині цієї кодової бази це згенеровані файли, і\nінструкції для роботи тут кажуть, що вручну їх не редагують.\n\n## Де виникають проблеми\n\n### Скопійований код розходиться\n\nДвом застосункам потрібна та сама допоміжна функція, і найшвидше — скопіювати\nїї. За рік існують дві версії з різними виправленнями, і помилка, закрита в\nодній, живе далі в іншій. Twelve-factor називає кілька застосунків зі спільним\nкодом порушенням методології і вказує вихід: винести спільну частину в\nбібліотеку, підключати її через менеджер залежностей, і нехай кожна кодова база\nвказує версію, яку використовує.\n\n### Секрет потрапляє в історію\n\nРядок підключення або ключ API потрапляє в коміт разом із конфігураційним файлом\nі відтоді лежить в історії, яку несе кожен клон, навіть після того, як пізніший\nкоміт видалив рядок. Перевірку twelve-factor варто робити перед кожним комітом:\nчи можна сьогодні опублікувати цю кодову базу як відкритий код, не розкривши\nоблікових даних? Усе, що цю перевірку провалює, належить до середовища кожного\nрозгортання.\n\n### Згенерований файл правлять вручну\n\nФайл, створений скриптом, виглядає як будь-який інший вихідний файл, тож хтось\nвиправляє друкарську помилку просто в ньому. Наступний запуск скрипта записує\nстарий текст назад, і виправлення тихо зникає. Позначайте згенеровані шляхи\nчітко, залиште генератор єдиним, хто їх пише, і спрямовуйте кожне виправлення у\nвхідні дані генератора.\n\n### Внутрішні стіни тоншають\n\nПід тиском дедлайну запит до бази потрапляє просто в обробник HTTP-запиту, бо це\nнайкоротший шлях, і шари, з якими починався проєкт, перестають описувати код.\nКожен обхідний шлях малий. Разом вони перетворюють зміну у два рядки на таку, що\nзачіпає кожен шар. Записане правило допомагає, рецензування допомагає більше, а\nперевірка, яка зупиняє збирання, коли один шар лізе в інший, допомагає\nнайбільше.\n\n### Стандарт покриває половину коду\n\nЛінтер, налаштований для фронтенду, оминає shell-скрипти і SQL, і саме ці файли\nзбирають ті проблеми, які лінтер мав зупиняти. Стандарт для всієї кодової бази\nмусить назвати кожну мову в ній, і це прихована ціна багатомовного репозиторію.\n\n### Форк стає новим продуктом\n\nКоманда копіює репозиторій, щоб почати споріднений продукт. Обидві копії\nзберігають той самий кореневий коміт, тож за правилом twelve-factor вони досі\nодна кодова база, яка тепер обслуговує два застосунки, і описане вище\nрозходження починається в масштабі цілого репозиторію. Порівняння кореневих\nкомітів показує, яка у вас ситуація:\n\n```sh\ngit -C app-a rev-list --max-parents=0 HEAD\ngit -C app-b rev-list --max-parents=0 HEAD\n```\n\nОднаковий вивід означає спільний корінь і спільну кодову базу; різний — дві\nокремі історії.\n\n## Що почитати далі\n\n- [I. Codebase](https://12factor.net/codebase) — правило «одна кодова база,\n  багато розгортань» і перевірка спільним кореневим комітом, на якій воно\n  тримається.\n- [II. Dependencies](https://12factor.net/dependencies) — як оголосити кожну\n  залежність у маніфесті й ізолювати її, щоб кодова база точно казала, що\n  підтягує.\n- [III. Config](https://12factor.net/config) — перевірка відкритим кодом для\n  всього, що має лишатися поза кодовою базою.\n- [gitsubmodules](https://git-scm.com/docs/gitsubmodules) — як Git вбудовує один\n  репозиторій в інший, коли кожен зберігає власну історію.\n- [git-rev-list](https://git-scm.com/docs/git-rev-list) — довідка про виведення\n  списку комітів, зокрема кореневих комітів історії.\n\n\u003chttps://engineer.company/uk/glossary/codebase/\u003e\n","date_modified":"2026-11-12T05:34:23Z","description":"Де закінчується одна кодова база і починається інша, що має бути всередині та як кодова база непомітно розпадається або набирає зайвого.","formats":{"gemtext":"https://engineer.company/uk/glossary/codebase/index.gmi","gopher":"https://engineer.company/uk/glossary/codebase/gophermap","html":"https://engineer.company/uk/glossary/codebase/","json":"https://engineer.company/uk/glossary/codebase/index.json","markdown":"https://engineer.company/uk/glossary/codebase/index.md","pdf":"https://engineer.company/uk/glossary/codebase/index.pdf"},"kind":"page","language":"uk","title":"Що таке кодова база?","url":"https://engineer.company/uk/glossary/codebase/","version":1}