SHA256
Добавили связи V3
This commit is contained in:
@@ -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 и сохранение координат при жестах.
|
||||
@@ -8,6 +8,7 @@
|
||||
Галерея сохранена без изменений и ещё не отражает итоговое сочетание решений. Для последующего переноса источником истины служит `DESIGN.md`, а не детали одного старого варианта. Эта галерея не является описанием текущего кода приложения.
|
||||
|
||||
- [Локализация UI (этап 1)](I18N.md) — языковой движок, приоритет системного языка и глобальные настройки.
|
||||
- [Связи V3: исследование графа](NETWORK_EXPLORER_V3.md) — BFS-глубина, X2, размеры аватарок, кэш 24 часа.
|
||||
- [PWA: масштабирование и аватар профиля](PWA_VIEWPORT_AND_AVATAR_PREVIEW.md) — поведение полноэкранного интерфейса и просмотра фотографии.
|
||||
- [Заявления о статусах и предупреждения о блокчейне](PROFILE_DECLARATIONS_AND_CONSENT.md) — действующие сценарии профиля, лайков и подтверждений на 06.11.2026.
|
||||
|
||||
|
||||
Reference in New Issue
Block a user