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

6.1 KiB
Raw Blame History

Связи — версия 3: интерактивная карта исследования

Реализация: shine-UI/js/pages/network-explorer/, переключатель версии — shine-UI/js/pages/network-version-switcher.js. V1 и V2 остаются отдельными режимами. Новые серверные операции и форматы блокчейна не вводились.

Управление

  • Близкие — рёбра только типа close_friend (тип выбирается владельцем исходящего отношения).
  • Сияющие — только сияющие пользователи; выбранный центр виден всегда.
  • X2 — для текущего пользователя дополнительно читаем друзей каждого непосредственного друга, по четыре запроса одновременно. Чтение прогрессивное: текущий граф показывается сразу, остальные ветки появляются после завершения запросов; ошибки не скрывают успешные ветки.
  • Глубина: 0–4 (старт 1) — максимальное кратчайшее расстояние в уже исследованном графе: 1 + глубина, если X2 выключен, и 2 + глубина, если X2 включён. Для определения расстояния по известным исходящим дружеским рёбрам используется BFS без учёта их направления; оригинальное направление сохраняется для отображения отношений.
  • Верхнее меню ⋮: «Искать пользователей» и «Очистить кэш». Очистка удаляет только кэш V3, обнуляет исследованный граф и заново запрашивает связи текущего пользователя. Поиск использует текущий серверный searchUsers.

В отличие от V1, V3 не хранит последовательность посещённых центров. При выборе любого пользователя общая исследованная сеть сохраняется, но на экране остаются только вершины в пределах заданной глубины. Совпадающие пользователи не дублируются; между видимыми вершинами объединяются известные связи.

Размеры и размещение

Размер кружочка определяется актуальной полнотой видимых исходящих дружеских связей:

  • Большой (масштаб 1) — его полный исходящий список известен и все друзья, подходящие под текущие фильтры, видны на карте.
  • Маленький (масштаб 0.5) — список ещё не прочитан либо часть его друзей сейчас за пределом глубины. Линии между двумя маленькими кружочками не рисуются.

Размер выбранного центра такой же, как у остальных (не 1.78, как в V1). Движок получает фиксированные мировые координаты, чтобы сохранять позицию при пересчётах/фильтрах. Кружочки перетаскиваются вручную, сцена панорамируется и масштабируется (колесо/щипок). Координаты сохраняются внутри активной вкладки при переходах по V3; после перезагрузки раскладка строится заново.

Кэш и обновление

В отличие от общего двухминутного кэша V1/V2 у V3 собственный IndexedDB shine-network-explorer-v3. Запись хранит ответ getUserConnectionsGraph, идентификатор сервера/аккаунта/логина и отметку времени. Время жизни — 24 часа; просроченное повторно запрашивается при обращении, а просроченные рёбра исключаются из исследованного графа. При открытии страницы до 1000 свежих изученных графов восстанавливаются без сетевых запросов; память ограничена 800 горячими записями. Если IndexedDB недоступен, работает временное кэширование в памяти.

Пока вкладка V3 открыта, раз в пять минут проверяется актуальность выбранного центра. Подтверждённое изменение дружеских связей через UI также сбрасывает кэш V3, если этот экран открыт. Операция очистки инвалидирует незавершённые загрузки.

Проверка

node --test shine-UI/tests/network-explorer-v3.test.mjs проверяет BFS, глубину, фильтры, дедупликацию, размеры, направление линий, TTL, изоляцию аккаунтов и очистку. Не является заменой проверки с реальным сервером и на мобильном устройстве: особенно нужно проверить производительность для пользователей с сотнями связей, запросы X2 и сохранение координат при жестах.