basic-python-project 0.0.0__py3-none-any.whl

meinewaldki_citizen_rest_service/schemas/image.py

@@ -0,0 +1,48 @@
+"""Shared Image schemas.
+
+ImageBase is inherited by both the SQLModel table model and future Pydantic
+request / response schemas, keeping field definitions in one place.
+
+Fields intentionally excluded from the base:
+    record_id   — server-side FK set after the parent record is inserted.
+    minio_path  — generated by the server after MinIO upload; returned in the
+                  response but never sent by the client.
+"""
+
+import enum
+from typing import Optional
+
+from sqlmodel import SQLModel
+
+
+class ImageSyncStatus(str, enum.Enum):
+    """Maps to the core.image_sync_status PostgreSQL enum."""
+
+    pending = "pending"
+    synced = "synced"
+    failed = "failed"
+
+
+class ImageOrientation(str, enum.Enum):
+    """Maps to the core.image_orientation PostgreSQL enum."""
+
+    up = "up"
+    front = "front"
+    down = "down"
+
+
+class ImageBase(SQLModel):
+    """Shared fields for Image Pydantic schemas and the DB table model."""
+
+    client_image_id: int
+    image_orientation: ImageOrientation
+    exif_metadata: Optional[dict] = None
+
+
+class ImageRead(SQLModel):
+    """Response schema returned per image after record creation."""
+
+    id: int
+    client_image_id: int
+    image_orientation: ImageOrientation
+    sync_status: ImageSyncStatus

meinewaldki_citizen_rest_service/schemas/record.py

@@ -0,0 +1,59 @@
+"""Shared Record schemas.
+
+RecordBase is inherited by both the SQLModel table model and future Pydantic
+request / response schemas, keeping field definitions in one place.
+
+Fields intentionally excluded from the base:
+    user_id          — derived from the JWT token server-side, not sent by client.
+    original_location
+    updated_location — the API represents these as a LocationSchema (lat/lon)
+                       while the DB uses Geography(POINT); handled separately.
+"""
+
+import enum
+import uuid
+from datetime import datetime
+from typing import Optional
+
+from sqlmodel import SQLModel
+
+from meinewaldki_citizen_rest_service.schemas.image import ImageBase, ImageRead
+
+
+class RecordSyncStatus(str, enum.Enum):
+    """Maps to the core.record_sync_status PostgreSQL enum."""
+
+    pending = "pending"
+    partial = "partial"
+    synced = "synced"
+    failed = "failed"
+
+
+class RecordBase(SQLModel):
+    """Shared fields for Record Pydantic schemas and the DB table model."""
+
+    client_record_id: uuid.UUID
+    created_at: datetime
+    hardware_data: Optional[dict] = None
+
+
+class LocationSchema(SQLModel):
+    """Lat/lon representation of a geographic point."""
+
+    lat: float
+    lon: float
+
+
+class RecordCreate(RecordBase):
+    """Request body for POST /records. Images declared here, user_id comes from JWT."""
+
+    original_location: Optional[LocationSchema] = None
+    images: list[ImageBase]
+
+
+class RecordRead(SQLModel):
+    """Response body for POST /records."""
+
+    id: int
+    client_record_id: uuid.UUID
+    images: list[ImageRead]

meinewaldki_citizen_rest_service/schemas/user.py

@@ -0,0 +1,25 @@
+"""Shared User schemas.
+
+UserBase is inherited by both the SQLModel table model and future Pydantic
+request / response schemas, keeping field definitions in one place.
+"""
+
+import enum
+from typing import Optional
+
+from sqlmodel import SQLModel
+
+
+class UserStatus(str, enum.Enum):
+    """Maps to the core.user_status PostgreSQL enum."""
+
+    guest = "guest"
+    registered = "registered"
+    deleted = "deleted"
+
+
+class UserBase(SQLModel):
+    """Shared fields for User Pydantic schemas and the DB table model."""
+
+    email: Optional[str] = None
+    status: UserStatus = UserStatus.guest