owner: gmikcon status: draft last_reviewed: 2026-10-11 review_interval: 90d confidence: medium
source_of_truth: planning
Gnexus Bookmarks (проект, не задеплоен)
Самодостаточный self-hosted сервис синхронизации закладок для экосистемы Gnexus — замена связки Floccus + Nextcloud Bookmarks. Проект оформлен 2026-10-11, к реализации приступаем позже (по явной команде владельца).
Purpose
Зачем: Floccus привязан к Nextcloud Bookmarks (или сторонним облакам), E2E-шифрование доступно только на WebDAV/Google Drive, мобильная поддержка ограничена (Kiwi/Fennec-квирки), а Nextcloud VM на bserv — главный кандидат на OOM-килл гипервизора (standing risk, см. 10-systems/hosts/nextcloud.md). Нужен лёгкий независимый сервис в стиле Gnexus: свой API, свой MCP, свой UI, своя авторизация.
Что это даёт:
- Полный контроль над данными закладок без зависимости от Nextcloud.
- E2E-шифрование как первоклассная фича (не опция отдельного метода синка).
- MCP-интерфейс для Navi-агентов (поиск, добавление, аудит закладок).
- Единый UX в дизайне gnexus-ui-kit и единая авторизация gnexus-auth.
Ownership
- Owner: gmikcon
- Criticality: low (комфорт-сервис, не критичная инфраструктура)
- Environment: планирование (не задеплоен)
- Status: draft / future work
Проблемы Floccus, которые решаем (факты, floccus.org/faq + GitHub, 2026-10)
- E2E-шифрование: только методы WebDAV и Google Drive; Nextcloud Bookmarks и Git — без E2E.
- Safari не поддержан (issue #23); Android — open beta app, расширения на мобилках только в Kiwi; Firefox Android не имеет bookmarks API.
- Firefox: нативные теги не поддержаны (нет API от Mozilla).
- Ограничения URL-схем: Nextcloud Bookmarks — только http(s)/javascript; chrome:// только через WebDAV/GDrive.
- Боли синхронизации: lock-зависания («Scheduled» без действий, снятие через 2 часа), ошибки «Failed to map parentId», E034/E035 (битый файл после выключения питания), failsafe против массовых удалений с ручным разбором.
- Зависимость от внешнего бэкенда (Nextcloud/облако) и его API-квирков.
Требования
Функциональные (MVP)
- CRUD закладок: URL, title, описание, теги, папки (иерархия), favicon.
- Синхронизация между браузерами: merge-стратегия, инкрементальные изменения, разрешение конфликтов без ручного разбора (в отличие от Floccus failsafe).
- Поиск: полнотекстовый по URL/title/описанию/тегам.
- Импорт/экспорт: HTML bookmarks file (стандарт Netscape), JSON.
- Миграция с Floccus: импорт текущего набора из Nextcloud Bookmarks.
Клиенты
- Браузерные расширения: Chrome, Firefox, Edge (WebExtensions API; Chromium-сборка покрывает Opera/Brave/Vivaldi).
- PWA: полноценный веб-клиент (установка на домашний экран, офлайн-кэш чтения).
- Мобильная стратегия: PWA как основной мобильный клиент (обход ограничений Kiwi/Fennec).
Безопасность (расширенные фичи)
- E2E-шифрование контента закладок: ключ выводится из пароля на клиенте (WebCrypto PBKDF2/Argon2id → AES-GCM), сервер хранит только шифротекст; опция per-profile.
- Токены устройств: отдельные revocable токены для каждого браузера/устройства (паттерн Floccus app-токенов, но с UI управления и last_used_at).
- Аудит всех операций (кто/что/когда), особенно через MCP.
- Rate-limit на API и MCP.
- 2FA/passkeys — наследуется от gnexus-auth (см. проект Gnexus Auth: passkeys как PWA-часть).
Архитектура
Компоненты
- Backend API: REST + WebSocket/SSE для push-событий синхронизации. Стек — по решению на этапе спеки (кандидаты: Python/FastAPI или PHP/Laravel — консистентно с gnexus-auth-client-py/php).
- БД: SQLite или PostgreSQL (решить на спеке; объёмы персонального сервиса малы).
- MCP-сервер: встроен в сервис (паттерн gnexus-creds), streamable HTTP
/mcp-protocol/ (слэш значим), Bearer токены сервиса, scopes mcp/read/write, страница «Токены» в UI, аудит channel=mcp.
- Browser extension: WebExtensions, синк-движок с локальной очередью изменений и офлайн-устойчивостью (анти-паттерны Floccus: без серверных lock-файлов, без битых файлов — инкрементальный журнал изменений на сервере).
- PWA: gnexus-ui-kit (Vue), брутализм/тёмная тема/JetBrains Mono, SPA-гейт авторизации.
Sync-модель (ключевое отличие от Floccus)
- Событийная модель: каждый клиент пишет изменения (create/update/move/delete) в журнал на сервере; сервер раздаёт дельты по cursor'у. Нет «файла закладок целиком» — нет E034/E035.
- Конфликты: серверная детерминированная резолюция (last-write-wins по полям + tombstone для удалений), опциональный журнал для отката.
- Failsafe-аналог: мягкий лимит массовых удалений с подтверждением в UI, но без блокировки синка.
- SSO через gnexus-auth: OAuth 2.0 PKCE, redirect_uri
<сервис>/auth/callback, клиентская либа gnexus-auth-client-py/php.
- SPA-гейт: splash →
GET /me → denied/ready; cookie-сессия ~7 суток; webhookи profile.update и global_logout с HMAC-подписью.
- Матрица доступа: браузер — cookie-сессия; расширения и MCP — Bearer токены сервиса; allowlist email опционально.
- Секреты клиента OAuth — в
.env сервиса и gnexus-creds, не в git.
- gnexus-ui-kit как зависимость, Vue-адаптер; GnPageHeader, drawer-навигация, GnModal/GnConfirmDialog, useToast.
- i18n: язык по умолчанию из
profile.locale gnexus-auth.
Интеграции экосистемы
- gnexus-auth: SSO + webhookи (обязательно).
- gnexus-creds: хранение секретов (OAuth client secret, ключи шифрования серверных снапшотов).
- Gnexus Synapse: уведомления о событиях (ошибки синка устройств, массовые удаления, новые устройства).
- hard-panel: health-чек после деплоя.
- GitBucket: репозиторий кода.
Deployment (черновик, решается на спеке)
- Кандидаты: отдельная лёгкая VM на bserv (вне Nextcloud VM — изоляция от OOM-риска) или контейнер на существующем хосте. Бюджет-first: минимальные ресурсы.
- Публичный URL:
bookmarks.gnexus.space (кандидат; TLS на internal-proxy-vps, паттерн прочих сервисов).
- Бэкапы: дамп БД + снапшоты по расписанию (политика 20-deployment handbook).
Фазы (бэклог в gntodo, проект «Gnexus Bookmarks»)
- Спека: финализировать стек, схему БД, протокол синка, протокол E2E-шифрования.
- MVP backend: CRUD + поиск + auth SSO + журнал изменений.
- Browser extension (Chromium + Firefox): синк-движок, токены устройств.
- PWA-клиент: ui-kit, поиск, управление, офлайн-чтение.
- MCP-сервер: streamable HTTP, токены, scopes, аудит.
- Расширенная безопасность: E2E-шифрование, rate-limit, аудит-дашборд.
- Миграция: импорт из Nextcloud Bookmarks, отключение Floccus-профилей, вывод bookmarks-приложения из Nextcloud (по решению владельца).
Known Risks
- Имя «Gnexus Bookmarks» визуально конфликтует с «Gnexus Book» (knowledge base) — финальное название решить на спеке.
- E2E-шифрование усложняет серверный поиск и MCP-чтение контента: искать компромисс (поиск по метаданным на сервере + локальный полнотекстовый индекс на клиенте) — ключевое решение спеки.
- Мобильные расширения ограничены платформами (Kiwi/Fennec) — PWA обязателен, не опционален.
- Синк-протокол — самая рискованная часть (история багов Floccus: parentId, lock, битые файлы) — прототипировать отдельно до UI.
- Проект не начат: все статусы в gntodo — «не начато», в активную работу не брать без явной команды владельца.
- Inventory: (создать при деплое: services.yml, endpoints.yml, projects.yml)
- Endpoints: (планируется bookmarks.gnexus.space)
- Integrations: gnexus-auth, gnexus-creds, gnexus-synapse, hard-panel, gitbucket
- Projects: gntodo проект «Gnexus Bookmarks»
- Runbooks: (создать при деплое)
Sources
- floccus.org/faq (браузеры, E2E, lock, failsafe, parentId, URL-схемы) — 2026-10-11.
- github.com/floccusaddon/floccus README (7 методов синка, Safari issue #23, Android beta) — 2026-10-11.
- gnexus-handbook: 00-principles.md, 10-platform/auth.md, 10-platform/mcp.md, 10-platform/ui.md — 2026-10-11.
- gnexus-book: 10-systems/hosts/nextcloud.md (OOM standing risk, bookmarks app), 10-systems/services/gnexus-auth.md.