first commit

app/schemas/common.py

@@ -0,0 +1,13 @@
+"""Shared API schemas used across all endpoints."""
+
+from typing import Any, Literal
+
+from pydantic import BaseModel
+
+
+class APIEnvelope(BaseModel):
+    """Standard JSON envelope for all API responses."""
+
+    status: Literal["success", "error"]
+    data: Any | None = None
+    error: str | None = None