読み方のヒント
矢印ボタン(または ← → キー)でページを移動できます。
キャンセルと受け取り済みは、どちらも「予約済みのときだけ、状態と日時を変える」操作です。前の章では、ほとんど同じ処理を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