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