Добавили связи V3

This commit is contained in:
AidarKC
2026-11-11 00:33:13 +03:00
parent 6489fb56ab
commit b220f2ac8b
12 changed files with 1047 additions and 16 deletions
+62
View File
@@ -0,0 +1,62 @@
# Связи — версия 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 и сохранение координат при жестах.