上級編 / システム設計

予約が重なったら、
どちらを確定する?

TypeScript と Rust で動く予約システムに、同じ空き枠への依頼を送ります。競合と異常終了を起こし、実際にDBに残った状態を確かめます。

同時予約の実験

実験ごとに空の SQLite データベースを作ります。予約・後続処理の結果は、DBに入った件数です。

TypeScript 予約を受け付ける SQLite 予約とジョブを記録する Rust 未処理のジョブを確定する
会議室 A10:00 の枠
二重予約をどう防ぐか

実行結果

条件を選んで実行すると、ここに結果が出ます。

空きを読んだ時点と、予約を入れる時点は違う

依頼 A と B は別々のスレッドと接続から空き状況を読みます。両方が読んでから書き込みへ進むため、空きチェックだけだと、二人とも「空いている」と判断して書き込めます。SQLite は書き込みを順番に処理しますが、空きチェックの結果は書き込みまで引き継がれません。

一意制約を付けると、先に書き込んだ依頼だけが確定します。後から来た書き込みは ON CONFLICT … DO NOTHING で行を追加せず、予約後のジョブも作りません。どちらが先かはスレッドの実行順で変わります。

-- 同じ部屋・同じ開始時刻の予約を1件までにする。
CREATE UNIQUE INDEX one_reservation_per_slot
ON reservations (room, starts_at);

ワーカーが落ちたら、どこからやり直す?

TypeScript は予約と処理待ちジョブを同じトランザクションに書きます。これがトランザクショナル・アウトボックスの基本です。Rust は未処理ジョブを拾い、DBに処理記録を作って、ジョブを完了にします。

異常終了を選ぶと、処理記録を挿入した直後、コミット前に Rust プロセスを終了させます。未コミットの処理記録は残らず、ジョブは未処理なので、次のプロセスが再実行できます。完了後にもう一度起動しても記録が増えないことを確認します。

この実験の後続処理はDB内の記録です。メールや決済など外部サービスへ送る場合は、送信先でも同じ予約IDを使って再送を識別できる仕組みが必要です。

設計演習 10:00〜11:00 と 10:30〜11:30 の重なりを防ぐには?

この実験の制約は開始時刻が等しい予約だけに効きます。時間を固定の30分枠に分ける設計なら、使う枠をすべて同じトランザクションで確保し、各枠に一意制約を付けられます。任意の開始・終了時刻を許す設計では、同じ部屋について時間区間の重なりを判定し、判定と追加が競合しないようにする必要があります。

Nginx はリクエストをどう捌くか

一つのサイトで画面を配信し、APIのリクエストを別プロセスに届ける構成を読みます。

ブラウザHTTP リクエスト NginxHost とパスで振り分け
/advanced.html 静的ファイルを返す /api/… TypeScript の API へ転送

末尾の / で転送先を比べる

実際の Nginx から、この教材と同じ予約APIへ POST /api/reservation-lab?via=nginx を送ります。

:3000 の直後に / を足して試してください。/v1/ のようなパスも指定できます。

転送結果

設定を試すと、APIが受信したパスを表示します。

受け付けから応答まで

  1. 接続を受け付ける。 Nginx は待受ポートで接続を受け付けます。HTTPSを設定した場合は、ここでTLSを終端できます。
  2. 設定ブロックを選ぶ。 HTTP の Host を手がかりに server を選び、パスに合う location に進みます。この例のように前方一致だけなら、より長く一致する方が選ばれます。
  3. ファイルを返すか、APIへ中継する。 proxy_pass で受け取ったリクエストを上流へ渡し、上流の応答をブラウザに返します。予約の競合判定は上流側のDBで行います。

上流が接続を拒否すると 502、上流の応答待ちがタイムアウトすると 504 になることがあります。予約の重複を表すアプリ側の応答とは、ログで区別して調べます。

設定例

同じマシンのポート3000に API がいる構成の例です。上の実験では location /api/ の転送を、実験ごとのコンテナで確かめます。

# http ブロックの内側に置く。
server {
    # ポート 80 で受け付ける。
    listen 80;
    # Host に対応する仮想サーバー名。
    server_name reservations.example.test;
    # 静的ファイルの配置先。
    root /srv/reservations/public;

    # API パスを上流へ渡す。
    location /api/ {
        # URI を指定しないので /api/ を含むパスを渡す。
        proxy_pass http://127.0.0.1:3000;
        # 元のサイト名を上流に知らせる。
        proxy_set_header Host $host;
    }

    # 残りのパスは静的ファイルとして探す。
    location / {
        # ファイルやディレクトリがなければ 404 を返す。
        try_files $uri $uri/ =404;
    }
}

proxy_pass http://127.0.0.1:3000/; と末尾に / を付けると、Nginx は location に一致した /api/ を / に置き換えます。上の実験では上流に /reservation-lab が届き、クエリ文字列の ?via=nginx も引き継がれます。