Chapter 19: Creating a Website with Controller-Style Routers

MVC controllers group related actions. In FastAPI, APIRouter modules fill that role.

# web/account.py
router = APIRouter(prefix="/account", tags=["account"])


@router.get("/login")
def login_page(request: Request):
    ...


@router.post("/login")
def login_submit(request: Request):
    ...


@router.post("/logout")
def logout():
    ...

Controller-style organization:

• api/recipes.py for API recipes.
• web/recipes.py for browser recipes.
• services/recipes.py for use cases.
• data/models.py and data/repositories.py for persistence.
• domain/recipes.py for domain rules that should not know HTTP exists.

Avoid placing all logic in route functions. Route functions should translate HTTP into application calls and translate results back into HTTP.