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

63 lines
6.1 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Связи — версия 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 и сохранение координат при жестах.