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