Дополнить описание перенесённой схемы и ограничений lab2

This commit is contained in:
2026-11-13 01:33:49 +03:00
parent 4322edcbec
commit 27055b6076
4 changed files with 24 additions and 1 deletions
+1 -1
View File
@@ -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 сохраняются отдельно; не менять пароль файла без изменения пароля в существующей БД.
+21
View File
@@ -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 ждут успешного завершения миграций.
+1
View File
@@ -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')
+1
View File
@@ -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']