読み方のヒント
矢印ボタン(または ← → キー)でページを移動できます。
役割ごとに、次のファイルに分けます。
| ファイル | 役割 | FastAPIを使うか |
|---|---|---|
main.py | アプリの組み立て | 使う |
reservations_api.py | 予約のAPI(要求を受け取り、応答を返す) | 使う |
reservation_service.py | 予約の業務処理(作る、状態を変える) | 使わない |
rules.py | 店の規則の判定 | 使わない |
errors.py | 業務処理の失敗を表す例外 | 応答への変換だけ |
main.py は、ルーターを登録するだけになります。
app = FastAPI()
app.include_router(auth_router)
app.include_router(catalog_router)
app.include_router(reservations_router)
業務処理は、HTTPの状態コードや Response を知りません。失敗したときは、ServiceError を起こします。
class ServiceError(Exception):
def __init__(self, status_code: int, code: str, message: str):
self.status_code = status_code
self.code = code
self.message = message
APIの関数は、ServiceError を受け止めて、HTTPException に直します。
rules.py です。店の規則の判定だけを直します。reservations_api.py です。要求の受け取り方だけが変わり、キャンセルの業務処理は変わりません。3 / 20