Fedora:```sh
sudo dnf install webkit2gtk4.1-devel openssl-devel curl wget file \
  libappindicator-gtk3-devel librsvg2-devel pkgconf-pkg-config
sudo dnf group install "C Development Tools and Libraries"

(Имена пакетов меняются между релизами Tauri: если сборка завершается ошибкой из-за
отсутствующего файла `.pc`, проверьте
[актуальные требования Tauri для Linux](https://v2.tauri.app/start/prerequisites/)
для вашего дистрибутива.)

</details>

<details>
<summary><strong>Windows</strong></summary>

1. Установите **Microsoft C++ Build Tools** (Visual Studio Installer →
   рабочая нагрузка «Разработка классических приложений на C++»), нужные как для нативной
   оболочки Tauri, так и для компиляции встроенного SQLite.
2. Установите тулчейн Rust **MSVC**: `rustup default stable-msvc`.
3. **WebView2**: уже присутствует в Windows 11 и в большинстве актуальных установок Windows
   10; если его нет, сборка Tauri предложит установить
   Evergreen runtime.

</details>

---

## 2. Сборка

Из корня репозитория:```sh
# Rust workspace (backend crates + the directory server)
cargo build --workspace --release

# Frontend + the actual desktop app bundle (installer/.app/.exe)
cd apps/desktop
npm install
npm run tauri build

Как только вы поднимете собственный сервер (§5) и направите на
него реальный домен, задайте это значение и пересоберите: каждая распространяемая вами копия с этого момента показывает
«Seal» как реальную выбираемую опцию с использованием этого URL, не затрагивая
никакой другой код. Оставьте это значение незаданным для обычных/dev-сборок: здесь нет официального
сервера, размещаемого этим репозиторием, поэтому «Seal» остаётся отключённой, и пользователи возвращаются к
пользовательскому серверу или локальному, вместо того чтобы приложение молча указывало на
домен-заполнитель, который на самом деле ничего не запускает.

---

## 3. Запуск в dev-режиме```sh
cd apps/desktop
npm install
npm run tauri dev

### Запуск двух экземпляров локально (чтобы реально протестировать обмен сообщениями)

Каждому экземпляру нужна своя идентичность. Seal поддерживает несколько аккаунтов нативно (Настройки → Аккаунты на этом устройстве), но для двух *отдельных процессов* на одной машине `P2P_CHAT_PROFILE` — более быстрый путь: он автоматически создаёт (при первом запуске) или автоматически возобновляет (при каждом последующем) аккаунт с этим именем, без интерактивного взаимодействия, полностью пропуская выбор аккаунта:```sh
# terminal 1
P2P_CHAT_PROFILE=alice npm run tauri dev

# terminal 2
P2P_CHAT_PROFILE=bob npm run tauri dev

Та же идея, что и выше, но запускает реально собранное приложение (результат `build-mac-app.sh` /
`build-mac-dmg.sh` или установленную копию в `/Applications`) дважды
с разными `P2P_CHAT_PROFILE` вместо `npm run tauri dev`, что ближе
к тому, что запускает реальный пользователь. Выводит их PID и способ остановки обоих.

### Отладка

- **Журналы Rust**: задайте `RUST_LOG` перед запуском, например:
  `RUST_LOG=debug npm run tauri dev` (или `RUST_LOG=p2p_core=debug,net=debug`
  для сужения области). Логируемые поля ограничены метаданными (идентификаторы
  пиров/групп/пользователей, типы ошибок); см. [`docs/SECURITY.md`](https://github.com/emn4tor/seal/blob/HEAD/docs/SECURITY.md) о том, почему
  это можно безопасно оставлять подробным.
- **Фронтенд**: окно разработки — это настоящее webview; щелчок правой кнопкой мыши →
  «Проверить элемент» (или открыть инструменты разработчика) работает как в обычном браузере.
- **Бэкенд-крейты изолированно**: каждый крейт имеет собственный набор тестов, который можно
  запускать и итерировать, вообще не трогая UI; см. §4.
- **Автономный сервер каталогов** вместо встроенного: см. §5.

---

## 4. Тестирование```sh
# everything
cargo test --workspace

# one crate, e.g. the full backend-to-backend flow a Tauri command would trigger
cargo test -p p2p-core --test app_service

# lint + format check (what CI runs)
cargo fmt --all -- --check
cargo clippy --workspace --all-targets -- -D warnings

# dependency vulnerability scan
cargo install cargo-audit --locked   # once
cargo audit

# frontend type-check + build
cd apps/desktop && npm run build

