Розділ для інвесторів Schoeffel: чому адмінку ми зробили на Node.js, а не на Laravel
Розділ із дослідженнями для інвесторів, адмінка без жодного пакета і чесна розмова про те, у чому добрий Node.js
Коли ми писали про перший лендинг Schoeffel, ми назвали його Phase 01, цифровим фундаментом. Тепер цей лендинг стає сайтом. У Schoeffel з'явився розділ для інвесторів, і команда Дому веде його сама, через адмінку, яку ми зробили на Node.js.
Laravel наш основний бекенд, ми писали про нього багато разів. Цього разу ми обрали інше, і в статті пояснюємо чому: навіщо потрібен розділ, як влаштована адмінка, у чому Node.js справді сильний і яку його слабкість ми ніколи не стали б приховувати від клієнта.
НАВІЩО ІНВЕСТОРАМ
Дім, що народжується заново
Schoeffel заснований у Німеччині 1921 року. У статті Якщо бренд зник, чи справді він помер? ми питали, чи може повернутися ім'я з історією. Відповідь, яку дає Дім, сягає далі за просте відродження. Schoeffel народжується заново і стає вагомим брендом, і для нього вже розробляється потужна платформа електронної комерції.
На такому етапі бізнес говорить з інвесторами, а інвестори просять доказів. Новий розділ збирає в одному місці незалежні дослідження, на яких тримається погляд Дому на ринок перлів: стислі викладення звітів McKinsey і The Business of Fashion, BCG і Altagamma, UBS, CIBJO та GIA, а також головний огляд ринку, поруч із яким показано його ключові висновки.
Сторінку зроблено для читання й для пересилання. Фільтри ділять документи на «Ринок і клієнти» та «Перли», кожен фільтр має власне посилання, а одна кнопка завантажує все одразу. Кожен документ відкривається або завантажується в PDF, і будь-яку таку дію можна порахувати в аналітиці.
Дому, що народжується заново, потрібне місце, де живуть його докази.
Розділ живе в дизайні самого лендингу. Ми не додали жодного нового візуального стилю: той самий глибокий темно-синій, та сама шапка, що ховається під час прокручування, той самий підвал із головної сторінки. Для бренду такого віку цілісність сама по собі частина послання.
ЗАВДАННЯ
Що мала вміти адмінка
Завдання було коротким. Команда Schoeffel має змінювати розділ будь-коли, не телефонуючи нам. На практиці це п'ять умінь:
- додавати, правити, прибирати й переставляти документи разом з їхніми PDF;
- змінювати головний звіт, його обкладинку та ключові висновки;
- змінювати будь-який текст на сторінці, зокрема описи фільтрів;
- бачити результат у попередньому перегляді раніше за всіх;
- повертати будь-яку попередню версію, якщо щось пішло не так.
Були й дві умови, які вплинули на вибір технології сильніше за будь-яку функцію. Сайт Schoeffel статичний, на PHP, розміщений на звичайному віртуальному хостингу з cPanel, поза нашими серверами, і обслуговуємо його не ми. А публічна сторінка мала працювати, навіть якщо адмінка зупиниться.
ЧОМУ НЕ LARAVEL
Чому ми не взяли Laravel
Для більшості бізнес-систем ми обираємо Laravel без вагань: CRM, клієнтські портали, магазини, системи бронювання, усе, де є ролі, документи й велика адміністративна частина. Чому, пояснюють наші сайти на Laravel і порівняння в статті Laravel, Node.js чи Python для бізнес-застосунку.
Тут масштаб був іншим. Адмінка на Laravel принесла б цілий другий застосунок на сайт, який сам на Laravel не працює: Composer, теку vendor із тисячами файлів, базу даних і версію фреймворку, яку треба оновлювати щороку. І все це заради восьми документів і кількох десятків рядків тексту.
| Чого вимагало завдання | Laravel | Node.js, як зробили ми |
|---|---|---|
| Встановлення на віртуальний хостинг | Composer, тека vendor, база даних | Одна тека, один файл запуску |
| Зберігання даних | База даних і міграції | Файли JSON на диску |
| Сторонні пакети | Десятки, через фреймворк | Жодного |
| Щорічне обслуговування | Оновлення фреймворку і PHP | Нова LTS-лінія Node.js приблизно раз на два роки |
| Якщо адмінка зупинилася | Адмінка недоступна | Сторінка лишається опублікованою |
Гіршим від цього Laravel не стає. Він просто не того розміру для такої роботи. Коли клієнтові потрібна справжня система, угоди фреймворку заощаджують місяці. Коли потрібен невеликий точний інструмент поруч із сайтом, що вже існує, фреймворк здебільшого стає зайвою вагою.
ЧОМУ NODE.JS
У чому сила Node.js
Node.js виконує JavaScript на сервері. Його документація описує його як асинхронне середовище, кероване подіями: замість окремого потоку для кожного відвідувача один процес обслуговує багато з'єднань одночасно й перемикається між ними, поки кожне чекає на базу даних, файл чи мережу.
З нашого досвіду, його сильні сторони виглядають так.
Режим реального часу. Node.js найкращий там, де сервер тримає багато відкритих з'єднань і надсилає в них події: живі панелі, чати, сповіщення, екрани для спільної роботи. Саме для цього його й створювали.
Швидкість і паралелізм. Процес не простоює в очікуванні, тож скромний сервер тримає дуже багато одночасних з'єднань. Для продуктів із великою кількістю дрібних запитів це реальна економія і на залізі, і на затримках.
Одна мова на весь продукт. На одному нашому відносно великому проєкті команда по суті працює однією мовою: JavaScript, а для фулстеку TypeScript, з React, Vue чи Angular на фронтенді. Типи й правила перевірки даних спільні для браузера і сервера, і розробник переходить з одного боку на інший, не перебудовуючи голову. Коли ми добираємо Node.js-розробників для такого продукту, це головний аргумент.
Легкість. Застосунок на Node.js може бути одним процесом з одним файлом запуску. Для адмінки Schoeffel саме це й вирішило вибір: вона мала стояти поруч із чужим сайтом і нічого від нього не вимагати.
Node.js дає цеглини. План дому ви малюєте самі.
БЕЗ ПАКЕТІВ
Адмінка без жодної залежності
Адмінка займає близько 940 рядків нашого власного JavaScript, а в її package.json немає жодної залежності. Під час встановлення нічого не завантажується, отже, ніщо не застаріє, не зникне з реєстру і не прийде із зараженим оновленням.
Усе потрібне вже є всередині Node.js: HTTP-сервер, файлова система, криптографія і потоки. Навіть завантажені PDF читаються без бібліотеки, бо в Node.js тепер є ті самі вебстандарти Request і FormData, що й у браузерах:
async function form(req) {
const r = new Request('http://local' + req.url, {
method: 'POST', headers: req.headers,
body: Readable.toWeb(req), duplex: 'half' });
return await r.formData();
}
Дані лежать у двох файлах JSON: чернетка, яку править адмінка, і опублікована версія, з якої зібрано живу сторінку. Базу даних не треба створювати, зберігати в резервну копію і переносити. Адмінка працює на Node.js 20 і новіших; сама лінія 20 втратила підтримку у квітні 2026 року, тому для нового встановлення ми беремо актуальну LTS-лінію, 22 або 24, яку пропонує хостинг.

