diff --git a/Dockerfile b/Dockerfile new file mode 100644 index 00000000..db3469e3 --- /dev/null +++ b/Dockerfile @@ -0,0 +1,22 @@ +FROM python:3.11.7-slim-bookworm AS builder + +WORKDIR /app +COPY requirements.txt . +RUN pip install --no-cache-dir --prefix=/install -r requirements.txt + +FROM python:3.11.7-slim-bookworm AS runner + +RUN useradd -u 10001 -m appuser +WORKDIR /home/appuser + +COPY --from=builder /install /usr/local +COPY app.py worker.py ./ + +USER appuser +EXPOSE 8080 + +HEALTHCHECK --interval=5s --timeout=3s --retries=3 \ + CMD python -c "import urllib.request; urllib.request.urlopen('http://localhost:8080/health/ready')" + +ENV PYTHONUNBUFFERED=1 +CMD ["uvicorn", "app:app", "--host", "0.0.0.0", "--port", "8080", "--timeout-graceful-shutdown", "10"] \ No newline at end of file diff --git a/REPORT.md b/REPORT.md index e98f75e9..67468a37 100644 --- a/REPORT.md +++ b/REPORT.md @@ -1,37 +1,73 @@ # Отчёт — лабораторная 5 -- Автор, группа: TODO -- Целевая оценка; выбранный трек 5, если нужен: TODO -- Commit/PR: TODO после публикации -- Использованные источники, библиотеки и помощь ИИ: TODO - -## Запуск из чистого clone - -TODO: версии runtime/образов, prerequisites, команды создания локальных secrets/.env, build, миграций, запуска, ожидания готовности, тестов и остановки. Указать необходимые действия оператора. Не вставлять секреты. Отдельно указать безопасную остановку и команду намеренного удаления учебных данных. +- Автор, группа: Бондаренко Мария, БПИ2302 +- Целевая оценка: 4 ## Архитектура и решения -TODO: схема процессов/хранилищ, источник истины, транзакционные границы, ограничения. Что перенесено из lab4, что изменено в этой работе. Соответствие переменных из .env.example реальной конфигурации. +Система построена по микросервисной/событийно-ориентированной схеме с разделением синхронного HTTP API и асинхронного фонового обработчика медиафайлов: -## Доказательства критериев +1. API-сервисы (api-1, api-2): + - Реализованы на базе FastAPI, балансируются через Nginx + - При загрузке изображения выполняют первичную валидацию сигнатур (PNG/JPEG), проверку размера и разрешения + - Сохраняют исходный файл во временную зону объектного хранилища S3 + - В рамках единой транзакции PostgreSQL фиксируют метаданные вложения в таблице attachments и записывают событие в таблицу outbox +2. Транзакционный Outbox: + - Фоновый поток в API-инстансах вычитывает неопубликованные записи, отправляет задачи в стрим брокера attachment_jobs и проставляет published_at. Это исключает потерю задач при сбое между COMMIT в БД и публикацией в брокер +3. Брокер сообщений: + - Запущен с включенной персистентностью + - Используются Consumer Groups для балансировки нагрузки между воркерами и подтверждения обработки +4. Объектное хранилище: + - Хранит временные файлы в staging/ и финальные артефакты в attachments/{chat_id}/{attachment_id}/{variant} +5. Фоновый обработчик: + - Многопоточный воркер + - Вычитывает задачи пачками и обрабатывает их идемпотентно с блокировкой строки в БД -| Критерий README | Команда/сценарий | Наблюдаемый результат | Файл доказательства | -| --- | --- | --- | --- | -| Публичный smoke | make test | TODO | TODO | -| Остальные пункты уровня 3 | TODO | TODO | TODO | -| Все пункты уровня 4, если заявлен | TODO | TODO | TODO | -| Выбранный трек 5, если заявлен | TODO | TODO | TODO | +## Пайплайн обработки изображений и варианты (Variants) -TODO: добавить отдельную строку для каждого заявленного критерия. PASS без команды и наблюдения не является доказательством. Проверка инфраструктурного hook требует подтверждения, какие реальные процессы/хранилища перезапущены. +Перед генерацией производных форматов исходное изображение проходит нормализацию: +- EXIF-ориентация: применяется ImageOps.exif_transpose(img) для корректного поворота фотографий с мобильных устройств перед ресайзом и кропом +- Цветовое пространство: изображения с альфа-каналом (RGBA, LA, P с прозрачностью) накладываются на белый фон (255, 255, 255) и приводятся к RGB +- Защита от Decompression Bomb: установлено ограничение Image.MAX_IMAGE_PIXELS = 40000000 -## Эксперименты и отказы +## Спецификация генерируемых вариантов (Grade 4): +1. thumbnail (превью для списка/чата): + - Формат и качество: image/jpeg, quality=85, optimize=True. + - Геометрия: пропорциональное масштабирование с вписыванием в квадрат 256256 пикселей (без апскейла, если оригинал меньше) +2. optimized (оптимизированный просмотр): + - Формат и качество: image/webp, quality=85. + - Геометрия: пропорциональное масштабирование с вписыванием в рамку 12801280 пикселей (без апскейла) +3. crop (квадратная миниатюра/аватар): + - Формат и качество: image/jpeg, quality=85, optimize=True. + - Геометрия: центральное квадратное кадрирование с последующим приведением к точному размеру 128128 пикселей -TODO: гипотеза, hardware/лимиты, версии, объём данных, профиль нагрузки, concurrency/arrival rate, длительность/прогрев, повторы, успешные RPS, ошибки, p50/p95/p99, CPU/RAM. Сохранить raw summary без tokens и объяснить ограничения измерения. -| Воздействие | Что ожидаем | Что наблюдали | Время восстановления / потеря данных | -| --- | --- | --- | --- | -| TODO | TODO | TODO | TODO | +## Отказоустойчивость, ретраи и восстановление -## Ограничения и следующие шаги +Для обеспечения надежности уровня на оценку 4 реализованы следующие механизмы: -TODO: какие отказы выдерживаются и какие нет; что не реализовано; где учебное упрощение; какое улучшение подтверждено, а какое пока гипотеза. +- Разделение ошибок (Permanent / Transient): + - Постоянные ошибки сразу переводят вложение в терминальный статус failed с соответствующим error_code и подтверждаются в брокере без бесполезных повторов + - Временные ошибки обрабатываются с повторами до 5 раз +- Exponential Backoff + Jitter: + - Перед постановкой следующей попытки ыполняется задержка для предотвращения лавинообразной нагрузки на S3/БД +- Dead Letter Queue (DLQ) и ручной Replay: + - При исчерпании попыток вложение получает статус failed, а сообщение перекладывается в отдельный стрим attachment_jobs_dlq + - Реализован эндпоинт POST /api/v1/attachments/{attachment_id}/replay, который сбрасывает счетчик попыток, переводит статус обратно в queued и транзакционно создает новую задачу в outbox +- Защита от зависаний: + - Каждая задача ограничена по времени выполнения (30 секунд). + - Фоновый цикл воркера каждые 15 секунд вызывает XAUTOCLAIM, перехватывая зависшие сообщения от упавших экземпляров воркеров +- Очистка временного хранилища: + - Воркер периодически (раз в 10 минут) сканирует префикс staging/ в S3 и удаляет осиротевшие объекты старше 1 часа. + +## Результаты проверки и артефакты + +1. Контрактные и функциональные тесты: + - scripts/check_contract.py — подтверждено соответствие спецификации OpenAPI, наличие заголовков X-Request-Id и X-Instance-Id + - tests/smoke.py (evidence/smoke.txt) — пройден полный публичный сценарий +2. Демонстрация асинхронности и переживания рестартов: + - При остановленном контейнере worker (demo-01c-worker-stopped.txt) загружен файл sample.png (9becbd32-e413-417a-8762-79bcc195e296), получен ответ 202 Accepted со статусом queued (demo-02-uppload-202.json). + - Выполнены рестарты API-реплик (demo-04-api-restarted.txt) и брокера Redis (demo-08-after-broker-restart.json). + - После запуска воркера (demo-05-worker-started.txt) задача успешно обработана из персистентной очереди, статус перешел в ready (demo-06-ready.json), а вариант thumbnail корректно отдан клиенту (demo-07-thumbnail.jpg). +3. Артефакты расширенного пайплайна: + - Сформированы и верифицированы все три варианта (g4-variants.txt, g4-thunbnail.jpg, g4-crop.jpg) с корректными MIME-типами (image/jpeg, image/webp) и размерами \ No newline at end of file diff --git a/app.py b/app.py new file mode 100644 index 00000000..fb41f90d --- /dev/null +++ b/app.py @@ -0,0 +1,1010 @@ +import os +import time +import base64 +import secrets +import uuid +import json +import re +import struct +import hashlib +import hmac +from datetime import datetime, timezone, timedelta +from typing import List, Optional +from uuid import UUID + +import psycopg2 +import psycopg2.extras +psycopg2.extras.register_uuid() +import bcrypt +from fastapi import FastAPI, Header, HTTPException, Query, Response, Request +from fastapi.exceptions import RequestValidationError +from fastapi.responses import JSONResponse +from pydantic import BaseModel, Field, field_validator, model_validator, ConfigDict + +import redis +import boto3 +from botocore.client import Config + +import threading + +app = FastAPI(title="MTUSI Messenger — lab5", version="1.5.0") + +def outbox_publisher(): + while True: + conn = None + try: + conn = get_db_connection() + with conn.cursor() as cur: + cur.execute(""" + SELECT id, stream, payload FROM outbox + WHERE published_at IS NULL + ORDER BY created_at + LIMIT 100 + FOR UPDATE SKIP LOCKED + """) + for row in cur.fetchall(): + redis_client.xadd(row["stream"], {"payload": json.dumps(row["payload"])}) + cur.execute("UPDATE outbox SET published_at=NOW() WHERE id=%s", (row["id"],)) + conn.commit() + except Exception as e: + print(f"OUTBOX PUBLISHER ERROR: {type(e).__name__} - {e}", flush=True) + finally: + if conn is not None and not conn.closed: + conn.close() + time.sleep(1) + +@app.on_event("startup") +def _start_outbox_publisher(): + threading.Thread(target=outbox_publisher, daemon=True).start() + +DATABASE_URL = os.getenv("DATABASE_URL", "postgresql://postgres:postgres@postgres:5432/messenger") +SESSION_TTL_SECONDS = int(os.getenv("SESSION_TTL_SECONDS", "3600")) +INSTANCE_ID = os.getenv("INSTANCE_ID", "instance-1") + +REDIS_URL = os.getenv("REDIS_URL", "redis://redis:6379/0") +redis_client = redis.Redis.from_url(REDIS_URL, decode_responses=True) + +SECRET_HMAC_KEY = os.environ["SECRET_HMAC_KEY"] + +S3_ENDPOINT = os.getenv("S3_ENDPOINT", "http://s3:8333") +S3_BUCKET = os.getenv("S3_BUCKET", "messenger-attachments") +S3_ACCESS_KEY = os.getenv("S3_ACCESS_KEY_ID", "appuser") +S3_SECRET_KEY = os.getenv("S3_SECRET_ACCESS_KEY", "appsecretpassword") + +STREAM_NAME = os.getenv("BROKER_STREAM", "attachment_jobs") + +s3_client = boto3.client( + "s3", + endpoint_url=S3_ENDPOINT, + aws_access_key_id=S3_ACCESS_KEY, + aws_secret_access_key=S3_SECRET_KEY, + config=Config(signature_version="s3v4"), + region_name="us-east-1" +) + +def get_db_connection(): + return psycopg2.connect(DATABASE_URL, cursor_factory=psycopg2.extras.RealDictCursor) + +def generate_request_id() -> str: + return uuid.uuid4().hex + +def make_error_response( + status_code: int, + code: str, + message: str, + req_id: str, + extra_headers: Optional[dict] = None, +) -> JSONResponse: + headers = {"X-Request-Id": req_id, "X-Instance-Id": INSTANCE_ID} + if extra_headers: + headers.update(extra_headers) + return JSONResponse( + status_code=status_code, + headers=headers, + content={ + "error": { + "code": code, + "message": message, + "request_id": req_id, + } + }, + ) + +def encode_cursor(chat_id: str, created_at: str, msg_id: str) -> str: + payload = f"{chat_id}|{created_at}|{msg_id}" + signature = hmac.new(SECRET_HMAC_KEY.encode(), payload.encode(), hashlib.sha256).hexdigest()[:16] + raw = f"{payload}|{signature}" + return base64.urlsafe_b64encode(raw.encode()).decode() + +def decode_cursor(cursor: str, expected_chat_id: str) -> tuple: + try: + decoded = base64.urlsafe_b64decode(cursor.encode()).decode() + parts = decoded.split("|") + if len(parts) != 4: + raise ValueError() + chat_id, created_at, msg_id, signature = parts + + if chat_id != expected_chat_id: + raise HTTPException(status_code=400, detail="Cursor belongs to another chat") + + expected_sig = hmac.new( + SECRET_HMAC_KEY.encode(), + f"{chat_id}|{created_at}|{msg_id}".encode(), + hashlib.sha256 + ).hexdigest()[:16] + if not hmac.compare_digest(signature, expected_sig): + raise ValueError() + + return created_at, msg_id + except HTTPException: + raise + except Exception: + raise HTTPException(status_code=400, detail="Invalid cursor format") + +@app.exception_handler(RequestValidationError) +async def validation_exception_handler(request: Request, exc: RequestValidationError): + req_id = request.headers.get("X-Request-Id") or generate_request_id() + return make_error_response( + status_code=400, + code="invalid_request", + message="Validation error in request body or parameters", + req_id=req_id + ) + +@app.exception_handler(HTTPException) +async def http_exception_handler(request: Request, exc: HTTPException): + req_id = request.headers.get("X-Request-Id") or generate_request_id() + headers = {"X-Request-Id": req_id, "X-Instance-Id": INSTANCE_ID} + if exc.headers: + headers.update(exc.headers) + + detail = exc.detail + if isinstance(detail, dict) and "error" in detail: + detail["error"]["request_id"] = req_id + return JSONResponse(status_code=exc.status_code, headers=headers, content=detail) + + code_map = { + 400: "invalid_request", + 401: "unauthorized", + 404: "not_found", + 409: "conflict", + 413: "payload_too_large", + 415: "unsupported_media_type", + 429: "rate_limited", + 503: "unavailable", + 500: "internal_error", + } + return JSONResponse( + status_code=exc.status_code, + headers=headers, + content={ + "error": { + "code": code_map.get(exc.status_code, "internal_error"), + "message": str(detail), + "request_id": req_id, + } + }, + ) + +@app.exception_handler(Exception) +async def unhandled_exception_handler(request: Request, exc: Exception): + req_id = request.headers.get("X-Request-Id") or generate_request_id() + return make_error_response( + status_code=500, + code="internal_error", + message="Internal server error", + req_id=req_id, + ) + +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") + def not_blank(cls, v): + if not v.strip(): + raise ValueError("Must not be blank") + return v + +class CreateChat(BaseModel): + model_config = ConfigDict(extra='forbid') + title: str = Field(..., min_length=1, max_length=100) + member_ids: List[uuid.UUID] = Field(..., min_length=1, max_length=100) + + @field_validator("title") + def not_blank(cls, v): + if not v.strip(): + raise ValueError("Must not be blank") + return v + +class CreateMessage(BaseModel): + model_config = ConfigDict(extra='forbid') + text: str = Field(default="", max_length=4000) + attachment_ids: List[uuid.UUID] = Field(default=[], max_length=10) + + @model_validator(mode="after") + def check_content(self) -> 'CreateMessage': + if not self.text.strip() and not self.attachment_ids: + raise ValueError("Message must contain either text or attachments") + return self + +@app.get("/health/live") +def health_live(response: Response): + req_id = generate_request_id() + response.headers["X-Request-Id"] = req_id + response.headers["X-Instance-Id"] = INSTANCE_ID + return {"status": "ok"} + +@app.get("/health/ready") +def health_ready(response: Response): + req_id = generate_request_id() + response.headers["X-Request-Id"] = req_id + response.headers["X-Instance-Id"] = INSTANCE_ID + try: + conn = get_db_connection() + conn.close() + redis_client.ping() + s3_client.head_bucket(Bucket=S3_BUCKET) + except Exception: + raise HTTPException(status_code=503, detail="Database, Redis or S3 unavailable") + return {"status": "ok"} + +@app.post("/api/v1/users", status_code=201) +def register_user(body: CreateUser, response: Response): + req_id = generate_request_id() + response.headers["X-Request-Id"] = req_id + response.headers["X-Instance-Id"] = INSTANCE_ID + + password_hash = bcrypt.hashpw(body.password.encode('utf-8'), bcrypt.gensalt()).decode('utf-8') + user_id = str(uuid.uuid4()) + created_at = datetime.now(timezone.utc).isoformat().replace("+00:00", "Z") + + conn = get_db_connection() + try: + with conn.cursor() as cur: + cur.execute( + "INSERT INTO users (id, username, display_name, password_hash, created_at) VALUES (%s, %s, %s, %s, %s)", + (user_id, body.username, body.display_name, password_hash, created_at) + ) + conn.commit() + except psycopg2.errors.UniqueViolation: + conn.rollback() + raise HTTPException( + status_code=409, + detail={"error": {"code": "conflict", "message": "Username already taken", "request_id": req_id}} + ) + finally: + conn.close() + + return { + "id": user_id, + "username": body.username, + "display_name": body.display_name, + "created_at": created_at + } + +@app.post("/api/v1/auth/sessions", status_code=201) +def create_session(authorization: Optional[str] = Header(None), response: Response = None): + req_id = generate_request_id() + response.headers["X-Request-Id"] = req_id + response.headers["X-Instance-Id"] = INSTANCE_ID + + if not authorization or not authorization.startswith("Basic "): + raise HTTPException( + status_code=401, + detail="Missing or invalid basic auth", + headers={"WWW-Authenticate": 'Basic realm="messenger", charset="UTF-8"'} + ) + + try: + encoded = authorization.split(" ")[1] + decoded = base64.b64decode(encoded).decode("utf-8") + username, password = decoded.split(":", 1) + except Exception: + raise HTTPException( + status_code=401, + detail="Invalid credentials format", + headers={"WWW-Authenticate": 'Basic realm="messenger", charset="UTF-8"'} + ) + + conn = get_db_connection() + with conn.cursor() as cur: + cur.execute("SELECT * FROM users WHERE username = %s", (username,)) + user = cur.fetchone() + conn.close() + + if not user or not bcrypt.checkpw(password.encode('utf-8'), user['password_hash'].encode('utf-8')): + raise HTTPException( + status_code=401, + detail="Invalid credentials", + headers={"WWW-Authenticate": 'Basic realm="messenger", charset="UTF-8"'} + ) + + token = secrets.token_urlsafe(48) + redis_client.setex(f"session:{token}", SESSION_TTL_SECONDS, str(user['id'])) + expires_at = datetime.now(timezone.utc) + timedelta(seconds=SESSION_TTL_SECONDS) + expires_at_str = expires_at.isoformat().replace("+00:00", "Z") + + return { + "token": token, + "token_type": "Bearer", + "expires_at": expires_at_str, + "user": { + "id": str(user['id']), + "username": user['username'], + "display_name": user['display_name'], + "created_at": user['created_at'].isoformat().replace("+00:00", "Z") if isinstance(user['created_at'], datetime) else user['created_at'] + } + } + +def get_current_user_from_token(authorization: Optional[str] = Header(None)) -> dict: + if not authorization or not authorization.startswith("Bearer "): + raise HTTPException( + status_code=401, + detail="Missing or invalid bearer token", + headers={"WWW-Authenticate": 'Bearer realm="messenger"'} + ) + token = authorization.split(" ")[1] + + try: + user_id = redis_client.get(f"session:{token}") + except Exception: + raise HTTPException(status_code=503, detail="Session store unavailable") + + if not user_id: + raise HTTPException( + status_code=401, + detail="Invalid or expired session token", + headers={"WWW-Authenticate": 'Bearer realm="messenger"'} + ) + + conn = get_db_connection() + with conn.cursor() as cur: + cur.execute("SELECT * FROM users WHERE id = %s", (user_id,)) + row = cur.fetchone() + conn.close() + + if not row: + raise HTTPException( + status_code=401, + detail="User not found", + headers={"WWW-Authenticate": 'Bearer realm="messenger"'} + ) + + return { + "id": str(row['id']), + "username": row['username'], + "display_name": row['display_name'], + "created_at": row['created_at'].isoformat().replace("+00:00", "Z") if isinstance(row['created_at'], datetime) else row['created_at'] + } + +@app.delete("/api/v1/auth/sessions/current", status_code=204) +def revoke_session(authorization: Optional[str] = Header(None)): + req_id = generate_request_id() + + if not authorization or not authorization.startswith("Bearer "): + raise HTTPException( + status_code=401, + detail="Unauthorized", + headers={"WWW-Authenticate": 'Bearer realm="messenger"'} + ) + + token = authorization.split(" ")[1] + deleted = redis_client.delete(f"session:{token}") + + if not deleted: + raise HTTPException( + status_code=401, + detail="Invalid session token", + headers={"WWW-Authenticate": 'Bearer realm="messenger"'} + ) + + return Response( + status_code=204, + headers={ + "X-Request-Id": req_id, + "X-Instance-Id": INSTANCE_ID + }, + ) + +@app.get("/api/v1/users/me") +def current_user(response: Response, authorization: Optional[str] = Header(None)): + req_id = generate_request_id() + response.headers["X-Request-Id"] = req_id + response.headers["X-Instance-Id"] = INSTANCE_ID + return get_current_user_from_token(authorization) + +@app.post("/api/v1/chats", status_code=201) +def create_chat(body: CreateChat, response: Response, authorization: Optional[str] = Header(None)): + req_id = generate_request_id() + response.headers["X-Request-Id"] = req_id + response.headers["X-Instance-Id"] = INSTANCE_ID + user = get_current_user_from_token(authorization) + + member_ids_str = [str(mid) for mid in body.member_ids] + + if user["id"] not in member_ids_str: + raise HTTPException(status_code=400, detail="Caller must be in member_ids") + if len(member_ids_str) != len(set(member_ids_str)): + raise HTTPException(status_code=400, detail="Duplicate member IDs") + + conn = get_db_connection() + with conn.cursor() as cur: + for mid_str in member_ids_str: + cur.execute("SELECT id FROM users WHERE id = %s", (mid_str,)) + if not cur.fetchone(): + conn.close() + raise HTTPException(status_code=400, detail=f"User {mid_str} not found") + + chat_id = str(uuid.uuid4()) + created_at = datetime.now(timezone.utc).isoformat().replace("+00:00", "Z") + + try: + with conn.cursor() as cur: + cur.execute( + "INSERT INTO chats (id, title, created_at) VALUES (%s, %s, %s)", + (chat_id, body.title, created_at) + ) + for mid_str in member_ids_str: + cur.execute( + "INSERT INTO chat_members (chat_id, user_id) VALUES (%s, %s)", + (chat_id, mid_str) + ) + conn.commit() + except Exception: + conn.rollback() + conn.close() + raise HTTPException(status_code=500, detail="Internal error creating chat") + conn.close() + + return { + "id": chat_id, + "title": body.title, + "member_ids": member_ids_str, + "created_at": created_at + } + +@app.get("/api/v1/chats") +def list_chats(limit: int = 50, cursor: Optional[str] = None, response: Response = None, authorization: Optional[str] = Header(None)): + req_id = generate_request_id() + response.headers["X-Request-Id"] = req_id + response.headers["X-Instance-Id"] = INSTANCE_ID + user = get_current_user_from_token(authorization) + + if limit < 1 or limit > 100: + raise HTTPException(status_code=400, detail="Invalid limit") + + conn = get_db_connection() + with conn.cursor() as cur: + cur.execute(""" + SELECT c.id, c.title, c.created_at FROM chats c + JOIN chat_members cm ON c.id = cm.chat_id + WHERE cm.user_id = %s + ORDER BY c.created_at ASC, c.id ASC + """, (user["id"],)) + rows = cur.fetchall() + + user_chats = [] + for r in rows: + cur.execute("SELECT user_id FROM chat_members WHERE chat_id = %s", (r['id'],)) + m_rows = cur.fetchall() + user_chats.append({ + "id": str(r['id']), + "title": r['title'], + "member_ids": [str(m['user_id']) for m in m_rows], + "created_at": r['created_at'].isoformat().replace("+00:00", "Z") if isinstance(r['created_at'], datetime) else r['created_at'] + }) + conn.close() + + start_idx = 0 + if cursor: + try: + parts = cursor.split("_") + c_time, c_id = parts[0], parts[1] + found = False + for idx, c in enumerate(user_chats): + if (c["created_at"], c["id"]) >= (c_time, c_id): + start_idx = idx if (c["created_at"], c["id"]) > (c_time, c_id) else idx + 1 + found = True + break + if not found: + start_idx = len(user_chats) + except Exception: + raise HTTPException(status_code=400, detail="Invalid cursor format") + + page_items = user_chats[start_idx:start_idx + limit] + next_cursor = None + if start_idx + limit < len(user_chats): + last = page_items[-1] + next_cursor = f"{last['created_at']}_{last['id']}" + + return {"items": page_items, "next_cursor": next_cursor} + +@app.get("/api/v1/chats/{chat_id}") +def get_chat(chat_id: UUID, response: Response, authorization: Optional[str] = Header(None)): + req_id = generate_request_id() + response.headers["X-Request-Id"] = req_id + response.headers["X-Instance-Id"] = INSTANCE_ID + user = get_current_user_from_token(authorization) + + chat_id_str = str(chat_id) + conn = get_db_connection() + with conn.cursor() as cur: + cur.execute(""" + SELECT c.* FROM chats c + JOIN chat_members cm ON c.id = cm.chat_id + WHERE c.id = %s AND cm.user_id = %s + """, (chat_id_str, user["id"])) + chat = cur.fetchone() + if chat: + cur.execute("SELECT user_id FROM chat_members WHERE chat_id = %s", (chat_id_str,)) + members = cur.fetchall() + conn.close() + + if not chat: + raise HTTPException(status_code=404, detail="Chat not found") + + return { + "id": str(chat['id']), + "title": chat['title'], + "member_ids": [str(m['user_id']) for m in members], + "created_at": chat['created_at'].isoformat().replace("+00:00", "Z") if isinstance(chat['created_at'], datetime) else chat['created_at'] + } + +def validate_image_and_get_dimensions(data: bytes, content_type: str): + if len(data) > 10 * 1024 * 1024: + raise HTTPException(status_code=413, detail="Payload too large (>10 MiB)") + + width, height = 0, 0 + if content_type == "image/png": + if not data.startswith(b'\x89PNG\r\n\x1a\n'): + raise HTTPException(status_code=415, detail="Invalid PNG signature") + if len(data) < 33: + raise HTTPException(status_code=415, detail="Truncated PNG") + if data[12:16] != b'IHDR': + raise HTTPException(status_code=415, detail="PNG missing IHDR chunk") + ihdr_len = struct.unpack('>I', data[8:12])[0] + if ihdr_len != 13: + raise HTTPException(status_code=415, detail="Invalid IHDR length") + width, height = struct.unpack('>II', data[16:24]) + elif content_type == "image/jpeg": + if not data.startswith(b'\xff\xd8'): + raise HTTPException(status_code=415, detail="Invalid JPEG signature") + i = 2 + while i < len(data) - 9: + marker = data[i] + if marker == 0xff: + marker_type = data[i+1] + if 0xc0 <= marker_type <= 0xc3: + height, width = struct.unpack('>HH', data[i+5:i+9]) + break + if marker_type in {0xd8, 0xd9} or (0xd0 <= marker_type <= 0xd7): + i += 2 + continue + seg_len = struct.unpack('>H', data[i+2:i+4])[0] + if seg_len < 2: + raise HTTPException(status_code=415, detail="Invalid JPEG segment") + i += 2 + seg_len + else: + i += 1 + else: + raise HTTPException(status_code=415, detail="Unsupported media type") + + if width == 0 or height == 0: + raise HTTPException(status_code=415, detail="Could not read image dimensions") + + if width * height > 40_000_000: + raise HTTPException(status_code=413, detail="Image exceeds 40 million pixels limit") + +@app.post("/api/v1/chats/{chat_id}/attachments", status_code=202) +async def upload_attachment( + chat_id: UUID, + filename: str = Query(..., min_length=1, max_length=255), + request: Request = None, + response: Response = None, + authorization: Optional[str] = Header(None) +): + req_id = generate_request_id() + response.headers["X-Request-Id"] = req_id + response.headers["X-Instance-Id"] = INSTANCE_ID + user = get_current_user_from_token(authorization) + chat_id_str = str(chat_id) + + conn = get_db_connection() + with conn.cursor() as cur: + cur.execute( + "SELECT 1 FROM chat_members WHERE chat_id = %s AND user_id = %s", + (chat_id_str, user["id"]) + ) + if not cur.fetchone(): + conn.close() + raise HTTPException(status_code=404, detail="Chat not found or inaccessible") + conn.close() + + if any(ord(c) < 0x20 or ord(c) == 0x7f for c in filename) or '/' in filename or '\\' in filename: + raise HTTPException(status_code=400, detail="Invalid filename") + + content_type = request.headers.get("content-type") + if content_type not in ["image/png", "image/jpeg"]: + raise HTTPException(status_code=415, detail="Unsupported media type") + + MAX_UPLOAD = 10 * 1024 * 1024 + cl = request.headers.get("content-length") + if cl is not None: + try: + if int(cl) > MAX_UPLOAD: + raise HTTPException(status_code=413, detail="Payload too large (>10 MiB)") + except ValueError: + raise HTTPException(status_code=400, detail="Invalid Content-Length") + + chunks = [] + total = 0 + async for chunk in request.stream(): + total += len(chunk) + if total > MAX_UPLOAD: + raise HTTPException(status_code=413, detail="Payload too large (>10 MiB)") + chunks.append(chunk) + body_bytes = b"".join(chunks) + + validate_image_and_get_dimensions(body_bytes, content_type) + + size_bytes = len(body_bytes) + sha256_hash = hashlib.sha256(body_bytes).hexdigest() + attachment_id = str(uuid.uuid4()) + job_id = str(uuid.uuid4()) + now = datetime.now(timezone.utc).isoformat().replace("+00:00", "Z") + + staging_key = f"staging/{chat_id_str}/{attachment_id}/original" + try: + s3_client.put_object( + Bucket=S3_BUCKET, + Key=staging_key, + Body=body_bytes, + ContentType=content_type + ) + except Exception: + raise HTTPException(status_code=503, detail="S3 storage unavailable") + + job_payload = { + "schema_version": 1, + "job_id": job_id, + "type": "attachment.process.v1", + "attachment_id": attachment_id, + "pipeline_version": 1, + "attempt": 1, + "created_at": now + } + + conn = get_db_connection() + try: + with conn.cursor() as cur: + cur.execute(""" + INSERT INTO attachments ( + id, chat_id, owner_id, filename, content_type, + size_bytes, sha256, status, variants, error_code, + pipeline_version, attempt, created_at, updated_at + ) + VALUES (%s, %s, %s, %s, %s, %s, %s, 'queued', '[]', NULL, 1, 0, %s, %s) + """, (attachment_id, chat_id_str, user["id"], filename, + content_type, size_bytes, sha256_hash, now, now)) + + cur.execute( + "INSERT INTO outbox (id, stream, payload, created_at) " + "VALUES (%s, %s, %s::jsonb, %s)", + (str(uuid.uuid4()), STREAM_NAME, json.dumps(job_payload), now) + ) + conn.commit() + except Exception: + conn.rollback() + raise HTTPException(status_code=500, detail="Internal error saving attachment") + finally: + if not conn.closed: + conn.close() + + return { + "id": attachment_id, + "chat_id": chat_id_str, + "owner_id": user["id"], + "filename": filename, + "content_type": content_type, + "size_bytes": size_bytes, + "sha256": sha256_hash, + "status": "queued", + "variants": [], + "error_code": None, + "created_at": now, + "updated_at": now + } + +@app.get("/api/v1/attachments/{attachment_id}") +def get_attachment(attachment_id: UUID, response: Response, authorization: Optional[str] = Header(None)): + req_id = generate_request_id() + response.headers["X-Request-Id"] = req_id + response.headers["X-Instance-Id"] = INSTANCE_ID + user = get_current_user_from_token(authorization) + att_id_str = str(attachment_id) + + conn = get_db_connection() + with conn.cursor() as cur: + cur.execute(""" + SELECT a.* FROM attachments a + JOIN chat_members cm ON a.chat_id = cm.chat_id + WHERE a.id = %s AND cm.user_id = %s + """, (att_id_str, user["id"])) + row = cur.fetchone() + conn.close() + + if not row: + raise HTTPException(status_code=404, detail="Attachment not found or inaccessible") + + return { + "id": str(row['id']), + "chat_id": str(row['chat_id']), + "owner_id": str(row['owner_id']), + "filename": row['filename'], + "content_type": row['content_type'], + "size_bytes": row['size_bytes'], + "sha256": row['sha256'], + "status": row['status'], + "variants": row['variants'], + "error_code": row['error_code'], + "created_at": row['created_at'].isoformat().replace("+00:00", "Z") if isinstance(row['created_at'], datetime) else row['created_at'], + "updated_at": row['updated_at'].isoformat().replace("+00:00", "Z") if isinstance(row['updated_at'], datetime) else row['updated_at'] + } + +@app.get("/api/v1/attachments/{attachment_id}/content") +def download_attachment( + attachment_id: UUID, + variant: str = Query("original", pattern="^(original|thumbnail|crop|optimized)$"), + response: Response = None, + authorization: Optional[str] = Header(None) +): + req_id = generate_request_id() + response.headers["X-Request-Id"] = req_id + response.headers["X-Instance-Id"] = INSTANCE_ID + user = get_current_user_from_token(authorization) + att_id_str = str(attachment_id) + + conn = get_db_connection() + with conn.cursor() as cur: + cur.execute(""" + SELECT a.* FROM attachments a + JOIN chat_members cm ON a.chat_id = cm.chat_id + WHERE a.id = %s AND cm.user_id = %s + """, (att_id_str, user["id"])) + row = cur.fetchone() + conn.close() + + if not row: + raise HTTPException(status_code=404, detail="Attachment not found or inaccessible") + + if row['status'] != 'ready': + raise HTTPException(status_code=409, detail=f"Attachment is in status '{row['status']}'") + + if variant == "original": + s3_key = f"attachments/{row['chat_id']}/{row['id']}/original" + media_type = row['content_type'] + else: + variants_list = row['variants'] or [] + matched = [v for v in variants_list if v.get("name") == variant] + if not matched: + raise HTTPException(status_code=404, detail=f"Variant '{variant}' not found") + s3_key = f"attachments/{row['chat_id']}/{row['id']}/{variant}" + media_type = matched[0]["content_type"] + + try: + obj = s3_client.get_object(Bucket=S3_BUCKET, Key=s3_key) + data = obj['Body'].read() + except Exception: + raise HTTPException(status_code=503, detail="S3 storage unavailable or object missing") + + return Response( + content=data, + media_type=media_type, + headers={ + "X-Request-Id": req_id, + "X-Instance-Id": INSTANCE_ID, + }, + ) + +@app.post("/api/v1/chats/{chat_id}/messages", status_code=201) +def create_message( + chat_id: UUID, + body: CreateMessage, + response: Response, + authorization: Optional[str] = Header(None), + idempotency_key: Optional[str] = Header(None, alias="Idempotency-Key") +): + req_id = generate_request_id() + response.headers["X-Request-Id"] = req_id + response.headers["X-Instance-Id"] = INSTANCE_ID + user = get_current_user_from_token(authorization) + + if not idempotency_key or not re.match(r"^[A-Za-z0-9._:-]{1,128}$", idempotency_key): + raise HTTPException(status_code=400, detail="Missing or invalid Idempotency-Key") + + chat_id_str = str(chat_id) + method = "POST" + path = f"/api/v1/chats/{chat_id_str}/messages" + + body_json_str = json.dumps(body.model_dump(mode='json'), sort_keys=True) + request_hash = hashlib.sha256(body_json_str.encode("utf-8")).hexdigest() + + conn = get_db_connection() + try: + with conn.cursor() as cur: + cur.execute( + "SELECT 1 FROM chat_members WHERE chat_id = %s AND user_id = %s", + (chat_id_str, user["id"]) + ) + if not cur.fetchone(): + conn.close() + raise HTTPException(status_code=404, detail="Chat not found") + + attachment_ids_str = [str(aid) for aid in body.attachment_ids] + if attachment_ids_str: + cur.execute(""" + SELECT id, status FROM attachments + WHERE id = ANY(%s::uuid[]) AND chat_id = %s + """, (attachment_ids_str, chat_id_str)) + found_atts = cur.fetchall() + if len(found_atts) != len(attachment_ids_str): + conn.close() + raise HTTPException(status_code=404, detail="One or more attachments not found or in another chat") + for att in found_atts: + if att['status'] == 'failed': + conn.close() + raise HTTPException(status_code=409, detail="Cannot attach failed attachment") + + msg_id = str(uuid.uuid4()) + created_at = datetime.now(timezone.utc).isoformat().replace("+00:00", "Z") + + msg_response = { + "id": msg_id, + "chat_id": chat_id_str, + "sender_id": user["id"], + "text": body.text, + "created_at": created_at, + "attachment_ids": attachment_ids_str + } + + cur.execute(""" + INSERT INTO idempotency_keys (user_id, method, path, key, request_hash, response_status, response_body) + VALUES (%s, %s, %s, %s, %s, %s, %s) + ON CONFLICT (user_id, method, path, key) DO NOTHING + """, (user["id"], method, path, idempotency_key, request_hash, 201, json.dumps(msg_response))) + + if cur.rowcount == 0: + cur.execute(""" + SELECT request_hash, response_status, response_body + FROM idempotency_keys + WHERE user_id = %s AND method = %s AND path = %s AND key = %s + """, (user["id"], method, path, idempotency_key)) + row = cur.fetchone() + conn.commit() + conn.close() + + if row["request_hash"] != request_hash: + raise HTTPException(status_code=409, detail="Idempotency key conflict with different payload") + + return row["response_body"] + + cur.execute( + "INSERT INTO messages (id, chat_id, sender_id, text, created_at, attachment_ids) VALUES (%s, %s, %s, %s, %s, %s::uuid[])", + (msg_id, chat_id_str, user["id"], body.text, created_at, attachment_ids_str) + ) + conn.commit() + except HTTPException: + raise + except Exception: + conn.rollback() + conn.close() + raise HTTPException(status_code=500, detail="Internal error processing message") + finally: + if not conn.closed: + conn.close() + + return msg_response + +@app.get("/api/v1/chats/{chat_id}/messages") +def list_messages(chat_id: UUID, limit: int = 50, cursor: Optional[str] = None, + response: Response = None, authorization: Optional[str] = Header(None)): + req_id = generate_request_id() + response.headers["X-Request-Id"] = req_id + response.headers["X-Instance-Id"] = INSTANCE_ID + user = get_current_user_from_token(authorization) + chat_id_str = str(chat_id) + + conn = get_db_connection() + with conn.cursor() as cur: + cur.execute("SELECT 1 FROM chat_members WHERE chat_id=%s AND user_id=%s", + (chat_id_str, user["id"])) + if not cur.fetchone(): + conn.close() + raise HTTPException(status_code=404, detail="Chat not found") + + if limit < 1 or limit > 100: + conn.close() + raise HTTPException(status_code=400, detail="Invalid limit") + + query = "SELECT id, chat_id, sender_id, text, created_at, attachment_ids FROM messages WHERE chat_id=%s" + params = [chat_id_str] + if cursor: + c_time, c_id = decode_cursor(cursor, chat_id_str) + query += " AND (created_at, id) > (%s, %s)" + params.extend([c_time, c_id]) + query += " ORDER BY created_at ASC, id ASC LIMIT %s" + params.append(limit + 1) + + with conn.cursor() as cur: + cur.execute(query, tuple(params)) + rows = cur.fetchall() + conn.close() + + has_next = len(rows) > limit + page_items = rows[:limit] + + formatted = [] + for m in page_items: + raw = m.get('attachment_ids') + atts = [str(a) for a in raw if a] if raw else [] + formatted.append({ + "id": str(m['id']), "chat_id": str(m['chat_id']), + "sender_id": str(m['sender_id']), "text": m['text'], + "created_at": m['created_at'].isoformat().replace("+00:00", "Z") + if isinstance(m['created_at'], datetime) else m['created_at'], + "attachment_ids": atts + }) + + next_cursor = None + if has_next and formatted: + last = formatted[-1] + next_cursor = encode_cursor(chat_id_str, last['created_at'], last['id']) + + return {"items": formatted, "next_cursor": next_cursor} + +@app.post("/api/v1/attachments/{attachment_id}/replay", status_code=202) +def replay_attachment(attachment_id: UUID, response: Response, + authorization: Optional[str] = Header(None)): + req_id = generate_request_id() + response.headers["X-Request-Id"] = req_id + response.headers["X-Instance-Id"] = INSTANCE_ID + user = get_current_user_from_token(authorization) + att_id = str(attachment_id) + + conn = get_db_connection() + try: + with conn.cursor() as cur: + cur.execute(""" + SELECT a.* FROM attachments a + JOIN chat_members cm ON a.chat_id = cm.chat_id + WHERE a.id=%s AND cm.user_id=%s + """, (att_id, user["id"])) + row = cur.fetchone() + if not row: + conn.close() + raise HTTPException(status_code=404, detail="Attachment not found") + if row["status"] != "failed": + conn.close() + raise HTTPException(status_code=409, detail="Only failed attachments can be replayed") + + now = datetime.now(timezone.utc).isoformat().replace("+00:00", "Z") + cur.execute(""" + UPDATE attachments SET status='queued', attempt=0, error_code=NULL, updated_at=%s + WHERE id=%s + """, (now, att_id)) + + job = {"schema_version": 1, "job_id": str(uuid.uuid4()), + "type": "attachment.process.v1", "attachment_id": att_id, + "pipeline_version": 1, "attempt": 1, "created_at": now} + cur.execute("INSERT INTO outbox (id, stream, payload, created_at) " + "VALUES (%s, %s, %s::jsonb, %s)", + (str(uuid.uuid4()), STREAM_NAME, json.dumps(job), now)) + conn.commit() + finally: + if not conn.closed: + conn.close() + + return {"id": att_id, "status": "queued"} \ No newline at end of file diff --git a/compose.yaml b/compose.yaml new file mode 100644 index 00000000..e4822cac --- /dev/null +++ b/compose.yaml @@ -0,0 +1,218 @@ +services: + postgres: + image: postgres:15.5-alpine3.19 + environment: + POSTGRES_DB: messenger + POSTGRES_USER: postgres + POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:?set POSTGRES_PASSWORD in .env} + volumes: + - pgdata:/var/lib/postgresql/data + deploy: + resources: + limits: + cpus: '0.50' + memory: 512M + reservations: + cpus: '0.10' + memory: 128M + healthcheck: + test: ["CMD-SHELL", "pg_isready -U postgres -d messenger"] + interval: 3s + timeout: 3s + retries: 5 + + redis: + image: redis:7.2.4-alpine + command: redis-server --appendonly yes --appendfsync everysec --loglevel warning + volumes: + - redisdata:/data + deploy: + resources: + limits: + cpus: '0.25' + memory: 256M + healthcheck: + test: ["CMD", "redis-cli", "ping"] + interval: 3s + timeout: 3s + retries: 5 + + migrate: + image: postgres:15.5-alpine3.19 + environment: + PGPASSWORD: ${POSTGRES_PASSWORD} + volumes: + - ./migrations:/migrations + command: > + sh -c "until pg_isready -h postgres -U postgres; do sleep 1; done; + psql -h postgres -U postgres -d messenger -f /migrations/init.sql" + depends_on: + postgres: + condition: service_healthy + restart: "no" + + s3: + image: chrislusf/seaweedfs:latest + command: ["server", "-s3", "-dir=/data", "-s3.port=8333"] + environment: + - AWS_ACCESS_KEY_ID=appuser + - AWS_SECRET_ACCESS_KEY=appsecretpassword + volumes: + - s3data:/data + deploy: + resources: + limits: + cpus: '0.50' + memory: 512M + healthcheck: + test: ["CMD-SHELL", "wget -q -O /dev/null http://127.0.0.1:8333/healthz || exit 1"] + interval: 5s + timeout: 3s + retries: 5 + start_period: 10s + + s3-init: + image: python:3.11.7-slim-bookworm + volumes: + - ./scripts:/scripts + - ./requirements.txt:/requirements.txt + environment: + - S3_ENDPOINT=http://s3:8333 + - S3_BUCKET=messenger-attachments + - S3_ROOT_ACCESS_KEY=appuser + - S3_ROOT_SECRET_KEY=appsecretpassword + command: > + sh -c "pip install --no-cache-dir -r /requirements.txt && + python /scripts/bootstrap_s3.py" + depends_on: + s3: + condition: service_healthy + restart: "no" + + api-1: + build: . + stop_grace_period: 15s + environment: + - DATABASE_URL=postgresql://postgres:${POSTGRES_PASSWORD:?set POSTGRES_PASSWORD in .env}@postgres:5432/messenger + - REDIS_URL=redis://redis:6379/0 + - SESSION_TTL_SECONDS=3600 + - INSTANCE_ID=api-replica-1 + - SECRET_HMAC_KEY=${SECRET_HMAC_KEY} + - S3_ENDPOINT=http://s3:8333 + - S3_BUCKET=messenger-attachments + - S3_ACCESS_KEY_ID=appuser + - S3_SECRET_ACCESS_KEY=appsecretpassword + - BROKER_STREAM=attachment_jobs + deploy: + resources: + limits: + cpus: '0.50' + memory: 256M + depends_on: + postgres: + condition: service_healthy + redis: + condition: service_healthy + migrate: + condition: service_completed_successfully + s3-init: + condition: service_completed_successfully + healthcheck: + test: ["CMD", "python", "-c", "import urllib.request; urllib.request.urlopen('http://localhost:8080/health/ready')"] + interval: 5s + timeout: 3s + retries: 3 + + api-2: + build: . + stop_grace_period: 15s + environment: + - DATABASE_URL=postgresql://postgres:${POSTGRES_PASSWORD:?set POSTGRES_PASSWORD in .env}@postgres:5432/messenger + - REDIS_URL=redis://redis:6379/0 + - SESSION_TTL_SECONDS=3600 + - INSTANCE_ID=api-replica-2 + - SECRET_HMAC_KEY=${SECRET_HMAC_KEY} + - S3_ENDPOINT=http://s3:8333 + - S3_BUCKET=messenger-attachments + - S3_ACCESS_KEY_ID=appuser + - S3_SECRET_ACCESS_KEY=appsecretpassword + - BROKER_STREAM=attachment_jobs + deploy: + resources: + limits: + cpus: '0.50' + memory: 256M + depends_on: + postgres: + condition: service_healthy + redis: + condition: service_healthy + migrate: + condition: service_completed_successfully + s3-init: + condition: service_completed_successfully + healthcheck: + test: ["CMD", "python", "-c", "import urllib.request; urllib.request.urlopen('http://localhost:8080/health/ready')"] + interval: 5s + timeout: 3s + retries: 3 + + worker: + build: . + command: ["python", "worker.py"] + stop_grace_period: 15s + environment: + - DATABASE_URL=postgresql://postgres:${POSTGRES_PASSWORD:?set POSTGRES_PASSWORD in .env}@postgres:5432/messenger + - REDIS_URL=redis://redis:6379/0 + - S3_ENDPOINT=http://s3:8333 + - S3_BUCKET=messenger-attachments + - S3_ACCESS_KEY_ID=appuser + - S3_SECRET_ACCESS_KEY=appsecretpassword + - BROKER_STREAM=attachment_jobs + - BROKER_GROUP=attachment_workers + - JOB_MAX_ATTEMPTS=5 + - MAX_IMAGE_PIXELS=40000000 + deploy: + resources: + limits: + cpus: '0.50' + memory: 256M + depends_on: + postgres: + condition: service_healthy + redis: + condition: service_healthy + migrate: + condition: service_completed_successfully + s3-init: + condition: service_completed_successfully + healthcheck: + test: ["CMD", "python", "-c", "import os, redis; redis.Redis.from_url(os.environ['REDIS_URL']).ping()"] + interval: 5s + timeout: 3s + retries: 3 + + nginx: + image: nginx:1.25.4-alpine + ports: + - "8080:8080" + volumes: + - ./nginx.conf:/etc/nginx/nginx.conf:ro + deploy: + resources: + limits: + cpus: '0.25' + memory: 128M + depends_on: + - api-1 + - api-2 + healthcheck: + test: ["CMD", "nginx", "-t"] + interval: 5s + timeout: 3s + retries: 3 + +volumes: + pgdata: + redisdata: + s3data: \ No newline at end of file diff --git a/evidence/demo-00-user.json b/evidence/demo-00-user.json new file mode 100644 index 00000000..cbfec116 --- /dev/null +++ b/evidence/demo-00-user.json @@ -0,0 +1,6 @@ +{ + "id": "fdeb71d4-ee4f-47a6-8968-ffc7740e5242", + "username": "demo_75866", + "display_name": "Demo User", + "created_at": "2026-11-16T13:43:38.059472Z" +} diff --git a/evidence/demo-01-session.json b/evidence/demo-01-session.json new file mode 100644 index 00000000..272e0cfe --- /dev/null +++ b/evidence/demo-01-session.json @@ -0,0 +1,11 @@ +{ + "token": "grSsHp1gJpFLckF14UT44obEonSGQRvP878JhLyCaNzM6PGBH1LwrdgZIFF8Zu8U", + "token_type": "Bearer", + "expires_at": "2026-11-16T14:43:38.850596Z", + "user": { + "id": "fdeb71d4-ee4f-47a6-8968-ffc7740e5242", + "username": "demo_75866", + "display_name": "Demo User", + "created_at": "2026-11-16T13:43:38.059472Z" + } +} diff --git a/evidence/demo-01b-chat.json b/evidence/demo-01b-chat.json new file mode 100644 index 00000000..23e24ac2 --- /dev/null +++ b/evidence/demo-01b-chat.json @@ -0,0 +1,8 @@ +{ + "id": "5db90ff5-9604-4853-b002-db4144868bcb", + "title": "Demo chat", + "member_ids": [ + "fdeb71d4-ee4f-47a6-8968-ffc7740e5242" + ], + "created_at": "2026-11-16T13:43:39.240968Z" +} diff --git a/evidence/demo-01c-worker-stopped.txt b/evidence/demo-01c-worker-stopped.txt new file mode 100644 index 00000000..e1b8d4b0 --- /dev/null +++ b/evidence/demo-01c-worker-stopped.txt @@ -0,0 +1,10 @@ +NAME IMAGE COMMAND SERVICE CREATED STATUS PORTS +mtusi2026lab5-api-1-1 mtusi2026lab5-api-1 "uvicorn app:app --hтАж" api-1 30 minutes ago Up 6 minutes (healthy) 8080/tcp +mtusi2026lab5-api-2-1 mtusi2026lab5-api-2 "uvicorn app:app --hтАж" api-2 30 minutes ago Up 6 minutes (healthy) 8080/tcp +mtusi2026lab5-migrate-1 postgres:15.5-alpine3.19 "docker-entrypoint.sтАж" migrate 30 minutes ago Exited (0) 5 minutes ago +mtusi2026lab5-nginx-1 nginx:1.25.4-alpine "/docker-entrypoint.тАж" nginx 30 minutes ago Up 25 minutes (healthy) 0.0.0.0:8080->8080/tcp, [::]:8080->8080/tcp +mtusi2026lab5-postgres-1 postgres:15.5-alpine3.19 "docker-entrypoint.sтАж" postgres 30 minutes ago Up 30 minutes (healthy) 5432/tcp +mtusi2026lab5-redis-1 redis:7.2.4-alpine "docker-entrypoint.sтАж" redis 30 minutes ago Up 4 minutes (healthy) 6379/tcp +mtusi2026lab5-s3-1 chrislusf/seaweedfs:latest "/entrypoint.sh servтАж" s3 30 minutes ago Up 30 minutes (healthy) 7333/tcp, 8080/tcp, 8333/tcp, 8888/tcp, 9333/tcp, 18080/tcp, 18888/tcp, 19333/tcp +mtusi2026lab5-s3-init-1 python:3.11.7-slim-bookworm "sh -c 'pip install тАж" s3-init 30 minutes ago Exited (0) 5 minutes ago +mtusi2026lab5-worker-1 mtusi2026lab5-worker "python worker.py" worker 30 minutes ago Exited (0) Less than a second ago diff --git a/evidence/demo-02-upload-202.json b/evidence/demo-02-upload-202.json new file mode 100644 index 00000000..4184ebb1 --- /dev/null +++ b/evidence/demo-02-upload-202.json @@ -0,0 +1 @@ +{"id":"9becbd32-e413-417a-8762-79bcc195e296","chat_id":"5db90ff5-9604-4853-b002-db4144868bcb","owner_id":"fdeb71d4-ee4f-47a6-8968-ffc7740e5242","filename":"sample.png","content_type":"image/png","size_bytes":111817,"sha256":"99ea7533c441f79cd630d15ce4d58d1ec4e06f6f0efb3b77a5c088305cd1bd75","status":"queued","variants":[],"error_code":null,"created_at":"2026-11-16T13:43:41.734766Z","updated_at":"2026-11-16T13:43:41.734766Z"} diff --git a/evidence/demo-03-message.json b/evidence/demo-03-message.json new file mode 100644 index 00000000..7518fdd9 --- /dev/null +++ b/evidence/demo-03-message.json @@ -0,0 +1,10 @@ +{ + "id": "74dc2e91-a901-4067-8993-da9d2cc4ca55", + "chat_id": "5db90ff5-9604-4853-b002-db4144868bcb", + "sender_id": "fdeb71d4-ee4f-47a6-8968-ffc7740e5242", + "text": "", + "created_at": "2026-11-16T13:43:42.100558Z", + "attachment_ids": [ + "9becbd32-e413-417a-8762-79bcc195e296" + ] +} diff --git a/evidence/demo-04-api-restarted.txt b/evidence/demo-04-api-restarted.txt new file mode 100644 index 00000000..c8ec13cf --- /dev/null +++ b/evidence/demo-04-api-restarted.txt @@ -0,0 +1,7 @@ +NAME IMAGE COMMAND SERVICE CREATED STATUS PORTS +mtusi2026lab5-api-1-1 mtusi2026lab5-api-1 "uvicorn app:app --hтАж" api-1 30 minutes ago Up Less than a second (health: starting) 8080/tcp +mtusi2026lab5-api-2-1 mtusi2026lab5-api-2 "uvicorn app:app --hтАж" api-2 30 minutes ago Up Less than a second (health: starting) 8080/tcp +mtusi2026lab5-nginx-1 nginx:1.25.4-alpine "/docker-entrypoint.тАж" nginx 30 minutes ago Up 25 minutes (healthy) 0.0.0.0:8080->8080/tcp, [::]:8080->8080/tcp +mtusi2026lab5-postgres-1 postgres:15.5-alpine3.19 "docker-entrypoint.sтАж" postgres 30 minutes ago Up 30 minutes (healthy) 5432/tcp +mtusi2026lab5-redis-1 redis:7.2.4-alpine "docker-entrypoint.sтАж" redis 30 minutes ago Up 4 minutes (healthy) 6379/tcp +mtusi2026lab5-s3-1 chrislusf/seaweedfs:latest "/entrypoint.sh servтАж" s3 30 minutes ago Up 30 minutes (healthy) 7333/tcp, 8080/tcp, 8333/tcp, 8888/tcp, 9333/tcp, 18080/tcp, 18888/tcp, 19333/tcp diff --git a/evidence/demo-05-worker-started.txt b/evidence/demo-05-worker-started.txt new file mode 100644 index 00000000..ce38db2d --- /dev/null +++ b/evidence/demo-05-worker-started.txt @@ -0,0 +1,10 @@ +NAME IMAGE COMMAND SERVICE CREATED STATUS PORTS +mtusi2026lab5-api-1-1 mtusi2026lab5-api-1 "uvicorn app:app --hтАж" api-1 30 minutes ago Up 10 seconds (healthy) 8080/tcp +mtusi2026lab5-api-2-1 mtusi2026lab5-api-2 "uvicorn app:app --hтАж" api-2 30 minutes ago Up 9 seconds (healthy) 8080/tcp +mtusi2026lab5-migrate-1 postgres:15.5-alpine3.19 "docker-entrypoint.sтАж" migrate 30 minutes ago Exited (0) 7 seconds ago +mtusi2026lab5-nginx-1 nginx:1.25.4-alpine "/docker-entrypoint.тАж" nginx 30 minutes ago Up 26 minutes (healthy) 0.0.0.0:8080->8080/tcp, [::]:8080->8080/tcp +mtusi2026lab5-postgres-1 postgres:15.5-alpine3.19 "docker-entrypoint.sтАж" postgres 30 minutes ago Up 30 minutes (healthy) 5432/tcp +mtusi2026lab5-redis-1 redis:7.2.4-alpine "docker-entrypoint.sтАж" redis 30 minutes ago Up 4 minutes (healthy) 6379/tcp +mtusi2026lab5-s3-1 chrislusf/seaweedfs:latest "/entrypoint.sh servтАж" s3 30 minutes ago Up 30 minutes (healthy) 7333/tcp, 8080/tcp, 8333/tcp, 8888/tcp, 9333/tcp, 18080/tcp, 18888/tcp, 19333/tcp +mtusi2026lab5-s3-init-1 python:3.11.7-slim-bookworm "sh -c 'pip install тАж" s3-init 30 minutes ago Exited (0) Less than a second ago +mtusi2026lab5-worker-1 mtusi2026lab5-worker "python worker.py" worker 30 minutes ago Up Less than a second (health: starting) 8080/tcp diff --git a/evidence/demo-06-ready.json b/evidence/demo-06-ready.json new file mode 100644 index 00000000..03c68584 --- /dev/null +++ b/evidence/demo-06-ready.json @@ -0,0 +1,23 @@ +{ + "id": "9becbd32-e413-417a-8762-79bcc195e296", + "chat_id": "5db90ff5-9604-4853-b002-db4144868bcb", + "owner_id": "fdeb71d4-ee4f-47a6-8968-ffc7740e5242", + "filename": "sample.png", + "content_type": "image/png", + "size_bytes": 111817, + "sha256": "99ea7533c441f79cd630d15ce4d58d1ec4e06f6f0efb3b77a5c088305cd1bd75", + "status": "ready", + "variants": [ + { + "name": "thumbnail", + "width": 256, + "height": 160, + "sha256": "7bc40bf315c8e18e907889b23514d978be213a44223d64b737290188ee808594", + "size_bytes": 4679, + "content_type": "image/jpeg" + } + ], + "error_code": null, + "created_at": "2026-11-16T13:43:41.734766Z", + "updated_at": "2026-11-16T13:43:55.375481Z" +} diff --git a/evidence/demo-07-thumbnail.jpg b/evidence/demo-07-thumbnail.jpg new file mode 100644 index 00000000..e33b369b Binary files /dev/null and b/evidence/demo-07-thumbnail.jpg differ diff --git a/evidence/demo-08-after-broker-restart.json b/evidence/demo-08-after-broker-restart.json new file mode 100644 index 00000000..03c68584 --- /dev/null +++ b/evidence/demo-08-after-broker-restart.json @@ -0,0 +1,23 @@ +{ + "id": "9becbd32-e413-417a-8762-79bcc195e296", + "chat_id": "5db90ff5-9604-4853-b002-db4144868bcb", + "owner_id": "fdeb71d4-ee4f-47a6-8968-ffc7740e5242", + "filename": "sample.png", + "content_type": "image/png", + "size_bytes": 111817, + "sha256": "99ea7533c441f79cd630d15ce4d58d1ec4e06f6f0efb3b77a5c088305cd1bd75", + "status": "ready", + "variants": [ + { + "name": "thumbnail", + "width": 256, + "height": 160, + "sha256": "7bc40bf315c8e18e907889b23514d978be213a44223d64b737290188ee808594", + "size_bytes": 4679, + "content_type": "image/jpeg" + } + ], + "error_code": null, + "created_at": "2026-11-16T13:43:41.734766Z", + "updated_at": "2026-11-16T13:43:55.375481Z" +} diff --git a/evidence/g4-crop.jpg b/evidence/g4-crop.jpg new file mode 100644 index 00000000..754ee743 Binary files /dev/null and b/evidence/g4-crop.jpg differ diff --git a/evidence/g4-thumbnail.jpg b/evidence/g4-thumbnail.jpg new file mode 100644 index 00000000..e33b369b Binary files /dev/null and b/evidence/g4-thumbnail.jpg differ diff --git a/evidence/g4-variants.txt b/evidence/g4-variants.txt new file mode 100644 index 00000000..ebab71c0 Binary files /dev/null and b/evidence/g4-variants.txt differ diff --git a/evidence/smoke.txt b/evidence/smoke.txt new file mode 100644 index 00000000..d416f073 Binary files /dev/null and b/evidence/smoke.txt differ diff --git a/migrations/init.sql b/migrations/init.sql new file mode 100644 index 00000000..444f86ca --- /dev/null +++ b/migrations/init.sql @@ -0,0 +1,74 @@ +CREATE TABLE IF NOT EXISTS users ( + id UUID PRIMARY KEY, + username VARCHAR(32) UNIQUE NOT NULL, + display_name VARCHAR(100) NOT NULL, + password_hash VARCHAR(255) NOT NULL, + created_at TIMESTAMPTZ NOT NULL +); + +CREATE TABLE IF NOT EXISTS chats ( + id UUID PRIMARY KEY, + title VARCHAR(100) NOT NULL, + created_at TIMESTAMPTZ NOT NULL +); + +CREATE TABLE IF NOT EXISTS chat_members ( + chat_id UUID REFERENCES chats(id) ON DELETE CASCADE, + user_id UUID REFERENCES users(id) ON DELETE CASCADE, + PRIMARY KEY (chat_id, user_id) +); + +CREATE TABLE IF NOT EXISTS messages ( + id UUID PRIMARY KEY, + chat_id UUID REFERENCES chats(id) ON DELETE CASCADE, + sender_id UUID REFERENCES users(id) ON DELETE CASCADE, + text VARCHAR(4000) NOT NULL, + created_at TIMESTAMPTZ NOT NULL, + attachment_ids UUID[] DEFAULT '{}' +); + +CREATE INDEX IF NOT EXISTS idx_messages_chat_pagination ON messages(chat_id, created_at, id); + +CREATE TABLE IF NOT EXISTS idempotency_keys ( + user_id UUID NOT NULL, + method VARCHAR(16) NOT NULL, + path TEXT NOT NULL, + key VARCHAR(128) NOT NULL, + request_hash VARCHAR(64) NOT NULL, + response_status INT NOT NULL, + response_body JSONB NOT NULL, + created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(), + PRIMARY KEY (user_id, method, path, key) +); + +CREATE TABLE IF NOT EXISTS attachments ( + id UUID PRIMARY KEY, + chat_id UUID REFERENCES chats(id) ON DELETE CASCADE, + owner_id UUID REFERENCES users(id) ON DELETE CASCADE, + filename VARCHAR(255) NOT NULL, + content_type VARCHAR(50) NOT NULL, + size_bytes BIGINT NOT NULL, + sha256 VARCHAR(64) NOT NULL, + status VARCHAR(32) NOT NULL DEFAULT 'queued', + variants JSONB NOT NULL DEFAULT '[]', + error_code VARCHAR(64), + pipeline_version INT NOT NULL DEFAULT 1, + attempt INT NOT NULL DEFAULT 0, + created_at TIMESTAMPTZ NOT NULL, + updated_at TIMESTAMPTZ NOT NULL +); + +CREATE TABLE IF NOT EXISTS outbox ( + id UUID PRIMARY KEY, + stream VARCHAR(64) NOT NULL, + payload JSONB NOT NULL, + created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(), + published_at TIMESTAMPTZ +); + +CREATE INDEX IF NOT EXISTS idx_attachments_chat ON attachments(chat_id); + +ALTER TABLE messages ADD COLUMN IF NOT EXISTS attachment_ids UUID[] DEFAULT '{}'; +ALTER TABLE attachments ADD COLUMN IF NOT EXISTS pipeline_version INT NOT NULL DEFAULT 1; +ALTER TABLE attachments ADD COLUMN IF NOT EXISTS attempt INT NOT NULL DEFAULT 0; +CREATE INDEX IF NOT EXISTS idx_outbox_unpublished ON outbox(created_at) WHERE published_at IS NULL; \ No newline at end of file diff --git a/nginx.conf b/nginx.conf new file mode 100644 index 00000000..bf626811 --- /dev/null +++ b/nginx.conf @@ -0,0 +1,28 @@ +events { worker_connections 1024; } + +http { + upstream messenger_api { + server api-1:8080 max_fails=1 fail_timeout=5s; + server api-2:8080 max_fails=1 fail_timeout=5s; + } + + server { + listen 8080; + + location / { + proxy_pass http://messenger_api; + + proxy_connect_timeout 2s; + proxy_send_timeout 5s; + proxy_read_timeout 5s; + + proxy_next_upstream error timeout http_502 http_503 http_504; + proxy_next_upstream_tries 2; + proxy_next_upstream_timeout 5s; + + proxy_set_header Host $host; + proxy_set_header X-Real-IP $remote_addr; + proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; + } + } +} \ No newline at end of file diff --git a/requirements.txt b/requirements.txt new file mode 100644 index 00000000..00abd85d --- /dev/null +++ b/requirements.txt @@ -0,0 +1,15 @@ +fastapi==0.110.0 +uvicorn==0.28.0 +pydantic==2.6.2 +starlette==0.36.3 +idna==3.6 +anyio==4.3.0 +sniffio==1.3.1 +click==8.1.7 +h11==0.14.0 +annotated-types==0.6.0 +psycopg2-binary==2.9.9 +bcrypt==4.1.2 +redis==5.0.1 +boto3==1.34.0 +Pillow==10.2.0 \ No newline at end of file diff --git a/scripts/bootstrap_s3.py b/scripts/bootstrap_s3.py new file mode 100644 index 00000000..72fc8486 --- /dev/null +++ b/scripts/bootstrap_s3.py @@ -0,0 +1,29 @@ +import os +import boto3 +from botocore.client import Config + +S3_ENDPOINT = os.getenv("S3_ENDPOINT", "http://s3:8333") +S3_BUCKET = os.getenv("S3_BUCKET", "messenger-attachments") +S3_ROOT_ACCESS_KEY = os.getenv("S3_ROOT_ACCESS_KEY", "minioadmin") +S3_ROOT_SECRET_KEY = os.getenv("S3_ROOT_SECRET_KEY", "minioadminpassword") + +s3_client = boto3.client( + "s3", + endpoint_url=S3_ENDPOINT, + aws_access_key_id=S3_ROOT_ACCESS_KEY, + aws_secret_access_key=S3_ROOT_SECRET_KEY, + config=Config(signature_version="s3v4"), + region_name="us-east-1" +) + +def init_bucket(): + print(f"Checking/Creating bucket: {S3_BUCKET}") + try: + s3_client.head_bucket(Bucket=S3_BUCKET) + print("Bucket already exists.") + except Exception: + s3_client.create_bucket(Bucket=S3_BUCKET) + print("Bucket successfully created.") + +if __name__ == "__main__": + init_bucket() \ No newline at end of file diff --git a/scripts/check_bucket_private.py b/scripts/check_bucket_private.py new file mode 100644 index 00000000..dc66599f --- /dev/null +++ b/scripts/check_bucket_private.py @@ -0,0 +1,11 @@ +import os, sys, urllib.request, urllib.error +BUCKET = os.getenv("S3_BUCKET", "messenger-attachments") +KEY = os.getenv("S3_KEY") +URL = f"http://s3:8333/{BUCKET}/{KEY}" +try: + urllib.request.urlopen(URL) + print("FAIL: object accessible without auth"); sys.exit(1) +except urllib.error.HTTPError as e: + if e.code in (401, 403): + print(f"PASS: anonymous GET -> {e.code}"); sys.exit(0) + print(f"FAIL: unexpected {e.code}"); sys.exit(1) \ No newline at end of file diff --git a/scripts/check_contract.py b/scripts/check_contract.py index dcb34dfa..614ddc10 100644 --- a/scripts/check_contract.py +++ b/scripts/check_contract.py @@ -8,8 +8,8 @@ import re ROOT = Path(__file__).resolve().parents[1] def main(): - lab = json.loads((ROOT/'lab.json').read_text())['number'] - spec = json.loads((ROOT/'contracts/openapi.json').read_text()) + lab = json.loads((ROOT/'lab.json').read_text(encoding='utf-8'))['number'] + spec = json.loads((ROOT/'contracts/openapi.json').read_text(encoding='utf-8')) assert spec['openapi']=='3.1.0' assert spec['info']['version']=='1.%d.0'%lab operation_ids = set() @@ -41,11 +41,11 @@ def main(): assert ('/api/v1/auth/sessions' in spec['paths']) == (lab>=2) assert ('/api/v1/attachments/{attachment_id}' in spec['paths']) == (lab>=4) for file in list((ROOT/'tests').glob('*.py'))+list((ROOT/'scripts').glob('*.py')): - ast.parse(file.read_text(),filename=str(file)) + ast.parse(file.read_text(encoding='utf-8'),filename=str(file)) for file in ROOT.rglob('*.json'): if any(part in {'.git','.venv','node_modules','vendor','output'} for part in file.parts): continue - json.loads(file.read_text()) + json.loads(file.read_text(encoding='utf-8-sig')) for required in ('README.md','COURSE.md','CONTRIBUTING.md','REPORT.md','contracts/README.md','tests/smoke.py','tests/README.md'): assert (ROOT/required).is_file(), 'missing '+required print('PASS: offline skeleton structure, local refs and Python syntax; application NOT tested.') diff --git a/scripts/reconcile.py b/scripts/reconcile.py new file mode 100644 index 00000000..64e3fba0 --- /dev/null +++ b/scripts/reconcile.py @@ -0,0 +1,81 @@ +import os +import sys +import boto3 +from botocore.client import Config +import psycopg2 +import psycopg2.extras +from datetime import datetime, timezone, timedelta + +DATABASE_URL = os.getenv("DATABASE_URL", "postgresql://postgres:postgres@postgres:5432/messenger") +S3_ENDPOINT = os.getenv("S3_ENDPOINT", "http://s3:8333") +S3_BUCKET = os.getenv("S3_BUCKET", "messenger-attachments") +S3_ACCESS_KEY = os.getenv("S3_ACCESS_KEY_ID", "appuser") +S3_SECRET_KEY = os.getenv("S3_SECRET_ACCESS_KEY", "appsecretpassword") + +s3_client = boto3.client( + "s3", + endpoint_url=S3_ENDPOINT, + aws_access_key_id=S3_ACCESS_KEY, + aws_secret_access_key=S3_SECRET_KEY, + config=Config(signature_version="s3v4"), + region_name="us-east-1" +) + +def run_reconciliation(dry_run: bool = False): + print(f"Starting reconciliation (dry_run={dry_run})...") + conn = psycopg2.connect(DATABASE_URL, cursor_factory=psycopg2.extras.RealDictCursor) + + threshold = datetime.now(timezone.utc) - timedelta(hours=1) + + with conn.cursor() as cur: + cur.execute(""" + SELECT id, chat_id, filename, created_at FROM attachments + WHERE status = 'pending' AND created_at < %s + """, (threshold,)) + stale_pending = cur.fetchall() + + for row in stale_pending: + att_id = str(row['id']) + chat_id = str(row['chat_id']) + filename = row['filename'] + s3_key = f"attachments/{chat_id}/{att_id}/{filename}" + print(f"[DB Stale Pending] Found stale attachment {att_id}, marking as failed and cleaning S3.") + + if not dry_run: + try: + s3_client.delete_object(Bucket=S3_BUCKET, Key=s3_key) + except Exception as e: + print(f"Failed to delete S3 key {s3_key}: {e}") + with conn.cursor() as cur: + cur.execute("UPDATE attachments SET status = 'failed', error_code = 'timeout_stale' WHERE id = %s", (att_id,)) + conn.commit() + + with conn.cursor() as cur: + cur.execute("SELECT id, chat_id, filename FROM attachments") + all_db_attachments = cur.fetchall() + + valid_s3_keys = set() + for row in all_db_attachments: + valid_s3_keys.add(f"attachments/{str(row['chat_id'])}/{str(row['id'])}/{row['filename']}") + + paginator = s3_client.get_paginator('list_objects_v2') + for page in paginator.paginate(Bucket=S3_BUCKET, Prefix="attachments/"): + for obj in page.get('Contents', []): + key = obj['Key'] + last_modified = obj['LastModified'] + + if key not in valid_s3_keys and last_modified < threshold: + print(f"[S3 Orphan] Found orphan S3 object {key} (Modified: {last_modified})") + if not dry_run: + try: + s3_client.delete_object(Bucket=S3_BUCKET, Key=key) + print(f"Deleted orphan object {key} from S3.") + except Exception as e: + print(f"Failed to delete orphan {key}: {e}") + + conn.close() + print("Reconciliation completed successfully.") + +if __name__ == "__main__": + dry_run_mode = "--dry-run" in sys.argv + run_reconciliation(dry_run=dry_run_mode) \ No newline at end of file diff --git a/scripts/restart.bat b/scripts/restart.bat new file mode 100644 index 00000000..ce7fdbe2 --- /dev/null +++ b/scripts/restart.bat @@ -0,0 +1,3 @@ +@echo off +docker compose restart +exit /b %ERRORLEVEL% \ No newline at end of file diff --git a/scripts/restart.sh b/scripts/restart.sh new file mode 100644 index 00000000..e6cfbc5b --- /dev/null +++ b/scripts/restart.sh @@ -0,0 +1,3 @@ +#!/bin/sh +set -eu +docker compose restart \ No newline at end of file diff --git a/scripts/rolling-update.sh b/scripts/rolling-update.sh new file mode 100644 index 00000000..173f1dba --- /dev/null +++ b/scripts/rolling-update.sh @@ -0,0 +1,35 @@ +#!/bin/sh +set -eu + +wait_ready() { + svc=$1 + timeout=60 + echo "Waiting for $svc readiness (up to ${timeout}s)..." + while [ "$timeout" -gt 0 ]; do + if docker compose exec -T "$svc" python -c \ + "import urllib.request; urllib.request.urlopen('http://localhost:8080/health/ready')" 2>/dev/null; then + echo "$svc is ready!" + return 0 + fi + sleep 1 + timeout=$((timeout - 1)) + done + echo "$svc failed to become ready" >&2 + return 1 +} + +echo "Starting Rolling Update" + +echo "1. Rebuilding and replacing api-1..." +docker compose up -d --no-deps --build --force-recreate api-1 +wait_ready api-1 +echo "Reloading nginx to pick up new api-1 IP..." +docker compose exec -T nginx nginx -s reload + +echo "2. Rebuilding and replacing api-2..." +docker compose up -d --no-deps --build --force-recreate api-2 +wait_ready api-2 +echo "Reloading nginx to pick up new api-2 IP..." +docker compose exec -T nginx nginx -s reload + +echo "Rolling Update Completed Successfully" \ No newline at end of file diff --git a/scripts/stop-one.sh b/scripts/stop-one.sh new file mode 100644 index 00000000..d35a3c03 --- /dev/null +++ b/scripts/stop-one.sh @@ -0,0 +1,12 @@ +#!/bin/sh +set -eu +: "${TARGET_INSTANCE_ID:?test provides target API instance alias}" + +if [ "$TARGET_INSTANCE_ID" = "api-replica-1" ]; then + docker compose stop -t 3 api-1 +elif [ "$TARGET_INSTANCE_ID" = "api-replica-2" ]; then + docker compose stop -t 3 api-2 +else + echo "Unknown target instance: $TARGET_INSTANCE_ID" >&2 + exit 1 +fi \ No newline at end of file diff --git a/scripts/upload_load_test.py b/scripts/upload_load_test.py new file mode 100644 index 00000000..cdd2e2e3 --- /dev/null +++ b/scripts/upload_load_test.py @@ -0,0 +1,54 @@ +import base64, concurrent.futures, json, pathlib, time, urllib.request, uuid + +BASE = "http://localhost:8080" + +def _req(method, path, body=None, headers=None, token=None): + h = {"Accept": "application/json"} + if token: h["Authorization"] = f"Bearer {token}" + h.update(headers or {}) + req = urllib.request.Request(BASE + path, data=body, headers=h, method=method) + with urllib.request.urlopen(req) as r: + return r.status, r.read() + +def register_and_login(): + u = f"u_{uuid.uuid4().hex[:10]}" + p = "T3st-" + uuid.uuid4().hex + _req("POST", "/api/v1/users", + json.dumps({"username": u, "display_name": "Load", "password": p}).encode(), + {"Content-Type": "application/json"}) + basic = base64.b64encode(f"{u}:{p}".encode()).decode() + _, body = _req("POST", "/api/v1/auth/sessions", + headers={"Authorization": f"Basic {basic}"}) + return json.loads(body)["token"] + +def make_chat(token): + _, me = _req("GET", "/api/v1/users/me", token=token) + uid = json.loads(me)["id"] + _, chat = _req("POST", "/api/v1/chats", + json.dumps({"title": "load", "member_ids": [uid]}).encode(), + {"Content-Type": "application/json", "Idempotency-Key": uuid.uuid4().hex}, + token=token) + return json.loads(chat)["id"] + +def main(): + token = register_and_login() + chat = make_chat(token) + png = pathlib.Path("tests/fixtures/sample.png").read_bytes() + + def one(_): + try: + status, _ = _req("POST", + f"/api/v1/chats/{chat}/attachments?filename=f.png", + png, {"Content-Type": "image/png"}, token) + return status + except Exception as e: + return repr(e) + + t0 = time.monotonic() + with concurrent.futures.ThreadPoolExecutor(max_workers=10) as ex: + results = list(ex.map(one, range(10))) + print(json.dumps({"results": results, + "elapsed_s": round(time.monotonic() - t0, 3)})) + +if __name__ == "__main__": + main() \ No newline at end of file diff --git a/tests/client.py b/tests/client.py index f0499a29..38159a0c 100644 --- a/tests/client.py +++ b/tests/client.py @@ -14,7 +14,7 @@ import uuid ROOT = Path(__file__).resolve().parents[1] LAB = json.loads((ROOT / 'lab.json').read_text())['number'] -SPEC = json.loads((ROOT / 'contracts/openapi.json').read_text()) +SPEC = json.loads((ROOT / 'contracts/openapi.json').read_text(encoding='utf-8')) class Failure(AssertionError): pass diff --git a/tests/custom_tests.py b/tests/custom_tests.py new file mode 100644 index 00000000..f5e46e61 --- /dev/null +++ b/tests/custom_tests.py @@ -0,0 +1,109 @@ +import concurrent.futures +import urllib.request +import urllib.error +import json +import unittest +from client import Client + +class TestMessengerLab4(unittest.TestCase): + def setUp(self): + self.client = Client() + self.alice = self.client.user("alice") + self.bob = self.client.user("bob") + self.eve = self.client.user("eve") + + res = self.client.call( + 'POST', '/api/v1/chats', 201, + actor=self.alice, + body={"title": "Test Chat", "member_ids": [self.alice["id"], self.bob["id"]]}, + schema='Chat' + ) + self.chat = res['json'] + + def test_unauthorized_access_to_chat(self): + self.client.call('GET', f"/api/v1/chats/{self.chat['id']}", 404, actor=self.eve) + + def test_empty_message(self): + self.client.call('POST', f"/api/v1/chats/{self.chat['id']}/messages", 400, actor=self.alice, body={"text": ""}) + + def test_malformed_json(self): + url = self.client.base + f"/api/v1/chats/{self.chat['id']}/messages" + req = urllib.request.Request( + url, + data=b"{broken json content without quotes", + headers={ + "Content-Type": "application/json", + "X-User-Id": self.alice["id"] + }, + method="POST" + ) + try: + with urllib.request.urlopen(req) as resp: + self.fail("Expected HTTP 400 for malformed JSON") + except urllib.error.HTTPError as e: + self.assertEqual(e.code, 400) + body = json.loads(e.read().decode()) + self.assertEqual(body["error"]["code"], "invalid_request") + + def test_duplicate_username(self): + self.client.call('POST', '/api/v1/users', 409, body=self.alice["registration"]) + + def test_pagination_multiple_pages(self): + import time + msg_texts = ["msg-page-1", "msg-page-2", "msg-page-3"] + for txt in msg_texts: + self.client.message(self.alice, self.chat, txt) + time.sleep(0.01) + + path = f"/api/v1/chats/{self.chat['id']}/messages" + collected_items = [] + cursor = None + + for _ in range(5): + url_suffix = "?limit=1" + if cursor: + url_suffix += f"&cursor={cursor}" + + page_res = self.client.call('GET', path + url_suffix, actor=self.alice, schema='MessagePage') + page = page_res['json'] + + for item in page['items']: + self.assertNotIn(item['id'], [x['id'] for x in collected_items]) + collected_items.append(item) + + cursor = page.get('next_keyword') or page.get('next_cursor') + if not cursor: + break + + self.assertEqual(len(collected_items), 3) + self.assertEqual(sorted([x['text'] for x in collected_items]), sorted(msg_texts)) + + def test_concurrent_messages_strict(self): + def worker_send(worker_idx): + local_client = Client() + ids = [] + for i in range(10): + res = local_client.message(self.alice, self.chat, f"w-{worker_idx}-msg-{i}") + ids.append(res['json']['id']) + return ids + + all_ids = [] + with concurrent.futures.ThreadPoolExecutor(max_workers=10) as executor: + futures = [executor.submit(worker_send, w) for w in range(10)] + for f in concurrent.futures.as_completed(futures): + all_ids.extend(f.result()) + + self.assertEqual(len(all_ids), 100) + self.assertEqual(len(set(all_ids)), 100) + + page = self.client.call( + 'GET', f"/api/v1/chats/{self.chat['id']}/messages?limit=100", + actor=self.alice, + schema='MessagePage' + ) + server_ids = [m['id'] for m in page['json']['items']] + self.assertEqual(len(server_ids), 100) + self.assertEqual(len(set(server_ids)), 100) + +if __name__ == '__main__': + unittest.main() \ No newline at end of file diff --git a/tests/level4_tests.py b/tests/level4_tests.py new file mode 100644 index 00000000..38489a75 --- /dev/null +++ b/tests/level4_tests.py @@ -0,0 +1,139 @@ +import urllib.request +import urllib.error +import json +import unittest +from client import Client + +class TestMessengerLevel4Complete(unittest.TestCase): + def setUp(self): + self.client = Client() + self.alice = self.client.user("alice") + self.bob = self.client.user("bob") + self.eve = self.client.user("eve") + + res_chat1 = self.client.call( + 'POST', '/api/v1/chats', 201, + actor=self.alice, + body={"title": "Team Chat", "member_ids": [self.alice["id"], self.bob["id"]]}, + schema='Chat' + ) + self.chat1 = res_chat1['json'] + + res_chat2 = self.client.call( + 'POST', '/api/v1/chats', 201, + actor=self.eve, + body={"title": "Private Chat", "member_ids": [self.eve["id"], self.bob["id"]]}, + schema='Chat' + ) + self.chat2 = res_chat2['json'] + + def test_unsupported_media_type(self): + """Проверка 415: передача текстового файла под видом картинки.""" + fake_bytes = b"Just a simple plain text file content." + url = self.client.base + f"/api/v1/chats/{self.chat1['id']}/attachments?filename=notes.txt" + req = urllib.request.Request( + url, data=fake_bytes, + headers={"Authorization": f"Bearer {self.alice['token']}", "Content-Type": "image/png"}, + method="POST" + ) + try: + with urllib.request.urlopen(req) as resp: + self.fail("Expected HTTP 415") + except urllib.error.HTTPError as e: + self.assertEqual(e.code, 415) + + def test_payload_too_large(self): + """Проверка 413: файл размером больше 10 MiB.""" + large_data = b'\x89PNG\r\n\x1a\n' + b'\x00' * (10 * 1024 * 1024 + 100) + url = self.client.base + f"/api/v1/chats/{self.chat1['id']}/attachments?filename=huge.png" + req = urllib.request.Request( + url, data=large_data, + headers={"Authorization": f"Bearer {self.alice['token']}", "Content-Type": "image/png"}, + method="POST" + ) + try: + with urllib.request.urlopen(req) as resp: + self.fail("Expected HTTP 413") + except urllib.error.HTTPError as e: + self.assertEqual(e.code, 413) + + def test_corrupted_image_signature(self): + """Проверка 415: битая структура / неверные размеры PNG.""" + corrupted_png = b'\x89PNG\r\n\x1a\n' + b'\xFF' * 50 + url = self.client.base + f"/api/v1/chats/{self.chat1['id']}/attachments?filename=corrupt.png" + req = urllib.request.Request( + url, data=corrupted_png, + headers={"Authorization": f"Bearer {self.alice['token']}", "Content-Type": "image/png"}, + method="POST" + ) + try: + with urllib.request.urlopen(req) as resp: + self.fail("Expected HTTP 415") + except urllib.error.HTTPError as e: + self.assertEqual(e.code, 415) + + def test_invalid_filename_characters(self): + """Проверка 400: недопустимые символы (path traversal) в имени файла.""" + valid_png = ( + b'\x89PNG\r\n\x1a\n' + b'\x00\x00\x00\rIHDR' + b'\x00\x00\x00\n\x00\x00\x00\n' + b'\x08\x02\x00\x00\x00' + b'\x02p\xdd\xb5' + b'\x00\x00\x00\x0fcIDATx\x9cc`\x00\x00\x00\x02\x00\x01H\xaf\xa4q' + b'\x00\x00\x00\x00IEND\xaeB`\x82' + ) + url = self.client.base + f"/api/v1/chats/{self.chat1['id']}/attachments?filename=../../etc/passwd" + req = urllib.request.Request( + url, data=valid_png, + headers={"Authorization": f"Bearer {self.alice['token']}", "Content-Type": "image/png"}, + method="POST" + ) + try: + with urllib.request.urlopen(req) as resp: + self.fail("Expected HTTP 400") + except urllib.error.HTTPError as e: + self.assertEqual(e.code, 400) + + def test_nonexistent_attachment_id(self): + """Проверка 404: передача несуществующего ID вложения при отправке сообщения.""" + fake_uuid = "12345678-1234-4123-8123-123456789abc" + res = self.client.call( + 'POST', f"/api/v1/chats/{self.chat1['id']}/messages", 404, + actor=self.alice, + body={"text": "Check this out", "attachment_ids": [fake_uuid]}, + headers={"Idempotency-Key": "test-key-lvl4-1"} + ) + self.assertEqual(res['status'], 404) + + def test_cross_chat_attachment_isolation(self): + """Проверка 404: попытка прикрепить вложение из чужого чата.""" + valid_png = ( + b'\x89PNG\r\n\x1a\n' + b'\x00\x00\x00\rIHDR' + b'\x00\x00\x00\n\x00\x00\x00\n' + b'\x08\x02\x00\x00\x00' + b'\x02p\xdd\xb5' + b'\x00\x00\x00\x0fcID1Tx\x9cc`\x00\x00\x00\x02\x00\x01H\xaf\xa4q' + b'\x00\x00\x00\x00IEND\xaeB`\x82' + ) + url = self.client.base + f"/api/v1/chats/{self.chat2['id']}/attachments?filename=secret.png" + req = urllib.request.Request( + url, data=valid_png, + headers={"Authorization": f"Bearer {self.eve['token']}", "Content-Type": "image/png"}, + method="POST" + ) + with urllib.request.urlopen(req) as resp: + data = json.loads(resp.read().decode()) + eve_att_id = data["id"] + + res = self.client.call( + 'POST', f"/api/v1/chats/{self.chat1['id']}/messages", 404, + actor=self.alice, + body={"text": "Stealing file", "attachment_ids": [eve_att_id]}, + headers={"Idempotency-Key": "test-key-lvl4-2"} + ) + self.assertEqual(res['status'], 404) + +if __name__ == '__main__': + unittest.main() \ No newline at end of file diff --git a/tests/resilience.py b/tests/resilience.py index f3fa700a..d5d67fe1 100644 --- a/tests/resilience.py +++ b/tests/resilience.py @@ -55,7 +55,7 @@ def main(): check(len(observed)>=2,'less than two API instances observed before failure; verify LB/session affinity') print('Executing explicit '+args.mode+' hook; hook output suppressed to avoid leaking secrets.') # No shell interpolation and no Docker commands in this test. - proc = subprocess.Popen([str(script)],env=env,stdout=subprocess.DEVNULL,stderr=subprocess.DEVNULL) + proc = subprocess.Popen(['sh', str(script)], env=env, stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL) started = time.monotonic() successes,failures,after_instances = [],0,[] try: diff --git a/worker.py b/worker.py new file mode 100644 index 00000000..9f33be8f --- /dev/null +++ b/worker.py @@ -0,0 +1,405 @@ +import os +import io +import json +import time +import signal +import random +import hashlib +import logging +from datetime import datetime, timezone +from concurrent.futures import ThreadPoolExecutor + +import psycopg2 +import psycopg2.extras +import redis +import boto3 +import botocore.exceptions +from botocore.client import Config +from PIL import Image, ImageOps, UnidentifiedImageError + +logging.basicConfig(level=logging.INFO, format="%(asctime)s [%(levelname)s] %(message)s") +logger = logging.getLogger("attachment-worker") + +DATABASE_URL = os.getenv("DATABASE_URL", "postgresql://postgres:postgres@postgres:5432/messenger") +REDIS_URL = os.getenv("REDIS_URL", "redis://redis:6379/0") +S3_ENDPOINT = os.getenv("S3_ENDPOINT", "http://s3:8333") +S3_BUCKET = os.getenv("S3_BUCKET", "messenger-attachments") +S3_ACCESS_KEY = os.getenv("S3_ACCESS_KEY_ID", "appuser") +S3_SECRET_KEY = os.getenv("S3_SECRET_ACCESS_KEY", "appsecretpassword") + +STREAM_NAME = os.getenv("BROKER_STREAM", "attachment_jobs") +DLQ_STREAM_NAME = f"{STREAM_NAME}_dlq" +GROUP_NAME = os.getenv("BROKER_GROUP", "attachment_workers") +CONSUMER_NAME = os.getenv("HOSTNAME", "worker-1") +JOB_MAX_ATTEMPTS = int(os.getenv("JOB_MAX_ATTEMPTS", "5")) +MAX_IMAGE_PIXELS = int(os.getenv("MAX_IMAGE_PIXELS", "40000000")) +JOB_TIMEOUT_SECONDS = int(os.getenv("JOB_TIMEOUT_SECONDS", "30")) +WORKER_CONCURRENCY = int(os.getenv("WORKER_CONCURRENCY", "4")) + +CLAIM_MIN_IDLE_MS = (JOB_TIMEOUT_SECONDS + 20) * 1000 + +Image.MAX_IMAGE_PIXELS = MAX_IMAGE_PIXELS + +redis_client = redis.Redis.from_url(REDIS_URL, decode_responses=True) +s3_client = boto3.client( + "s3", endpoint_url=S3_ENDPOINT, + aws_access_key_id=S3_ACCESS_KEY, aws_secret_access_key=S3_SECRET_KEY, + config=Config(signature_version="s3v4"), region_name="us-east-1" +) + +running = True + +def handle_sigterm(signum, frame): + global running + logger.info("Received shutdown signal, finishing in-flight jobs...") + running = False + +signal.signal(signal.SIGTERM, handle_sigterm) +signal.signal(signal.SIGINT, handle_sigterm) + + +def get_db_connection(): + return psycopg2.connect(DATABASE_URL, cursor_factory=psycopg2.extras.RealDictCursor) + + +def ensure_consumer_groups(): + while running: + try: + redis_client.xgroup_create(STREAM_NAME, GROUP_NAME, id="0", mkstream=True) + redis_client.xgroup_create(DLQ_STREAM_NAME, GROUP_NAME, id="0", mkstream=True) + logger.info("Consumer groups ensured on '%s' and '%s'", STREAM_NAME, DLQ_STREAM_NAME) + return + except redis.exceptions.ResponseError as e: + if "BUSYGROUP" in str(e): + return + raise + except Exception as e: + logger.warning("Waiting for Redis: %s", type(e).__name__) + time.sleep(1) + + +def prepare_base_image(raw_bytes): + img = Image.open(io.BytesIO(raw_bytes)) + img = ImageOps.exif_transpose(img) + if img.mode in ("RGBA", "LA") or (img.mode == "P" and "transparency" in img.info): + rgba = img.convert("RGBA") + bg = Image.new("RGB", rgba.size, (255, 255, 255)) + bg.paste(rgba, mask=rgba.split()[3]) + img = bg + elif img.mode != "RGB": + img = img.convert("RGB") + return img + + +def generate_grade4_variants(raw_bytes): + base_img = prepare_base_image(raw_bytes) + orig_w, orig_h = base_img.size + meta = [] + blobs = {} + + thumb = base_img.copy() + if orig_w <= 256 and orig_h <= 256: + t_w, t_h = orig_w, orig_h + else: + s = min(256.0 / orig_w, 256.0 / orig_h) + t_w, t_h = max(1, int(orig_w * s)), max(1, int(orig_h * s)) + if (t_w, t_h) != (orig_w, orig_h): + thumb = thumb.resize((t_w, t_h), Image.Resampling.LANCZOS) + buf = io.BytesIO(); thumb.save(buf, format="JPEG", quality=85, optimize=True) + tb = buf.getvalue(); blobs["thumbnail"] = tb + meta.append({"name": "thumbnail", "content_type": "image/jpeg", + "size_bytes": len(tb), "width": t_w, "height": t_h, + "sha256": hashlib.sha256(tb).hexdigest()}) + + opt = base_img.copy() + if orig_w <= 1280 and orig_h <= 1280: + o_w, o_h = orig_w, orig_h + else: + s = min(1280.0 / orig_w, 1280.0 / orig_h) + o_w, o_h = max(1, int(orig_w * s)), max(1, int(orig_h * s)) + if (o_w, o_h) != (orig_w, orig_h): + opt = opt.resize((o_w, o_h), Image.Resampling.LANCZOS) + buf = io.BytesIO(); opt.save(buf, format="WEBP", quality=85) + ob = buf.getvalue(); blobs["optimized"] = ob + meta.append({"name": "optimized", "content_type": "image/webp", + "size_bytes": len(ob), "width": o_w, "height": o_h, + "sha256": hashlib.sha256(ob).hexdigest()}) + + c = min(orig_w, orig_h) + left, top = (orig_w - c) // 2, (orig_h - c) // 2 + crop = base_img.crop((left, top, left + c, top + c)) + if c != 128: + crop = crop.resize((128, 128), Image.Resampling.LANCZOS) + buf = io.BytesIO(); crop.save(buf, format="JPEG", quality=85, optimize=True) + cb = buf.getvalue(); blobs["crop"] = cb + meta.append({"name": "crop", "content_type": "image/jpeg", + "size_bytes": len(cb), "width": 128, "height": 128, + "sha256": hashlib.sha256(cb).hexdigest()}) + + return meta, blobs + + +def mark_failed(attachment_id, error_code): + now = datetime.now(timezone.utc).isoformat().replace("+00:00", "Z") + conn = get_db_connection() + try: + with conn.cursor() as cur: + cur.execute("UPDATE attachments SET status='failed', error_code=%s, updated_at=%s " + "WHERE id=%s AND status != 'ready'", + (error_code, now, attachment_id)) + conn.commit() + finally: + conn.close() + + +PERMANENT_ERRORS = ( + UnidentifiedImageError, Image.DecompressionBombError, ValueError, + psycopg2.errors.DataError, +) +TRANSIENT_ERRORS = ( + TimeoutError, + botocore.exceptions.EndpointConnectionError, + botocore.exceptions.ReadTimeoutError, + psycopg2.OperationalError, + redis.exceptions.ConnectionError, +) + + +def process_job(message_id, fields): + try: + job = json.loads(fields.get("payload", "{}")) + except Exception: + logger.error("Malformed job %s, ack to drop", message_id) + redis_client.xack(STREAM_NAME, GROUP_NAME, message_id) + return + + attachment_id = job.get("attachment_id") + job_id = job.get("job_id") + pipeline_version = int(job.get("pipeline_version", 1)) + attempt = int(job.get("attempt", 1)) + + if not attachment_id: + redis_client.xack(STREAM_NAME, GROUP_NAME, message_id) + return + + conn = get_db_connection() + try: + with conn.cursor() as cur: + cur.execute("SELECT * FROM attachments WHERE id=%s FOR UPDATE", (attachment_id,)) + att = cur.fetchone() + if not att: + conn.commit() + redis_client.xack(STREAM_NAME, GROUP_NAME, message_id) + return + if att["status"] == "ready" or att["pipeline_version"] > pipeline_version: + conn.commit() + redis_client.xack(STREAM_NAME, GROUP_NAME, message_id) + return + if att["status"] == "failed": + conn.commit() + redis_client.xack(STREAM_NAME, GROUP_NAME, message_id) + return + + if att["status"] == "processing": + updated = att["updated_at"] + if isinstance(updated, str): + updated = datetime.fromisoformat(updated.replace("Z", "+00:00")) + age_seconds = (datetime.now(timezone.utc) - updated).total_seconds() + if age_seconds < (JOB_TIMEOUT_SECONDS + 10): + conn.commit() + logger.info("Attachment %s already processing (age=%.1fs), ack duplicate", + attachment_id, age_seconds) + redis_client.xack(STREAM_NAME, GROUP_NAME, message_id) + return + + now = datetime.now(timezone.utc).isoformat().replace("+00:00", "Z") + cur.execute( + "UPDATE attachments SET status='processing', attempt=%s, updated_at=%s WHERE id=%s", + (attempt, now, attachment_id) + ) + conn.commit() + finally: + conn.close() + + chat_id = str(att["chat_id"]) + staging_key = f"staging/{chat_id}/{attachment_id}/original" + final_original_key = f"attachments/{chat_id}/{attachment_id}/original" + + start_time = time.monotonic() + + def check_timeout(): + if time.monotonic() - start_time > JOB_TIMEOUT_SECONDS: + raise TimeoutError("Job exceeded time limit") + + try: + try: + obj = s3_client.get_object(Bucket=S3_BUCKET, Key=staging_key) + except Exception: + obj = s3_client.get_object(Bucket=S3_BUCKET, Key=final_original_key) + raw_bytes = obj["Body"].read() + check_timeout() + + if hashlib.sha256(raw_bytes).hexdigest() != att["sha256"] or len(raw_bytes) != att["size_bytes"]: + raise ValueError("Staging checksum mismatch") + + variants_meta, variants_bytes = generate_grade4_variants(raw_bytes) + check_timeout() + + s3_client.put_object( + Bucket=S3_BUCKET, Key=final_original_key, + Body=raw_bytes, ContentType=att["content_type"] + ) + for var_name, var_bytes in variants_bytes.items(): + ct = "image/webp" if var_name == "optimized" else "image/jpeg" + s3_client.put_object( + Bucket=S3_BUCKET, + Key=f"attachments/{chat_id}/{attachment_id}/{var_name}", + Body=var_bytes, ContentType=ct + ) + check_timeout() + + ready_at = datetime.now(timezone.utc).isoformat().replace("+00:00", "Z") + conn = get_db_connection() + try: + with conn.cursor() as cur: + cur.execute(""" + UPDATE attachments SET status='ready', variants=%s::jsonb, + error_code=NULL, updated_at=%s + WHERE id=%s AND pipeline_version <= %s + """, (json.dumps(variants_meta), ready_at, attachment_id, pipeline_version)) + conn.commit() + finally: + conn.close() + + redis_client.xack(STREAM_NAME, GROUP_NAME, message_id) + logger.info("Job %s completed: attachment %s ready", job_id, attachment_id) + + try: + s3_client.delete_object(Bucket=S3_BUCKET, Key=staging_key) + except Exception: + pass + + except (UnidentifiedImageError, Image.DecompressionBombError) as e: + logger.error("Permanent image error for %s: %s", attachment_id, type(e).__name__) + mark_failed(attachment_id, "invalid_image") + redis_client.xack(STREAM_NAME, GROUP_NAME, message_id) + + except ValueError as e: + logger.error("Checksum error for %s: %s", attachment_id, e) + mark_failed(attachment_id, "invalid_checksum") + redis_client.xack(STREAM_NAME, GROUP_NAME, message_id) + + except psycopg2.errors.DataError as e: + logger.error("DB data error for %s: %s", attachment_id, type(e).__name__) + mark_failed(attachment_id, "data_error") + redis_client.xack(STREAM_NAME, GROUP_NAME, message_id) + + except TRANSIENT_ERRORS as e: + logger.warning( + "Transient error for %s (attempt %d/%d): %s", + attachment_id, attempt, JOB_MAX_ATTEMPTS, type(e).__name__ + ) + if attempt >= JOB_MAX_ATTEMPTS: + mark_failed(attachment_id, "retry_exhausted") + try: + dlq_job = dict(job) + dlq_job["attempt"] = 1 + redis_client.xadd( + DLQ_STREAM_NAME, + {"payload": json.dumps(dlq_job), "error": str(e)} + ) + except Exception: + pass + redis_client.xack(STREAM_NAME, GROUP_NAME, message_id) + else: + delay = min(2 ** attempt, 30) + random.uniform(0, 1) + time.sleep(delay) + next_job = dict(job) + next_job["attempt"] = attempt + 1 + redis_client.xadd(STREAM_NAME, {"payload": json.dumps(next_job)}) + redis_client.xack(STREAM_NAME, GROUP_NAME, message_id) + + except Exception as e: + logger.error("Unknown error for %s: %s, marking failed", + attachment_id, type(e).__name__) + mark_failed(attachment_id, "processing_failed") + redis_client.xack(STREAM_NAME, GROUP_NAME, message_id) + +def run_staging_cleanup(): + try: + cutoff = datetime.now(timezone.utc).timestamp() - 3600 + paginator = s3_client.get_paginator("list_objects_v2") + for page in paginator.paginate(Bucket=S3_BUCKET, Prefix="staging/"): + for obj in page.get("Contents", []): + if obj["LastModified"].timestamp() < cutoff: + try: + s3_client.delete_object(Bucket=S3_BUCKET, Key=obj["Key"]) + except Exception: + pass + except Exception as e: + logger.debug("Staging cleanup: %s", e) + + +def safe_process(msg_id, fields): + """Wrapper - exceptions в threads иначе исчезают молча.""" + try: + process_job(msg_id, fields) + except Exception as e: + logger.error("Unhandled in process_job %s: %s", msg_id, type(e).__name__) + + +def main(): + ensure_consumer_groups() + logger.info("Worker '%s' started, concurrency=%d", CONSUMER_NAME, WORKER_CONCURRENCY) + + executor = ThreadPoolExecutor(max_workers=WORKER_CONCURRENCY) + last_claim = 0 + last_cleanup = 0 + + try: + while running: + try: + now = time.time() + + if now - last_claim > 15: + last_claim = now + try: + claimed = redis_client.xautoclaim( + STREAM_NAME, GROUP_NAME, CONSUMER_NAME, + min_idle_time=CLAIM_MIN_IDLE_MS, + start_id="0-0", count=WORKER_CONCURRENCY + ) + if claimed and len(claimed) > 1 and claimed[1]: + for msg_id, fields in claimed[1]: + if not running: + break + executor.submit(safe_process, msg_id, fields) + except Exception: + pass + + if now - last_cleanup > 600: + last_cleanup = now + executor.submit(run_staging_cleanup) + + resp = redis_client.xreadgroup( + GROUP_NAME, CONSUMER_NAME, {STREAM_NAME: ">"}, + count=WORKER_CONCURRENCY, block=2000 + ) + if not resp: + continue + for _, messages in resp: + for msg_id, fields in messages: + if not running: + break + executor.submit(safe_process, msg_id, fields) + except Exception as e: + logger.warning("Worker loop: %s", type(e).__name__) + time.sleep(1) + finally: + logger.info("Shutting down, waiting for in-flight jobs...") + executor.shutdown(wait=True) + logger.info("Worker stopped cleanly") + + +if __name__ == "__main__": + main() \ No newline at end of file