Интерактивный, только Linux + systemd (см. шапку скрипта, почему). Он
спрашивает, к какому семейству дистрибутивов вы относитесь (Debian/Ubuntu, Fedora/RHEL/Rocky/Alma,
Arch/Manjaro или openSUSE, с предварительно заполненным значением, угаданным из `/etc/os-release`,
так что обычно достаточно одного нажатия клавиши) и устанавливает зависимости сборки
этого дистрибутива с помощью отдельной функции для каждого семейства, предлагает установить Rust
через `rustup`, если он отсутствует, собирает release-бинарник, создаёт отдельного
системного пользователя, генерирует токен администратора, спрашивает, хотите ли вы,
чтобы он настроил домен с автоматическим HTTPS через [Caddy](https://caddyserver.com)
(устанавливая сам Caddy, для каждого дистрибутива, с откатом на официальный
статический бинарник Caddy, если пакет дистрибутива недоступен), или чтобы он просто привязался
к loopback/обычному HTTP, если вы предпочитаете обслуживать его самостоятельно, затем записывает и
включает systemd-сервис. Безопасно запускать повторно.
Всё, что ниже, — это то, что скрипт на самом деле делает, если вы хотите сделать это вручную
или понять это перед запуском.

### macOS: быстрый тестовый сервер в локальной сети```sh
./scripts/run-mac-test-server.sh

| Переменная | Обязательна | Значение |
|---|---|---|
| `DIRECTORY_DB_PATH` | нет (по умолчанию `directory.sqlite3`, cwd) | Где живёт единственный файл SQLite. Родительский каталог должен существовать. |
| `DIRECTORY_PUBLIC_ADDR` | нет (по умолчанию `0.0.0.0:8080`) | Rendezvous API, с которым общаются приложения. Можно безопасно выставлять наружу. |
| `DIRECTORY_ADMIN_ADDR` | нет (по умолчанию `127.0.0.1:8090`) | Эндпоинт очистки (purge). Не открывайте его в публичный интернет; см. ниже. |
| `DIRECTORY_ADMIN_TOKEN` | **да** | Bearer-токен для административного API. Процесс отказывается запускаться без него. Сгенерируйте с помощью `openssl rand -hex 32` или аналогично; не используйте его где-либо ещё. |

Процесс при запуске записывает в журнал, какие адреса он слушает, и громко предупреждает, если
`DIRECTORY_ADMIN_ADDR` не является loopback.

### Как подключить приложение к нему

Три способа — в порядке, в котором вы обычно будете к ним обращаться:

1. **Экран первого запуска**: выберите «Пользовательский сервер» и введите URL. См. §3.
2. **Настройки → Сервер каталога**: измените позже; вступит в силу после
   следующего перезапуска.
3. **`P2P_CHAT_DIRECTORY_URL`**, установите перед запуском: полностью пропускает запрос
   и переопределяет всё сохранённое; полезно для разработки и скриптованных запусков:   ```sh
   P2P_CHAT_DIRECTORY_URL=https://directory.example.com npm run tauri dev

Это удаляет файл SQLite и заново создаёт пустую схему: никаких `DELETE`
операторов, никакого частичного состояния. Его можно безопасно запускать без предупреждения кого-либо:
каждая запись в нём — это кэш данных, которые каждый клиент уже хранит локально
(свою регистрацию, присутствие и любые списки участников групп, в которые он входит),
поэтому клиенты просто заново заполняют его в течение нескольких мгновений после следующего действия.
Для этой базы данных намеренно не предусмотрена политика резервного копирования; см.
[`docs/SECURITY.md`](https://github.com/emn4tor/seal/blob/HEAD/docs/SECURITY.md) о том, почему её наличие подорвало бы
весь смысл.

---

## 6. Использование приложения

1. **Первый запуск, первый вопрос**: какой сервер каталогов использовать (§3).
   По умолчанию используется то, что встроено в запускаемую вами сборку (локальный
   тестовый сервер, если только тот, кто собрал её, не настроил официальный); выберите
   "Свой сервер", чтобы указать на сервер, который размещаете вы или тот, кому вы доверяете.
2. **Выберите отображаемое имя.** При этом на вашем устройстве создаётся пара ключей
   (нечего запоминать, и при потере невозможно ничего восстановить: это сделано намеренно),
   и вы проходите краткое объяснение в приложении того, как на самом деле работает шифрование.
   Повторить его можно в любой момент в Настройках. Каждый последующий запуск сразу
   возвращает вас в приложение без запроса; это происходит только один раз для каждой
   учётной записи. Добавляйте другие учётные записи (полностью отдельные личности) через
   Настройки → Учётные записи на этом устройстве и переключайтесь между ними без перезапуска.
3. **Добавьте собеседника**: нажмите **+** рядом с "Личные сообщения" и введите его
   ID (указан в *его* Настройки → Моя личность). Каталога для просмотра нет — это
   сделано намеренно; вы подключаетесь так же, как делитесь номером телефона.
4. **Напишите собеседнику**: выберите имя из списка и вводите текст. Первое сообщение
   собеседнику автоматически устанавливает зашифрованный сеанс.
5. **Создайте группу**: нажмите **+** на панели значков, дайте ей имя, затем пригласите
   людей по ID так же, как описано выше. Удаление кого-либо ротирует ключ группы, чтобы
   удалённый не мог прочитать ничего из отправленного после.
6. **Удалите всё**: Настройки → Данные и конфиденциальность. Это мгновенно, действует
   только локально и необратимо: оно уничтожает ваши ключи, контакты и историю на
   *этом устройстве* и не оказывает никакого влияния на тех, с кем вы общались.