GrantTapGraph, Health и кодовые башни
Архитектурные отчёты, поиск, источники и недоступные данные.
В этой главе · 5 разделов
Graph и Health помогают разобраться в устройстве проекта и качестве полученных сведений. Они показывают отчёт компьютера о конкретном репозитории. Открытие картинки не запускает новый разговор с моделью, не перечитывает весь диск телефона и не проверяет код на правильность. Начинайте с того, какой проект, репозиторий и ревизия указаны в отчёте.
Первый маршрут по учебному проекту#
- Откройте Mesh, затем учебный проект.
- Выберите Graph, чтобы посмотреть компоненты и связи архитектуры.
- Нажмите компонент: посмотрите название, тип и соседние связи.
- Откройте сведения об отчёте и найдите ревизию, источник и полноту.
- Вернитесь в Health, чтобы проверить состояние отчётов отдельных репозиториев.
- Откройте карту кода, выберите файл или символ и сравните его сведения с общим графом.
На иллюстрации настоящая сборка GrantTap с тестовым отчётом demo-revision. Пять компонентов и четыре связи относятся к этому примеру. Они не описывают ваш репозиторий и не доказывают, что новый анализ уже выполнен.
Архитектура и карта кода#
Architecture показывает компоненты и сообщённые зависимости: например, приложение, мост, Engine и relay. Code map показывает файлы, функции, другие полученные символы и измерения исходников. Эти представления отвечают на разные вопросы: «кто с кем связан?» и «из каких частей состоит код?».
Связи имеют направление. Нажав связь или элемент в списке Links, проверьте её начало и конец. Одинаковое имя файла в двух репозиториях не делает их одним файлом. Для объединённого Mesh сохраняйте внимание к repository identity.
Как читать город кода#
Используйте Files для поиска пути, имени файла или символа. Выбор файла открывает его список секций; выбор символа — конкретные сведения об исходнике. Списки прокручиваются, поэтому видимые подписи в самой сцене не являются полным каталогом.
В инспекторе переключайтесь между Sections, Links и Health. Последний показывает доступные измерения, происхождение отчёта и ограничения. Fit возвращает обзор всей карты; Top и ISO меняют ракурс. Orbit и Pan помогают повернуть сцену или передвинуть её. Если камера потерялась, начните с Fit, затем заново выберите нужный файл.
Цвет зависит от режима. Size описывает измеренный размер, а Code checks — доступные статические проверки и выбранные пороги. Зелёная секция не означает, что её тесты прошли; красная не доказывает ошибку исполнения. Неизмеренный участок должен оставаться неизвестным. Легенда поясняет текущую палитру, не меняя правил проекта.
Отсутствующее значение не равно нулю#
| Что видно | Практический смысл |
|---|---|
| Нет отчёта | Компьютер ещё не передал подходящий результат |
| Partial / INCOMPLETE | Получена только часть пригодных данных |
| COMPLETE | Анализ завершён в пределах сообщённого охвата |
| Unknown | Для этой метрики нет подтверждённого измерения |
| Unavailable | Показана причина недоступности репозитория или анализа |
Даже COMPLETE не означает знание всех возможных зависимостей. Отсутствующая связь не доказывает независимость компонентов. Нулевое покрытие тестами и отсутствие сведений о покрытии тоже различаются. Подробности метода ищите в Report details.
Обновление и офлайн#
Активный проект может автоматически запросить анализ отсутствующего или изменившегося репозитория. Явное обновление проходит отдельные стадии: запрос, ожидание, получение подходящего отчёта либо отказ. Обычное обновление каталога не подтверждает выполнение нового анализа. Git revision и fingerprint содержимого отчёта также не одно и то же.
Во время пересборки старый полученный граф остаётся доступным. Если компьютеру нельзя доставить запрос, GrantTap показывает это отдельно и предлагает повторную проверку. Сохранённый отчёт можно изучать офлайн; это не создаёт новые сведения об изменившемся коде.
В русской сборке часть названий Mesh и пояснений пока остаётся английской. Скриншоты сохраняют реальный интерфейс; это ограничение локализации не объявляется исправленным. Продолжение: Runtime и доказательства · Governance · Usage.