118 lines
3.5 KiB
Python
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
|