add updated_at

Author: Kerushani

backend/python/app/models/__init__.py

@@ -81,9 +81,9 @@ def init_app(_app: Any | None = None) -> None:
     """Initialize database for the application"""
     # Import models to register them with SQLModel
     from .entity import Entity  # noqa: F401
+    from .jobs import Jobs  # noqa: F401
     from .simple_entity import SimpleEntity  # noqa: F401
     from .user import User  # noqa: F401
-    from .jobs import Jobs  # noqa: F401
 
     init_database()
 

backend/python/app/models/jobs.py

@@ -1,51 +1,65 @@
-from .enum import StatusEnum
-from .base import BaseModel
-from typing import Optional
+from datetime import datetime
 from uuid import UUID, uuid4
+
 from sqlalchemy import DateTime
-from datetime import datetime
-from sqlmodel import SQLModel, Field
+from sqlmodel import Field, SQLModel
+
+from .base import BaseModel
+from .enum import StatusEnum
 
 
 class JobsBase(SQLModel):
     """Shared fields between table and API models"""
 
-    route_group_id: Optional[UUID] = Field(foreign_key="route_groups.id")
+    route_group_id: UUID | None = Field(foreign_key="route_groups.id")
     status: StatusEnum = Field(default=StatusEnum.PENDING)
     progress: str = Field(default=None)
 
 
 class Jobs(JobsBase, BaseModel, table=True):
+    """Jobs model for demonstration purposes"""
+
     __tablename__ = "jobs"
 
     id: UUID = Field(default=uuid4, primary_key=True)
-    started_at: Optional[datetime] = Field(
+    started_at: datetime | None = Field(
         default_factory=datetime.utcnow,
         sa_type=DateTime(timezone=True),
         description="Timestamp when the record was created",
     )
-    finished_at: Optional[datetime] = Field(
+    updated_at: datetime | None = Field(
+        default=None,
+        sa_type=DateTime(timezone=True),
+        description="Timestamp when the record was updated",
+    )
+    finished_at: datetime | None = Field(
         default=None,
         sa_type=DateTime(timezone=True),
         description="Timestamp when the record is finished",
     )
 
 
 class JobsCreate(JobsBase):
+    """Jobs creation request"""
+
     pass
 
 
 class JobsRead(JobsBase):
+    """Jobs response model"""
+
     id: UUID
-    started_at: Optional[datetime] = None
-    finished_at: Optional[datetime] = None
+    started_at: datetime | None = None
+    finished_at: datetime | None = None
     created_at: datetime
     updated_at: datetime
 
 
 class JobsUpdate(SQLModel):
-    status: Optional[StatusEnum] = None
-    progress: Optional[str] = None
-    route_group_id: Optional[UUID] = None
-    started_at: Optional[datetime] = None
-    finished_at: Optional[datetime] = None
+    """Jobs update request - all optional"""
+
+    status: StatusEnum | None = None
+    progress: str | None = None
+    route_group_id: UUID | None = None
+    started_at: datetime | None = None
+    finished_at: datetime | None = None