Гайды · документация

Первый запуск

открывает подробности ведёт к полному разбору

При первом запуске приложение открывает мастер из семи шагов. Это не «регистрация на сайте»: мастер создаёт ключ, локальную базу и первый пакет данных — всё на вашем устройстве.

Прогресс сохраняется. Окно можно закрыть на любом шаге и продолжить позже. Для уже работающего узла мастер короткий: ключ и карточка подставляются готовыми, в боковой колонке есть «Пропустить мастер». Вернуться к мастеру можно в «Настройках» → «Режим работы» → «Пройти мастер заново».
технически что мастер создаёт на диске
  • Файл ключа узла (keystore), закрытый вашим паролем: Argon2id + XChaCha20-Poly1305.
  • Базу SQLite (схема v14) для карточек, переписки и индексов поиска.
  • Заготовку приватного пакета: pack.keys.json и pack.enc.json.

Шаг 1. Знакомство

Короткий экран о том, как устроен узел: данные у вас, раскрытие только по одобрению, поиск локальный. Здесь нечего настраивать — просто подтвердите, что понятно.

Первый экран мастера: знакомство с устройством личного узла
Знакомство. Четыре пункта: роль, ключ, карточка, релеи — что именно делает мастер.

Шаг 2. Роль

«Я ищу работу» (работник), «Я ищу исполнителей» (работодатель) или «И ищу, и нанимаю» (две стороны). Роль влияет только на интерфейс: ключи, карточка и данные не меняются, переключить можно в любой момент.

Выбор роли в мастере: работник, работодатель или две стороны
Роль. В режиме «две стороны» в навигации появляются обе карточки — соискателя и компании.

Шаг 3. Ключ узла

Создайте новый ключ (метка + пароль от 8 символов) или восстановите из секретного ключа nsec. После создания nsec показывается один раз — сохраните его офлайн и отметьте галочку «Я сохранил nsec офлайн», иначе мастер не пойдёт дальше.

Экран с nsec: единожды показанный секретный ключ и подтверждение, что он сохранён
nsec показывается один раз. Пароль защищает файл ключа, но восстановить узел можно только по nsec.
Пароль и секретный ключ — разные вещи. Пароль расшифровывает файл ключа на вашем устройстве. Если файл ключа потерян, пароль не поможет — нужен именно nsec. Если потерян nsec и файл ключа цел, но пароль забыт — узел тоже не восстановить.
технически как устроен ключ узла

nsec — приватный ключ (32 байта, формат bech32) по схеме Schnorr/BIP-340. Открытая пара к нему — npub, он и есть адрес вашего узла в сети. Ключ хранится в зашифрованном keystore, пароль живёт только в памяти приложения и забывается при автолоке или выходе.

pvctl identity-status # npub, did, состояние ключа

Шаг 4. Карточка

Публичный слой. Поля подсказываются по роли: у соискателя — специализация, навыки, стаж, город, ожидания по оплате; у компании — название, отрасли, направления найма, города, формат, бюджет. Контакты и документы сюда не пишите — для них есть приватный пакет.

Шаг мастера с двумя карточками: резюме соискателя и карточка компании
Карточки. В режиме «две стороны» на шаге есть переключатель соискатель / компания; публикуются они одним событием.

Шаг 5. Релеи

В списке уже есть 3–5 релеев: видны статус и задержка. Можно добавить свой, снять или поставить галочки чтения и записи. Для заявок и выдачи доступа полезно добавить отдельный закрытый релей — приватную полосу (в интерфейсе она помечена словом private).

Экран релеев: статусы, задержки, полосы public и private, кнопки чтения и записи
Релеи. Статус, задержка и переключатели чтения/записи. Приватная полоса — для заявок, доступов и чата.
технически релеи, полосы и чтение

Публичный релей проекта — wss://relay.job.xnpk.ru, приватный — wss://private.job.xnpk.ru (белый список ключей, чтение только после NIP-42 AUTH). Полоса задаётся при добавлении релея; события публичной и приватной полосы не смешиваются.

pvctl relays-list pvctl relays-replace --url wss://relay.job.xnpk.ru --lane public pvctl relays-replace --url wss://private.job.xnpk.ru --lane private

подробнее: релеи и PoW

Шаг 6. Сессия

Автолок по простою: выкл / 5 / 15 / 30 / 60 минут. После него пароль забывается, и приложение снова просит разблокировку. Здесь же — базовые правила безопасности.

Настройки: автолок по простою и данные ключа узла
Автолок. По умолчанию 30 минут. Пароль живёт только в памяти приложения.

Шаг 7. Готово

Чек-лист: обязательные шаги закрыты, рекомендации можно выполнять позже. Кнопки «Опубликовать карточку» (для нового ключа приложение сразу посчитает нужную защиту от спама) и «Синхронизировать индекс» (сторона работодателя).

технически что происходит при первой публикации

Для нового ключа узел сразу добывает proof-of-work 20 бит (NIP-13) — рекомендация релеев проекта. Майнинг идёт на клиенте в фоне, результат кэшируется на 10 минут.

подробнее: релеи · proof-of-work

После мастера

  1. Заполните приватный пакет. Разделы и файлы — в разделе «Пакет». В общую сеть уйдёт только оглавление.
  2. Проверьте чек-лист. Он покажет, что закрыто, а что нет.
  3. Опубликуйте карточку. Панель публикации покажет результат по каждому релею: принято / ошибка, задержка, чтение обратно.
  4. Настройте уведомления. Всплывающее сообщение, системные уведомления, звук — категории можно отключать по отдельности.
Если что-то пошло не так. Ошибки публикации почти всегда означают требование релея: не хватает защиты от спама или ключ не в белом списке. При отказе клиент сам добивает нужную сложность и повторяет попытку.
технически чек-лист и диагностика из терминала
pvctl readiness # ключ, карточка, публикация, релеи pvctl identity-status # npub и did:key pvctl cards-search --query 'win' --side worker