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

91 lines
9.6 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Связи 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` — проверки градиентов, затухания, геометрии и модели.
## Проверка и ограничения
Команды в корне репозитория:
```bash
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 и сброс исследованной карты при входе в «Связи» без изменений. Никаких пульсаций и фоновых циклов рендера.