{"canonical_url":"https://engineer.company/uk/portfolio/vendored-a-qr-encoder-in-522-lines/","content_markdown":"# Вбудувала кодувальник QR на 522 рядки\n\nПеренесла в репозиторій власний кодувальник QR — код Ріда‑Соломона над GF(256), фіксоване розташування модулів, вісім шаблонів маски — на 522 рядках, замість додавати третю залежність середовища виконання, і перевірила його, зчитавши готову матрицю незалежно написаним декодером.\n\nсерпень 2026\n\n**Ситуація.** Документам потрібен був QR‑код із посиланням на онлайн‑версію. Це вміє будь‑яка доступна бібліотека, але взяти одну з них означало б додати третю залежність часу виконання до проєкту, який свідомо обмежився двома — рушієм шаблонів і рендерером PDF, — виходячи з того, що генератор документів має встановлюватися й через багато років.\n\n**Завдання.** Треба було або погодитися на залежність, або реалізувати формат самостійно, причому довести, що реалізація правильна, а не просто видає щось чорне й квадратне.\n\n**Дія.** Кодувальник займає 522 рядки й реалізує ті частини специфікації, які справді потрібні для цього завдання: кодування в байтовому режимі, виправлення помилок кодом Ріда — Соломона над полем Галуа з 256 елементів із твірним многочленом потрібного степеня, фіксоване розташування модулів із пошуковими, синхронізувальними й вирівнювальними візерунками, інформацію про формат і версію, а також усі вісім масок даних, кожну з яких оцінюють за чотирма штрафними правилами специфікації, щоб обрати маску з найменшим штрафом, а не завжди ту саму. Саме перевірка зробила це рішення обґрунтованим. Перевірка кодувальника за його ж логікою нічого не доводить, тому готову матрицю модулів зчитує назад декодувальник, написаний незалежно за описаним у специфікації порядком читання, а тест перевіряє, що декодований рядок збігається з вхідним. Так «воно дає правдоподібне зображення» перетворюється на «воно дає код, який декодується в правильну URL‑адресу», і це перевіряють під час кожного прогону, а не один раз на око, телефоном.\n\n**Результат.** Кількість залежностей часу виконання лишилася на рівні двох, а кодувальник — єдиний вбудований (vendored) компонент у проєкті. Слід прямо сказати, що це не універсальна реалізація: вона підтримує ті режими й версії, які використовують документи, і нічого більше, а чесне обґрунтування рішення — бюджет залежностей, а не якісь заяви, що результат кращий за зрілу бібліотеку.\n\n---\n\n- Роль: Python‑інженер\n- Категорії: [Backend‑розробка](https://software.engineer.company/uk/categories/backend/), [Оптимізація продуктивності](https://software.engineer.company/uk/categories/performance/), [Тестування та QA](https://software.engineer.company/uk/categories/testing/), [Python](https://software.engineer.company/uk/categories/python/), [Документація](https://software.engineer.company/uk/categories/documentation/)\n- Послуги: [Архітектура платформи та рішень](https://software.engineer.company/uk/services/platform-architecture/), [Backend- та API‑розробка](https://software.engineer.company/uk/services/backend-development/)\n\n\u003chttps://engineer.company/uk/portfolio/vendored-a-qr-encoder-in-522-lines/\u003e\n","date_modified":"2026-10-20T21:59:50Z","description":"Кількість залежностей часу виконання лишилася на рівні двох, а кодувальник — єдиний вбудований (vendored) компонент у проєкті.","formats":{"gemtext":"https://software.engineer.company/uk/portfolio/vendored-a-qr-encoder-in-522-lines/index.gmi","gopher":"https://software.engineer.company/uk/portfolio/vendored-a-qr-encoder-in-522-lines/gophermap","html":"https://software.engineer.company/uk/portfolio/vendored-a-qr-encoder-in-522-lines/","json":"https://software.engineer.company/uk/portfolio/vendored-a-qr-encoder-in-522-lines/index.json","markdown":"https://software.engineer.company/uk/portfolio/vendored-a-qr-encoder-in-522-lines/index.md","pdf":"https://software.engineer.company/uk/portfolio/vendored-a-qr-encoder-in-522-lines/index.pdf"},"kind":"page","language":"uk","title":"Вбудувала кодувальник QR на 522 рядки","url":"https://software.engineer.company/uk/portfolio/vendored-a-qr-encoder-in-522-lines/","version":1}