diff --git a/VERSION.properties b/VERSION.properties index 066b17d0..e6ee987b 100644 --- a/VERSION.properties +++ b/VERSION.properties @@ -1,2 +1,2 @@ -client.version=1.20.27 +client.version=1.20.28 server.version=1.16.19 diff --git a/docs/UI-Design/NETWORK_EXPLORER_V3.md b/docs/UI-Design/NETWORK_EXPLORER_V3.md new file mode 100644 index 00000000..2cc9017c --- /dev/null +++ b/docs/UI-Design/NETWORK_EXPLORER_V3.md @@ -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 и сохранение координат при жестах. diff --git a/docs/UI-Design/README.md b/docs/UI-Design/README.md index 215e84cb..10fbd94e 100644 --- a/docs/UI-Design/README.md +++ b/docs/UI-Design/README.md @@ -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. diff --git a/shine-UI/js/i18n/locales/en.json b/shine-UI/js/i18n/locales/en.json index 037d7dd5..a84fd824 100644 --- a/shine-UI/js/i18n/locales/en.json +++ b/shine-UI/js/i18n/locales/en.json @@ -4170,7 +4170,8 @@ "text_001": "Version:", "text_003": "Version 2", "text_002": "Version 1", - "text_004": "Communications screen version" + "text_004": "Communications screen version", + "text_005": "Version 3" }, "media_viewer": { "text_001": "Close", @@ -4196,6 +4197,19 @@ "open": "Enlarge avatar", "dialog": "Avatar preview", "close": "Close avatar preview" + }, + "network_explorer": { + "depth": "Depth: {value1}", + "depth_hint": "Up to {value1} links from the selected person. Tap to change depth.", + "menu": "Connections menu", + "search": "Find users", + "clear_cache": "Clear cache", + "loading": "Loading connections…", + "progress": "Loading connections: {value1}/{value2}", + "partial": "Could not load {value1} branches. The rest of the map is available.", + "error": "Could not load connections. Check your connection or try another user.", + "clearing": "Clearing cache…", + "a11y": "Center: {value1}. {value2} users shown on the map." } }, "errors": { diff --git a/shine-UI/js/i18n/locales/ru.json b/shine-UI/js/i18n/locales/ru.json index 7e5c04cc..6a715e12 100644 --- a/shine-UI/js/i18n/locales/ru.json +++ b/shine-UI/js/i18n/locales/ru.json @@ -4151,7 +4151,8 @@ "text_001": "Версия:", "text_002": "Версия 1", "text_003": "Версия 2", - "text_004": "Версия экрана Связи" + "text_004": "Версия экрана Связи", + "text_005": "Версия 3" }, "node_menu": { "text_001": "Контакт", @@ -4196,6 +4197,19 @@ "open": "Увеличить аватар", "dialog": "Просмотр аватара", "close": "Закрыть просмотр аватара" + }, + "network_explorer": { + "depth": "Глубина: {value1}", + "depth_hint": "Максимум {value1} связей от выбранного пользователя. Нажмите, чтобы изменить глубину.", + "menu": "Меню связей", + "search": "Искать пользователей", + "clear_cache": "Очистить кэш", + "loading": "Загрузка связей…", + "progress": "Загрузка связей: {value1}/{value2}", + "partial": "Не удалось загрузить {value1} веток. Остальная карта доступна.", + "error": "Не удалось загрузить связи. Проверьте соединение или попробуйте другого пользователя.", + "clearing": "Очистка кэша…", + "a11y": "Центр: {value1}. На карте {value2} пользователей." } }, "errors": { diff --git a/shine-UI/js/pages/network-explorer/graph-cache.js b/shine-UI/js/pages/network-explorer/graph-cache.js new file mode 100644 index 00000000..8dc180b1 --- /dev/null +++ b/shine-UI/js/pages/network-explorer/graph-cache.js @@ -0,0 +1,133 @@ +// V3-only cache: IndexedDB + memory fallback, TTL 24 hours. V1/V2 retain 2-minute TTL. +export const EXPLORER_CACHE_TTL_MS = 24 * 60 * 60 * 1000; +const DB_NAME = 'shine-network-explorer-v3'; +const STORE = 'connections'; +let dbPromise = null; +const memory = new Map(); +const inflight = new Map(); +let epoch = 0; + +function dbOpen() { + if (typeof indexedDB === 'undefined') return Promise.resolve(null); + if (!dbPromise) dbPromise = new Promise((resolve) => { + try { + const request = indexedDB.open(DB_NAME, 1); + request.onupgradeneeded = () => request.result.createObjectStore(STORE, { keyPath: 'key' }); + request.onsuccess = () => resolve(request.result); + request.onerror = () => resolve(null); + request.onblocked = () => resolve(null); + } catch { resolve(null); } + }); + return dbPromise; +} + +async function read(key) { + const db = await dbOpen(); + if (!db) return null; + return new Promise((resolve) => { + try { + const req = db.transaction(STORE, 'readonly').objectStore(STORE).get(key); + req.onsuccess = () => resolve(req.result || null); + req.onerror = () => resolve(null); + } catch { resolve(null); } + }); +} + +async function write(record) { + const db = await dbOpen(); + if (!db) return; + await new Promise((resolve) => { + try { + const tx = db.transaction(STORE, 'readwrite'); + tx.objectStore(STORE).put(record); + tx.oncomplete = resolve; + tx.onerror = resolve; + tx.onabort = resolve; + } catch { resolve(); } + }); +} + +// Восстанавливаем ранее исследованную карту без сети. Просроченные графы не выдаём: +// их обновит обычный запрос, когда пользователь снова откроет соответствующую ветку. +export async function readExplorerCachedGraphs(scope, limit = 1000) { + const prefix = `${scope}|`; + const collected = new Map(); + for (const row of memory.values()) { + if (row.key.startsWith(prefix) && row.savedAt <= Date.now() && Date.now() - row.savedAt < EXPLORER_CACHE_TTL_MS) + collected.set(row.key, row); + } + const db = await dbOpen(); + if (!db) return [...collected.values()].slice(0, limit); + await new Promise((resolve) => { + try { + const range = IDBKeyRange.bound(prefix, `${prefix}\uffff`); + const request = db.transaction(STORE, 'readonly').objectStore(STORE).openCursor(range); + request.onerror = () => resolve(); + request.onsuccess = () => { + const cursor = request.result; + if (!cursor || collected.size >= limit) { resolve(); return; } + const row = cursor.value; + if (row?.savedAt <= Date.now() && Date.now() - row.savedAt < EXPLORER_CACHE_TTL_MS) + collected.set(row.key, row); + cursor.continue(); + }; + } catch { resolve(); } + }); + return [...collected.values()].slice(0, limit); +} + +export function explorerCacheScope(service, sessionLogin) { + return `${String(service?.serverUrl || '').trim().toLowerCase()}|${String(sessionLogin || '').trim()}`; +} + +export async function getExplorerGraph(service, login, { scope, force = false } = {}) { + const key = `${scope || explorerCacheScope(service, '')}|${String(login || '').trim().toLowerCase()}`; + if (!login) throw new Error('LOGIN_REQUIRED'); + const valid = (record) => record && record.graph && Date.now() - record.savedAt < EXPLORER_CACHE_TTL_MS && record.savedAt <= Date.now(); + if (!force) { + const item = memory.get(key) || await read(key); + if (valid(item)) { + memory.set(key, item); + return item.graph; + } + } + if (inflight.has(key)) return inflight.get(key); + const started = epoch; + const task = (async () => { + const graph = await service.getUserConnectionsGraph(login); + if (started !== epoch) throw new Error('EXPLORER_CACHE_INVALIDATED'); + const record = { key, graph, savedAt: Date.now() }; + memory.set(key, record); + // Ограничиваем горячий слой. Записи IndexedDB остаются до ручной очистки или перезаписи по TTL. + while (memory.size > 800) memory.delete(memory.keys().next().value); + await write(record); + return graph; + })(); + inflight.set(key, task); + try { return await task; } + finally { if (inflight.get(key) === task) inflight.delete(key); } +} + +// Модель V3 должна наследовать время фактического получения ответа, а не время +// очередного чтения его из IndexedDB: иначе повторные визиты продлевали бы TTL. +export function explorerGraphSavedAt(scope, login) { + const key = `${scope}|${String(login || '').trim().toLowerCase()}`; + return memory.get(key)?.savedAt || null; +} + +export async function clearExplorerGraphCache() { + epoch += 1; + inflight.clear(); + memory.clear(); + const db = await dbOpen(); + if (!db) return; + await new Promise((resolve) => { + try { + const tx = db.transaction(STORE, 'readwrite'); + tx.objectStore(STORE).clear(); + tx.oncomplete = resolve; + tx.onerror = resolve; + tx.onabort = resolve; + } catch { resolve(); } + }); +} diff --git a/shine-UI/js/pages/network-explorer/graph-model.js b/shine-UI/js/pages/network-explorer/graph-model.js new file mode 100644 index 00000000..6dd269e5 --- /dev/null +++ b/shine-UI/js/pages/network-explorer/graph-model.js @@ -0,0 +1,201 @@ +// V3: исследованный (не ограниченный историей центров) граф и видимый BFS-срез. +// Храним исходящие дружеские связи с направлением; расстояние для карты считаем +// по неориентированному представлению только уже обнаруженных рёбер. +export const EXPLORER_MAX_DEPTH = 4; +export const EXPLORER_DEFAULT_DEPTH = 1; +export const keyOf = (value) => String(value || '').trim().toLowerCase(); + +const isFriend = (type) => type === 'friend' || type === 'close_friend'; + +function decorate(row, fallback) { + const login = String(row?.login || fallback || '').trim(); + const avatar = row?.avatar?.ar || row?.avatar?.sha256Hex + ? { ar: String(row.avatar.ar || ''), sha256Hex: String(row.avatar.sha256Hex || row.avatar.sha256 || '') } + : (row?.avatarTxId ? { ar: String(row.avatarTxId) } : null); + return { + login, + name: [row?.firstName, row?.lastName].filter(Boolean).join(' ').trim() || login, + avatar, + shining: row?.shine === true || row?.shine === 'true' || row?.shineStatus === 'shining', + official: row?.official === true || row?.official === 'true' || row?.accountRole === 'primary', + shineKnown: row?.shine !== undefined || row?.shineStatus !== undefined, + officialKnown: row?.official !== undefined || row?.accountRole !== undefined, + }; +} + +export function createExplorerGraph() { + const graphs = new Map(); // известные полные исходящие списки + const people = new Map(); + const edges = new Map(); // owner -> friend (направленные) + const updatedAt = new Map(); + + function remember(row, fallback) { + const data = decorate(row, fallback); + const id = keyOf(data.login); + if (!id) return; + const previous = people.get(id); + if (!previous) people.set(id, data); + else people.set(id, { + login: previous.login || data.login, + name: data.name && data.name !== data.login ? data.name : previous.name, + avatar: data.avatar || previous.avatar, + shining: data.shineKnown ? data.shining : previous.shining, + official: data.officialKnown ? data.official : previous.official, + shineKnown: previous.shineKnown || data.shineKnown, + officialKnown: previous.officialKnown || data.officialKnown, + }); + } + + function add(graph, fallbackLogin, savedAt = Date.now()) { + const login = String(graph?.login || fallbackLogin || '').trim(); + const owner = keyOf(login); + if (!owner) return; + remember({ login }, login); + (Array.isArray(graph?.allUsers) ? graph.allUsers : []).forEach((row) => remember(row)); + // Если граф обновился, старые исходящие рёбра этого владельца больше не действуют. + for (const edgeKey of edges.keys()) if (edgeKey.startsWith(`${owner}\u0000`)) edges.delete(edgeKey); + const close = new Set((graph?.outCloseFriends || []).map(keyOf)); + const inbound = new Set([...(graph?.inFriends || []), ...(graph?.inCloseFriends || [])].map(keyOf)); + // Сохраняем оригинальный регистр логина для серверного API (ключи графа + // нормализуем независимо, только для сопоставления вершин). + const friendNames = new Map(); + for (const raw of [...(graph?.outFriends || []), ...(graph?.outCloseFriends || [])]) { + const id = keyOf(raw); + if (id && id !== owner && !friendNames.has(id)) friendNames.set(id, String(raw).trim()); + } + const friends = new Set(friendNames.keys()); + for (const id of friends) { + remember({ login: friendNames.get(id) }, id); + edges.set(`${owner}\u0000${id}`, { + from: owner, to: id, type: close.has(id) ? 'close_friend' : 'friend', + mutual: inbound.has(id), + }); + } + graphs.set(owner, { login, friends, friendLogins: [...friendNames.values()] }); + updatedAt.set(owner, savedAt); + } + + function clear() { + graphs.clear(); people.clear(); edges.clear(); updatedAt.clear(); + } + + function getFriends(login) { + return graphs.get(keyOf(login))?.friendLogins || null; + } + + function pruneExpired(now = Date.now()) { + for (const [id, savedAt] of updatedAt) { + if (savedAt <= now && now - savedAt < 24 * 60 * 60 * 1000) continue; + graphs.delete(id); + updatedAt.delete(id); + for (const edgeKey of edges.keys()) { + if (edgeKey.startsWith(`${id}\u0000`)) edges.delete(edgeKey); + } + } + } + + function snapshot(centerLogin, { depth = EXPLORER_DEFAULT_DEPTH, x2 = false, close = false, shining = false } = {}) { + pruneExpired(); + const center = keyOf(centerLogin); + if (!center) return { focusId: '', nodes: [], preserveHistory: true }; + const radius = Math.max(0, Math.min(EXPLORER_MAX_DEPTH, Number(depth) || 0)) + (x2 ? 2 : 1); + const allowed = (id) => id === center || !shining || Boolean(people.get(id)?.shining); + const neighbors = new Map(); + const eligibleEdges = []; + for (const edge of edges.values()) { + if (!isFriend(edge.type) || (close && edge.type !== 'close_friend')) continue; + if (!allowed(edge.from) || !allowed(edge.to)) continue; + eligibleEdges.push(edge); + if (!neighbors.has(edge.from)) neighbors.set(edge.from, new Set()); + if (!neighbors.has(edge.to)) neighbors.set(edge.to, new Set()); + neighbors.get(edge.from).add(edge.to); + neighbors.get(edge.to).add(edge.from); + } + const distances = new Map([[center, 0]]); + const queue = [center]; + for (let i = 0; i < queue.length; i += 1) { + const from = queue[i]; + const d = distances.get(from); + if (d >= radius) continue; + for (const to of neighbors.get(from) || []) { + if (distances.has(to)) continue; + distances.set(to, d + 1); + queue.push(to); + } + } + + // Полностью раскрыт = его исходящий список известен, и ВСЕ разрешённые фильтрами + // друзья сейчас видимы. За границей глубины большой аватар становится маленьким. + const expanded = new Map(); + const isExpanded = (id) => { + if (expanded.has(id)) return expanded.get(id); + const own = graphs.get(id); + if (!own) { expanded.set(id, false); return false; } + let complete = true; + for (const friend of own.friends) { + if (!allowed(friend)) continue; + if (close && edges.get(`${id}\u0000${friend}`)?.type !== 'close_friend') continue; + if (!distances.has(friend)) { complete = false; break; } + } + expanded.set(id, complete); + return complete; + }; + + const refs = new Map(); + const edgePairs = new Set(); + const immediateEdges = new Map(); + for (const edge of eligibleEdges) { + if (!distances.has(edge.from) || !distances.has(edge.to)) continue; + if (!immediateEdges.has(edge.from)) immediateEdges.set(edge.from, edge); + if (!immediateEdges.has(edge.to)) immediateEdges.set(edge.to, edge); + const pair = [edge.from, edge.to].sort(); + const pairKey = pair.join('\u0000'); + if (edgePairs.has(pairKey)) continue; + edgePairs.add(pairKey); + // Линия одна на пару, направленность сохранена в исходном графе. + // Направленное ребро оставляем owner -> friend (не алфавитный порядок). + const child = edge.to; + const parent = edge.from; + const reverse = edges.get(`${edge.to}\u0000${edge.from}`); + // Периферийные маленькие пользователи не раскрывают собственные связи. + // Если оба конца сжаты из-за глубины, линия между ними не рисуется. + if (!isExpanded(edge.from) && !isExpanded(edge.to)) continue; + const detail = { + id: parent, + relationType: edge.type === 'close_friend' || reverse?.type === 'close_friend' ? 'close_friend' : 'friend', + mutual: Boolean(edge.mutual || reverse), + strength: edge.type === 'close_friend' ? 0.9 : 0.55, + }; + if (!refs.has(child)) refs.set(child, []); + refs.get(child).push(detail); + } + const nodes = [...distances].map(([id, d]) => { + const person = people.get(id) || { login: id, name: id }; + const ownEdge = immediateEdges.get(id); + return { + id, + login: person.login, + name: person.name, + avatar: person.avatar || null, + shining: Boolean(person.shining), + official: Boolean(person.official), + relationType: id === center ? 'self' : (ownEdge?.type || 'friend'), + mutual: Boolean(ownEdge?.mutual), + strength: ownEdge?.type === 'close_friend' ? 0.9 : 0.55, + distance: d, + tier: 1, // фиксированная карта; размер определяется visualSmall, НЕ tier. + visualSmall: !isExpanded(id), + edgeParents: refs.get(id) || [], + keepVisible: id === center, + }; + }); + return { focusId: center, nodes, preserveHistory: true, radius }; + } + + return { add, clear, snapshot, getFriends, has: (login) => graphs.has(keyOf(login)), + isFresh: (login, now = Date.now()) => { + const saved = updatedAt.get(keyOf(login)); + return saved != null && saved <= now && now - saved < 24 * 60 * 60 * 1000; + }, + size: () => graphs.size }; +} diff --git a/shine-UI/js/pages/network-explorer/network-view.js b/shine-UI/js/pages/network-explorer/network-view.js new file mode 100644 index 00000000..09df75da --- /dev/null +++ b/shine-UI/js/pages/network-explorer/network-view.js @@ -0,0 +1,447 @@ +import { t } from '../../i18n/index.js'; +import { createTopBar } from '../../components/topbar.js'; +import { iconHtml } from '../../components/ui-icon.js'; +import { authService, state } from '../../state.js'; +import { makeProfileRoute, makeProfileLinksRoute } from '../../services/shine-routes.js'; +import { CONNECTIONS_GRAPH_CHANGED } from '../../services/connections-graph-cache.js'; +import { createForceGraph } from '../network-legacy/force-graph.js'; +import { openNodeMenu } from '../network-legacy/node-menu.js'; +import { createExplorerGraph, keyOf, EXPLORER_DEFAULT_DEPTH, EXPLORER_MAX_DEPTH } from './graph-model.js'; +import { getExplorerGraph, readExplorerCachedGraphs, clearExplorerGraphCache, explorerCacheScope, explorerGraphSavedAt } from './graph-cache.js'; + +export const pageMeta = { + id: 'network-view', + get title() { return t('screens.network_view.text_001'); }, + shellMode: { + topFade: true, bottomFade: true, bottomFadeAnchor: 'toolbar', + fadeProfile: 'edge', contentUnderTopbar: true, scrollContainer: 'locked', + }, +}; + +const normalizeLogin = (value) => String(value || '').trim(); +const escapeHtml = (text) => String(text || '').replaceAll('&', '&').replaceAll('<', '<') + .replaceAll('>', '>').replaceAll('"', '"').replaceAll("'", '''); +function createDebounced(fn, ms = 2000) { + let timer = 0; + const debounced = (...args) => { if (timer) window.clearTimeout(timer); timer = window.setTimeout(() => { timer = 0; fn(...args); }, ms); }; + debounced.cancel = () => { if (timer) window.clearTimeout(timer); timer = 0; }; + return debounced; +} +function hash01(value) { + let h = 2166136261; + for (const ch of String(value)) { h ^= ch.charCodeAt(0); h = Math.imul(h, 16777619); } + return (h >>> 0) / 4294967296; +} + +// V3 state survives switching between tabs; long-term graph responses reside in IndexedDB. +let retained = null; + +export function render({ navigate, route, chrome } = {}) { + const screen = document.createElement('section'); + screen.className = 'network-screen network-explorer'; + const stage = document.createElement('div'); + stage.className = 'network-stage'; + const board = document.createElement('div'); + board.className = 'network-board network-board--full fg-stage'; + const toolbar = document.createElement('div'); + toolbar.className = 'fg-filter-bar app-top-tabs'; + toolbar.addEventListener('pointerdown', (event) => event.stopPropagation()); + const status = document.createElement('div'); + status.className = 'network-explorer__status'; + status.setAttribute('role', 'status'); + status.setAttribute('aria-live', 'polite'); + stage.append(board, toolbar, status); + screen.append(stage); + + const scope = explorerCacheScope(authService, state.session.login); + if (!retained || retained.scope !== scope) retained = { + scope, graph: createExplorerGraph(), positions: new Map(), center: '', + depth: EXPLORER_DEFAULT_DEPTH, x2: false, close: false, shining: false, + }; + const session = retained; + let centerLogin = normalizeLogin(route?.params?.login || session.center || state.session.login); + session.center = centerLogin; + let engine = null; + let disposed = false; + let loadSeq = 0; + let drawTimer = 0; + let searchClose = null; + let cacheWasCleared = false; + + function profileRoute(login) { + if (keyOf(login) === keyOf(state.session.login)) return 'profile-view'; + return makeProfileRoute(login); + } + function updateStatus(text = '') { + if (disposed) return; + status.textContent = text; + status.hidden = !text; + } + function getSnapshot() { + return session.graph.snapshot(centerLogin, session); + } + function shiftToCenter(login) { + const pivot = session.positions.get(keyOf(login)); + if (!pivot) return; + for (const [key, p] of session.positions) { + session.positions.set(key, { x: p.x - pivot.x, y: p.y - pivot.y }); + } + } + + // Расставляем только новые узлы. Старые координаты не меняются при загрузке/фильтрах. + function placeNodes(nodes) { + const occupied = [...session.positions.values()]; + const byId = new Map(nodes.map((node) => [node.id, node])); + const adjacency = new Map(); + for (const node of nodes) { + for (const edge of node.edgeParents || []) { + const parent = edge.id; + if (!adjacency.has(node.id)) adjacency.set(node.id, []); + if (!adjacency.has(parent)) adjacency.set(parent, []); + adjacency.get(node.id).push(parent); + adjacency.get(parent).push(node.id); + } + } + const center = keyOf(centerLogin); + if (!session.positions.has(center)) session.positions.set(center, { x: 0, y: 0 }); + const pending = nodes.filter((node) => !session.positions.has(node.id)).sort((a, b) => a.distance - b.distance); + for (const node of pending) { + const connected = (adjacency.get(node.id) || []).filter((id) => session.positions.has(id)); + const nearest = connected.sort((a, b) => (byId.get(a)?.distance ?? 99) - (byId.get(b)?.distance ?? 99))[0]; + const base = session.positions.get(nearest) || { x: 0, y: 0 }; + let point = null; + const phase = hash01(node.id) * Math.PI * 2; + for (let ring = 1; ring <= 35 && !point; ring += 1) { + const count = Math.max(8, Math.round(6 * ring)); + for (let i = 0; i < count; i += 1) { + const angle = phase + Math.PI * 2 * i / count; + const x = base.x + Math.cos(angle) * ring * 84; + const y = base.y + Math.sin(angle) * ring * 84; + if (occupied.every((p) => Math.hypot(x - p.x, y - p.y) >= 66)) { point = { x, y }; break; } + } + } + point ||= { x: base.x + 300, y: base.y + 300 }; + session.positions.set(node.id, point); + occupied.push(point); + } + } + + function draw() { + if (disposed || !centerLogin) return; + const model = getSnapshot(); + placeNodes(model.nodes); + model.nodes = model.nodes.map((node) => ({ + ...node, layoutX: session.positions.get(node.id)?.x || 0, + layoutY: session.positions.get(node.id)?.y || 0, fixedLayout: true, + })); + if (engine) engine.setModel(model); + else engine = createForceGraph({ + stage: board, model, explorerMode: true, + onNodeTap: (node) => { void load(node.login, true); }, + onCenterTap: (node) => nodeMenu(node, false), + onNodeLongPress: (node, point) => nodeMenu(node, true, point), + onNodeMoveEnd: (node, point) => savePositions([{ id: node.id, ...point }]), + onGroupMoveEnd: savePositions, + }); + } + function scheduleDraw() { + if (drawTimer || disposed) return; + drawTimer = window.setTimeout(() => { drawTimer = 0; draw(); }, 120); + } + function savePositions(rows) { + (rows || []).forEach((row) => { + const x = Number(row?.x); const y = Number(row?.y); + if (keyOf(row?.id) && Number.isFinite(x) && Number.isFinite(y)) session.positions.set(keyOf(row.id), { x, y }); + }); + } + function nodeMenu(node, long = false, point = null) { + const rect = node?.el?.getBoundingClientRect?.(); + openNodeMenu({ + login: normalizeLogin(node?.login), displayName: String(node?.name || '').trim(), + relationType: node?.relationType, + point: point || (rect ? { x: rect.left + rect.width / 2, y: rect.top, rect } : undefined), + actions: [ + { label: t(long ? 'screens.network_view.text_006' : 'screens.network_view.text_004'), onClick: () => navigate?.(profileRoute(node?.login)) }, + { label: t(long ? 'screens.network_view.text_007' : 'screens.network_view.text_005'), onClick: () => navigate?.(`chat/${encodeURIComponent(normalizeLogin(node?.login))}`) }, + ], + }); + } + function updateUrl(login, push = false) { + const nextPath = `/${makeProfileLinksRoute(login)}`; + if (window.location.pathname === nextPath) return; + if (push) window.history.pushState({}, '', nextPath); + else window.history.replaceState({}, '', nextPath); + } + async function fetchGraph(login, currentSeq) { + const key = keyOf(login); + if (session.graph.isFresh(key)) return true; + try { + const graph = await getExplorerGraph(authService, login, { scope }); + if (disposed || currentSeq !== loadSeq) return false; + session.graph.add(graph, login, explorerGraphSavedAt(scope, login) || Date.now()); + scheduleDraw(); + return true; + } catch (error) { + if (!disposed && currentSeq === loadSeq) console.warn('[Network V3] Failed to load', login, error); + return false; + } + } + async function load(nextLogin, push = false) { + const next = normalizeLogin(nextLogin); + if (!next || disposed) return; + const seq = ++loadSeq; + if (keyOf(next) !== keyOf(centerLogin)) { + if (session.positions.has(keyOf(next))) shiftToCenter(next); + else { + // Поиск неизвестного ранее человека: сдвигаем старую карту от нового центра. + for (const [id, p] of session.positions) + session.positions.set(id, { x: p.x - 190, y: p.y }); + } + } + centerLogin = next; + session.center = next; + updateUrl(next, push); + draw(); // мгновенно показать уже исследованную карту, ещё до завершения сетевых запросов + updateStatus(t('screens.network_explorer.loading')); + const ok = await fetchGraph(next, seq); + if (disposed || seq !== loadSeq) return; + if (!ok) { updateStatus(t('screens.network_explorer.error')); return; } + draw(); + if (!session.x2) { updateStatus(); return; } + + const friends = [...(session.graph.getFriends(next) || [])]; + let index = 0; + let finished = 0; + let failed = 0; + const workers = Array.from({ length: Math.min(4, friends.length) }, async () => { + while (index < friends.length && !disposed && seq === loadSeq && session.x2) { + const friend = friends[index++]; + if (!await fetchGraph(friend, seq)) failed += 1; + finished += 1; + if (!disposed && seq === loadSeq) updateStatus(t('screens.network_explorer.progress', { value1: finished, value2: friends.length })); + } + }); + await Promise.all(workers); + if (disposed || seq !== loadSeq) return; + draw(); + updateStatus(failed ? t('screens.network_explorer.partial', { value1: failed }) : ''); + } + + function chip(label, fn, selected = false) { + const element = document.createElement('button'); + element.type = 'button'; element.className = `fg-filter-chip${selected ? ' is-active' : ''}`; + element.textContent = label; + element.setAttribute('aria-pressed', selected ? 'true' : 'false'); + element.addEventListener('click', fn); + toolbar.append(element); + return element; + } + const closeChip = chip(t('screens.network_view.text_002'), () => { + session.close = !session.close; + closeChip.classList.toggle('is-active', session.close); + closeChip.setAttribute('aria-pressed', String(session.close)); + draw(); + }, session.close); + const shineChip = chip(t('screens.network_view.text_003'), () => { + session.shining = !session.shining; + shineChip.classList.toggle('is-active', session.shining); + shineChip.setAttribute('aria-pressed', String(session.shining)); + draw(); + }, session.shining); + const x2Chip = chip('X2', () => { + session.x2 = !session.x2; + x2Chip.classList.toggle('is-active', session.x2); + x2Chip.setAttribute('aria-pressed', String(session.x2)); + void load(centerLogin); + }, session.x2); + const depthChip = chip('', () => { + session.depth = (session.depth + 1) % (EXPLORER_MAX_DEPTH + 1); + syncDepth(); draw(); + }); + function syncDepth() { + depthChip.textContent = t('screens.network_explorer.depth', { value1: session.depth }); + depthChip.title = t('screens.network_explorer.depth_hint', { value1: session.depth + (session.x2 ? 2 : 1) }); + depthChip.setAttribute('aria-label', depthChip.title); + } + syncDepth(); + + async function resetCache() { + ++loadSeq; + cacheWasCleared = true; + updateStatus(t('screens.network_explorer.clearing')); + await clearExplorerGraphCache(); + session.graph.clear(); + session.positions.clear(); + if (!disposed) void load(centerLogin); + } + + + function openSearchModal() { + const root = document.getElementById('modal-root'); + if (!(root instanceof HTMLElement)) return; + root.innerHTML = ` +
Центр: ${escapeHtml(focus ? (focus.name || focus.login || '') : '')}. Связей 1-го уровня: ${tier1.length}.
Центр: ${escapeHtml(focus ? (focus.name || focus.login || '') : '')}. Связей 1-го уровня: ${tier1.length}.