Files
mtusi2026lab4/src/domain.py
T

118 lines
3.5 KiB
Python

"""Доменные записи. Неизменяемые: хранилище отдаёт их наружу без копирования.
Пароль, его хэш и токен сессии в `User` не входят: хэш живёт только в
`Credentials` (вход), токен — только в `IssuedSession` (ответ на вход).
"""
from dataclasses import dataclass, field
from datetime import datetime
from uuid import UUID
@dataclass(frozen=True, slots=True)
class User:
id: UUID
username: str
display_name: str
created_at: datetime
@dataclass(frozen=True, slots=True)
class Credentials:
"""Пользователь и хэш его пароля: только для проверки при входе."""
user: User
password_hash: str = field(repr=False)
@dataclass(frozen=True, slots=True)
class Session:
"""Серверная сессия входа. Срок фиксируется при создании."""
id: UUID
user_id: UUID
expires_at: datetime
created_at: datetime
@dataclass(frozen=True, slots=True)
class IssuedSession:
"""Ответ на вход: токен отдаётся клиенту один раз и нигде не хранится."""
token: str = field(repr=False)
expires_at: datetime
user: User
@dataclass(frozen=True, slots=True)
class Identity:
"""Кто прислал запрос: действующая сессия и её владелец."""
session_id: UUID
user: User
@dataclass(frozen=True, slots=True)
class Chat:
id: UUID
title: str
# в порядке, переданном при создании
member_ids: tuple[UUID, ...]
created_at: datetime
@dataclass(frozen=True, slots=True)
class Message:
id: UUID
chat_id: UUID
sender_id: UUID
text: str
created_at: datetime
# с лабы 4: вложения этого чата в порядке отправки
attachment_ids: tuple[UUID, ...] = ()
@dataclass(frozen=True, slots=True)
class Attachment:
"""Метаданные вложения; байты — объект `object_key` в S3.
`status`: `pending` — строка записана до объекта, загрузка не
закончена (наружу не видна); `ready` — объект записан, 201 отдан.
`lost_at` — сверка подтвердила, что объекта готового вложения нет или
он другого размера. `filename` только показывается: ни ключ, ни путь из
него не строятся.
"""
id: UUID
chat_id: UUID
owner_id: UUID
filename: str
content_type: str
size_bytes: int
sha256: bytes
object_key: str
status: str
created_at: datetime
updated_at: datetime
lost_at: datetime | None = None
@dataclass(frozen=True, slots=True)
class SentMessage:
"""Итог отправки с ключом: новое сообщение или сохранённое прежнее.
`replayed` — ответ на повтор того же тела; клиенту оба случая
отдаются одинаково (201 и то же `Message`), флаг нужен журналу.
"""
message: Message
replayed: bool
@dataclass(frozen=True, slots=True)
class Page[T]:
"""Страница списка в порядке `(created_at, id)`."""
items: tuple[T, ...]
next_cursor: str | None