Samurai-meet

引き継ぎ

実装を再開する前に docs/ai/README.md、現在の実装状態、バックログ、ゼロトラスト規約 を読むこと。現行コードとこの引き継ぎが食い違う場合は、Go／TypeScriptの実装・テストを確認してからドキュメントを直す。

現在の境界（2026-08-27）

• 通常のネイティブAPI Base URLは https://samurai-meet.disnana.com/api/v1。127.0.0.1:8080やLAN URLへは自動切替しない。別環境は EXPO_PUBLIC_API_BASE_URL 等を明示する。
• 募集・マッチングのGo APIと、外国人／日本人画面からの募集フロー接続コードは存在する。日時入力はISO内部値と Asia/Tokyo 固定へ統一し、フロント／Goの自動テストで確認済み。募集作成から通知遷移までのiOS実機全通しE2Eは未確認。絶対時刻はUTC。
• 通知はDB永続化、一覧・既読、応募／承認／辞退／暗号化チャット送信のイベント生成、通知画面接続まで。OSプッシュ通知は未実装。
• チャットはRESTの暗号文送信・履歴・既読・短命token発行に加え、WebSocketリアルタイム配送（internal/chat/websocket.go、単一インスタンス前提のプロセス内ハブ）を実装済み。QUIC／HTTP/3 WebTransport配送は未実装。
• POST /api/v1/chats/{id}/transport-token はhandler既定値・サービス受理値ともに websocket で一致（実装済み・動作確認済み）。webtransport／quic は終端サーバーが無いため ErrChatInvalidInput（HTTP 400）で拒否する。QUIC採用時にサーバー実装と同じ変更で受理値を追加する。

変更時の注意

• 適用済みmigrationは編集しない。runnerは正規化SQLのSHA-256を schema_migrations に保存し、checksum mismatchで起動を止める。DDL変更は新しい番号のmigrationを追加する。
• 作業ツリーには未追跡の backend/migrations/0026_match_withdrawal.sql がある。本ドキュメントコミットではmigration本体をステージせず、対応するGoコード・テストと一緒に正式コミットするまで未適用として扱う。
• Expo Goはnative Passkey、hardware-backed storage、native moduleの実機相当検証に使わない。Development Build／ストアビルドの確認を別に行う。
• 秘密値、.env、token、Recovery Phraseを表示・commit・ログ出力しない。dirty worktreeでは作業対象以外の差分を保持する。

検証コマンド

cd backend
go test ./...
go vet ./...
go build ./cmd/server

cd ../frontend
bun run typecheck
bun run lint
bun test

最後に git diff --check と、コミット対象のパス一覧を確認する。自動テスト成功だけではiOS実機E2E、Expo Go／Development Build差、production domain接続、migration適用済みDBの整合性を証明しない。