From 859dbee1f1f44adf39cb03228a0a65486b5f902ef55c157a2813e58baf635264 Mon Sep 17 00:00:00 2001 From: AidarKC Date: Thu, 19 Nov 2026 21:13:24 +0300 Subject: [PATCH] =?UTF-8?q?=D0=94=D0=BE=D0=B1=D0=B0=D0=B2=D0=B8=D1=82?= =?UTF-8?q?=D1=8C=20Canvas=20v4=20=D0=B4=D0=BB=D1=8F=20=D0=B8=D1=81=D1=81?= =?UTF-8?q?=D0=BB=D0=B5=D0=B4=D0=BE=D0=B2=D0=B0=D0=BD=D0=B8=D1=8F=20=D1=81?= =?UTF-8?q?=D0=B2=D1=8F=D0=B7=D0=B5=D0=B9?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/UI-Design/DESIGN.md | 2 + docs/UI-Design/NETWORK_EXPLORER_V3.md | 7 +- docs/UI-Design/NETWORK_EXPLORER_V4.md | 90 +++ docs/UI-Design/README.md | 1 + shine-UI/index.html | 2 +- shine-UI/js/app.js | 2 +- shine-UI/js/components/message-menu.js | 6 +- shine-UI/js/components/toolbar.js | 7 + shine-UI/js/pages/channel-thread-view.js | 44 +- shine-UI/js/pages/channel-view.js | 30 +- .../pages/network-canvas-v4/graph-renderer.js | 582 ++++++++++++++++++ .../js/pages/network-canvas-v4/graph-style.js | 63 ++ .../pages/network-canvas-v4/network-view.js | 6 + .../js/pages/network-explorer/network-view.js | 40 +- shine-UI/js/pages/network-version-switcher.js | 9 +- shine-UI/js/services/channels-ux.js | 6 +- shine-UI/js/services/user-profile-params.js | 6 + shine-UI/styles/features/network.css | 19 + shine-UI/tests/network-explorer-v4.test.mjs | 112 ++++ 19 files changed, 993 insertions(+), 41 deletions(-) create mode 100644 docs/UI-Design/NETWORK_EXPLORER_V4.md create mode 100644 shine-UI/js/pages/network-canvas-v4/graph-renderer.js create mode 100644 shine-UI/js/pages/network-canvas-v4/graph-style.js create mode 100644 shine-UI/js/pages/network-canvas-v4/network-view.js create mode 100644 shine-UI/tests/network-explorer-v4.test.mjs diff --git a/docs/UI-Design/DESIGN.md b/docs/UI-Design/DESIGN.md index ce2c0135..1938a030 100644 --- a/docs/UI-Design/DESIGN.md +++ b/docs/UI-Design/DESIGN.md @@ -139,6 +139,8 @@ Исходное сообщение остаётся наверху, ниже — счётчик и ответы в последовательном порядке. Не предлагать «Популярные» до подтверждения алгоритма и источника данных. +Шапка автора — отдельная компактная полоса: фотография, отображаемые имя и фамилия, затем логин и относительное время без знака минус. Нажатие на шапку не уводит со страницы сразу, а открывает меню с действием «Показать профиль». + Прямые ответы исходному сообщению показываются отдельными блоками, разделёнными тонкой линией. Внутри блока виден только один вложенный уровень: не более двух комментариев сразу, остальные раскрываются кнопкой «Показать ещё». Более глубокие ответы не добавляются в этот блок; их можно открыть как отдельную подветку выбранного комментария. На карточке комментария счётчик означает только число его прямых ответов. Для вложенных ответов показывать «В ответ …» и короткий контекст. Не уменьшать ширину текстовой колонки бесконечными отступами. Тонкая линия допустима только для обозначения реальной связи, не вокруг каждого комментария. Плотность ответов сохраняется близкой к Ночному SHiNE; выбор полноэкранного редактора из Клуба не означает переноса всей его плотности. Возврат ведёт в тот же канал и на прежнюю позицию. После отправки новый ответ появляется в ветке; при ошибке остаются текст и вложения. Длинные ветки потребуют отдельной проверки пагинации, состояния загрузки и перехода к конкретному ответу. diff --git a/docs/UI-Design/NETWORK_EXPLORER_V3.md b/docs/UI-Design/NETWORK_EXPLORER_V3.md index 2cc9017c..9e73da28 100644 --- a/docs/UI-Design/NETWORK_EXPLORER_V3.md +++ b/docs/UI-Design/NETWORK_EXPLORER_V3.md @@ -45,13 +45,16 @@ `shine-network-explorer-v3`. Запись хранит ответ `getUserConnectionsGraph`, идентификатор сервера/аккаунта/логина и отметку времени. Время жизни — 24 часа; просроченное повторно запрашивается при обращении, а просроченные рёбра исключаются -из исследованного графа. При открытии страницы до 1000 свежих изученных графов +из исследованного графа. При переключении версий внутри уже открытой вкладки до 1000 свежих изученных графов восстанавливаются без сетевых запросов; память ограничена 800 горячими записями. Если IndexedDB недоступен, работает временное кэширование в памяти. Пока вкладка V3 открыта, раз в пять минут проверяется актуальность выбранного центра. Подтверждённое изменение дружеских связей через UI также сбрасывает кэш V3, если -этот экран открыт. Операция очистки инвалидирует незавершённые загрузки. +этот экран открыт. Операция очистки инвалидирует незавершённые загрузки. **При каждом нажатии нижней +кнопки «Связи»** исследованный граф V3/V4, координаты и IndexedDB-кэш графа +сбрасываются, центр снова — собственный пользователь; X2 и фильтры выключены. +При смене V3 ↔ V4 внутри открытого экрана сброса нет. Кэш изображений не затрагивается. ## Проверка diff --git a/docs/UI-Design/NETWORK_EXPLORER_V4.md b/docs/UI-Design/NETWORK_EXPLORER_V4.md new file mode 100644 index 00000000..57fb7d05 --- /dev/null +++ b/docs/UI-Design/NETWORK_EXPLORER_V4.md @@ -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 и сброс исследованной карты при входе в «Связи» без изменений. Никаких пульсаций и фоновых циклов рендера. diff --git a/docs/UI-Design/README.md b/docs/UI-Design/README.md index 52bceeae..5766f1c3 100644 --- a/docs/UI-Design/README.md +++ b/docs/UI-Design/README.md @@ -10,6 +10,7 @@ - [Поддержка SHiNE в меню кошельков](WALLET_SHINE_SUPPORT.md) — отдельный пункт пожертвования, старые экраны кошельков и билетов. - [Локализация UI (этап 1)](I18N.md) — языковой движок, приоритет системного языка и глобальные настройки. - [Связи V3: исследование графа](NETWORK_EXPLORER_V3.md) — BFS-глубина, X2, размеры аватарок, кэш 24 часа. +- [Связи V4: Canvas](NETWORK_EXPLORER_V4.md) — та же логика V3, аватары и подписи V2, статичная аура и неоновые линии. - [PWA: масштабирование и аватар профиля](PWA_VIEWPORT_AND_AVATAR_PREVIEW.md) — поведение полноэкранного интерфейса и просмотра фотографии. - [Заявления о статусах и предупреждения о блокчейне](PROFILE_DECLARATIONS_AND_CONSENT.md) — действующие сценарии профиля, лайков и подтверждений на 06.11.2026. diff --git a/shine-UI/index.html b/shine-UI/index.html index 84d3e981..e22c5f3f 100644 --- a/shine-UI/index.html +++ b/shine-UI/index.html @@ -39,7 +39,7 @@ }());