Добавить Canvas v4 для исследования связей

This commit is contained in:
AidarKC
2026-11-19 21:13:24 +03:00
parent 8f3b81c368
commit 859dbee1f1
19 changed files with 993 additions and 41 deletions
+90
View File
@@ -0,0 +1,90 @@
# Связи 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 и сброс исследованной карты при входе в «Связи» без изменений. Никаких пульсаций и фоновых циклов рендера.