From 27055b607627d825d401f229bfb1f7aef36bf8b7 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=D0=92=D0=BB=D0=B0=D0=B4=D0=B8=D1=81=D0=BB=D0=B0=D0=B2=20?= =?UTF-8?q?=D0=93=D0=B0=D0=B2=D1=80=D0=B8=D0=BB=D0=B5=D0=BD=D0=BA=D0=BE?= <178+sxdees@noreply.gitea.privcloud.tech> Date: Fri, 13 Nov 2026 01:33:49 +0300 Subject: [PATCH] =?UTF-8?q?=D0=94=D0=BE=D0=BF=D0=BE=D0=BB=D0=BD=D0=B8?= =?UTF-8?q?=D1=82=D1=8C=20=D0=BE=D0=BF=D0=B8=D1=81=D0=B0=D0=BD=D0=B8=D0=B5?= =?UTF-8?q?=20=D0=BF=D0=B5=D1=80=D0=B5=D0=BD=D0=B5=D1=81=D1=91=D0=BD=D0=BD?= =?UTF-8?q?=D0=BE=D0=B9=20=D1=81=D1=85=D0=B5=D0=BC=D1=8B=20=D0=B8=20=D0=BE?= =?UTF-8?q?=D0=B3=D1=80=D0=B0=D0=BD=D0=B8=D1=87=D0=B5=D0=BD=D0=B8=D0=B9=20?= =?UTF-8?q?lab2?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- REPORT.md | 2 +- infra/schema.md | 21 +++++++++++++++++++++ src/db.py | 1 + src/server.py | 1 + 4 files changed, 24 insertions(+), 1 deletion(-) create mode 100644 infra/schema.md diff --git a/REPORT.md b/REPORT.md index 19357273..5747a80e 100644 --- a/REPORT.md +++ b/REPORT.md @@ -29,7 +29,7 @@ docker compose up -d --wait `setup.sh` создаёт случайный пароль, DSN в `secrets/` и `.env`, существующие файлы не перезаписывает. Secrets не коммитятся; хостовый каталог доступен только владельцу. DSN доступен UID приложения внутри контейнера через read-only mount. `HOST_PORT=8083` выбран, чтобы не мешать соседним лабораторным; тестам явно передаётся BASE_URL. На хосте опубликован только LB на loopback. `API_REPLICAS` по умолчанию 2 (для лабы минимум 2, конфигурация LB содержит до 10 мест), `SESSION_TTL_SECONDS=3600`, `IDEMPOTENCY_TTL_SECONDS=86400` (меньше 24 часов запрещено). APP_HOST/APP_PORT и путь DATABASE_URL_FILE заданы в Compose; SESSION_STORE — PostgreSQL. APP_ENV, CACHE_URL_FILE не используются. -Миграции запускает отдельный завершающийся service `migrate`, API ждут успешного завершения. Версии записываются в `schema_migrations`, advisory lock защищает от параллельного запуска операторами. Миграция 002 добавляет отдельную таблицу и совместима со старой схемой; старый API lab2 не поддерживает новую гарантию идемпотентности, смешанный запуск lab2/lab3 за одним LB не допускается. Для переноса используются исходники и миграции, существующие volumes lab2 не изменяются. +Миграции запускает отдельный завершающийся service `migrate`, API ждут успешного завершения. Версии записываются в `schema_migrations`, advisory lock защищает от параллельного запуска операторами. Схема описана в [infra/schema.md](infra/schema.md), перенесённом из lab2 и дополненном таблицей ключей. Миграция 002 добавляет отдельную таблицу и совместима со старой схемой; старый API lab2 не поддерживает новую гарантию идемпотентности, смешанный запуск lab2/lab3 за одним LB не допускается. Для переноса используются исходники и миграции, существующие volumes lab2 не изменяются. Остановка без потери данных: `docker compose down`. Повторный запуск: `docker compose up -d --wait`. Намеренное удаление **всех учебных данных именно этого проекта**: `docker compose down -v`. Secrets сохраняются отдельно; не менять пароль файла без изменения пароля в существующей БД. diff --git a/infra/schema.md b/infra/schema.md new file mode 100644 index 00000000..41288933 --- /dev/null +++ b/infra/schema.md @@ -0,0 +1,21 @@ +# Схема PostgreSQL (перенесена из lab2) + +PostgreSQL — единственный источник истины. UUID назначает API, время — БД (timestamptz). + +- users: PK id, UNIQUE username, display_name, created_at, соль и scrypt digest пароля. +- chats: PK id, title, created_at. +- chat_members: составной PK (chat_id, user_id), FK на chats/users; индекс (user_id, chat_id) для списка чатов. +- messages: PK id, FK chat_id, составной FK (chat_id, sender_id) на членство, + text, created_at; индекс (chat_id, created_at, id) для keyset истории. +- sessions: PK SHA-256 случайного 256-битного токена, FK user_id, expires_at. + Сам токен хранится только у клиента. Пароль хешируется scrypt, не SHA-256. +- message_keys: составной PK (user_id, chat_id, key), FK на users/chats/messages, expires_at; + сохраняется в той же транзакции, что и сообщение, после advisory lock по scope. +- schema_migrations: PK имени применённого SQL-файла. + +Каждый запрос использует отдельную транзакцию. Успешный ответ отправляется после +COMMIT. Создание чата и всех участников — одна транзакция; ошибка откатывает всё. +Регистрация опирается на UNIQUE БД, отзыв сессии — DELETE. Expiry проверяется +по часам БД при каждом защищённом запросе, рестарт не меняет expires_at. +Миграции выполняются отдельным Compose-service migrate под транзакционной advisory lock; +повторный запуск пропускает записанные версии. API ждут успешного завершения миграций. diff --git a/src/db.py b/src/db.py index 851471fa..e1ba4579 100644 --- a/src/db.py +++ b/src/db.py @@ -7,6 +7,7 @@ from psycopg.rows import dict_row def connect(): + # shortcut: one connection per request; add a bounded pool before load testing. dsn = Path(os.environ['DATABASE_URL_FILE']).read_text().strip() return psycopg.connect(dsn, connect_timeout=3, row_factory=dict_row, options='-c statement_timeout=5000 -c timezone=UTC') diff --git a/src/server.py b/src/server.py index 8d0406dc..4a0d7675 100644 --- a/src/server.py +++ b/src/server.py @@ -157,6 +157,7 @@ class Handler(BaseHTTPRequestHandler): return 201, dict(session, token=token, token_type='Bearer', user={k: user[k] for k in ('id', 'username', 'display_name', 'created_at')}) token = self.credentials('Bearer') token_digest = hashlib.sha256(token.encode()).digest() + # shortcut: expired rows remain; add scheduled cleanup for a long-lived deployment. actor = db.execute('SELECT user_id FROM sessions WHERE token_hash=%s AND expires_at > clock_timestamp()', (token_digest,)).fetchone() require(actor is not None, 401, 'unauthorized') actor = actor['user_id']