§5で自分のサーバーを立ち上げ、実際のドメインをそこに向けたら、これを設定して再ビルドしてください：以降に配布するすべてのコピーでは、他のコードに一切手を加えることなく、そのURLを使用して "Seal" が実際の選択可能なオプションとして表示されます。通常のビルド/開発ビルドでは未設定のままにしてください：このリポジトリには公式サーバーがホストされていないため、"Seal" は無効のままであり、ユーザーはカスタムサーバーまたはローカルサーバーにフォールバックすることになります。アプリが実際には何も実行していないプレースホルダードメインを黙って指すことはありません。

---

## 3. 開発モードで実行する```sh
cd apps/desktop
npm install
npm run tauri dev

### 2つのインスタンスをローカルで実行する（実際にメッセージングをテストするため）

各インスタンスには独自のIDが必要です。Seal は複数のアカウントをネイティブにサポートしています（このデバイスの Settings → Accounts）が、1台のマシン上で2つの *別々のプロセス* を実行するには、`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`にインストールされたコピー）を
`npm run tauri dev`の代わりに異なる`P2P_CHAT_PROFILE`で2回起動し、
実際のユーザーが実行する状況に近い。PIDと両方の停止方法を出力する。

### デバッグ

- **Rustログ**: 起動前に`RUST_LOG`を設定します。例:
  `RUST_LOG=debug npm run tauri dev`（または`RUST_LOG=p2p_core=debug,net=debug`
  で範囲を絞る）。ログに記録されるフィールドはメタデータ（ピア/グループ/ユーザー
  ID、エラータイプ）のみです。詳細なままでも安全な理由は
  [`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

Interactive、Linux + systemd のみ対応（理由はスクリプトのヘッダーを参照）。どのディストリビューション系かを尋ねる（Debian/Ubuntu、Fedora/RHEL/Rocky/Alma、Arch/Manjaro、openSUSE。`/etc/os-release` からの推測で事前入力されるので、通常は1回のキー入力で確認できる）。そして、ファミリーごとの専用関数でそのディストリのビルド前提条件をインストールし、Rust が無い場合は `rustup` 経由でインストールするか尋ね、リリースバイナリをビルドし、専用システムユーザーを作成し、管理トークンを生成し、[Caddy](https://caddyserver.com) による自動HTTPS付きドメインを設定するか（Caddy自体もディストリごとにインストールし、ディストリのパッケージが無い場合はCaddy公式の静的バイナリにフォールバック）、それとも自分で前面に出す場合はループバック/平文HTTPにバインドするだけにするかを尋ね、その後 systemd サービスを書き込んで有効化する。再実行しても安全。
以下は、実際にこのスクリプトが行っている内容です。手動で行いたい場合や、実行前に理解したい場合にどうぞ。

### macOS: 手軽なLANテストサーバー```sh
./scripts/run-mac-test-server.sh

| 変数 | 必須 | 意味 |
|---|---|---|
| `DIRECTORY_DB_PATH` | 任意（デフォルト `directory.sqlite3`、カレントディレクトリ） | 単一のSQLiteファイルが配置される場所。親ディレクトリが存在している必要があります。 |
| `DIRECTORY_PUBLIC_ADDR` | 任意（デフォルト `0.0.0.0:8080`） | アプリが通信するランデブーAPI。公開しても問題ありません。 |
| `DIRECTORY_ADMIN_ADDR` | 任意（デフォルト `127.0.0.1:8090`） | パージエンドポイント。これをパブリックインターネットに公開しないでください。以下を参照。 |
| `DIRECTORY_ADMIN_TOKEN` | **必須** | 管理API用のBearerトークン。プロセスはこれなしでは起動を拒否します。`openssl rand -hex 32` または類似のコマンドで生成してください。他の場所で再利用しないでください。 |

プロセスは起動時にバインドしたアドレスをログに記録し、
`DIRECTORY_ADMIN_ADDR` がループバックでない場合は大きく警告します。

### アプリの接続先を指定する

通常使うであろう順に、3つの方法があります：

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. **表示名を選択します。** これにより、デバイス上に秘密鍵ペアが生成され
   （覚えるものはなく、失われた場合に回復できるものもありません。これは
   意図的です）と、暗号化が実際にどのように機能するかについてのアプリ内の
   短い説明が表示されます。設定からいつでも再生できます。以降の
   起動時は、プロンプトなしで直接戻ります。これはアカウントごとに1回だけ
   発生します。設定 → アカウントから、このデバイス上でさらにアカウント
   （完全に別々のアイデンティティ）を追加し、再起動せずにそれらを切り替えることができます。
3. **誰かを追加する**: 「ダイレクトメッセージ」の横にある**+**をクリックし、
   相手のID（*相手の*設定 → マイアイデンティティにあります）を入力します。閲覧できるディレクトリは
   設計上ありません。電話番号を共有するのと同じ方法で接続します。
4. **メッセージを送信する**: リストから名前を選んで入力します。誰かに送る最初の
   メッセージは、自動的に暗号化セッションを確立します。
5. **グループを開始する**: アイコン欄の**+**をクリックし、名前を付けてから、
   同じ方法でIDで人を招待します。メンバーを削除するとグループのキーがローテーションされるため、
   その後送信されたものを読めなくなります。
6. **すべて削除する**: 設定 → データとプライバシー。これは即時で、
   ローカルのみに影響し、取り消し不可能です。キー、連絡先、
   *このデバイス*上の履歴を破壊し、会話した相手には影響しません。