feat: update datetime handling to use UTC and improve type annotations

app/core/security.py

@@ -1,5 +1,6 @@
 from dataclasses import dataclass
-from datetime import datetime, timedelta, timezone
+from datetime import UTC, datetime, timedelta
+from typing import Annotated
 from uuid import uuid4
 
 from authlib.jose import jwt  # type: ignore
@@ -43,7 +44,7 @@ def verify_password(plain_password: str, password_hash: str) -> bool:
 
 
 def create_access_token(*, subject: str) -> str:
-    now = datetime.now(timezone.utc)
+    now = datetime.now(UTC)
     expires_delta = timedelta(minutes=settings.JWT_EXPIRE_MINUTES)
     expires_at = int((now + expires_delta).timestamp())
 
@@ -72,7 +73,10 @@ def decode_access_token(token: str) -> AccessTokenPayload:
 
 
 async def get_auth_context(
-    credentials: HTTPAuthorizationCredentials | None = Depends(bearer_scheme),
+    credentials: Annotated[
+        HTTPAuthorizationCredentials | None,
+        Depends(bearer_scheme),
+    ],
 ) -> AuthContext:
     if credentials is None or credentials.scheme.lower() != "bearer":
         raise token_auth_error()
@@ -94,6 +98,6 @@ async def get_auth_context(
 
 
 async def require_authenticated_user(
-    auth_context: AuthContext = Depends(get_auth_context),
+    auth_context: Annotated[AuthContext, Depends(get_auth_context)],
 ) -> AuthUserDocument:
     return auth_context.user