Карта кода: устройство проекта на досках за минуту

1. 1

   Выберите папку или zip

   Кнопка «Карта кода» на странице проектов. Перетащите папку проекта в окно или выберите zip-архив до 300 МБ. Папки node_modules, .git и сборки пропускаются сами.

2. 2

   Браузер разберёт исходники

   В фоновом потоке, не тормозя страницу: «Ищем файлы», «Читаем файлы», «Разбираем код», «Строим доски». Обычно — до минуты; разбор можно отменить, дольше 3 минут он не идёт.

3. 3

   Проверьте предпросмотр

   Окно покажет, какие доски будут созданы, сколько на них блоков и связей, какие фреймворки нашлись и сколько файлов пропущено и почему. До нажатия «Создать проект» на сервер не уходит ничего.

4. 4

   Откройте готовый проект

   Проект с досками появится в списке. Доска «Обзор» ведёт на остальные, блоки разложены без наложений — дальше это обычные доски для работы всей командой.

• Обзор

  Карточка на каждую доску карты с переходом на неё, стек проекта — фреймворки и языки — и что разобрано.

• Страницы

  Страница — маршрут и файл, группы по разделам сайта, связи — переходы по ссылкам и из кода.

• API

  Маршрут на карточке, цвет по методу: GET зелёный, POST синий, PUT и PATCH оранжевые, DELETE красный. Группы по модулям.

• Фронт → API

  Какая страница или модуль какой маршрут вызывает. Вызовы, которых нет на бэкенде, — отдельной группой.

• Данные

  Таблицы с полями, типами и пометками PK и UNIQUE, связи — внешние ключи с подписью поля.

• Архитектура

  Сервисы из docker-compose и самые заметные зависимости между папками кода — мелочь не рисуется, чтобы схема читалась.

• Страницы

  • Next.js — App и Pages Router
  • React Router
  • Vue Router и шаблоны .vue
  • Nuxt
  • SvelteKit и шаблоны .svelte
  • Angular
  • 1С-Битрикс — urlrewrite.php и страницы сайта

  Маршруты страниц и переходы: ссылки в коде и шаблонах, переадресации, переходы из кода.

• API

  • Express
  • NestJS
  • FastAPI
  • Flask
  • Django
  • Laravel
  • Symfony
  • Go — net/http, Gin, Echo, chi, Fiber, gorilla/mux
  • Spring и JAX-RS на Java и Kotlin
  • ASP.NET Core — контроллеры и Minimal API
  • Ruby on Rails
  • Rust — Axum и Actix Web

  Маршруты с методами и префиксами групп и роутеров, ресурсы Laravel и Rails раскрываются в стандартные маршруты, обработчики route.ts в Next.js и файлы маршрутов Nuxt и SvelteKit.

• Вызовы с фронта

  • fetch
  • axios
  • HttpClient в Angular
  • свои API-клиенты

  Какой адрес вызывает страница или модуль — и есть ли такой маршрут на бэкенде.

• Данные

  • Prisma
  • SQL-миграции
  • Django-модели
  • миграции и модели Laravel (Eloquent)
  • Doctrine
  • GORM
  • JPA
  • Entity Framework Core
  • Rails — schema.rb, миграции и модели

  Таблицы, поля и внешние ключи, включая связи «многие ко многим».

• Архитектура

  • docker-compose
  • импорты JS, TS, Vue и Svelte
  • импорты Python, PHP, Go, Java, Kotlin, C# и Rust
  • компоненты 1С-Битрикс

  Сервисы, образы, порты и зависимости; псевдонимы путей из tsconfig, пакеты монорепозитория, модули go.mod, пакеты и пространства имён.

• Разбор только в браузере

  Исходники читает фоновый поток в изолированной песочнице прямо в вашей вкладке: у неё нет доступа ни к вашему входу в NodePanel, ни к странице, ни к интернету. Автотест проверяет: во время разбора на наш сервер не уходит ни одного запроса с данными.

