feat(cameras): add route to patch location

Author: frgfm

src/app/api/api_v1/endpoints/cameras.py

@@ -13,7 +13,7 @@
 from app.core.security import create_access_token
 from app.crud import CameraCRUD
 from app.models import Camera, Role, UserRole
-from app.schemas.cameras import CameraCreate, LastActive, LastImage
+from app.schemas.cameras import CameraCreate, CameraEdit, LastActive, LastImage
 from app.schemas.login import Token, TokenPayload
 from app.services.storage import s3_service, upload_file
 from app.services.telemetry import telemetry_client
@@ -97,6 +97,17 @@ async def create_camera_token(
     return Token(access_token=token, token_type="bearer")  # noqa S106
 
 
+@router.patch("/{camera_id}/location", status_code=status.HTTP_200_OK, summary="Update the location of a camera")
+async def update_camera_location(
+    payload: CameraEdit,
+    camera_id: int = Path(..., gt=0),
+    cameras: CameraCRUD = Depends(get_camera_crud),
+    token_payload: TokenPayload = Security(get_jwt, scopes=[UserRole.ADMIN]),
+) -> Camera:
+    telemetry_client.capture(token_payload.sub, event="cameras-update-location", properties={"camera_id": camera_id})
+    return await cameras.update(camera_id, payload)
+
+
 @router.delete("/{camera_id}", status_code=status.HTTP_200_OK, summary="Delete a camera")
 async def delete_camera(
     camera_id: int = Path(..., gt=0),

src/app/crud/crud_camera.py

@@ -7,11 +7,11 @@
 
 from app.crud.base import BaseCRUD
 from app.models import Camera
-from app.schemas.cameras import CameraCreate, LastActive
+from app.schemas.cameras import CameraCreate, CameraEdit, LastActive
 
 __all__ = ["CameraCRUD"]
 
 
-class CameraCRUD(BaseCRUD[Camera, CameraCreate, LastActive]):
+class CameraCRUD(BaseCRUD[Camera, CameraCreate, LastActive | CameraEdit]):
     def __init__(self, session: AsyncSession) -> None:
         super().__init__(session, Camera)

src/app/schemas/cameras.py

@@ -21,7 +21,19 @@ class LastImage(LastActive):
     last_image: str
 
 
-class CameraCreate(BaseModel):
+class CameraEdit(BaseModel):
+    elevation: float = Field(
+        ...,
+        gt=0,
+        lt=10000,
+        description="number of meters from sea level",
+        json_schema_extra={"examples": [1582]},
+    )
+    lat: float = Field(..., gt=-90, lt=90, description="latitude", json_schema_extra={"examples": [44.765181]})
+    lon: float = Field(..., gt=-180, lt=180, description="longitude", json_schema_extra={"examples": [4.514880]})
+
+
+class CameraCreate(CameraEdit):
     organization_id: int = Field(..., gt=0)
     name: str = Field(
         ...,
@@ -37,13 +49,4 @@ class CameraCreate(BaseModel):
         description="angle between left and right camera view",
         json_schema_extra={"examples": [120.0]},
     )
-    elevation: float = Field(
-        ...,
-        gt=0,
-        lt=10000,
-        description="number of meters from sea level",
-        json_schema_extra={"examples": [1582]},
-    )
-    lat: float = Field(..., gt=-90, lt=90, description="latitude", json_schema_extra={"examples": [44.765181]})
-    lon: float = Field(..., gt=-180, lt=180, description="longitude", json_schema_extra={"examples": [4.514880]})
     is_trustable: bool = Field(True, description="whether the detection from this camera can be trusted")