読み方のヒント

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

第3節 店員の権限

3.2 店員のAPI

受け取り日ごとの予約一覧です。

@app.get("/staff/reservations", response_model=list[ReservationDetail])
def list_reservations_for_day(
    pickup_date: Annotated[date, Query(alias="pickupDate")],
    session: SessionDep,
    staff: StaffUser,
):
    start = datetime.combine(pickup_date, time(0, 0), tzinfo=JST)
    end = start + timedelta(days=1)
    statement = (
        select(Reservation)
        .where(Reservation.pickup_at >= start, Reservation.pickup_at < end)
        .order_by(Reservation.pickup_at, Reservation.id)
    )
    return [to_detail(r) for r in session.scalars(statement).all()]

pickupDate=2026-11-02 は、日本時間の11月2日0:00から、翌日0:00の前まで、という範囲に直して絞ります。受け取りの時刻の順に並べます。

受け取り済みにするAPIは、POST /staff/reservations/{id}/pickup です。キャンセルと同じく、予約済みのときだけ書き換える UPDATE を使い、書き換えた行がなければ 409 を返します。店員は、すべての客の予約を操作できるため、持ち主の確認はしません。

解答
  1. 401 です。認証ができていません。
  2. 403 です。鈴木さんは認証できていますが、role が customer なので、店員の操作は許されません。

11 / 20