forked from mtusi2026/mtusi2026lab3
Дополнить описание перенесённой схемы и ограничений lab2
This commit is contained in:
@@ -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 сохраняются отдельно; не менять пароль файла без изменения пароля в существующей БД.
|
||||
|
||||
|
||||
@@ -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 ждут успешного завершения миграций.
|
||||
@@ -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')
|
||||
|
||||
@@ -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']
|
||||
|
||||
Reference in New Issue
Block a user