Задача

Revisitor вирішує прикладну задачу: сервіс повторних візитів і ре-енгейджмента на TypeScript. Node API для розкладів, легкої аналітики та інтеграцій.

Проект належить до комерційної розробки і активно розробляється. Він пов'язаний з послугами: SEO, AEO та GEO: підготовка сайтів до AI-пошуку, інженерія зростання та контент-платформи.

Цей кейс демонструє підхід до завдань у сфері «SEO, AEO та GEO: підготовка сайтів до AI-пошуку»: від постановки до здачі з зрозумілою структурою модулів.

Перед стартом були зафіксовані критерії готовності: зрозумілий перший екран, передбачувані помилки форм, можливість доопрацювання без переписування половини кодової бази.

Рішення

Зроблена навчальна, але повноцінна реалізація з акцентом на читабельність коду та відтворювальну збірку.

Сценарії спроектовані так, щоб основні дії укладалися в один–два екрани: менше переключень, менше помилок при введенні. Навігація та підписи полів узгоджені з звичними патернами — користувачеві не потрібно «вчити інтерфейс».

Окрему увагу — состояния загрузки та пусті списки: skeleton/spinner там, де дані приходять асинхронно, і зрозумілі empty-state тексти замість пустої таблиці.

Архітектура і стек

Сервер і дані: Node.js.

Інфраструктура і утиліти: TypeScript.

Розподіл мов у репозиторії: TypeScript (68.7%), JavaScript (16.1%), HTML (14.9%), Dockerfile (0.3%).

Шари розділені так, щоб UI не знав деталей транспорту: адаптери API/сховища, доменні типи, компоненти представлення. Це спрощує заміну бекенду та точкові UX-правки.

Ключові функції

• TypeScript — використаний у продуктовій логіці: зменшує кількість самописного коду та прискорює додавання нових екранів.
• Node.js — використаний у продуктовій логіці: зменшує кількість самописного коду та прискорює додавання нових екранів.

Додатково:

• Інтеграція та використання TypeScript у продуктовій логіці та інтерфейсі.
• Інтеграція та використання Node.js у продуктовій логіці та інтерфейсі.
• Валідація користувацького вводу та зрозумілі повідомлення про помилки.

Результат

MVP вже покриває ключовий сценарій; далі — розширення звітності, тестів і моніторингу.

Вихідний код відкритий: https://github.com/astropsy999/revisitor — можна оцінити структуру модулів і стиль комітів.

Що б покращив

Наступний крок — observability (логи/метрики), автотести на регресію та документація API для інтеграторів. Для high-load сценаріїв — профілювання вузьких місць та кешування довідників.