fastapi-application-structure

name	fastapi-application-structure
description	[Applies to: **/main.py] Defines the preferred file structure and component usage for FastAPI applications.
source	cursor_mdc

• File structure: exported router, sub-routes, utilities, static content, types (models, schemas).
• Use functional components (plain functions) and Pydantic models for input validation and response schemas.
• Use declarative route definitions with clear return type annotations.
• Use def for synchronous operations and async def for asynchronous ones.
• Minimize @app.on_event("startup") and @app.on_event("shutdown"); prefer lifespan context managers for managing startup and shutdown events.
• Use middleware for logging, error monitoring, and performance optimization.