from datetime import datetime, timezone


def is_expired(expires_at: datetime) -> bool:
    return expires_at < datetime.utcnow()


def create_token() -> dict[str, datetime]:
    return {
        "issued_at": datetime.now(timezone.utc),
        "expires_at": datetime.utcnow(),
    }

@Reviewer: `datetime.utcnow()` はtimezone情報を持たないnaive datetimeを返します。一方で `issued_at` はaware datetimeです。比較や保存境界で混在するため、UTC awareに統一してください。

from datetime import datetime, timezone


def utc_now() -> datetime:
    return datetime.now(timezone.utc)

@Reviewer: 現在時刻の生成が複数箇所に散っています。UTC awareに統一するため、`datetime.now(timezone.utc)` を返すヘルパーへ集約してください。

from datetime import datetime, timezone


def parse_deadline(value: str) -> datetime:
    parsed = datetime.fromisoformat(value)
    if parsed.tzinfo is None or parsed.utcoffset() is None:
        raise ValueError("deadline must include timezone")
    return parsed.astimezone(timezone.utc)

@Reviewer: API入力のdatetime文字列をそのまま内部に渡しています。timezoneなし入力を拒否するか、仕様としてどのtimezoneで解釈するかを境界で明示してください。

@Reviewer: `replace(tzinfo=timezone.utc)` は時刻変換ではなくtzinfoの付け替えです。入力値がローカル時刻なら誤ったUTCとして扱われるため、解釈元timezoneを明示して `astimezone` で変換してください。

from datetime import datetime, timedelta, timezone


def utc_now() -> datetime:
    return datetime.now(timezone.utc)


def parse_api_datetime(value: str) -> datetime:
    parsed = datetime.fromisoformat(value)
    if parsed.tzinfo is None or parsed.utcoffset() is None:
        raise ValueError("datetime must include timezone")
    return parsed.astimezone(timezone.utc)


def is_expired(expires_at: datetime) -> bool:
    if expires_at.tzinfo is None or expires_at.utcoffset() is None:
        raise ValueError("expires_at must be timezone-aware")
    return expires_at.astimezone(timezone.utc) < utc_now()


def create_token(ttl_seconds: int) -> dict[str, datetime]:
    issued_at = utc_now()
    return {
        "issued_at": issued_at,
        "expires_at": issued_at + timedelta(seconds=ttl_seconds),
    }

@Reviewer: DBから取得した `created_at` がnaive datetimeとして扱われています。DB driverがUTCとして返す契約なのか、アプリ側でtimezoneを付与する責務なのかを明示してください。

@Reviewer: APIレスポンスでtimezoneなし文字列を返しています。クライアントがローカル時刻として解釈する可能性があるため、UTC offset付きのISO文字列で返す設計にしてください。

@Reviewer: テスト対象内で現在時刻を直接取得しているため、期限境界のテストが不安定になります。clock関数を注入し、UTC aware datetimeで固定できる構造にしてください。