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

6.6 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, если этот экран открыт. Операция очистки инвалидирует незавершённые загрузки. При каждом нажатии нижней кнопки «Связи» исследованный граф V3/V4, координаты и IndexedDB-кэш графа сбрасываются, центр снова — собственный пользователь; X2 и фильтры выключены. При смене V3 ↔ V4 внутри открытого экрана сброса нет. Кэш изображений не затрагивается.

Проверка

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