• Код не запускается

  Файлы только читаются как текст. Скрипты из package.json не выполняются, файлы настроек вроде vite.config или next.config не исполняются, а исходники разборщика тест проверяет на конструкции, способные запустить чужой код.

• Секреты не открываются

  Файлы .env, ключи и сертификаты, .npmrc, файлы credentials и secrets, базы SQLite, папки .ssh и .aws пропускаются по имени, не читая, — даже под хитрыми именами вроде .ENV или server.pem.txt. В отчёте только их число.

• Похожее на ключи вырезается

  Строки из кода на доски не попадают, кроме путей маршрутов. Параметры адресов, логины и пароли в адресах срезаются, а похожее на токены и ключи заменяется на «[скрыто]».

• Архив под контролем

  Пути, ведущие за пределы проекта, ссылки на другие файлы и вложенные архивы не открываются. Архив-бомбу видно по фактически разжатым байтам, а на диск ничего не записывается.

• Текст — только текст

  Имена из кода на доске — простой текст: невидимые и управляющие символы и «перевёрнутый» текст убираются, длина ограничена. Ссылки между досками ставит только сервер — на доски этой же карты.

• Предпросмотр перед отправкой

  Вы видите, какие доски, сколько блоков и связей уйдёт на сервер и сколько файлов пропущено. Не понравилось — закройте окно, и ничего не отправится.

• Сервер не верит браузеру

  Каждую доску сервер проверяет строгой схемой, заново сверяет права и подписку, выдаёт блокам свои id и записывает всё одной транзакцией. Чужой проект для него неотличим от несуществующего.

• Лимиты от перегрузки

  Размер архива, число файлов, размер файла, глубина папок и время разбора ограничены. Создать или обновить карту можно до 20 раз в час, и у каждого — один запрос за раз.

Обещать «стопроцентную безопасность» честно не может никто. Поэтому главное решение здесь другое: исходники просто не отправляются. Если не хотите, чтобы на сервер попали даже названия маршрутов и таблиц, — посмотрите предпросмотр и не нажимайте «Создать проект».

• Онбординг

  Новый человек в команде

  В первый же день видит, какие страницы есть, какие маршруты они вызывают и где лежат таблицы, — вместо недели блужданий по папкам.

• Ревью архитектуры

  Архитектор

  Сервисы и зависимости между модулями — на одной доске. Видно, где связей слишком много, и это можно обсудить комментарием прямо у блока.

• Живая документация

  Аналитик и тестировщик

  Полный список страниц и маршрутов API с файлами — то, что есть в продукте на самом деле. Обновили карту — документация снова свежая, заметки на досках остались.

• Поиск лишнего

  Тимлид

  Вызовы с фронта, которых нет на бэкенде, собраны в группу «Не найдены на бэкенде», а после обновления видно новое и исчезнувшее из кода.

• Языки — JavaScript, TypeScript, Python, PHP, Go, Java, Kotlin, C#, Ruby и Rust. Проекты на других языках пока не разбираются.
• Маршруты, которые собираются на лету — в цикле или из настроек, — могут не найтись: код читается, но не исполняется.
• Маршруты из файлов настроек (routes.yaml в Symfony, роутинг на функциях Spring, Ktor) и маршрутизация ASP.NET MVC по шаблону {controller}/{action} без атрибутов не читаются.
• Связи между файлами Ruby не строятся. Псевдонимы путей берутся из tsconfig и jsconfig, а не из настроек сборщика.
• В карте — до 24 досок, на доске — до 400 блоков. Большой проект попадёт в карту не целиком — предпросмотр предупредит об этом заранее.
• Файлы больше 1 МБ и сжатый код сборки пропускаются.
• В песочнице на главной карты кода нет: нужен аккаунт с подпиской или пробным периодом.

Все кнопки, подписи и шаги — в документации. Открыть раздел «Карта кода»