forked from mtusi2026/mtusi2026lab3
Compare commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
b8d7d977b3 |
+1
-12
@@ -1,13 +1,2 @@
|
|||||||
# Copy to .env for your LOCAL synthetic test environment; never commit .env.
|
POSTGRES_PASSWORD=change-me-local-only
|
||||||
# These are logical interface suggestions; map actual framework names in REPORT.md.
|
|
||||||
APP_HOST=0.0.0.0
|
|
||||||
APP_PORT=8080
|
|
||||||
APP_ENV=lab
|
|
||||||
SESSION_TTL_SECONDS=3600
|
SESSION_TTL_SECONDS=3600
|
||||||
# Choose credentials locally. File paths contain no secret values.
|
|
||||||
DATABASE_URL_FILE=/run/secrets/database_url
|
|
||||||
# Optional on 3, required use on 4 in lab2; Redis OR Valkey:
|
|
||||||
SESSION_STORE=postgres
|
|
||||||
CACHE_URL_FILE=/run/secrets/cache_url
|
|
||||||
API_REPLICAS=2
|
|
||||||
IDEMPOTENCY_TTL_SECONDS=86400
|
|
||||||
|
|||||||
+16
@@ -0,0 +1,16 @@
|
|||||||
|
FROM python:3.13-slim-bookworm
|
||||||
|
|
||||||
|
ENV PYTHONDONTWRITEBYTECODE=1 PYTHONUNBUFFERED=1
|
||||||
|
WORKDIR /app
|
||||||
|
|
||||||
|
COPY requirements.txt .
|
||||||
|
RUN python -m pip install --no-cache-dir -r requirements.txt
|
||||||
|
COPY app.py ./
|
||||||
|
COPY migrations ./migrations/
|
||||||
|
|
||||||
|
RUN useradd --create-home --shell /usr/sbin/nologin appuser && \
|
||||||
|
chown -R appuser:appuser /app
|
||||||
|
USER appuser
|
||||||
|
|
||||||
|
EXPOSE 8080
|
||||||
|
CMD ["python", "app.py"]
|
||||||
@@ -1,37 +1,82 @@
|
|||||||
# Отчёт — лабораторная 3
|
# Лабораторная 3
|
||||||
|
|
||||||
- Автор, группа: TODO
|
- Автор / группа: Антонова Екатерина
|
||||||
- Целевая оценка; выбранный трек 5, если нужен: TODO
|
- Целевая оценка (3/4/5): 3
|
||||||
- Commit/PR: TODO после публикации
|
- Трек 5: не заявлен
|
||||||
- Использованные источники, библиотеки и помощь ИИ: TODO
|
- Использованные источники и помощь ИИ: задание лабораторной 3, `COURSE.md`, `contracts/openapi.json`, `contracts/README.md`, `contracts/infrastructure.json`, публичные тесты из `tests/` и реализация лабораторной 2. Также использовалась официальная документация Docker Compose, PostgreSQL и Nginx. ИИ применялся как вспомогательный инструмент для проверки изменений и подготовки отчёта.
|
||||||
|
|
||||||
|
## Что реализовано
|
||||||
|
|
||||||
|
Перенесены пользователи, чаты, участники, сообщения, PostgreSQL, миграции,
|
||||||
|
Argon2id и Bearer-сессии из lab2. Добавлены две взаимозаменяемые API-реплики
|
||||||
|
(`api1`, `api2`), Nginx как единственная публичная точка входа, проверки
|
||||||
|
готовности и заголовок `X-Instance-Id`. Сессии, сообщения и идемпотентность
|
||||||
|
хранятся в общей PostgreSQL. Повтор сообщения с одинаковым
|
||||||
|
`Idempotency-Key` защищён уникальным ключом и транзакцией PostgreSQL; при
|
||||||
|
конкурентном повторе возвращается тот же message ID.
|
||||||
|
|
||||||
|
Миграция `001_initial.sql` создаёт основные таблицы, а `002_idempotency.sql`
|
||||||
|
создаёт общее хранилище ключей. Миграции запускаются отдельным одноразовым
|
||||||
|
сервисом `migrate` до API-реплик и безопасны при повторном запуске.
|
||||||
|
|
||||||
## Запуск из чистого clone
|
## Запуск из чистого clone
|
||||||
|
|
||||||
TODO: версии runtime/образов, prerequisites, команды создания локальных secrets/.env, build, миграций, запуска, ожидания готовности, тестов и остановки. Указать необходимые действия оператора. Не вставлять секреты. Отдельно указать безопасную остановку и команду намеренного удаления учебных данных.
|
Требуется Docker Desktop с Compose:
|
||||||
|
|
||||||
## Архитектура и решения
|
```sh
|
||||||
|
cp .env.example .env
|
||||||
|
# замените POSTGRES_PASSWORD в .env на локальное значение
|
||||||
|
docker compose --env-file .env config --quiet
|
||||||
|
docker compose --env-file .env up -d --build
|
||||||
|
curl --fail http://localhost:8080/health/ready
|
||||||
|
make check
|
||||||
|
make validate
|
||||||
|
make test
|
||||||
|
```
|
||||||
|
|
||||||
TODO: схема процессов/хранилищ, источник истины, транзакционные границы, ограничения. Что перенесено из lab2, что изменено в этой работе. Соответствие переменных из .env.example реальной конфигурации.
|
Публичный порт есть только у `load_balancer`; `api1`, `api2` и PostgreSQL
|
||||||
|
доступны только во внутренней сети Compose. Для остановки одной реплики:
|
||||||
|
|
||||||
## Доказательства критериев
|
```sh
|
||||||
|
chmod +x scripts/restart.sh scripts/stop-one.sh
|
||||||
|
TARGET_INSTANCE_ID=api1 ./scripts/stop-one.sh
|
||||||
|
docker compose start api1
|
||||||
|
```
|
||||||
|
|
||||||
| Критерий README | Команда/сценарий | Наблюдаемый результат | Файл доказательства |
|
Для штатного теста отказа:
|
||||||
| --- | --- | --- | --- |
|
|
||||||
| Публичный smoke | make test | TODO | TODO |
|
|
||||||
| Остальные пункты уровня 3 | TODO | TODO | TODO |
|
|
||||||
| Все пункты уровня 4, если заявлен | TODO | TODO | TODO |
|
|
||||||
| Выбранный трек 5, если заявлен | TODO | TODO | TODO |
|
|
||||||
|
|
||||||
TODO: добавить отдельную строку для каждого заявленного критерия. PASS без команды и наблюдения не является доказательством. Проверка инфраструктурного hook требует подтверждения, какие реальные процессы/хранилища перезапущены.
|
```sh
|
||||||
|
make test-persistence ACTION_SCRIPT=scripts/restart.sh
|
||||||
|
make test-failover ACTION_SCRIPT=scripts/stop-one.sh
|
||||||
|
```
|
||||||
|
|
||||||
## Эксперименты и отказы
|
Удаление учебных данных выполняется только намеренно:
|
||||||
|
`docker compose down -v`.
|
||||||
|
|
||||||
TODO: гипотеза, hardware/лимиты, версии, объём данных, профиль нагрузки, concurrency/arrival rate, длительность/прогрев, повторы, успешные RPS, ошибки, p50/p95/p99, CPU/RAM. Сохранить raw summary без tokens и объяснить ограничения измерения.
|
## Доказательства критериев уровня 3
|
||||||
|
|
||||||
| Воздействие | Что ожидаем | Что наблюдали | Время восстановления / потеря данных |
|
| Критерий | Команда / сценарий | Результат |
|
||||||
| --- | --- | --- | --- |
|
| --- | --- | --- |
|
||||||
| TODO | TODO | TODO | TODO |
|
| Контракт | `make check` | PASS |
|
||||||
|
| Compose и инфраструктура | `docker compose --env-file .env config --quiet` | PASS |
|
||||||
|
| Публичный API | `make test` | `PASS: lab3 public API scenario` |
|
||||||
|
| Две реплики | `docker compose ps`, ответы smoke | `api1` и `api2` healthy; ответы содержат разные `X-Instance-Id` |
|
||||||
|
| Общие сессии и данные | перезапуск `postgres`, `api1`, `api2`, `load_balancer` без `-v` | прежний Bearer и сообщение сохранились |
|
||||||
|
| Идемпотентность | 20 параллельных POST с одним ключом | 20 ответов, 1 уникальный message ID |
|
||||||
|
| Отказ API | `docker compose stop api1`, затем `make test` | smoke продолжил проходить через `api2` |
|
||||||
|
|
||||||
## Ограничения и следующие шаги
|
В Windows `tests/resilience.py` не может запустить Unix-файл `.sh` напрямую
|
||||||
|
через `Popen` (WinError 193). Поэтому локально отказ и сохранность были
|
||||||
|
проверены эквивалентными командами Docker Compose; в Linux/CI hooks запускаются
|
||||||
|
напрямую после `chmod +x`.
|
||||||
|
|
||||||
TODO: какие отказы выдерживаются и какие нет; что не реализовано; где учебное упрощение; какое улучшение подтверждено, а какое пока гипотеза.
|
## Архитектура и ограничения
|
||||||
|
|
||||||
|
Nginx распределяет запросы между `api1` и `api2` без sticky sessions.
|
||||||
|
PostgreSQL volume является источником истины для пользователей, членства,
|
||||||
|
сообщений, сессий и idempotency records. Остановка одной API-реплики не
|
||||||
|
останавливает БД или вторую реплику; во время обнаружения отказа возможны
|
||||||
|
краткие 502/таймауты, после чего Nginx направляет запросы на оставшуюся
|
||||||
|
реплику. Отказ PostgreSQL, Docker host и высокодоступность самой БД в этой
|
||||||
|
лабораторной не исследовались. Redis/Valkey и возможности уровня 4/5 не
|
||||||
|
заявляются.
|
||||||
|
|||||||
@@ -0,0 +1,558 @@
|
|||||||
|
import base64
|
||||||
|
import binascii
|
||||||
|
import hashlib
|
||||||
|
import json
|
||||||
|
import os
|
||||||
|
import re
|
||||||
|
import secrets
|
||||||
|
import time
|
||||||
|
import uuid
|
||||||
|
from datetime import datetime, timedelta, timezone
|
||||||
|
from pathlib import Path
|
||||||
|
from typing import Any
|
||||||
|
|
||||||
|
import psycopg
|
||||||
|
from psycopg.rows import dict_row
|
||||||
|
from fastapi import FastAPI, Query, Request, Response
|
||||||
|
from fastapi.exceptions import RequestValidationError
|
||||||
|
from fastapi.responses import JSONResponse
|
||||||
|
from pydantic import BaseModel, ConfigDict, Field, field_validator
|
||||||
|
from argon2 import PasswordHasher
|
||||||
|
from argon2.exceptions import VerificationError
|
||||||
|
|
||||||
|
APP_HOST = os.getenv("APP_HOST", "0.0.0.0")
|
||||||
|
APP_PORT = int(os.getenv("APP_PORT", "8080"))
|
||||||
|
DATABASE_URL = os.getenv("DATABASE_URL", "")
|
||||||
|
DATABASE_URL_FILE = os.getenv("DATABASE_URL_FILE", "")
|
||||||
|
SESSION_TTL_SECONDS = int(os.getenv("SESSION_TTL_SECONDS", "3600"))
|
||||||
|
INSTANCE_ID = os.getenv("INSTANCE_ID", "api-" + uuid.uuid4().hex[:8])
|
||||||
|
MIGRATIONS_DIR = Path(__file__).parent / "migrations"
|
||||||
|
PASSWORD_HASHER = PasswordHasher()
|
||||||
|
|
||||||
|
|
||||||
|
class APIError(Exception):
|
||||||
|
def __init__(self, status_code: int, code: str, message: str):
|
||||||
|
self.status_code = status_code
|
||||||
|
self.code = code
|
||||||
|
self.message = message
|
||||||
|
|
||||||
|
|
||||||
|
class CreateUser(BaseModel):
|
||||||
|
model_config = ConfigDict(extra="forbid")
|
||||||
|
|
||||||
|
username: str = Field(..., pattern=r"^[a-z0-9_]{3,32}$")
|
||||||
|
display_name: str = Field(..., min_length=1, max_length=100)
|
||||||
|
password: str = Field(..., min_length=12, max_length=128)
|
||||||
|
|
||||||
|
@field_validator("display_name", "password")
|
||||||
|
@classmethod
|
||||||
|
def validate_non_blank(cls, value: str) -> str:
|
||||||
|
if not value.strip():
|
||||||
|
raise ValueError("value must not be blank")
|
||||||
|
return value
|
||||||
|
|
||||||
|
|
||||||
|
class CreateChat(BaseModel):
|
||||||
|
model_config = ConfigDict(extra="forbid")
|
||||||
|
|
||||||
|
title: str = Field(..., min_length=1, max_length=100)
|
||||||
|
member_ids: list[str] = Field(..., min_length=1, max_length=100)
|
||||||
|
|
||||||
|
@field_validator("title")
|
||||||
|
@classmethod
|
||||||
|
def validate_title(cls, value: str) -> str:
|
||||||
|
if not value.strip():
|
||||||
|
raise ValueError("title must not be blank")
|
||||||
|
return value
|
||||||
|
|
||||||
|
@field_validator("member_ids")
|
||||||
|
@classmethod
|
||||||
|
def validate_member_ids(cls, value: list[str]) -> list[str]:
|
||||||
|
if len(set(value)) != len(value):
|
||||||
|
raise ValueError("member_ids must be unique")
|
||||||
|
for member_id in value:
|
||||||
|
try:
|
||||||
|
uuid.UUID(member_id)
|
||||||
|
except ValueError as exc:
|
||||||
|
raise ValueError("member_ids must contain UUIDs") from exc
|
||||||
|
return value
|
||||||
|
|
||||||
|
|
||||||
|
class CreateMessage(BaseModel):
|
||||||
|
model_config = ConfigDict(extra="forbid")
|
||||||
|
|
||||||
|
text: str = Field(..., min_length=1, max_length=4000)
|
||||||
|
|
||||||
|
@field_validator("text")
|
||||||
|
@classmethod
|
||||||
|
def validate_text(cls, value: str) -> str:
|
||||||
|
if not value.strip():
|
||||||
|
raise ValueError("text must not be blank")
|
||||||
|
return value
|
||||||
|
|
||||||
|
|
||||||
|
def utc_now() -> datetime:
|
||||||
|
return datetime.now(timezone.utc)
|
||||||
|
|
||||||
|
|
||||||
|
def iso(value: datetime) -> str:
|
||||||
|
return value.astimezone(timezone.utc).isoformat(timespec="microseconds").replace(
|
||||||
|
"+00:00", "Z"
|
||||||
|
)
|
||||||
|
|
||||||
|
|
||||||
|
def database_url() -> str:
|
||||||
|
if DATABASE_URL:
|
||||||
|
return DATABASE_URL
|
||||||
|
if DATABASE_URL_FILE:
|
||||||
|
try:
|
||||||
|
return Path(DATABASE_URL_FILE).read_text(encoding="utf-8").strip()
|
||||||
|
except OSError as exc:
|
||||||
|
raise RuntimeError("database URL file is not readable") from exc
|
||||||
|
raise RuntimeError("DATABASE_URL or DATABASE_URL_FILE is required")
|
||||||
|
|
||||||
|
|
||||||
|
def db():
|
||||||
|
return psycopg.connect(database_url(), row_factory=dict_row)
|
||||||
|
|
||||||
|
|
||||||
|
def apply_migrations() -> None:
|
||||||
|
with db() as conn:
|
||||||
|
conn.execute(
|
||||||
|
"""
|
||||||
|
CREATE TABLE IF NOT EXISTS schema_migrations (
|
||||||
|
version text PRIMARY KEY,
|
||||||
|
applied_at timestamptz NOT NULL DEFAULT now()
|
||||||
|
)
|
||||||
|
"""
|
||||||
|
)
|
||||||
|
for path in sorted(MIGRATIONS_DIR.glob("*.sql")):
|
||||||
|
version = path.name.split("_", 1)[0]
|
||||||
|
applied = conn.execute(
|
||||||
|
"SELECT 1 FROM schema_migrations WHERE version = %s", (version,)
|
||||||
|
).fetchone()
|
||||||
|
if applied is None:
|
||||||
|
for statement in path.read_text(encoding="utf-8").split(";"):
|
||||||
|
if statement.strip():
|
||||||
|
conn.execute(statement)
|
||||||
|
conn.execute(
|
||||||
|
"INSERT INTO schema_migrations(version) VALUES (%s)", (version,)
|
||||||
|
)
|
||||||
|
|
||||||
|
|
||||||
|
def wait_for_database() -> None:
|
||||||
|
deadline = time.monotonic() + 60
|
||||||
|
last_error: Exception | None = None
|
||||||
|
while time.monotonic() < deadline:
|
||||||
|
try:
|
||||||
|
apply_migrations()
|
||||||
|
return
|
||||||
|
except (OSError, psycopg.Error) as exc:
|
||||||
|
last_error = exc
|
||||||
|
time.sleep(1)
|
||||||
|
raise RuntimeError("database did not become ready") from last_error
|
||||||
|
|
||||||
|
|
||||||
|
def error_response(request: Request, status_code: int, code: str, message: str):
|
||||||
|
request_id = getattr(request.state, "request_id", str(uuid.uuid4()))
|
||||||
|
headers = {"X-Request-Id": request_id}
|
||||||
|
if status_code == 401:
|
||||||
|
headers["WWW-Authenticate"] = (
|
||||||
|
'Bearer realm="messenger"'
|
||||||
|
if request.url.path != "/api/v1/auth/sessions"
|
||||||
|
else 'Basic realm="messenger", charset="UTF-8"'
|
||||||
|
)
|
||||||
|
return JSONResponse(
|
||||||
|
status_code=status_code,
|
||||||
|
content={"error": {"code": code, "message": message, "request_id": request_id}},
|
||||||
|
headers=headers,
|
||||||
|
)
|
||||||
|
|
||||||
|
|
||||||
|
def bearer_user(request: Request) -> dict[str, Any]:
|
||||||
|
header = request.headers.get("Authorization", "")
|
||||||
|
scheme, _, token = header.partition(" ")
|
||||||
|
if scheme.lower() != "bearer" or not token or " " in token:
|
||||||
|
raise APIError(401, "unauthorized", "valid bearer session required")
|
||||||
|
hashed_token = token_hash(token)
|
||||||
|
with db() as conn:
|
||||||
|
user = conn.execute(
|
||||||
|
"""
|
||||||
|
SELECT u.id, u.username, u.display_name, u.created_at
|
||||||
|
FROM sessions s JOIN users u ON u.id = s.user_id
|
||||||
|
WHERE s.token_hash = %s AND s.revoked_at IS NULL
|
||||||
|
AND s.expires_at > now()
|
||||||
|
""",
|
||||||
|
(hashed_token,),
|
||||||
|
).fetchone()
|
||||||
|
if user is None:
|
||||||
|
raise APIError(401, "unauthorized", "valid bearer session required")
|
||||||
|
return user
|
||||||
|
|
||||||
|
|
||||||
|
def basic_credentials(request: Request) -> tuple[str, str]:
|
||||||
|
header = request.headers.get("Authorization", "")
|
||||||
|
scheme, _, encoded = header.partition(" ")
|
||||||
|
if scheme.lower() != "basic" or not encoded:
|
||||||
|
raise APIError(401, "unauthorized", "basic credentials required")
|
||||||
|
try:
|
||||||
|
decoded = base64.b64decode(encoded, validate=True).decode("utf-8")
|
||||||
|
username, separator, password = decoded.partition(":")
|
||||||
|
except (binascii.Error, UnicodeDecodeError):
|
||||||
|
raise APIError(401, "unauthorized", "invalid credentials") from None
|
||||||
|
if not separator or not username or not password:
|
||||||
|
raise APIError(401, "unauthorized", "invalid credentials")
|
||||||
|
return username, password
|
||||||
|
|
||||||
|
|
||||||
|
def token_hash(token: str) -> str:
|
||||||
|
try:
|
||||||
|
return hashlib.sha256(token.encode("ascii", "strict")).hexdigest()
|
||||||
|
except UnicodeEncodeError:
|
||||||
|
raise APIError(401, "unauthorized", "valid bearer session required") from None
|
||||||
|
|
||||||
|
|
||||||
|
def encode_cursor(created_at: datetime, object_id: uuid.UUID) -> str:
|
||||||
|
payload = json.dumps(
|
||||||
|
{"created_at": iso(created_at), "id": str(object_id)},
|
||||||
|
separators=(",", ":"),
|
||||||
|
).encode()
|
||||||
|
return base64.urlsafe_b64encode(payload).decode().rstrip("=")
|
||||||
|
|
||||||
|
|
||||||
|
def decode_cursor(cursor: str) -> tuple[datetime, uuid.UUID]:
|
||||||
|
try:
|
||||||
|
padding = "=" * ((4 - len(cursor) % 4) % 4)
|
||||||
|
payload = json.loads(
|
||||||
|
base64.urlsafe_b64decode((cursor + padding).encode()).decode()
|
||||||
|
)
|
||||||
|
created_at = datetime.fromisoformat(payload["created_at"].replace("Z", "+00:00"))
|
||||||
|
return created_at, uuid.UUID(payload["id"])
|
||||||
|
except (KeyError, TypeError, ValueError, UnicodeDecodeError, binascii.Error, json.JSONDecodeError):
|
||||||
|
raise APIError(400, "invalid_request", "cursor is invalid") from None
|
||||||
|
|
||||||
|
|
||||||
|
app = FastAPI(title="MTUSI Messenger Lab2")
|
||||||
|
|
||||||
|
|
||||||
|
@app.on_event("startup")
|
||||||
|
def startup() -> None:
|
||||||
|
wait_for_database()
|
||||||
|
|
||||||
|
|
||||||
|
@app.middleware("http")
|
||||||
|
async def add_request_id(request: Request, call_next):
|
||||||
|
request_id = request.headers.get("X-Request-Id") or str(uuid.uuid4())
|
||||||
|
request.state.request_id = request_id
|
||||||
|
response = await call_next(request)
|
||||||
|
response.headers["X-Request-Id"] = request_id
|
||||||
|
response.headers["X-Instance-Id"] = INSTANCE_ID
|
||||||
|
return response
|
||||||
|
|
||||||
|
|
||||||
|
@app.exception_handler(APIError)
|
||||||
|
async def api_error_handler(request: Request, exc: APIError):
|
||||||
|
return error_response(request, exc.status_code, exc.code, exc.message)
|
||||||
|
|
||||||
|
|
||||||
|
@app.exception_handler(RequestValidationError)
|
||||||
|
async def validation_error_handler(request: Request, exc: RequestValidationError):
|
||||||
|
return error_response(request, 400, "invalid_request", "invalid request")
|
||||||
|
|
||||||
|
|
||||||
|
@app.exception_handler(Exception)
|
||||||
|
async def unexpected_error_handler(request: Request, exc: Exception):
|
||||||
|
return error_response(request, 500, "internal_error", "internal server error")
|
||||||
|
|
||||||
|
|
||||||
|
@app.get("/health/live")
|
||||||
|
def health_live():
|
||||||
|
return {"status": "ok"}
|
||||||
|
|
||||||
|
|
||||||
|
@app.get("/health/ready")
|
||||||
|
def health_ready():
|
||||||
|
try:
|
||||||
|
with db() as conn:
|
||||||
|
conn.execute("SELECT 1")
|
||||||
|
except (OSError, psycopg.Error):
|
||||||
|
raise APIError(503, "unavailable", "database unavailable")
|
||||||
|
return {"status": "ok"}
|
||||||
|
|
||||||
|
|
||||||
|
@app.post("/api/v1/users", status_code=201)
|
||||||
|
def create_user(payload: CreateUser):
|
||||||
|
user_id = uuid.uuid4()
|
||||||
|
password_hash = PASSWORD_HASHER.hash(payload.password)
|
||||||
|
try:
|
||||||
|
with db() as conn:
|
||||||
|
user = conn.execute(
|
||||||
|
"""
|
||||||
|
INSERT INTO users(id, username, display_name, password_hash)
|
||||||
|
VALUES (%s, %s, %s, %s)
|
||||||
|
RETURNING id, username, display_name, created_at
|
||||||
|
""",
|
||||||
|
(user_id, payload.username, payload.display_name, password_hash),
|
||||||
|
).fetchone()
|
||||||
|
except psycopg.errors.UniqueViolation:
|
||||||
|
raise APIError(409, "conflict", "user already exists") from None
|
||||||
|
return {**user, "id": str(user["id"]), "created_at": iso(user["created_at"])}
|
||||||
|
|
||||||
|
|
||||||
|
@app.post("/api/v1/auth/sessions", status_code=201)
|
||||||
|
def create_session(request: Request):
|
||||||
|
username, password = basic_credentials(request)
|
||||||
|
with db() as conn:
|
||||||
|
user = conn.execute(
|
||||||
|
"SELECT id, username, display_name, created_at, password_hash FROM users WHERE username = %s",
|
||||||
|
(username,),
|
||||||
|
).fetchone()
|
||||||
|
if user is None:
|
||||||
|
raise APIError(401, "unauthorized", "invalid credentials")
|
||||||
|
try:
|
||||||
|
PASSWORD_HASHER.verify(user["password_hash"], password)
|
||||||
|
except VerificationError:
|
||||||
|
raise APIError(401, "unauthorized", "invalid credentials") from None
|
||||||
|
token = secrets.token_urlsafe(32)
|
||||||
|
expires_at = utc_now() + timedelta(seconds=SESSION_TTL_SECONDS)
|
||||||
|
with db() as conn:
|
||||||
|
conn.execute(
|
||||||
|
"INSERT INTO sessions(token_hash, user_id, expires_at) VALUES (%s, %s, %s)",
|
||||||
|
(token_hash(token), user["id"], expires_at),
|
||||||
|
)
|
||||||
|
public_user = {
|
||||||
|
"id": str(user["id"]),
|
||||||
|
"username": user["username"],
|
||||||
|
"display_name": user["display_name"],
|
||||||
|
"created_at": iso(user["created_at"]),
|
||||||
|
}
|
||||||
|
return {
|
||||||
|
"token": token,
|
||||||
|
"token_type": "Bearer",
|
||||||
|
"expires_at": iso(expires_at),
|
||||||
|
"user": public_user,
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
@app.delete("/api/v1/auth/sessions/current", status_code=204)
|
||||||
|
def revoke_session(request: Request):
|
||||||
|
bearer_user(request)
|
||||||
|
header = request.headers["Authorization"]
|
||||||
|
token = header.split(" ", 1)[1]
|
||||||
|
with db() as conn:
|
||||||
|
conn.execute(
|
||||||
|
"UPDATE sessions SET revoked_at = now() WHERE token_hash = %s AND revoked_at IS NULL",
|
||||||
|
(token_hash(token),),
|
||||||
|
)
|
||||||
|
return Response(status_code=204)
|
||||||
|
|
||||||
|
|
||||||
|
@app.get("/api/v1/users/me")
|
||||||
|
def current_user(request: Request):
|
||||||
|
user = bearer_user(request)
|
||||||
|
return {**user, "id": str(user["id"]), "created_at": iso(user["created_at"])}
|
||||||
|
|
||||||
|
|
||||||
|
@app.post("/api/v1/chats", status_code=201)
|
||||||
|
def create_chat(payload: CreateChat, request: Request):
|
||||||
|
actor = bearer_user(request)
|
||||||
|
member_ids = [uuid.UUID(member_id) for member_id in payload.member_ids]
|
||||||
|
if actor["id"] not in member_ids:
|
||||||
|
raise APIError(400, "invalid_request", "actor must be included in member_ids")
|
||||||
|
chat_id = uuid.uuid4()
|
||||||
|
with db() as conn:
|
||||||
|
existing = conn.execute(
|
||||||
|
"SELECT id FROM users WHERE id = ANY(%s)", (member_ids,)
|
||||||
|
).fetchall()
|
||||||
|
if len(existing) != len(member_ids):
|
||||||
|
raise APIError(400, "invalid_request", "member not found")
|
||||||
|
chat = conn.execute(
|
||||||
|
"INSERT INTO chats(id, title) VALUES (%s, %s) RETURNING id, title, created_at",
|
||||||
|
(chat_id, payload.title),
|
||||||
|
).fetchone()
|
||||||
|
with conn.cursor() as cur:
|
||||||
|
cur.executemany(
|
||||||
|
"INSERT INTO chat_members(chat_id, user_id) VALUES (%s, %s)",
|
||||||
|
[(chat_id, member_id) for member_id in member_ids],
|
||||||
|
)
|
||||||
|
return {
|
||||||
|
"id": str(chat["id"]),
|
||||||
|
"title": chat["title"],
|
||||||
|
"member_ids": sorted(str(member_id) for member_id in member_ids),
|
||||||
|
"created_at": iso(chat["created_at"]),
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
def chat_for_user(conn, chat_id: uuid.UUID, user_id: uuid.UUID):
|
||||||
|
return conn.execute(
|
||||||
|
"""
|
||||||
|
SELECT c.id, c.title, c.created_at
|
||||||
|
FROM chats c JOIN chat_members m ON m.chat_id = c.id
|
||||||
|
WHERE c.id = %s AND m.user_id = %s
|
||||||
|
""",
|
||||||
|
(chat_id, user_id),
|
||||||
|
).fetchone()
|
||||||
|
|
||||||
|
|
||||||
|
def public_chat(conn, chat: dict[str, Any]) -> dict[str, Any]:
|
||||||
|
members = conn.execute(
|
||||||
|
"SELECT user_id FROM chat_members WHERE chat_id = %s ORDER BY user_id", (chat["id"],)
|
||||||
|
).fetchall()
|
||||||
|
return {
|
||||||
|
"id": str(chat["id"]),
|
||||||
|
"title": chat["title"],
|
||||||
|
"member_ids": [str(row["user_id"]) for row in members],
|
||||||
|
"created_at": iso(chat["created_at"]),
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
@app.get("/api/v1/chats/{chat_id}")
|
||||||
|
def get_chat(chat_id: uuid.UUID, request: Request):
|
||||||
|
actor = bearer_user(request)
|
||||||
|
with db() as conn:
|
||||||
|
chat = chat_for_user(conn, chat_id, actor["id"])
|
||||||
|
if chat is None:
|
||||||
|
raise APIError(404, "not_found", "chat not found")
|
||||||
|
return public_chat(conn, chat)
|
||||||
|
|
||||||
|
|
||||||
|
@app.get("/api/v1/chats")
|
||||||
|
def list_chats(request: Request, limit: int = Query(50, ge=1, le=100), cursor: str | None = None):
|
||||||
|
actor = bearer_user(request)
|
||||||
|
after = decode_cursor(cursor) if cursor else None
|
||||||
|
with db() as conn:
|
||||||
|
rows = conn.execute(
|
||||||
|
"""
|
||||||
|
SELECT c.id, c.title, c.created_at
|
||||||
|
FROM chats c JOIN chat_members m ON m.chat_id = c.id
|
||||||
|
WHERE m.user_id = %s
|
||||||
|
AND (%s::timestamptz IS NULL OR (c.created_at, c.id) > (%s::timestamptz, %s::uuid))
|
||||||
|
ORDER BY c.created_at, c.id
|
||||||
|
LIMIT %s
|
||||||
|
""",
|
||||||
|
(actor["id"], after[0] if after else None, after[0] if after else None,
|
||||||
|
after[1] if after else None, limit + 1),
|
||||||
|
).fetchall()
|
||||||
|
items = [public_chat(conn, row) for row in rows[:limit]]
|
||||||
|
next_cursor = (
|
||||||
|
encode_cursor(rows[limit - 1]["created_at"], rows[limit - 1]["id"])
|
||||||
|
if len(rows) > limit
|
||||||
|
else None
|
||||||
|
)
|
||||||
|
return {"items": items, "next_cursor": next_cursor}
|
||||||
|
|
||||||
|
|
||||||
|
@app.post("/api/v1/chats/{chat_id}/messages", status_code=201)
|
||||||
|
def create_message(
|
||||||
|
chat_id: uuid.UUID,
|
||||||
|
payload: CreateMessage,
|
||||||
|
request: Request,
|
||||||
|
):
|
||||||
|
actor = bearer_user(request)
|
||||||
|
idempotency_key = request.headers.get("Idempotency-Key", "")
|
||||||
|
if not re.fullmatch(r"[A-Za-z0-9._:-]{1,128}", idempotency_key):
|
||||||
|
raise APIError(400, "invalid_request", "valid Idempotency-Key required")
|
||||||
|
request_hash = hashlib.sha256(
|
||||||
|
json.dumps({"text": payload.text}, ensure_ascii=False, sort_keys=True).encode()
|
||||||
|
).hexdigest()
|
||||||
|
with db() as conn:
|
||||||
|
if chat_for_user(conn, chat_id, actor["id"]) is None:
|
||||||
|
raise APIError(404, "not_found", "chat not accessible")
|
||||||
|
existing = conn.execute(
|
||||||
|
"""
|
||||||
|
INSERT INTO idempotency_keys(user_id, chat_id, idempotency_key, request_hash)
|
||||||
|
VALUES (%s, %s, %s, %s)
|
||||||
|
ON CONFLICT (user_id, chat_id, idempotency_key) DO NOTHING
|
||||||
|
RETURNING message_id, request_hash
|
||||||
|
""",
|
||||||
|
(actor["id"], chat_id, idempotency_key, request_hash),
|
||||||
|
).fetchone()
|
||||||
|
if existing is None:
|
||||||
|
existing = conn.execute(
|
||||||
|
"""
|
||||||
|
SELECT message_id, request_hash
|
||||||
|
FROM idempotency_keys
|
||||||
|
WHERE user_id = %s AND chat_id = %s AND idempotency_key = %s
|
||||||
|
FOR UPDATE
|
||||||
|
""",
|
||||||
|
(actor["id"], chat_id, idempotency_key),
|
||||||
|
).fetchone()
|
||||||
|
if existing["request_hash"] != request_hash:
|
||||||
|
raise APIError(409, "conflict", "idempotency key has another request")
|
||||||
|
message = conn.execute(
|
||||||
|
"""
|
||||||
|
SELECT id, chat_id, sender_id, text, created_at
|
||||||
|
FROM messages WHERE id = %s
|
||||||
|
""",
|
||||||
|
(existing["message_id"],),
|
||||||
|
).fetchone()
|
||||||
|
if message is None:
|
||||||
|
raise APIError(503, "unavailable", "idempotent result is not ready")
|
||||||
|
return {
|
||||||
|
**message,
|
||||||
|
"id": str(message["id"]),
|
||||||
|
"chat_id": str(message["chat_id"]),
|
||||||
|
"sender_id": str(message["sender_id"]),
|
||||||
|
"created_at": iso(message["created_at"]),
|
||||||
|
}
|
||||||
|
message_id = uuid.uuid4()
|
||||||
|
message = conn.execute(
|
||||||
|
"""
|
||||||
|
INSERT INTO messages(id, chat_id, sender_id, text)
|
||||||
|
VALUES (%s, %s, %s, %s)
|
||||||
|
RETURNING id, chat_id, sender_id, text, created_at
|
||||||
|
""",
|
||||||
|
(message_id, chat_id, actor["id"], payload.text),
|
||||||
|
).fetchone()
|
||||||
|
conn.execute(
|
||||||
|
"""
|
||||||
|
UPDATE idempotency_keys SET message_id = %s
|
||||||
|
WHERE user_id = %s AND chat_id = %s AND idempotency_key = %s
|
||||||
|
""",
|
||||||
|
(message_id, actor["id"], chat_id, idempotency_key),
|
||||||
|
)
|
||||||
|
return {**message, "id": str(message["id"]), "chat_id": str(message["chat_id"]),
|
||||||
|
"sender_id": str(message["sender_id"]), "created_at": iso(message["created_at"])}
|
||||||
|
|
||||||
|
|
||||||
|
@app.get("/api/v1/chats/{chat_id}/messages")
|
||||||
|
def list_messages(
|
||||||
|
chat_id: uuid.UUID,
|
||||||
|
request: Request,
|
||||||
|
limit: int = Query(50, ge=1, le=100),
|
||||||
|
cursor: str | None = None,
|
||||||
|
):
|
||||||
|
actor = bearer_user(request)
|
||||||
|
after = decode_cursor(cursor) if cursor else None
|
||||||
|
with db() as conn:
|
||||||
|
if chat_for_user(conn, chat_id, actor["id"]) is None:
|
||||||
|
raise APIError(404, "not_found", "chat not accessible")
|
||||||
|
rows = conn.execute(
|
||||||
|
"""
|
||||||
|
SELECT id, chat_id, sender_id, text, created_at
|
||||||
|
FROM messages
|
||||||
|
WHERE chat_id = %s
|
||||||
|
AND (%s::timestamptz IS NULL OR (created_at, id) > (%s::timestamptz, %s::uuid))
|
||||||
|
ORDER BY created_at, id
|
||||||
|
LIMIT %s
|
||||||
|
""",
|
||||||
|
(chat_id, after[0] if after else None, after[0] if after else None,
|
||||||
|
after[1] if after else None, limit + 1),
|
||||||
|
).fetchall()
|
||||||
|
items = [
|
||||||
|
{**row, "id": str(row["id"]), "chat_id": str(row["chat_id"]),
|
||||||
|
"sender_id": str(row["sender_id"]), "created_at": iso(row["created_at"])}
|
||||||
|
for row in rows[:limit]
|
||||||
|
]
|
||||||
|
next_cursor = (
|
||||||
|
encode_cursor(rows[limit - 1]["created_at"], rows[limit - 1]["id"])
|
||||||
|
if len(rows) > limit
|
||||||
|
else None
|
||||||
|
)
|
||||||
|
return {"items": items, "next_cursor": next_cursor}
|
||||||
|
|
||||||
|
|
||||||
|
if __name__ == "__main__":
|
||||||
|
import uvicorn
|
||||||
|
|
||||||
|
uvicorn.run("app:app", host=APP_HOST, port=APP_PORT, reload=False)
|
||||||
@@ -0,0 +1,81 @@
|
|||||||
|
services:
|
||||||
|
postgres:
|
||||||
|
image: postgres:16.4-bookworm
|
||||||
|
environment:
|
||||||
|
POSTGRES_DB: messenger
|
||||||
|
POSTGRES_USER: messenger
|
||||||
|
POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:?set POSTGRES_PASSWORD in .env}
|
||||||
|
volumes:
|
||||||
|
- postgres_data:/var/lib/postgresql/data
|
||||||
|
healthcheck:
|
||||||
|
test: ["CMD-SHELL", "pg_isready -U messenger -d messenger"]
|
||||||
|
interval: 2s
|
||||||
|
timeout: 3s
|
||||||
|
retries: 30
|
||||||
|
|
||||||
|
migrate:
|
||||||
|
build: .
|
||||||
|
environment:
|
||||||
|
DATABASE_URL: postgresql://messenger:${POSTGRES_PASSWORD}@postgres:5432/messenger
|
||||||
|
depends_on:
|
||||||
|
postgres:
|
||||||
|
condition: service_healthy
|
||||||
|
command: ["python", "-c", "import app; app.wait_for_database()"]
|
||||||
|
restart: "no"
|
||||||
|
|
||||||
|
api1:
|
||||||
|
build: .
|
||||||
|
environment:
|
||||||
|
APP_HOST: 0.0.0.0
|
||||||
|
APP_PORT: 8080
|
||||||
|
DATABASE_URL: postgresql://messenger:${POSTGRES_PASSWORD}@postgres:5432/messenger
|
||||||
|
SESSION_TTL_SECONDS: ${SESSION_TTL_SECONDS:-3600}
|
||||||
|
INSTANCE_ID: api1
|
||||||
|
depends_on:
|
||||||
|
migrate:
|
||||||
|
condition: service_completed_successfully
|
||||||
|
healthcheck:
|
||||||
|
test: ["CMD", "python", "-c", "import urllib.request; urllib.request.urlopen('http://127.0.0.1:8080/health/ready', timeout=2)"]
|
||||||
|
interval: 2s
|
||||||
|
timeout: 3s
|
||||||
|
retries: 30
|
||||||
|
restart: unless-stopped
|
||||||
|
|
||||||
|
api2:
|
||||||
|
build: .
|
||||||
|
environment:
|
||||||
|
APP_HOST: 0.0.0.0
|
||||||
|
APP_PORT: 8080
|
||||||
|
DATABASE_URL: postgresql://messenger:${POSTGRES_PASSWORD}@postgres:5432/messenger
|
||||||
|
SESSION_TTL_SECONDS: ${SESSION_TTL_SECONDS:-3600}
|
||||||
|
INSTANCE_ID: api2
|
||||||
|
depends_on:
|
||||||
|
migrate:
|
||||||
|
condition: service_completed_successfully
|
||||||
|
healthcheck:
|
||||||
|
test: ["CMD", "python", "-c", "import urllib.request; urllib.request.urlopen('http://127.0.0.1:8080/health/ready', timeout=2)"]
|
||||||
|
interval: 2s
|
||||||
|
timeout: 3s
|
||||||
|
retries: 30
|
||||||
|
restart: unless-stopped
|
||||||
|
|
||||||
|
load_balancer:
|
||||||
|
image: nginx:1.27.2-alpine
|
||||||
|
ports:
|
||||||
|
- "8080:80"
|
||||||
|
volumes:
|
||||||
|
- ./nginx/default.conf:/etc/nginx/conf.d/default.conf:ro
|
||||||
|
depends_on:
|
||||||
|
api1:
|
||||||
|
condition: service_healthy
|
||||||
|
api2:
|
||||||
|
condition: service_healthy
|
||||||
|
healthcheck:
|
||||||
|
test: ["CMD", "wget", "-q", "-O", "-", "http://127.0.0.1/health/live"]
|
||||||
|
interval: 2s
|
||||||
|
timeout: 3s
|
||||||
|
retries: 30
|
||||||
|
restart: unless-stopped
|
||||||
|
|
||||||
|
volumes:
|
||||||
|
postgres_data:
|
||||||
@@ -0,0 +1,38 @@
|
|||||||
|
CREATE TABLE users (
|
||||||
|
id uuid PRIMARY KEY,
|
||||||
|
username varchar(32) NOT NULL UNIQUE,
|
||||||
|
display_name varchar(100) NOT NULL CHECK (btrim(display_name) <> ''),
|
||||||
|
password_hash text NOT NULL,
|
||||||
|
created_at timestamptz NOT NULL DEFAULT now()
|
||||||
|
);
|
||||||
|
|
||||||
|
CREATE TABLE chats (
|
||||||
|
id uuid PRIMARY KEY,
|
||||||
|
title varchar(100) NOT NULL CHECK (btrim(title) <> ''),
|
||||||
|
created_at timestamptz NOT NULL DEFAULT now()
|
||||||
|
);
|
||||||
|
|
||||||
|
CREATE TABLE chat_members (
|
||||||
|
chat_id uuid NOT NULL REFERENCES chats(id) ON DELETE CASCADE,
|
||||||
|
user_id uuid NOT NULL REFERENCES users(id) ON DELETE CASCADE,
|
||||||
|
PRIMARY KEY (chat_id, user_id)
|
||||||
|
);
|
||||||
|
|
||||||
|
CREATE TABLE messages (
|
||||||
|
id uuid PRIMARY KEY,
|
||||||
|
chat_id uuid NOT NULL REFERENCES chats(id) ON DELETE CASCADE,
|
||||||
|
sender_id uuid NOT NULL REFERENCES users(id),
|
||||||
|
text varchar(4000) NOT NULL CHECK (btrim(text) <> ''),
|
||||||
|
created_at timestamptz NOT NULL DEFAULT now()
|
||||||
|
);
|
||||||
|
|
||||||
|
CREATE TABLE sessions (
|
||||||
|
token_hash char(64) PRIMARY KEY,
|
||||||
|
user_id uuid NOT NULL REFERENCES users(id) ON DELETE CASCADE,
|
||||||
|
expires_at timestamptz NOT NULL,
|
||||||
|
revoked_at timestamptz
|
||||||
|
);
|
||||||
|
|
||||||
|
CREATE INDEX chat_members_user_idx ON chat_members(user_id, chat_id);
|
||||||
|
CREATE INDEX messages_chat_order_idx ON messages(chat_id, created_at, id);
|
||||||
|
CREATE INDEX sessions_user_idx ON sessions(user_id, expires_at);
|
||||||
@@ -0,0 +1,11 @@
|
|||||||
|
CREATE TABLE idempotency_keys (
|
||||||
|
user_id uuid NOT NULL REFERENCES users(id) ON DELETE CASCADE,
|
||||||
|
chat_id uuid NOT NULL REFERENCES chats(id) ON DELETE CASCADE,
|
||||||
|
idempotency_key varchar(128) NOT NULL,
|
||||||
|
request_hash char(64) NOT NULL,
|
||||||
|
message_id uuid REFERENCES messages(id) ON DELETE CASCADE,
|
||||||
|
created_at timestamptz NOT NULL DEFAULT now(),
|
||||||
|
PRIMARY KEY (user_id, chat_id, idempotency_key)
|
||||||
|
);
|
||||||
|
|
||||||
|
CREATE INDEX idempotency_created_idx ON idempotency_keys(created_at);
|
||||||
@@ -0,0 +1,20 @@
|
|||||||
|
upstream messenger_api {
|
||||||
|
server api1:8080 max_fails=1 fail_timeout=2s;
|
||||||
|
server api2:8080 max_fails=1 fail_timeout=2s;
|
||||||
|
}
|
||||||
|
|
||||||
|
server {
|
||||||
|
listen 80;
|
||||||
|
|
||||||
|
location / {
|
||||||
|
proxy_pass http://messenger_api;
|
||||||
|
proxy_http_version 1.1;
|
||||||
|
proxy_set_header Host $host;
|
||||||
|
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
|
||||||
|
proxy_set_header X-Request-Id $http_x_request_id;
|
||||||
|
proxy_connect_timeout 1s;
|
||||||
|
proxy_read_timeout 10s;
|
||||||
|
proxy_next_upstream error timeout http_502 http_503 http_504;
|
||||||
|
proxy_next_upstream_tries 2;
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,4 @@
|
|||||||
|
argon2-cffi==23.1.0
|
||||||
|
fastapi==0.115.5
|
||||||
|
psycopg[binary]==3.2.3
|
||||||
|
uvicorn==0.32.0
|
||||||
@@ -0,0 +1,3 @@
|
|||||||
|
#!/usr/bin/env bash
|
||||||
|
set -eu
|
||||||
|
docker compose restart postgres api1 api2 load_balancer
|
||||||
@@ -0,0 +1,10 @@
|
|||||||
|
#!/usr/bin/env bash
|
||||||
|
set -eu
|
||||||
|
|
||||||
|
case "${TARGET_INSTANCE_ID:-}" in
|
||||||
|
api1) service=api1 ;;
|
||||||
|
api2) service=api2 ;;
|
||||||
|
*) echo "unknown TARGET_INSTANCE_ID" >&2; exit 2 ;;
|
||||||
|
esac
|
||||||
|
|
||||||
|
docker compose stop "$service"
|
||||||
Reference in New Issue
Block a user