Files
SHiNE-server/docs/UI-Design/NETWORK_EXPLORER_V4.md
T

9.6 KiB
Raw Blame History

Связи V4 — статический Canvas 2D

Вводится отдельный вариант V4 · Canvas в селекторе версий «Связи». V1, V2 и V3 остаются доступны. Ни сервер, ни API, ни блокчейн не меняются.

Данные и управление

V4 использует ту же страницу network-explorer/network-view.js через renderExplorer(context, { canvas: true }): передача graph-model.js, кэш IndexedDB, загрузка X2, глубина 0–4, фильтры «Близкие»/«Сияющие», поиск, сброс кэша и хранение координат являются общими для V3 и V4. Если пользователь перемещает узел, координаты сохраняются точно так же, как в V3. Разрешено перерисовать весь граф при приходе новых данных; перерасчёт модели не превращается в бесконечную анимацию.

V4 поддерживает мышь/сенсорный экран: перетаскивание сцены и узлов, масштабирование колесом и щипком, короткое и долгое нажатие, контекстное меню правой кнопкой. Групповое перетаскивание исторических центров из общего движка V1 для модели V3 не применяется.

ZOOM_MIN = 0.55, ZOOM_MAX = 2.2, DIVE_ZOOM = 1.7. Параметр DIVE_ZOOM используется в методе recenter движка; обычный выбор пользователя, как и V3, обрабатывается страницей с обновлением центра исследуемой сети.

Рисование

  • Слой №1 Canvas — связи; слой №2 — сияние, аватары, значки официальных пользователей, подписи.
  • Для каждой вершины изображение собирается в спрайт: внешняя стеклянная кромка V3 (/assets/glass_overlay_faithful.png) рисуется под круглой непрозрачной фотографией/инициалами. Дополнительных цветных ободков V2 нет. Непрозрачная подложка под кромкой закрывает концы линий.
  • У сияющих есть статическая аура. Фотография остаётся поверх стекла и сияния; типы отношений кодируются цветами самих связей.
  • Подписи V2: округлая полупрозрачная плашка, компактное «Имя Ф.» (кроме центра), приоритет важных узлов, проверка пересечений и перенос плашки над узлом при необходимости.
  • Взаимная связь со встречными разными типами получает градиент от первого цвета ко второму. Для односторонней связи яркость плавно падает в сторону адресата.
  • Между двумя сияющими пользователями рисуется трёхслойный неон V3 на кривой: размытое поле, размытая трубка и светлая сердцевина. Для остальных пар — тонкая двухпроходная цветная линия. Односторонние сияющие линии сохраняют статичный пунктир V3. Пульсация и бегущие штрихи отсутствуют.
  • Все вершины направляются на отрисовку, даже если они за кадром. Для читабельности пересекающиеся текстовые плашки могут пропускаться. Связи также не отсекаются по viewport.
  • Спрайты повторно используются при движении карты и пересоздаются только при изменении фото, вида/разрешения или темы. Размер кэшированных спрайтов подстраивается под zoom и DPR, а общий расчётный бюджет изображений ограничен примерно 96 МБ.
  • После завершения ввода, загрузки изображений и пакетного построения спрайтов requestAnimationFrame больше не запрашивается; в состоянии покоя расхода кадров на эффекты нет.
  • В V4 старый анимированный псевдо-фон .fg-stage::before отключён; фон остаётся статичным.

Повторное открытие вкладки «Связи»

Каждое нажатие нижней кнопки «Связи» сбрасывает исследованный граф V3/V4: очищает графы в памяти и в IndexedDB, забывает раскрытые ветви и координаты, возвращает к собственному профилю, отключает X2 и дополнительные фильтры. После окончания очистки загружаются собственные непосредственные связи. Новый запрос ждёт завершения очистки — старые данные не восстанавливаются наперегонки из IndexedDB. Переключение версий V1/V2/V3/V4 в селекторе внутри открытого экрана не сбрасывает исследованный граф. Кэш изображений браузера, фотографии и другие данные приложения не стираются. Верхнее меню «Очистить кэш» остаётся отдельным действием внутри уже открытой карты.

Файлы

  • shine-UI/js/pages/network-canvas-v4/graph-renderer.js — рендер и жесты.
  • shine-UI/js/pages/network-canvas-v4/graph-style.js — палитры и геометрия направленных линий.
  • shine-UI/js/pages/network-canvas-v4/network-view.js — адаптер страницы V4.
  • shine-UI/js/pages/network-explorer/network-view.js — общая страница V3/V4.
  • shine-UI/js/pages/network-version-switcher.js — выбор V4 и обработчик входа во вкладку.
  • shine-UI/js/components/toolbar.js — сигнал повторного входа по нижней кнопке.
  • shine-UI/index.html — обновлённый build hash загрузки UI.
  • shine-UI/styles/features/network.css — Canvas-слои, выключение старой анимации.
  • shine-UI/tests/network-explorer-v4.test.mjs — проверки градиентов, затухания, геометрии и модели.

Проверка и ограничения

Команды в корне репозитория:

node --test shine-UI/tests/network-explorer-v3.test.mjs shine-UI/tests/network-explorer-v4.test.mjs

Базовые тесты проверяют градиенты и затухание линий, геометрию и BFS-модель, а также инварианты порядка рисования стекла/фото, стиля неона/подписей и механизма сброса вкладки. Они не заменяют полноценный браузерный тест страницы с авторизацией и реальными запросами к серверу. Для финальной проверки на устройстве стоит сравнить FPS/память V3 и V4 на одном исследованном графе, проверить фото из Arweave и R2, долгий тап и пересечения подписей на узком экране.

Canvas V4c — стекло и неон как в V3 (19.11.2026)

  • Цветные красно-синие кольца аватаров удалены. Возвращена стеклянная PNG-кромка V3 (glass_overlay_faithful.png, 119% размера узла).
  • Фото/инициалы рисуются после стекла, непрозрачно, поверх бликов; диск под стеклом закрывает окончания линий нижнего Canvas. Сияющие ауры остались статичными.
  • Сияющие связи рисуются в стиле V3: поле 16px с размытием 6px, трубка 6px с размытием 2px и тонкое светлое ядро 2px, всё с screen-композитингом. Blur выполняется один раз для слоя всех связей. Сине-красные градиенты и затухание односторонних связей сохранены.
  • Система подписей V2, масштаб 0.55–2.2 и сброс исследованной карты при входе в «Связи» без изменений. Никаких пульсаций и фоновых циклов рендера.