読み方のヒント

矢印ボタン(または ← → キー)でページを移動できます。

第3節 入力・保存・応答のモデル

3.2 状態の変更をまとめる

キャンセルと受け取り済みは、どちらも「予約済みのときだけ、状態と日時を変える」操作です。前の章では、ほとんど同じ処理を2か所に書いていました。

def change_status(session: Session, reservation: Reservation, new_status: str, now: datetime) -> ReservationDetail:
    """予約済みの予約だけを、受け取り済みかキャンセルに変える。"""
    values = {"status": new_status}
    values["picked_up_at" if new_status == "picked_up" else "cancelled_at"] = now
    result = session.execute(
        update(Reservation)
        .where(Reservation.id == reservation.id, Reservation.status == "reserved")
        .values(**values)
    )
    if result.rowcount == 0:
        session.rollback()
        raise ServiceError(409, "status_conflict", "この予約は、すでに受け取り済みかキャンセル済みです")
    session.commit()
    session.refresh(reservation)
    return to_detail(reservation)

values(**values) は、辞書の中身を status=…, cancelled_at=… のように引数として渡す書き方です。

APIの側は、権限の確かめ方だけが違います。

API権限の確かめ業務処理
キャンセルget_own_reservation(持ち主)change_status(…, "cancelled", now)
受け取り済みStaffUser(店員)change_status(…, "picked_up", now)

同じ処理を1か所にまとめると、「予約済みのときだけ」という規則を直すときに、1か所だけ直せば済みます。

解答例

受け取り済みの操作だけの規則なので、change_status には入れず、受け取り済みのAPIか、受け取り専用の業務処理の関数で確かめます。キャンセルの処理に影響しないようにします。

11 / 20