合言葉共有

要件	値
ログインの有無	True
合言葉共有トグル	True
パスワード（合言葉）	string
エンドポイント	/v1/files/watchword
メソッド	POST

概要

「合言葉」を介して、サーバーにファイルを保存せずブラウザ間で直接ファイルを転送する機能です。同一LAN内・インターネット越し（異なるネットワーク間）の双方に対応しています。

解決する問題: 共有リンクの発行や権限設定の手間を省き、口頭で「合言葉」を伝えるだけでセキュアな受け渡しを可能にします。

プライバシー: 機密ファイルはデバイス間（Peer-to-Peer）で完結するため、サーバーに実体やログが残りません。

フロント→バックに必要なデータ

キー	値の情報
ファイル名	string
ファイル形式	string
ファイルサイズ	integer
MIME形式	string
送信者ID	string
受信者ID	string
ファイルハッシュ	string
チャンクサイズ	integer
共有有効期限（任意）	datetime
ダウンロード可	boolean

バック→フロントに必要なデータ

キー	値の種類
合言葉	String

実装要件

必要なコンポーネント

コンポーネント	技術	備考
シグナリング	Rust (Axum) + WebSocket	SDPオファー/ICE候補の中継
ルーム管理	Valkey	合言葉をキーにルーム状態管理・TTL付き
P2P転送	WebRTC DataChannel	バイナリ直接転送（サーバー経由なし）

詳細: インフラ/WebRTCシグナリング.md