Initial deployment setup

apps/secretary-api/app/schemas/errors.py

@@ -0,0 +1,19 @@
+"""Shared error response schemas for the public Secretary API contract."""
+
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class ApiErrorResponse(BaseModel):
+    """Stable error shape shared with the NestJS API."""
+
+    model_config = ConfigDict(populate_by_name=True)
+
+    code: str = Field(description="Machine-readable error code", examples=["NOT_FOUND"])
+    message: str | list[str] = Field(description="Human-readable error message")
+    error: str = Field(description="Error category")
+    status_code: int = Field(
+        alias="statusCode",
+        description="HTTP status code",
+        examples=[404],
+    )
+    path: str = Field(description="Request path", examples=["/api/tickets/1"])