6.1 KiB
Связи — версия 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 и сохранение координат при жестах.