Задача

Refactor Analyzer вирішує прикладну задачу: Інструмент статичного аналізу для підказок по рефакторингу через AST. TypeScript Node CLI та звіти.

Це особистий навчальний проект (завершений і використовується), де відпрацьовувалися конкретні патерни та інструменти без зайвої обв'язки.

Кейс демонструє підхід до задач у сфері "Full-stack веб-додатків та дашбордів": від постановки до здачі з зрозумілою структурою модулів.

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

Рішення

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

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

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

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

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

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

Розподіл мов у репозиторії: TypeScript (97.9%), JavaScript (2.1%).

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

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

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

Додатково:

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

Результат

Проект доведено до робочого стану: команда/користувач отримує стабільний інструмент замість ручних таблиць і переписки. Скорочено час на типові операції за рахунок автоматизації в інтерфейсі.

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

Що б покращив

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