Когда сайт разрастается, даже небольшая правка требует разведки. Где формируется карточка проекта? Откуда приходят её заголовок и картинка? На каких страницах она повторяется? Если начать с первого найденного файла, легко исправить один экран и пропустить два других.
Для сайта AIN мы собрали карту знаний с помощью Graphify. Она показывает связи между частями проекта и помогает выбрать место для изменения до того, как трогать код.
Что показывает карта
Список папок отвечает на вопрос «где лежит файл». Карта помогает выяснить, что с этим файлом связано: какие компоненты его используют, откуда приходят данные и куда ведут зависимости.
Например, блок портфолио на нашем сайте встречается на главной, в каталоге проектов и на странице услуг. Если смотреть только на одну страницу, можно принять его за локальный элемент и сделать отдельную копию. Связи в проекте подсказывают другое решение: сначала проверить общий компонент и источник данных.
Graphify разбирает код локально и создаёт интерактивный graph.html, отчёт GRAPH_REPORT.md и данные graph.json. Для анализа документов и медиа у инструмента есть отдельный семантический проход. Его возможности и способ установки могут меняться, поэтому перед запуском лучше открыть инструкцию проекта.
Как пользоваться картой перед задачей
Допустим, нужно изменить карточки проектов. Мы начинаем с компонента карточки и смотрим, где он используется. Затем проверяем, откуда приходят названия, категории и изображения. Только после этого понятно, достаточно ли изменить данные или затронут и сам компонент.
Такой порядок полезен и человеку, и ИИ-ассистенту. Вместо расплывчатого «найди нужный файл» можно поставить более точную задачу: найти общий путь данных, перечислить затронутые страницы и предложить одно место для правки. Но вывод ассистента всё равно нужно сверять с текущими файлами.
После изменения мы собираем сайт и открываем затронутые страницы. Карта показывает структуру, но не скажет, съехала ли карточка на телефоне и не обрезался ли заголовок.
Когда инструмент оправдан
Карта особенно полезна в проекте с общими компонентами, несколькими источниками данных и историей доработок. Она сокращает время на поиск связей, когда команда возвращается к сайту спустя месяцы или передаёт задачу новому разработчику.
Для лендинга из нескольких файлов отдельная карта может оказаться лишней. Практический ориентир простой: если перед каждой правкой приходится снова выяснять «где это ещё используется?», карта уже решает реальную задачу.