Адмінка виглядає як частина Дому. Її кольори взято з блоку Heritage на головній сторінці, світло-блакитний, що переходить у білий, з темно-синіми заголовками, а кнопки повторюють кнопки лендингу. Люди, які ведуть розділ, бачать Schoeffel, а не безлику панель керування.
ПУБЛІКАЦІЯ
Сторінка, якій не потрібна адмінка
Найважливіше рішення непомітне оку. Коли команда натискає Publish, адмінка записує на сайт готову статичну сторінку. Відвідувачі ніколи не звертаються до застосунку на Node.js. Якщо застосунок зупиниться, перезапуститься чи буде вимкнений на місяць, сторінка лишиться саме такою, якою її опублікували востаннє.
Щоб записувати цю сторінку безпечно, вистачило одного невеликого прийому. Нова сторінка спершу пишеться в тимчасовий файл, а потім перейменовується поверх старої, тож відвідувач ніколи не відкриє сторінку, записану наполовину:
function writeAtomic(file, content) {
const tmp = file + '.tmp-' + process.pid + '-' + Date.now();
fs.writeFileSync(tmp, content);
fs.renameSync(tmp, file);
}
Кожна публікація зберігає копію даних і самої сторінки. Адмінка показує останні 30 версій, а кнопка Bring back завантажує будь-яку з них у чернетку. Попередній перегляд показує чернетку до виходу у світ. Разом вони роблять адмінку поблажливою до помилок, а для зайнятої команди це важливіше за будь-який перелік функцій.
Публічна сторінка не повинна залежати від адмінки, яка її пише.
БЕЗПЕКА
Безпека без фреймворку
Фреймворк одразу дає вхід, сесії та захист форм. Без нього кожну з цих речей треба написати й перевірити вручну. Ми написали їх тим, що дає сам Node.js:
- пароль зберігається лише як хеш scrypt і порівнюється за сталий час;
- cookie сесії живе 12 годин, із прапорцями HttpOnly і SameSite=Strict;
- кожна форма, що щось змінює, несе власний токен;
- після 8 неправильних паролів за 15 хвилин з однієї адреси вхід перестає відповідати.
Завантаження перевіряються за вмістом, а не за назвою: файл приймається як PDF, лише якщо про це кажуть його перші байти, а назву файлу очищено ще до того, як він потрапить на диск. Кожен текст з адмінки екранується під час збирання сторінки, тож через неї на публічний сайт не потрапить ні HTML, ні скрипт. Сторінки адмінки просять пошуковики їх не індексувати, а сам застосунок із даними лежить поза публічною текою сайту.
ЦІНА ВИБОРУ
Єдина справжня слабкість: тимлід
Якщо назвати одну проблему Node.js, це буде тимлід. Node.js це середовище виконання, і готових рішень він майже не дає. Laravel приходить зі структурою: де живуть маршрути, як іде робота з базою, як перевіряються форми, як ставляться завдання в чергу. У Node.js архітектуру треба збирати, і багато чого команда пише сама.
Саме ця свобода дала змогу зробити адмінку Schoeffel такою маленькою. Вона ж пояснює, чому два проєкти на Node.js можуть не мати майже нічого спільного і чому новий розробник спершу вивчає, як влаштовано саме ваш. На великому продукті якість результату залежить від однієї людини: провідного розробника, який обирає структуру, записує її й тримає в ній усіх. Із сильним тимлідом Node.js швидкий і приємний. Без нього проєкт розростається в клубок, якого ніхто не хоче торкатися.
Для інструмента на 940 рядків структура вміщається в одній голові та в одному README. Для продукту з командою ми спершу плануємо тимліда, а потім стек.
ЩО ДАЛІ
Наступний шар
Розділ для інвесторів дотримується того самого правила, що й перший лендинг: один продуманий шар за раз, і кожен тримається сам. Наступний шар той, на який вказує цей розділ: платформа електронної комерції для Дому, що збирається продавати свої перли по всьому світу.
Кожен шар отримує інструмент, який йому пасує. Якісь будуть на Laravel, як більшість наших систем. Цей на Node.js, бо йому треба було бути легким, незалежним і непомітним. Попередні розділи цієї історії є в статті Building the Next Century і на сторінці партнерства зі Schoeffel.
ПИТАННЯ
Часті запитання
Чому невелику адмінку краще зробити на Node.js, а не на Laravel?
Для кількох документів і текстів поруч із сайтом, який сам не на Laravel, Node.js потребує набагато менше: одна тека, без бази даних і без пакетів. Для справжніх бізнес-систем із ролями, документами й великою адміністративною частиною ми й далі обираємо Laravel.
Для чого добрий Node.js?
Для продуктів у реальному часі, як-от живі панелі, чати й сповіщення, для API з великою кількістю одночасних з'єднань і для команд, яким потрібна одна мова, JavaScript і TypeScript, і на сервері, і на фронтенді.
Чи можна запустити застосунок на Node.js на віртуальному хостингу з cPanel?
Так, якщо хостинг дає в cPanel інструмент Setup Node.js App, як багато тарифів віртуального хостингу. Застосунок лежить поза публічною текою, а хостинг запускає його й дає йому адресу.
Яка головна слабкість Node.js?
За замовчуванням він майже не задає структури, тож архітектура залежить від тимліда. Друга слабкість у важких обчисленнях: поки одне завдання займає процес, інші відвідувачі чекають, тому таку роботу виносять в окремий обробник.
Що станеться зі сторінкою для інвесторів, якщо адмінка зупиниться?
Нічого. Publish записує на сайт готову статичну сторінку, тож відвідувачі до адмінки не доходять. Сторінка лишається такою, якою її опублікували востаннє, доки хтось не опублікує нову версію.
Джерела
- Node.js: About Node.js
- Node.js: Don't block the event loop
- Node.js: Release schedule and previous releases
- Node.js: Crypto module, scrypt
Потрібна невелика адмінка поруч із сайтом, який не хочеться переробляти? Подивімося, що їй справді потрібно.
Раз на тиждень одне сповіщення з новими статтями PERETZ. Нічого зайвого.