"""API 边界 Pydantic schemas（snake_case；前端经 OpenAPI 消费）。"""