Первый скан

Эта страница проводит через скан от и до. Берите любой проект на TypeScript / Vue / React / Svelte — даже маленький подойдёт.

1. Открыть проект

В десктоп-приложении нажмите Open Project и выберите корень репозитория (директорию с package.json).

Archora определяет фреймворк, читает tsconfig.json (включая цепочки extends) и показывает панель подтверждения с автоматически найденными entry-точками. Подкорректируйте include / exclude глобы при необходимости и нажмите Scan.

Скан выполняется полностью в одном процессе. На ~1000 модулях занимает около 2 секунд; на ~5000 — около 10.

2. Прочитать Overview

После завершения скана вы попадаете на страницу проекта:

• Overview — оценка архитектуры, главный риск и первое рекомендуемое исправление.
• Priority queue — severity, причина, цель и следующее действие.
• Inspector — проблема, доказательства, предложенный фикс, влияние и сырые детали при необходимости.

Первый вопрос не “как выглядит граф?”, а “что чинить первым, почему и как безопасно проверить влияние?”.

3. Заглянуть в hot zone

Откройте Горячие точки или выберите рискованную строку в Проводнике. Inspector держит диагноз рядом:

• почему модуль или папка рискованные;
• доказательства по входящим/исходящим зависимостям;
• рекомендуемый путь проверки;
• связанные циклы или нарушения правил.

Если у вас настроен редактор (см. Конфигурацию), путь к файлу кликабелен и открывает его в редакторе.

4. Понять цикл

Откройте Циклы. Циклы показаны как элементы очереди ремонта, а не как сырой node-link граф:

• читаемая цепочка зависимостей;
• direct/indirect severity;
• предложенная точка разрыва;
• затронутые модули и связанные нарушения.

Предложенная точка разрыва вычисляется из доказательств цикла и сужает рефакторинг, но не пытается автоматически переписать бизнес-код.

5. Сохранить снапшот

Откройте Экспорт в TopBar проекта:

• Полный HTML-отчёт — читаемый architecture brief для ревью.
• JSON-план исправлений — очередь ремонта с доказательствами для планирования.
• Полный JSON-отчёт — полный payload анализатора для интеграций.

Что ещё есть на странице проекта

• Cmd+K — быстрый поиск по модулям с префиксами path:, export:, import:, kind:.
• b — saved views: запомнить полезные состояния фильтров и выбора.
• Иконка Layers в TopBar — GUI-редактор .archora.json overrides с live-предпросмотром нарушений.
• Settings → Watcher — авто re-scan при изменении файлов (только Tauri).
• Иконка-палочка у type-only-candidate инсайта — one-click переписывание import → import type с side-by-side diff и backup'ом.

См. Работа с Architecture Workspace — подробный walkthrough.

Дальше

• Как это устроено — алгоритмы за каждым инсайтом.
• CLI — те же данные в CI.
• Конфигурация — исключение vendored-кода, настройка слоёв.