готово

This commit is contained in:
2026-11-12 19:38:03 +03:00
parent ec540a1a72
commit f3ba37f736
142 changed files with 10257 additions and 0 deletions
+7
View File
@@ -0,0 +1,7 @@
# Matplotlib SVG paths contain generated trailing separators.
evidence/**/*.svg -whitespace
# Preserve generated measurements byte-for-byte for evidence checksums.
evidence/**/*.csv -text -whitespace
# Raw verification output is kept byte-for-byte, including command whitespace.
evidence/**/*.txt -text -whitespace
+25
View File
@@ -0,0 +1,25 @@
FROM python:3.13.0-slim-bookworm
ENV PYTHONDONTWRITEBYTECODE=1 \
PYTHONUNBUFFERED=1
WORKDIR /app
COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt \
&& python -m pip uninstall --yes pip \
&& addgroup --system app \
&& adduser --system --ingroup app app
COPY --chown=app:app src ./src
COPY --chown=app:app migrations ./migrations
COPY --chown=app:app infra/s3 ./infra/s3
COPY --chown=app:app alembic.ini ./alembic.ini
USER app
EXPOSE 8080
HEALTHCHECK --interval=10s --timeout=3s --start-period=5s --retries=3 \
CMD python -c "import urllib.request; from src.core.settings import settings; urllib.request.urlopen(f'http://127.0.0.1:{settings.app_port}/health/ready', timeout=settings.healthcheck_timeout_seconds)"
CMD ["python", "-m", "src"]
+67
View File
@@ -0,0 +1,67 @@
# Lab4: проверка замечаний преподавателя
Перечень сценариев взят из замечаний, переданных пользователем. Проверяется наша
реализация; доступность или текущее состояние чужих репозиториев не утверждаются.
Повтор: `make -f student.mk test-lab4-review PYTHON=.venv/bin/python`, затем
`make -f student.mk test-reconciliation`. Итоговый повтор входит в `make -f student.mk verify-lab4`.
| Замечание | Проверка у нас | Ожидаемый результат / защита |
| --- | --- | --- |
| Readiness не отвечает 12 секунд при pause PostgreSQL | Прямой HTTP внутри API-контейнера, без LB, при замороженной БД | 503 примерно за 2 секунды, контрактный error и оба ID-заголовка |
| История зависает при уже выполняющемся SQL | Удержать SELECT истории на SQL-блокировке, подтвердить wait в pg_stat_activity, затем pause | 503 примерно за 5 секунд; unpause восстанавливает 200 без рестарта API |
| Username review123 с завершающим LF попадает в БД и даёт 500 | Реальная регистрация с LF, CR, TAB, NUL | 400 до INSERT; Pydantic проверяет имя по ограниченному ASCII-шаблону |
| Усечённый PNG принимается после чтения заголовка | Полный fixture без IEND и только первые 33 байта | 415; после раннего лимита проверяются структура и полное декодирование |
| Обрыв клиента или слишком большое chunked-тело | Прервать передачу до EOF; отправить >10 MiB без Content-Length | Постоянное состояние не создаётся; oversized получает 413 |
| PNG с MIME image/jpeg принимается | Загрузить реальный PNG с image/jpeg | 415; определённый формат сравнивается с Content-Type |
| API использует owner credentials и создаёт другой bucket | Выполнить make_bucket с фактическими API credentials | AccessDenied; owner/reconciler credentials отсутствуют в API |
| Лишние S3 credentials в служебных контейнерах | Проверить environment API, reconciler и migration без вывода значений | Owner ключей нет во всех трёх; migration не получает S3-ключей вообще |
| После неуспешного DELETE объект навсегда выпадает из очистки | Реальный объект, ошибка до DELETE, восстановление S3 и повтор apply | Pending не фиксируется как очищенный; следующий проход реально удаляет объект |
| Ответ DELETE потерян после удаления | Удалить объект и выбросить ошибку до фиксации БД, повторить | Повтор безопасен, старая попытка закрывается |
| В сдаче отсутствуют файлы Dockerfile COPY | Скопировать полный снимок исходников, собрать API с --no-cache и MinIO, запустить пустой UUID-проект | Образы собираются, миграция 008, public smoke, вложения и сверка проходят |
| PNG 8000×5001 даёт 415, PNG 20000×10000 даёт 500 | Сформировать настоящие PNG со всеми scanlines/CRC, загрузить с корректным MIME | Оба 413; перехватываются DecompressionBombWarning и DecompressionBombError |
| Граница 40 млн пикселей | Настоящий PNG 8000×5000, загрузка и скачивание | 201 и полное совпадение исходных байтов |
| DEL допускается в filename | filename=a%7F.png | 400; запрещены все Unicode Cc, включая C0 и DEL |
| Нет filename → 422 detail | POST без query-параметра filename | 400 в общем error-конверте, X-Request-Id совпадает с request_id |
## Обнаруженный дефект и исправление
До исправления обычный pause давал ограниченные ошибки, но запрос, уже вошедший
в SQL, не возвращался за 8 секунд: `evidence/lab4-review-inflight-before.txt`.
Одних connect/pool/statement timeout недостаточно, когда процесс PostgreSQL
заморожен, а драйвер ждёт отмену/rollback.
Добавлен `RequestDeadlineMiddleware`: обычный запрос получает 503 по истечении
5 секунд до заголовков. Незавершённый обработчик отменяется, но HTTP не ждёт его
очистки. Его слот остаётся занятым до фактического завершения; максимум — 64 на
процесс. Поздняя отправка ответа от отменённой работы подавляется. Отдельная проверка
с задержанным rollback доказывает ограниченный ответ, сохранение лимита и восстановление.
Readiness использует собственную пробу с бюджетом 2 секунды и максимум одной
незавершённой пробой на процесс.
После исправления реальные запросы возвращают 503 в бюджете и восстанавливают 200
без рестарта: `evidence/lab4-final-reviewer-cases.txt`. Unit-проверки таймаутов:
`evidence/lab4-final-request-deadline.txt` и `lab4-final-readiness-budget.txt`.
## Источники замечаний
- [Pause PostgreSQL и readiness](https://gitea.privcloud.tech/Savelev_Ivan/mtusi2026lab4/src/commit/c43d3490a07ad939e4e4748863589b73c84ad05a/src/db.py#L14).
- [Pause и история](https://gitea.privcloud.tech/sokolova-bvt2304/mtusi2026lab3/src/commit/03ca3a6562981e644bfe5531f93e57167a82d6e1/app/db.py#L27).
- [Завершающий LF в username](https://gitea.privcloud.tech/Anatoly01/mtusi2026lab4/src/commit/92ce8c9a59eb4ea0f4db893b0ff02a3b61f1c7a9/app/main.py#L236).
- [PNG, MIME, S3-права и повтор очистки](https://gitea.privcloud.tech/Rakshasa/mtusi2026lab4-fork/src/commit/8c7375a6ea5f823ffce9f1b1e068a10b13266535/src/internal/handler/handler.go#L179).
- [Отсутствующие файлы сборки](https://gitea.privcloud.tech/mtusi2026/mtusi2026lab4/src/commit/ad63cf53bd4eba22495c037e448021f3fafdce51/Dockerfile#L13).
- [Пиксельные границы, DEL и filename](https://gitea.privcloud.tech/Artu-Rito/mtusi2026lab4/src/commit/38268f63f854a6ca947f0c75089ea52c4ee67706/app/images.py#L25).
## Итоговый прогон
Все случаи из таблицы прошли в составе 16 итоговых этапов. Реальные задержки
при замороженном выполняющемся SQL: история 5.1013 с,
readiness 2.0959 с, оба ответа 503. После unpause — 200.
Ошибка до S3 DELETE теперь проверяется отдельно от потерянного ответа после DELETE;
восстановление приводит к реальному удалению объекта, а не только смене статуса.
## Дополнительная проверка после переноса
В отдельном клоне обнаружена передача owner S3 credentials контейнеру migration
через общий env_file. Для migration явно очищены все S3-ключи; API и reconciler
ранее уже имели отдельные ограничения. Контейнерный environment теперь проверяется
в tests/lab4_review.py без печати секретных значений.
+44
View File
@@ -0,0 +1,44 @@
# Проверки и результаты лабораторной 4
Основная инструкция запуска — [README.md](STUDENT_README.md), отчёт — [REPORT.md](STUDENT_REPORT.md).
Выбран трек 2 на оценку 5: согласованность PostgreSQL и приватного S3.
## Команды
```sh
make -f student.mk check validate lint PYTHON=.venv/bin/python
make -f student.mk verify-lab4 PYTHON=.venv/bin/python
```
Полный прогон выполняет 16 этапов последовательно. Он проверяет контракт,
PNG/JPEG, SHA-256, доступ к чатам, ограничения файлов, идемпотентность сообщений,
замечания преподавателя, сверку с внедрением сбоев, память при 10 загрузках,
отказ принявшей файл реплики, restart и сборку с пустыми volumes.
Для отдельных HTTP-проверок локального стенда на порту 8084:
```sh
make -f student.mk test test-attachments test-idempotency BASE_URL=http://127.0.0.1:8084 PYTHON=.venv/bin/python
```
Инфраструктурные проверки временно меняют состояние учебного стенда и восстанавливают
его. Clean-start использует отдельный UUID-проект и удаляет только свои временные
volumes. Обычный restart сохраняет данные API, PostgreSQL, Redis, MinIO, reconciler и LB.
## Доказательства
- `evidence/lab4-final-summary.json` — итог команд и exit codes.
- `evidence/lab4-final-public-smoke.txt` — исходный публичный сценарий lab4.
- `evidence/lab4-final-attachments.txt` — байты оригинала, ACL, MIME и лимиты.
- `evidence/lab4-final-idempotency.txt` — параллельные повторы через две реплики.
- `evidence/lab4-final-reviewer-cases.txt` — ошибки файлов, пиксели, filename, S3-права и frozen PostgreSQL.
- `evidence/lab4-final-reconciliation.txt` — orphan/missing, dry-run, ошибки PUT/COMMIT/DELETE и стоимость обхода.
- `evidence/lab4-final-upload-memory.txt` — 10 одновременных загрузок и RAM.
- `evidence/lab4-final-uploader-failover.txt` — остановка именно загрузившей реплики.
- `evidence/lab4-final-persistence-proof.txt` — сохранность и реальные StartedAt до/после.
- `evidence/lab4-clean-start.json` — пустые volumes, миграция 008 и build без кэша API.
- `evidence/lab4-public-artifacts.json` — контрольные суммы неизменного публичного контракта и тестов.
- `evidence/lab4-research/` — исходные измерения и графики трека 2.
Алгоритм загрузки и сверки: [LAB4_RECONCILIATION.md](LAB4_RECONCILIATION.md).
Соответствие замечаниям преподавателя: [LAB4_AUDIT.md](LAB4_AUDIT.md).
+207
View File
@@ -0,0 +1,207 @@
# Lab4, трек 2: согласованность PostgreSQL и S3
## Задача и гипотеза
S3 PUT и PostgreSQL COMMIT не образуют общую транзакцию. При сбоях возможны:
объект без Attachment, зависший pending без объекта и Attachment с потерянным
оригиналом. Гипотеза: устойчивый журнал намерений, общая блокировка на ключ и
повторяемая сверка устраняют бесхозные объекты, сохраняя свежие, активные и
используемые вложения. Время обхода ожидается примерно линейным по числу ключей.
## Что хранится в БД
- `attachments` — опубликованные вложения. Наличие записи защищает оригинал,
даже если вложение ещё не использовано в сообщении.
- `upload_intents` — ключ, время регистрации и состояние `pending`, `committed`
или `abandoned`. Это внутренний журнал, не публичные статусы Attachment.
- `storage_findings` — наблюдения orphan/missing, время обнаружения/последней
проверки/закрытия и отпечаток объекта для диагностики.
- `attachments.storage_missing_since` — внутренняя отметка о потере оригинала.
Миграция `008` добавляет эти данные без изменения предыдущих вложений. Старые
Attachment защищаются и без журнала. Наличие строки журнала само по себе не
защищает мусор навсегда: старые pending проверяются и закрываются.
## Загрузка и транзакции
1. Проверить пользователя, чат, имя, размер, MIME, структуру и число пикселей.
До S3 файл находится во временном ограниченном хранилище; считать SHA-256.
2. Назначить уникальный `originals/<uuid>`.
3. В отдельной транзакции взять advisory lock на ключ, записать pending и COMMIT.
4. В HTTP-транзакции взять ту же блокировку, повторно проверить pending.
5. Выполнить S3 PUT, удерживая блокировку.
6. Одним COMMIT сохранить Attachment и перевести журнал в committed.
7. Только после COMMIT вернуть 201 ready.
Блокировка `pg_advisory_xact_lock` вычисляется по стабильному хешу object key;
она действует до конца транзакции и освобождается PostgreSQL при разрыве
соединения. Reconciler использует `pg_try_advisory_xact_lock`: занятый ключ
пропускается, а не задерживает весь обход. Случайная коллизия хеша только
сериализует независимые ключи, но не разрешает удаление используемого объекта.
При неизвестном результате COMMIT файл сразу не удаляется. Журнал и последующая
проверка Attachment позволяют разобрать исход без риска удалить уже подтверждённый
оригинал. При обрыве HTTP до этапа S3 PUT постоянного объекта ещё нет.
## Алгоритм сверки
Область действия — только настроенный `S3_BUCKET` и `originals/` либо более узкий
префикс. Другие bucket и префиксы не перечисляются. ListObjectsV2 читается лениво
постранично; приложение не собирает весь список в RAM. Записи БД читаются
порциями по 200 с продолжением по ключу.
Для каждого объекта:
1. Попробовать взять блокировку; занят — пропустить.
2. Проверить Attachment заново под блокировкой. Есть запись — сохранить.
3. Проверить актуальный S3 HEAD и pending, зафиксировать наблюдение.
4. Если объект или намерение свежие — сохранить.
5. Иначе закрыть существующее намерение как abandoned, удалить бесхозный объект,
закрыть наблюдение и COMMIT.
Запас `RECONCILE_GRACE_SECONDS=300` — один настраиваемый период, без второго
ожидания после первого обнаружения. Он проверяется относительно времени изменения
S3-объекта и создания намерения. Он не заменяет блокировку и не является lease:
сколько бы ни длилась активная загрузка, занятый ключ пропускается.
Старые pending без Attachment и без S3-объекта переводятся в abandoned. Отложенный
загрузчик повторно проверяет состояние и не публикует закрытую попытку.
Незавершённые multipart parts не видны в ListObjectsV2. SDK пытается отменить
неудачный multipart; дополнительно MinIO настроен на expiry незавершённых загрузок
через 24 часа с проверкой раз в час. Объекты целиком по этим настройкам не удаляются.
Обратный проход проверяет S3 HEAD для каждого Attachment:
- Подтверждённое NoSuchKey/NoSuchObject отмечается как missing. Метаданные,
сообщения и связи сохраняются. API отвечает 503 на чтение такого вложения;
новые сообщения с ним получают 409. Повтор ранее подтверждённого сообщения
с прежним Idempotency-Key сохраняет прежний результат.
- Если отсутствовавший объект появился снова, проверяются размер и фактический
SHA-256 при ограниченном чтении. Совпали — отметка снимается. ETag не считается SHA-256.
- AccessDenied, пропавший bucket, timeout и другие ошибки прерывают проход;
они не интерпретируются как отсутствие всех файлов.
Отдельный проход закрывает оставшиеся orphan-наблюдения, если S3 DELETE выполнился,
но его ответ или последующий COMMIT потерялись. Повтор удаления безопасен.
Reconciler не восстанавливает потерянные байты из метаданных: для восстановления
нужна копия исходного файла. Он безопасно изолирует потерю и проверяет восстановление.
## Запуск и наблюдение
Compose запускает отдельный reconciler: apply каждые 300 секунд, grace 300 секунд.
Процесс пишет JSON: режим, область обхода, действия, ограниченную выборку ключей,
время, число SQL statements, HTTP-запросы S3 по операциям и пик RSS процесса.
Healthcheck этого контейнера проверяет жизнь процесса; результаты проходов — в JSON.
Сбой обслуживания S3/БД оставляет цикл работающим для повторной попытки.
```sh
make -f student.mk reconcile # просмотр, без изменения БД и S3
make -f student.mk reconcile-apply # применить безопасные исправления
# Полные отчёты фонового процесса:
docker compose logs reconciler
```
Dry-run не пишет наблюдения, не меняет статусы и не удаляет файлы. Он не обещает,
что последующий apply увидит ровно то же состояние: apply перепроверяет всё заново.
Другой фоновый процесс может менять данные одновременно с dry-run. Для спокойного
просмотра без фоновой очистки:
```sh
docker compose stop reconciler
docker compose run --rm --no-deps reconciler python -m src.maintenance.reconcile
# После просмотра восстановить периодическую работу:
docker compose up -d reconciler
```
## Права доступа
Bootstrap с MinIO owner credentials создаёт приватный bucket и двух отдельных
пользователей. Декларативные политики находятся в `infra/s3/api-policy.json` и
`infra/s3/reconciler-policy.json`; Dockerfile копирует их в образ. Python-сценарий
явно выполняет подготовку bucket и настройку каждого пользователя. В API-контейнерах owner/reconciler credentials переопределены пустыми
значениями; в reconciler нет owner/API credentials.
| Роль | Права |
| --- | --- |
| API | ListBucket/GetBucketLocation своего bucket; GetObject/PutObject и multipart операции только в originals/; нет DeleteObject |
| Reconciler | ListBucket/GetBucketLocation/GetBucketVersioning своего bucket; GetObject/DeleteObject только в originals/; нет PutObject и admin прав |
| Bootstrap | Создание bucket, пользователей и политик; доступен только как отдельная завершающаяся задача |
`MINIO_ROOT_*` должны сохранять прежние credentials владельца при обновлении
существующего volume. `S3_ACCESS_KEY_ID`/`S3_SECRET_ACCESS_KEY` теперь относятся к
отдельному API-пользователю. Значения по умолчанию предназначены для локального
учебного стенда. Консоль выключена, порты S3 наружу не публикуются.
## Методика и доказательства
```sh
make -f student.mk test-reconciliation
make -f student.mk test-upload-memory PYTHON=.venv/bin/python
make -f student.mk test
make -f student.mk test-attachments PYTHON=.venv/bin/python
```
`tests/reconciliation.py` использует отдельную UUID-схему PostgreSQL и приватный
UUID-bucket MinIO; при завершении удаляет только собственные тестовые ресурсы.
Проверяет реальные PUT/HEAD/GET/DELETE, процесс, аварийно завершающий настоящий
код загрузки после PUT, ошибку COMMIT, отказ PUT, занятую блокировку, свежий файл,
публикацию между dry-run и apply, missing, неправильное и правильное восстановление,
потерянный ответ DELETE, AccessDenied и отказ БД. Snapshot доказывает отсутствие
изменений при dry-run. Отдельно проверяются развёрнутые S3-права API/reconciler.
Стоимость обхода измеряется на 10, 100 и 1005 объектах, по три прогона; 1005
объектов проверяют переход между страницами ListObjectsV2. Используется dry-run
по свежим бесхозным объектам: на объект приходится HEAD и примерно пять SQL
statements. Размер объекта почти не влияет на этот профиль, поскольку его байты
не читаются. Hash-проверка восстановленного missing имеет отдельную стоимость
чтения исходника. Точные результаты — `evidence/lab4-final-reconciliation.txt`.
Локальное исследование не доказывает ту же скорость на удалённых сервисах:
RTT, объём bucket и задержки СУБД могут существенно изменить время. Текущий обход
последовательный; пакетная сверка могла бы уменьшить число SQL round trips.
Эксперимент памяти временно задаёт 5 принимаемых загрузок на каждую из двух API-
реплик; декодирование изображений ограничено одним потоком на реплику. Запускает
10 одновременных загрузок для двух размеров PNG, проверяет SHA-256 и скачивание,
измеряет cgroup memory.current каждые 20 мс, включая tmpfs. После теста восстанавливает
обычную настройку параллелизма. Короткие пики между измерениями могут быть пропущены;
эти два размера не доказывают worst case для изображения в 40 млн пикселей.
## Границы безопасности
Поддерживается один неверсионируемый bucket. CLI отказывается работать с Enabled
или Suspended versioning: там нужны отдельный учёт версий и политика delete markers.
Все штатные писатели должны соблюдать протокол блокировок. Прямая административная
перезапись/удаление S3-объекта одновременно со сверкой обходят эту координацию.
Не обещается автоматическое восстановление БД/S3 из backup или защита от потери
всего Docker host. Согласованность S3-провайдера, расхождение часов и допустимый срок
pending нужно учитывать при переносе; будущие временные метки консервативно задерживают очистку.
Журнал и закрытые наблюдения пока сохраняются без автоматического удаления истории.
## Итоговые измерения
Все 16 этапов `make -f student.mk verify-lab4` завершились с exit code 0. Интеграционный
набор сверки содержит 15 проверок, включая отказ DELETE до удаления
и прямой unsigned GET существующего объекта с результатом 403.
| Объектов | Медиана 3 обходов, с | LIST | HEAD | SQL statements |
| --- | --- | --- | --- | --- |
| 10 | 0.0181 | 1 | 10 | 53 |
| 100 | 0.1559 | 1 | 100 | 503 |
| 1005 | 1.9679 | 2 | 1005 | 5028 |
Оба профиля по 10 одновременных загрузок завершились без отказов: 20 ответов 201,
все SHA-256 и скачанные оригиналы совпали. Пики RAM: **124.71 / 128.91 MiB**
при 512 MiB на реплику. Размеры PNG: 197105 и
4923446 байт. Обычный UPLOAD_CONCURRENCY=1 восстановлен.
При замороженной PostgreSQL уже выполнявшаяся история вернула 503 за
**5.0988 с**, readiness — за **2.1109 с**.
После unpause восстановились 200 без рестарта API. Пустой стенд дошёл до миграции
008; API build --no-cache занял 32.829 с. Временный проект,
volumes и его теги образов удалены; действующие данные сохранены.
![Измеренная стоимость обхода и память API](evidence/lab4-research/results.png)
Усы на графике — min/max трёх запусков, не доверительный интервал.
Указанная RAM — максимум отсчётов, а не доказанный абсолютный пик между ними.
+62
View File
@@ -0,0 +1,62 @@
## Лабораторная 4: S3-хранилище и вложения
Автор / группа: **Каменский Андрей, БПИ2301**.
Целевая оценка: **5**. Трек **2 — согласованность двух хранилищ**.
### Реализация
Обязательная основа приложения: PostgreSQL, Redis-сессии с TTL/AOF, два API за HAProxy, контракт
авторизации, пагинация и общая идемпотентность. Добавлены приватный MinIO,
метаданные Attachment, до 10 вложений в сообщении, raw PNG/JPEG upload и
авторизованный побайтный download. Проверяются размер до 10 MiB, MIME по содержимому,
целостность, безопасный filename и не более 40 млн пикселей включительно.
Миграции до 008 и bootstrap запускаются отдельными задачами. Две декларативные
S3-политики хранятся в infra/s3 и копируются в Docker-образ. API и reconciler
получают разные ограниченные S3-права; owner credentials отсутствуют в API.
Публикуется только LB, консоль MinIO выключена. MinIO собирается из закреплённого
исходного commit, поэтому отсутствующий готовый образ не блокирует сборку.
Перед PUT отдельно коммитится журнал pending. Advisory lock на ключ удерживается
до общего COMMIT Attachment/committed. Worker сверяет наш bucket/prefix постранично,
пропускает активные и свежие файлы, закрывает зависшие попытки и удаляет orphan.
Dry-run не меняет БД/S3. Missing-оригиналы отмечаются с сохранением сообщений;
восстановление подтверждается размером и SHA-256. Ошибка DELETE не исключает
объект из дальнейшей очистки.
### Запуск и проверки
```sh
python3 scripts/setup-env.py
docker compose up -d --build --wait
python3 -m venv .venv
.venv/bin/python -m pip install -r requirements-student.txt
make -f student.mk verify-lab4 PYTHON=.venv/bin/python
```
Инфраструктурные проверки выполняются последовательно на локальном учебном стенде.
Сохранность проверяется с прежним токеном и доказательствами StartedAt до/после API,
PostgreSQL, Redis и MinIO. Чистый запуск использует отдельный UUID-проект, пустые
volumes и полный снимок исходников, включая новые файлы; API строится с --no-cache.
Сводка: `evidence/lab4-final-summary.json`; подробный вывод —
`evidence/lab4-final-*.txt`, чистый старт — `evidence/lab4-clean-start.json`.
Отчёт и методика: [REPORT.md](STUDENT_REPORT.md),
[LAB4_RECONCILIATION.md](LAB4_RECONCILIATION.md).
### Ограничения
Нет автоматического восстановления потерянных байтов из backup. Поддерживается
неверсионируемый bucket и штатные писатели, соблюдающие блокировки. Хранилища,
LB и host остаются едиными точками отказа. Последовательный обход имеет линейную
стоимость; локальные измерения не задают production SLA. Журнал/наблюдения сохраняют
историю без автоматического сокращения. Применение любых исправлений перепроверяет
состояние, а не слепо выполняет ранее выведенный план dry-run.
- [x] Обязательное API lab4 и прежние возможности сохранены.
- [x] Оригинал, ACL, failover и restart проверены.
- [x] Негативные случаи и замечания преподавателя покрыты проверками.
- [x] Ограниченные S3-роли и приватность bucket проверены реальными запросами.
- [x] Трек 2 имеет гипотезу, сценарии сбоев, повторяемые измерения и ограничения.
- [x] Секреты не входят в исходники сдачи; .env создаётся локально.
- [x] Использование Codex и первичные источники указаны в REPORT.md.
+379
View File
@@ -0,0 +1,379 @@
{
"format": 1,
"lab": 4,
"author": "Каменский Андрей, БПИ2301",
"clean_start_code_matches": true,
"private_credentials_scan": "PASS",
"files": {
".dockerignore": "62c0534ad74d9f0e2982e97d1fbadb66d80c493ed237df5bcb9fbb797062eb38",
".env.example": "08edfd4f68f801cd8db6000dfa040f9be7ff10a11c6bbdf7544f6c996fc2f909",
".gitattributes": "0dadd4b1a4ae7778c71877bdf1643531eddda7d36768bc06205692cbcd89f42b",
".github/pull_request_template.md": "3e565965912efed231a91675bc25950b76d7303892bdd8819d2e5209b522a55e",
".github/workflows/contracts.yml": "419e73533e32f083c20516f683711f0c1a3206fa497d9538fa8cb676b9ffb00b",
".gitignore": "c999f938485ff5e0bf83e5d0c386f936abc051e1d4e0fb7eeb66b6995f06c0b8",
"CONTRIBUTING.md": "2c01dd698cc9653dece49a94c9fd3f58d36e84764aaa643b46e26d7e599dc12e",
"COURSE.md": "c34d53cd082d194aa4b58f504c4e0348d25b6afec3d6a9c0963dd01c9c81e971",
"Dockerfile": "f6d3a539fd5b0787c366c76dc0e02086857eb465790bcaa599ab7a36ea2f5c35",
"Dockerfile.example": "fd7ac9491c0c3c663b083c41a762fb38bc2d212fa4a2ed3e6a0702af72108709",
"LAB2_CHECKLIST.md": "93c6a769e9976e27a0385306caa47d1f1ecb801b5eee8d8291acb71407f316c0",
"LAB2_GUIDE.md": "d1fd24c4d20466dba4671c44699b1811b48b820c11ebcb2fc7d76019e1d9bd82",
"LAB2_REVIEW.md": "dea37b8a76f9e274429d23572cf1e10b61deea71b1f01501d69defb92eb6872d",
"LAB2_TASK.md": "4f14a97911bd3ea335868d37fec187d1738b42f91a7d4780d33b721edf25b6dc",
"LAB3_AUDIT.md": "8e38000227ac201472e7983f19deedbf4858c9fda541851fb8010350ba0da853",
"LAB3_TASK.md": "7622c956ad4508d10d1807b4190461e3a7911a22759108ecf812d5bc477ff7a2",
"LAB4_AUDIT.md": "4d1cad8f5821421bac85cd2d88d73a5197db62955b8fe03f917c4e36d0ebaf5f",
"LAB4_GUIDE.md": "6b43c78768c051f540afc075ab87eae6b553c186069e9f33d442c16d4fdc6baa",
"LAB4_RECONCILIATION.md": "32ad564a38ceff48668ac09936e3d2beaaecd1e2f2edd29e3c0742e9a1a6ee6e",
"LAB4_TASK.md": "7fc4cfff884705202115fd93b7145d5bc3452e4db156dfef2b04e9d9edb74408",
"LAB5_BASE.md": "fb5ce2691f159dbc8368eadb16840b1da2fad315aac8afdda01267564a90329d",
"MAINTAINERS.md": "bc1bcc8c415c606f55274ee67987f80206321e045626b0a9236f5721719b7e9f",
"Makefile": "eff61ab3bed88c2a5697735643d94df1f2b3d0db14971abbd3fcc70323bd42f8",
"PRODUCTION_REVIEW.md": "48e34919dc4f9e96a2f8bad4446a8d75badeea6326af82fdb025fca48f7b4af8",
"README.md": "3a4bce648cbddccd735b55eea1f9d743faffceaf61f762a8a4a7e89df7926092",
"REPORT.md": "c319f814d086c9de12d03a94ad26b4e99ba1f122c3cddc57a781feb201dd9d98",
"alembic.ini": "024bf3fe092ea4f8e6bb6309cba89e67b53bada366dee6859339297f090fdda1",
"compose.example.yaml": "5368758f38e47f42c864b207f4baa05d5086773fa397b035dd2784d385e5c4a0",
"compose.yaml": "86f40a2b6485fd9ba18b33171d7cd1c99e36b9b5e2e1ac0409e2aabd45af0793",
"contracts/README.md": "72df27a559f88ffa3fd8c3c79d3c32f6db2c5986a0602677c51994c434a3fc4f",
"contracts/course-README.md": "72df27a559f88ffa3fd8c3c79d3c32f6db2c5986a0602677c51994c434a3fc4f",
"contracts/course-openapi.json": "c5c0ebdcf205018126c5bb91e2512b11f543827e76baa21d776210d05a0b2cca",
"contracts/examples.json": "381cc18c03789e935b391d007fb5843964be9cfd9f7530cb6b1996ed4a1c4c37",
"contracts/infrastructure.json": "baaeb5a2233096a50d791f521bfc6dd66a23e516f81833c2b17c554cc0bab5d8",
"contracts/openapi.json": "c5c0ebdcf205018126c5bb91e2512b11f543827e76baa21d776210d05a0b2cca",
"course-tests/README.md": "e0bfa7e196797f6a5bf6e44d8ad2ffeb82651927ff5d8484eb1c2dda1ec7dec5",
"course-tests/client.py": "8d50976fc7c7bbb81e88a152f613c61ab25eaf53dba33c6a9dfab19f868d546d",
"course-tests/fixtures/sample.png": "99ea7533c441f79cd630d15ce4d58d1ec4e06f6f0efb3b77a5c088305cd1bd75",
"course-tests/load.py": "6d3511ea719c7a7e841083e73d435c86dcbfd9f4e5c2a07d62eb9614b01d9933",
"course-tests/resilience.py": "1f96663a174b3978d24eff66f2741f5f8c9b788d3242261d37a972720c52788b",
"course-tests/smoke.py": "52ac38eb343ff7d43e7543588e1da58ca06c9fce74b2b0d0bf0e4982bc23c1db",
"evidence/README.md": "78e4bfd738d034597d15d8846accd8a8a5dc738a23a3d15f243f3992bd530cc3",
"evidence/lab1-report.md": "472496ea046dac25daaf1db2cd490beb1eed3aa080f2a82ee2fead0371ffdd54",
"evidence/lab1-results.txt": "39f86842b8ac61cdb4e46a2c51c68f1b5515c91a1a2e3bb783e5041054f50951",
"evidence/lab2-alembic-api.txt": "002a16c65fdd6f2615b383903b73902c70b63a7f6e3d36f44d2826e525c9db9b",
"evidence/lab2-alembic.txt": "5750f1e935c6ca64102d33d86f4e88019016c2a2428d69407614ccbd4593d778",
"evidence/lab2-argon2.txt": "3d1a3447fe342ddf4179a9529a6057c9855d96d22f1cc6ab0c9a0cc36c0befba",
"evidence/lab2-auth-quality.txt": "72957b6e091a1885c694134a59ab0da519c8c94c126303ed6178a001d766c2a7",
"evidence/lab2-auth-runtime.txt": "47e606243307c4fc949f9f39765739dc72770e6b770cb0ace5b1eeb6f1c6a2a0",
"evidence/lab2-callbacks-quality.txt": "8319eb9f5f6f62e7472c63f7fd07598a754675c042bc1d7a3315bbe86ffc2a22",
"evidence/lab2-callbacks-runtime.txt": "0d35bac31b0eb9a3deff4280bb86d148e8346e87dcedbdfc2e2143ae802a5f4e",
"evidence/lab2-checks.txt": "fd877dcc9c6d119e9eb4fc81f232eb838c23dcf1d9c885f223a2ed6c02c2d907",
"evidence/lab2-database.txt": "f9757b39ef374afb644725c34449987efb110b456dca3e1b0368b7aa2905df63",
"evidence/lab2-failures.txt": "51d2a30d0d8f5f535db52cdf1de46939683fb1df1a25e113de58193d268663d8",
"evidence/lab2-json-login-quality.txt": "983f8bbc5c8b529b3546c38861e5547c08cb0343f9b4b8e86025e819a935f938",
"evidence/lab2-json-login-runtime.txt": "9b32fc093b6790d66ee8342fa69ed664282f2d3a19a1232b4ad6bfb575320183",
"evidence/lab2-persistence.txt": "bebee89766b9933d4b1279060658983b981bb109eddc4e6fb7499ebf86d08977",
"evidence/lab2-production-after.txt": "bbbc9c4143eadf7eaf6ffe65e10b2ca334cd9746b7d8e143128bd7d7bffe59a9",
"evidence/lab2-production-before.txt": "352dd41f1cc1ae11038c8cf7d1e56353f951ccba7d29f450768f15a283b2a910",
"evidence/lab2-production-dependencies-before.json": "60e09e41f38a6ee74c4e8b0b752a16e4588c7cbc89d4b116369702e6704512f4",
"evidence/lab2-production-dependencies-before.txt": "7850b311e17fa98f27125dd2f676ece0afe14a8e758e225059e80918051ebe91",
"evidence/lab2-production-dependencies.json": "4ef346f6390d6ae670ccb5f5a151273d09ec70ea08c2bb30d71d091bd834f901",
"evidence/lab2-production-dependencies.txt": "67d375e91856b0385a8bf51f8900f87ab2ead441c86d5028f797f943511eef08",
"evidence/lab2-production-image.txt": "f612ab3d7ca8ea093018b8f40ffe763bf14129fb52721d65353ad538eff529c2",
"evidence/lab2-production-limits.txt": "dab3534fe2c4751d8596d6106ccb38a42ee68f7dc2d7b988c93cd2f457bc204b",
"evidence/lab2-production-network-final.txt": "5443bbc1e6cffe3440e5316a1313b3e5da09c7d5fbc0e81b3643c1074f536310",
"evidence/lab2-production-quality.txt": "8ac2c95ba5c3c5fb7765ed383092898ecd4d3ca445f508ce4ec43c864899bcc2",
"evidence/lab2-production-runtime.txt": "55f6828860ec1334cfc45759c4a3a25cd7ddc981c787207519df8686f95f9e6c",
"evidence/lab2-redis-sessions.txt": "c36d39ea99e59e03188249662a19948792c13fc9ac839bfd6234771593cab47e",
"evidence/lab2-report.md": "3a5bc857d78cadd2cf939b7bc712f740ac8da9ce8c2a63c8c7fa041b025ec8dd",
"evidence/lab2-review-additional.txt": "dd1366d1ed1774d7f659a752457eecee09f33715a9872bba51ed3273f73806fc",
"evidence/lab2-review-failures.txt": "4ce930892e3b8b6291be7e49e1a45972ec495fec0c177f2246535cb2c402cd42",
"evidence/lab2-review-quality.txt": "983f8bbc5c8b529b3546c38861e5547c08cb0343f9b4b8e86025e819a935f938",
"evidence/lab2-review-runtime.txt": "755638752b236f9447c3f590ed873dacf1351ff8c161dc557bd69d1739c28a2a",
"evidence/lab2-settings-expiry.txt": "77c2092073557c14439051d0fe4b5bd704582c6061368b521d85ec836a775a5e",
"evidence/lab2-settings-quality.txt": "15738f352e6b489669f1c2b78b499405edee2998839263dfab7935c85f973f3e",
"evidence/lab2-settings-runtime.txt": "3952868e8c4d9ca6b1cf50a5edec2d59717bd12d86ad46bfbe56752afcda05c6",
"evidence/lab2-sqlalchemy.txt": "e02382975a3854ad997288e6baea79885669878e0bf166838e5678b318fac022",
"evidence/lab3-500-headers.txt": "78d154cb8adfce2887505fa75061d30922a187a5e01c7c782a6d01ff69026d9f",
"evidence/lab3-audit-before.json": "e028214d4d634a1568dcf3dee446419c67ab78b1d281f6a764c78cecdc3caa85",
"evidence/lab3-audit-changing-ips.json": "dd8d3ac3c12dafb24c0fad75e7d1b361c3e1a1a290f743e931bf08c5ebfa8a0b",
"evidence/lab3-audit-contract.json": "0cb908ee39402a4c762fbe54bd21a5cbe608bf62a51c563bac3da1ac18140b72",
"evidence/lab3-audit-first-run.txt": "225d7866052c114ef51b7600b5ff1f6737d0b89716e50387324b34cdb52e8927",
"evidence/lab3-audit-frozen-stores.json": "a8172e1edae6d7ecd00f98d657df7ae724c57449cee1f81c5096be182f0578f6",
"evidence/lab3-audit-limits-evidence.json": "8aacb91500cd0609d8d4357d302fd1f9f4d52293119a91e44384326b14e5e921",
"evidence/lab3-audit-readiness.json": "e3d03a2f399ba1b02319b182967095772acd4a396bd291768a5f9ccf013a54f2",
"evidence/lab3-audit-run.txt": "ec07d1d4e1fd64d9fc7291dedcb91cf118103e9ea969663231d0995d13b15ddd",
"evidence/lab3-audit-summary-all.json": "662475dbaf9038285f89de2b79bcf2dcd258850d7a5f379bc34df5b52ae3626d",
"evidence/lab3-cache-edge-before.json": "2515e2ffa2e41c0eba56aca797c66f167140c1ba583191e3ce31a7cb38ca8ab9",
"evidence/lab3-clean-start.json": "5767655646e659600b8d73465fc1b6e340a01130a8fb235a06a672122926613c",
"evidence/lab3-clean-start.txt": "5767655646e659600b8d73465fc1b6e340a01130a8fb235a06a672122926613c",
"evidence/lab3-control/method.json": "d0b58111acd56ba8153b636304e13788c9b958e7dbe8618840aa1aa8330dbd1f",
"evidence/lab3-control/results.json": "25eef5d12a45f068209dca8f8acd4c0c0e918c178f34b20b30be795b8bead05e",
"evidence/lab3-control/run-01.json": "cbee52c4c2c91328b71301b7a3b6e0f7c6cc2dbeac4c38146afc1da0ce7f33c6",
"evidence/lab3-control/run-02.json": "54c091a8aa6a407c82e8e19ce6d89841fd7f845fb76e8f4775560c9932844d6f",
"evidence/lab3-control/summary.csv": "3c77706e65ae8291092a0512e6757c642d8908d1a49faa47a2c29b4135f475d4",
"evidence/lab3-db-idempotency.txt": "22a74ebaa53afe9c3e50e25a384c47866daa2ea0022dac1d6aa6c519b062da8d",
"evidence/lab3-edge-audit.json": "d069cfdb5fe2efdbc54dfc4d1e6b7b912033a9aa773c82fd11e6e0f9a5701c7e",
"evidence/lab3-edge-audit.txt": "d069cfdb5fe2efdbc54dfc4d1e6b7b912033a9aa773c82fd11e6e0f9a5701c7e",
"evidence/lab3-extra-audit-before.json": "bff94786de7081de3f2e0d0bc4213af630099ecd1b78989d13b861ea1929d3f9",
"evidence/lab3-extra.txt": "5a1fb843ce8fe3fe3440da1d32471ac850945333b3cd76d181b5cdadab6d2c8e",
"evidence/lab3-failures.json": "66cd4f46921697809bcd5ae11e48a87a283f757d17a58f2c39a2836e8b16e6c1",
"evidence/lab3-final-callbacks.txt": "4a0892bdb647713353af05b2e8a2286a6943acc3d1ef17cc96a3c9fa66a4d68f",
"evidence/lab3-final-checks.txt": "b9248ecea6a33fb267aee05dfb0c5aabebd69698d61e469adffa5503d6d87576",
"evidence/lab3-final-database.txt": "9cbbd011646c1a7bb5864a07868c80d382f71708cc53e5d13c6f72609b3f6a12",
"evidence/lab3-final-dependencies.txt": "ccc50fed22eee589139911021bb1bc4f74671603cc6af54f4d3a9f124c422ada",
"evidence/lab3-final-error_headers.txt": "01eef328846520f6222186372fd816355d00d9b5674ede1775f2b505cbd5a4b6",
"evidence/lab3-final-idempotency_db.txt": "22a74ebaa53afe9c3e50e25a384c47866daa2ea0022dac1d6aa6c519b062da8d",
"evidence/lab3-final-lab3.txt": "3239d3e8305c00c51c74fcc363f55fc6f4baae9dc359d08c495506e1419f172b",
"evidence/lab3-final-passwords.txt": "2c39e0ea11b0bf55c64f7a6f828eb4f19bebfd791404d7fbb6200acb86857692",
"evidence/lab3-final-readiness.txt": "b438a8c6836924e83830cf0efdd4355be5e9227c332fd6fedc9a5c16f12084e2",
"evidence/lab3-final-regressions.txt": "34a9299a69c01de47319f7ed8fccccfecea566b2c37715a34585b387b34ccabb",
"evidence/lab3-final-settings.txt": "08e331f85ae830bc10461a995f2fa82ccc94e985d5310897ede3be293f446e66",
"evidence/lab3-final-smoke.txt": "58cee16087387ba887af7995d3492b9549bc11a0e6b0ab8d204daefbd7271d14",
"evidence/lab3-idempotency.json": "96193806eba0dc609847b066a14d8a9f74b34ed7a348dc10e18b9a91cf363496",
"evidence/lab3-infrastructure.json": "3b8cc78233d192ccad2498ff1797afef9c06d78d7b0d224cd78b4be1ee40925b",
"evidence/lab3-lab3.txt": "1fdab40c96c91d93c9addae9648a851af41de3f814d7fdf8630c0026b64b101a",
"evidence/lab3-original-research-run.txt": "af5854bda4fd7e74a181d3f9020389d0c9e5855750074c5ef229d6c870e93d43",
"evidence/lab3-persistence.txt": "e02faf150363968a8e46ae95e2beb9bd1081d9cb13e8be490a170712f8a81851",
"evidence/lab3-pr-description.md": "f944732e2d6ec2c668e4a14ddd20b3728dce039be82491e87d07abe55bff2958",
"evidence/lab3-production.txt": "e2749c926b6aab4e47435e5b499ebec4d9828fcafb492f968dd4646c682bfdb1",
"evidence/lab3-public-artifacts.json": "2f8ed4935870c8c865012b4ef0cad43f7a3ea03b1cceb7e586d4b14eb37929ab",
"evidence/lab3-public-failover.txt": "49e0eb9268ebe732cb8b0b7706dd0fd8441872e79903ce1cc77c9373ff4c3f40",
"evidence/lab3-quality.txt": "484010ce995e90e28854a117ccff672afca7241adb6a371dc6d2baa35a989aaa",
"evidence/lab3-readiness-budget.txt": "b438a8c6836924e83830cf0efdd4355be5e9227c332fd6fedc9a5c16f12084e2",
"evidence/lab3-readme.md": "c20fc548a1d7e3137cd329448c23694ddb07b1886f4c6b98ac724ff4ef754e48",
"evidence/lab3-regressions.txt": "34a9299a69c01de47319f7ed8fccccfecea566b2c37715a34585b387b34ccabb",
"evidence/lab3-report.md": "a30e7b4cf1b9fb52f43d17b8c014ec720dfb75cad37549816aefe002a90d55de",
"evidence/lab3-research-plots.txt": "1827ffc6b07de12d354d69d7e6d6a1497731be5ebebb7521d26cc0f10feb4a62",
"evidence/lab3-research-run.txt": "5d60ca3991831c5441d88276ea603771fb909948d0f3f96dcc0c5dd3eb2a28ee",
"evidence/lab3-research/README.md": "7c0767ab14847d3abe9b3cb46da2114c598d1cacbc4311d29e8192f26446155c",
"evidence/lab3-research/bottleneck.png": "2639512b3147cb5a29f515e7704417eebb014a6557a110647d21d352423f7cbc",
"evidence/lab3-research/bottleneck.svg": "85e890a8dc1c2b8ecb9884122e6acca29378e76dc74f0c1346a59c03b7790800",
"evidence/lab3-research/method.json": "cc8c8f1a41defc136ac18932662c938ce8a9e87e5e5a7387abe4d55703d0d764",
"evidence/lab3-research/results.json": "07c0a21c7b74efe1e0cf9ddab5ccb6f2d52daa943055245170bd1c87c4e7e241",
"evidence/lab3-research/run-01.json": "85911358cc985036335cd839fa7a43f00d68c5c92b31cc336972a22c53574b05",
"evidence/lab3-research/run-02.json": "b96e89642ec371455d40b4f0e5bf98173a5a7b63b555eca1d0044514c9cf4f96",
"evidence/lab3-research/run-03.json": "398da4de7e5e4d07a7b04d7a62641fbc1c95b5527c98c5ed900089bada5359ca",
"evidence/lab3-research/run-04.json": "3530f35583a49b62c9a9eab7a0245f57368f09d60308c2b4b15109c8c7c80884",
"evidence/lab3-research/run-05.json": "947ccdedd719f5f71934a54579c4f61a0832d5c407f033ead6711f8e6dcc2ded",
"evidence/lab3-research/run-06.json": "b2641494dcf7a37e7118cace9cdfe59fa60e285bd5c11f21b692cead53d449bd",
"evidence/lab3-research/run-07.json": "bb0a5a957271bd2e62a4581790c00c972498cd35c54ddad2d93f90962551abfc",
"evidence/lab3-research/run-08.json": "25de3ea5f76ec198bc819361a24f68216e7b18fdc4bf12b433c1033ff5d1915a",
"evidence/lab3-research/run-09.json": "c39fc1238f25c4f502f2a02ebf67725b8b27d305cccf783405600dff05501ecf",
"evidence/lab3-research/run-10.json": "9cedb0553356d14da67c58cf37e176270c8c2546599553db5c1e0cde87ba240b",
"evidence/lab3-research/run-11.json": "cc9d2858ba22981895897f1ddd9ba9668b5d3b25d611b010b822c18203209ac7",
"evidence/lab3-research/run-12.json": "1700b51d5f14c68bdffe0f8f81ee8a86e44d67eb7f3e9acf3237a80db9cd62c9",
"evidence/lab3-research/run-13.json": "5d33b91230252bd22571e24216919dd98cf8f29c79e1a396e6bc15445fa629e9",
"evidence/lab3-research/run-14.json": "35f697b1c9abb62924498023280bd846af4699b6e2e6c58a28694768ef0e6916",
"evidence/lab3-research/run-15.json": "e17d874073eef8de68d19f068242a13aa14bafa63e415f1481bd6a512098520f",
"evidence/lab3-research/run-16.json": "909f683f7638d16f515fafebd6f143dda68a50ed23386a28401622a4719181c3",
"evidence/lab3-research/run-17.json": "2a95a33015e5846e19ad128cc1f95115b99f247b0ff38eb694fefc5203eb73d7",
"evidence/lab3-research/run-18.json": "11f1b66c6df6f2a2fd06cb8e4ca6bfe7865aaabc8c81c1113572ef20d686fd58",
"evidence/lab3-research/scaling.png": "654be1b0652d19b4eb2c70db1c102947cadb8dd92ca3586ebf20e9c15d10b3b7",
"evidence/lab3-research/scaling.svg": "f7d94e8d60623ceae87fcef0972649ba2cb538d24195d87d3e5ad690e159ae54",
"evidence/lab3-research/summary.csv": "a6f75217347794f4acf414f5367c95b691189ec8474a61e72009da84d4c88465",
"evidence/lab3-restart-proof.json": "b3dc6651f3cbd5d3bdd8ea173b02c24d422d9362fc3726c64ef7ad77d6f31e19",
"evidence/lab3-review-summary.json": "ce00141c300a1caf64e6300863ddba61235059c2fad12b0cf213350f52de5986",
"evidence/lab3-review.txt": "8ba77e5766ef665dfbf795d478b5dbe1d25897606fe24e3e5f0090ec612cae32",
"evidence/lab3-rolling-load.json": "94922bff8fbfb823064200bebeca3201476d2b60da4296406474f6245ae38b1c",
"evidence/lab3-rolling.txt": "d0f30f65e47f732d3fc514e87d5ed0974bbd1f610f6dd4608ec5634b418b5b72",
"evidence/lab3-smoke.txt": "58cee16087387ba887af7995d3492b9549bc11a0e6b0ab8d204daefbd7271d14",
"evidence/lab3-unicode-migration.json": "8e98c090381e7ed694d46b62d799d9ff96e5cf56f5765f858f4a8e9da47b8451",
"evidence/lab3-unicode-names-migration.json": "7d2038b09921bd700986b73b47016d37d13d9996b3f1ce779d9825a6e364dd29",
"evidence/lab3-verify.txt": "2d3d149de2300454320c3d63f99099d13b6e8da9c167b25fd8e69c9b1e0766d7",
"evidence/lab4-attachment-failover.txt": "f64d39de3dc97f2f63aac414e3f31d2b7fe470cc482627ba558b8496443c53ca",
"evidence/lab4-attachments.txt": "506ecbf2abb8c553d632ae2077dfa6ada440cc071abcda53379cd5fa289376e7",
"evidence/lab4-bootstrap-clean-start.txt": "c28ca3be3dce9cd6dfcf1bc2d63043416fdf39f9e1f1b09b8212bcc6e371e9f0",
"evidence/lab4-bootstrap-refactor.txt": "91a00a93324cd7da9f9088f57ef85bdfa097df072fe6a811d42b01651afaadae",
"evidence/lab4-clean-start.json": "4298040cc2f9459f011e7a1a3e292007fc918a415b53960b003617f152fa7116",
"evidence/lab4-clean-start.txt": "6a411e542880440eefe3b6068797fdc41e3f52aabe58ad7e3d1c5af04adead78",
"evidence/lab4-final-attachments.txt": "506ecbf2abb8c553d632ae2077dfa6ada440cc071abcda53379cd5fa289376e7",
"evidence/lab4-final-clean-start.txt": "8b70c88dc4241419e44d85217f8251539497ab384fa80a7dda69a311cb1c7e1d",
"evidence/lab4-final-format.txt": "b642d2f0cc49caff9e609808fb9c82854fc174b2f54b459a0d09dbe4c0f837ab",
"evidence/lab4-final-idempotency.txt": "4606fd4dbc1d5fdfcc891cbfc967ac76c5c5b5bbb790ba6c00ea6dad436fbc9f",
"evidence/lab4-final-openapi.txt": "516e71d5728e863ed942752e9efbc4f65714ab7281a3af2c472fda5bb4a9b963",
"evidence/lab4-final-persistence-proof.txt": "3f32089a7c4f484b1c1d4a3ac8993abe07312f8f1b3bd8a986b198760fd93669",
"evidence/lab4-final-public-smoke.txt": "59c0b2b30d44d6ee3d44ea86fa4946c2f87d0b89ad0fcd57652dd4082bcceafd",
"evidence/lab4-final-quality.txt": "82b3e6a6c090a57601d22943bd23fca9218d1031dbe5a7b754092f9a156b4f18",
"evidence/lab4-final-readiness-budget.txt": "b438a8c6836924e83830cf0efdd4355be5e9227c332fd6fedc9a5c16f12084e2",
"evidence/lab4-final-reconciliation.txt": "32d3797ec915dbf9cc829e14ea546f68b042da30dc9553a072769733721b9622",
"evidence/lab4-final-request-deadline.txt": "6a5288cc2d77e914541566f45d716642fa227350ae92badc5a4eeff3610f69f0",
"evidence/lab4-final-reviewer-cases.txt": "ba4b919516c839e73146b7b9f1d1ecd5194b7e42b107d661b035e0547caf86d1",
"evidence/lab4-final-run.txt": "5b65eba805cc8283798fbe22492747db2e9f3f19fbce37862899bdfd477d322c",
"evidence/lab4-final-structure.txt": "cd7f9c6d8443a7595346367c3ecc9daa099204db17d71ba8c41bb40d0d868bc1",
"evidence/lab4-final-summary.json": "e1cb94a9bfe63ecf011ab5c86e7229819f5a0fbd101553d9cd98db0e1fa7145f",
"evidence/lab4-final-upload-memory.txt": "c059a9e6634dd1b26969d45d17ed3947573acec900ceb1344e1c75d7851dc64e",
"evidence/lab4-final-uploader-failover.txt": "f64d39de3dc97f2f63aac414e3f31d2b7fe470cc482627ba558b8496443c53ca",
"evidence/lab4-lab3-regression.txt": "aea3426c0326c4d4718b29f3674485cba7c5ea39ce9d0a05978e5157dbdce2b0",
"evidence/lab4-persistence.txt": "e02faf150363968a8e46ae95e2beb9bd1081d9cb13e8be490a170712f8a81851",
"evidence/lab4-public-artifacts.json": "d032d7b251dd20e46b34b9fd79f2f691dc49c1878fcde1315f397fe45a1b26c2",
"evidence/lab4-reconciliation.txt": "9aae52dcb823c58d9a21f1561c173bd64c6260f3653682f8e3e15f0171791373",
"evidence/lab4-research/results.json": "9bb75f7190c316a0645aea398615e6c60e9b336b162cfbcfbec29d042b60592b",
"evidence/lab4-research/results.png": "869e660c4ba969749570645aa90d2bcdf75d3669cd909bad76b58cef7be897e6",
"evidence/lab4-research/results.svg": "2f7613ad1e156f519743b4b6abbd4b3207718fe3d690f249f50edbf26a4bce19",
"evidence/lab4-review-inflight-after.txt": "a783c0a1a5fb1b8138d81faefe025283d562af18325a6bd961433533fc5b5f28",
"evidence/lab4-review-inflight-before.txt": "3b3375fdd1aef72907eb416e6eccc85c240556e81d775c8a20bd8b6ce2c2be04",
"evidence/lab4-review-pause-before.txt": "ac2070384201bae2f159294f8129fd9ffa231e5b1079199000a3a32b9dfc8708",
"evidence/lab4-review.txt": "b0798b3f3693657c69de9cae939a813698c2d259af638fa9bf211be5f6981ff7",
"evidence/lab4-s3-unavailable.txt": "2c805922abff1234a5956bd804453415b0bc3b2dd648caf92f87136912ab28f4",
"evidence/lab4-smoke.txt": "59c0b2b30d44d6ee3d44ea86fa4946c2f87d0b89ad0fcd57652dd4082bcceafd",
"evidence/lab4-track2-attachments.txt": "506ecbf2abb8c553d632ae2077dfa6ada440cc071abcda53379cd5fa289376e7",
"evidence/lab4-track2-environment.json": "fcaa8cfbbd225fe24f8986bddaa124119f061c5d9bff80f0a436d60003102a0b",
"evidence/lab4-track2-failover.txt": "f64d39de3dc97f2f63aac414e3f31d2b7fe470cc482627ba558b8496443c53ca",
"evidence/lab4-track2-idempotency.txt": "d94fef6a46877d2a1de1b8b7315ad2622de353bb37f0844595985d7bcd9eb447",
"evidence/lab4-track2-persistence.txt": "e02faf150363968a8e46ae95e2beb9bd1081d9cb13e8be490a170712f8a81851",
"evidence/lab4-track2-smoke.txt": "59c0b2b30d44d6ee3d44ea86fa4946c2f87d0b89ad0fcd57652dd4082bcceafd",
"evidence/lab4-transfer.json": "fc7a2df55fe0a39da9c651dd46502a6168d91fa2687c449801fa6d08021ad775",
"evidence/lab4-upload-memory.txt": "979939bb093cc16af4c0823763b921d51955d2b6dce214e84d3a8503ab3c91ce",
"evidence/pre-audit-research/README.md": "04058068412952041038a6ce4649a98d5ecfea8452306fd9e3aad8703cb6e38a",
"evidence/pre-audit-research/bottleneck.png": "2639512b3147cb5a29f515e7704417eebb014a6557a110647d21d352423f7cbc",
"evidence/pre-audit-research/bottleneck.svg": "e43c0d0f47c3a51b8b10f174dcb922d99e8766905712ecdf2cf6fc78362a2198",
"evidence/pre-audit-research/method.json": "cc8c8f1a41defc136ac18932662c938ce8a9e87e5e5a7387abe4d55703d0d764",
"evidence/pre-audit-research/results.json": "07c0a21c7b74efe1e0cf9ddab5ccb6f2d52daa943055245170bd1c87c4e7e241",
"evidence/pre-audit-research/run-01.json": "85911358cc985036335cd839fa7a43f00d68c5c92b31cc336972a22c53574b05",
"evidence/pre-audit-research/run-02.json": "b96e89642ec371455d40b4f0e5bf98173a5a7b63b555eca1d0044514c9cf4f96",
"evidence/pre-audit-research/run-03.json": "398da4de7e5e4d07a7b04d7a62641fbc1c95b5527c98c5ed900089bada5359ca",
"evidence/pre-audit-research/run-04.json": "3530f35583a49b62c9a9eab7a0245f57368f09d60308c2b4b15109c8c7c80884",
"evidence/pre-audit-research/run-05.json": "947ccdedd719f5f71934a54579c4f61a0832d5c407f033ead6711f8e6dcc2ded",
"evidence/pre-audit-research/run-06.json": "b2641494dcf7a37e7118cace9cdfe59fa60e285bd5c11f21b692cead53d449bd",
"evidence/pre-audit-research/run-07.json": "bb0a5a957271bd2e62a4581790c00c972498cd35c54ddad2d93f90962551abfc",
"evidence/pre-audit-research/run-08.json": "25de3ea5f76ec198bc819361a24f68216e7b18fdc4bf12b433c1033ff5d1915a",
"evidence/pre-audit-research/run-09.json": "c39fc1238f25c4f502f2a02ebf67725b8b27d305cccf783405600dff05501ecf",
"evidence/pre-audit-research/run-10.json": "9cedb0553356d14da67c58cf37e176270c8c2546599553db5c1e0cde87ba240b",
"evidence/pre-audit-research/run-11.json": "cc9d2858ba22981895897f1ddd9ba9668b5d3b25d611b010b822c18203209ac7",
"evidence/pre-audit-research/run-12.json": "1700b51d5f14c68bdffe0f8f81ee8a86e44d67eb7f3e9acf3237a80db9cd62c9",
"evidence/pre-audit-research/run-13.json": "5d33b91230252bd22571e24216919dd98cf8f29c79e1a396e6bc15445fa629e9",
"evidence/pre-audit-research/run-14.json": "35f697b1c9abb62924498023280bd846af4699b6e2e6c58a28694768ef0e6916",
"evidence/pre-audit-research/run-15.json": "e17d874073eef8de68d19f068242a13aa14bafa63e415f1481bd6a512098520f",
"evidence/pre-audit-research/run-16.json": "909f683f7638d16f515fafebd6f143dda68a50ed23386a28401622a4719181c3",
"evidence/pre-audit-research/run-17.json": "2a95a33015e5846e19ad128cc1f95115b99f247b0ff38eb694fefc5203eb73d7",
"evidence/pre-audit-research/run-18.json": "11f1b66c6df6f2a2fd06cb8e4ca6bfe7865aaabc8c81c1113572ef20d686fd58",
"evidence/pre-audit-research/run-log.txt": "af5854bda4fd7e74a181d3f9020389d0c9e5855750074c5ef229d6c870e93d43",
"evidence/pre-audit-research/scaling.png": "654be1b0652d19b4eb2c70db1c102947cadb8dd92ca3586ebf20e9c15d10b3b7",
"evidence/pre-audit-research/scaling.svg": "e4fb3f9cb4f0a895cde9e2939753e0da8ca6a61a117740f0e3de8a4ce04e6b37",
"evidence/pre-audit-research/summary.csv": "a6f75217347794f4acf414f5367c95b691189ec8474a61e72009da84d4c88465",
"examples/requests.http": "397bc6c114287388f39921bd5fdbc0783438c662b6969f0230e327e44faa0986",
"infra/README.md": "0e804fa51debba4c38d3cc84abf4704897665e0335b272060363f03aadd6354f",
"infra/haproxy.cfg": "6640795207cee655e5c22d685d73b2a57ae1a987156783ad5226d57d7ed6d59c",
"infra/minio/Dockerfile": "632a16d3468aa0290a0dcb69cdbdba7a8827ada9ab56d5b9903d1ba8eaf182d7",
"infra/s3/api-policy.json": "ab08e1c66eeb8e872768cba5b72a2ebc2d82f31353c2ad5c5c20a88200ca1782",
"infra/s3/reconciler-policy.json": "80fc157de3beb754a713644ed213c18d1fb571f13b5c062576fc3602cd3177cc",
"lab.json": "1fd0bc0c8de97cad2bc6e574bc5d318669e99933f2ff9a0a5615fa8d384f4b5b",
"migrations/env.py": "67360cd30a7dd1295ee80b1991c773d817bc601b30cd32d88fb38769c91144f9",
"migrations/script.py.mako": "d7558dcb7ce01d3e44830898336d3027de66e5ffdb1491c0cd27f6159b021902",
"migrations/versions/001_initial.py": "72862742da825a042bb63deef80e22cbef79da8a9b0f369644c344211c8a5a87",
"migrations/versions/002_redis_sessions.py": "5bdd751818e8577f81cbb96cd28031b569f62afff43ee72660f980bc0ee7614a",
"migrations/versions/003_admin.py": "24fcc923b12d0b68e401c7b47642563de3d5b5808821e4fefed8d69e48eb8b6d",
"migrations/versions/004_idempotency.py": "4f51289fd202cde682bf1256f9f4bfc2f17c35fc00ada7d1c4bf36182968e9b9",
"migrations/versions/005_message_unicode.py": "0851e4ae1e4d3ca8e11b00cb7714827c0de1651d9bb49cd2bfb4525cd1f2c999",
"migrations/versions/006_unicode_names.py": "fb087985717e280b7b6f67348e9cd8abb9c193ab759cff23a6e5628ecd2818ac",
"migrations/versions/007_attachments.py": "c4936a499313cd22f32fac9538d5892cfe2f2eb49aa8427d54dc72b73c7b5a7c",
"migrations/versions/008_reconciliation.py": "84fd1650ee4338c57f68328221cb82c9e75b69c52512b58907be9660677a3963",
"pyproject.toml": "a97aafb1fe0db23b2f66ad5a354b13b75f86b0aeeedd91bc3254967ddf0f0f71",
"requirements-dev.txt": "ff726d128963d3df8620a8a658387290350642ca22444c367d25dd4ccc988a92",
"requirements.txt": "977716fbc3ee1b11681500aa61cf1d561ec1d4267a1f2c35dbbed8bdcf7493e0",
"scripts/audit-dependencies.py": "39b53062b565610b531f0c7aa46842db5fc742097eddcd0bd9d25c3837c208fc",
"scripts/audit-lab3.py": "4c6cba35b5795453477ce68b1e29d35b12e981c03ff8c7be1d7d28bd9a5eb062",
"scripts/benchmark.py": "d93a933bea29400700c1ad9825929a7031406134eeffe704b7b615844549b5f5",
"scripts/check_contract.py": "7c4402c2a6ab80d3b4676e1866d6ecc87b6daea14c080bcb9be9a7e8b959d671",
"scripts/edge-audit-lab3.py": "23414eb0c2c718c942fd49380382aeb9272770bc592518be101a439c35e60216",
"scripts/export-submission.py": "d4fb68cec4680b98d1eba63873b49f7ea9c79a2b4d6d429b21837175cf96f472",
"scripts/final-checks-lab3.py": "beb2dcb18b989b8d7269b118165c2f85721412c84af3136bee7a09899a7f8558",
"scripts/haproxy.py": "6491aecbcd7f3720cde4bdd616230a8ec3a9d081d9eff3793da34e98cf332834",
"scripts/plot-lab3.py": "446426926111688c223e651f30118f9db78baac66705ed8f28b56ace5ce48352",
"scripts/plot-lab4.py": "feec49b550721bed42642edb52e1f83bbcf56d986eb051af7f0248307e6fbb9f",
"scripts/replicas.py": "ac0ba64e73cdd06957b1c8bdba5b691192cc7b261ee54f67555220f387519f21",
"scripts/research-lab3.py": "58b2aa7d7467c8d2d9bbd533a2888ea6703017ee6243b04de3f413dec47cff53",
"scripts/restart.example.sh": "0328246ba75defbced992104e986fde973f63e3830d83251eced5953263e944b",
"scripts/restart.sh": "f4bca13c78ddffbd03211b12e12d9d514e9caef750ba191dca10557e36500e93",
"scripts/review-lab3.py": "2d0b1160e448c3a8bfe9905e5d3f6f7b1683cf82d7a33e1a2f0d20267ddf12fd",
"scripts/rolling-update.py": "bb151cab072bd678e27c7152f6048f5647d1170f42dce8a2d683aa7e13517696",
"scripts/setup-env.py": "a966f0e359b1c754879cfedef2ec7408c3c6582c9631dbf4009fccbda5560239",
"scripts/stop-one.example.sh": "1bcf34394520b89d95b7605ec56675be799eea920e83cfbba306d5dc0a6d9811",
"scripts/stop-one.py": "8f14d78e99f1b86529a5e23278a33eeb7199acc77ddc529b012a38f9d6e782bc",
"scripts/stop-one.sh": "81a4e83f4daf989005e19d55d2f64c6079cfdc0d674acc4aa54e3317f66ff8d8",
"scripts/test-clean-lab3.py": "63c806eafee190008eb27dd0ec7fc0d6c18aa57614eea419fd7ee2e7eb18e96a",
"scripts/test-clean-lab4.py": "c605bfbea6e0efa464c449b2446be572078133b4428845399b462f43b2979285",
"scripts/test-expiry.sh": "657bd7b3c757d1a51ad60a3e1590c11d73e40cd098319c0d841f68345806a080",
"scripts/test-persistence.py": "699920fc23bf17f0db148f82be30d11edaff2ee9078643748383d5ba61169681",
"scripts/test-reconciliation.sh": "f61b07c5553f84b59fffceab236bf6b600aea02ec7e14f843b77868e464ee96d",
"scripts/test-upload-memory.sh": "cf4b1049c6e8b3602c2ba3b96977b6f1e193e9cb9437475d6a027b840013750c",
"scripts/validate_openapi.py": "4e981acbfc10dac58817bf922d5896e996798551fedc1b2385130e1cddb13d54",
"scripts/verify-lab3.py": "daaeb8d2a49aeeb7c32fbde4c192f98882b8fec9ae665e7028a7c0350a597db8",
"scripts/verify-lab4.py": "fce5836c17c7e6ba3cdff8a9471c25d9bb45ff09b18f38c4dbb4be251dac941f",
"src/__init__.py": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
"src/__main__.py": "b1b472fa858b203911db455eb5c25965b961510985ec4d2c94f627d378aaa9f8",
"src/api/__init__.py": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
"src/api/dependencies.py": "73c3f94d7c14d6c34031214933340124ebc4e22730b2b1bf8a2eb89a0d42e986",
"src/api/router.py": "4ac01f4ab0e646e0782c760a29fe7b5caa577046eb1ae981328daa1510393915",
"src/api/v1/__init__.py": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
"src/api/v1/routers/__init__.py": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
"src/api/v1/routers/attachments.py": "c95476d41d5794e2dbe6d24b1ced381035d6626889b0b14def2f21485e2e6658",
"src/api/v1/routers/auth/__init__.py": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
"src/api/v1/routers/auth/callback.py": "69a2cde6ac37f445e64d9afdea55437240846d158460e6fc5601ff0ce2045d2c",
"src/api/v1/routers/auth/router.py": "075648602d66bdc3497c4714d9789b2ea5661501478b05ba845b65c55a725fd8",
"src/api/v1/routers/auth/schemas.py": "ba3345570c35b8a9e55751202f9c8a27f7d338cfcd85b300c196a43ac03aa311",
"src/api/v1/routers/chats/__init__.py": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
"src/api/v1/routers/chats/router.py": "85cac2d5ade6917c99e4e6a82053f681e1d253eca4fe3eee726e9f7621635bce",
"src/api/v1/routers/chats/schemas.py": "00e0fc283069cca6c7929ef8d704aa1e577e6bfb555a496eb1b8170231c3b240",
"src/api/v1/routers/messages/__init__.py": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
"src/api/v1/routers/messages/router.py": "88f020fc60fdbf00f574308aa7b811416e308588fad27ff78ccc0f3d3b77f032",
"src/api/v1/routers/messages/schemas.py": "fa82dfb70f2f8f344c3e3577a8df4e5e365241ddcc9f2bcd43021ab952a40316",
"src/api/v1/routers/users/__init__.py": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
"src/api/v1/routers/users/router.py": "fedd9cb7da2fb21caccd8ae2080d013719b4f13382dc795de880fb8ca87f857f",
"src/api/v1/routers/users/schemas.py": "c30356333a3f6bd1b80b8cf6f4208d550201adfaaa0667e1db074c4aecc70dd7",
"src/api/v1/schemas.py": "403d5821588d8abcc33a285cd2689be5eba0e7ab0373d1e17856ff0464934766",
"src/core/__init__.py": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
"src/core/cache.py": "1973038f948f2eff50b18ba9c0ea3aa1eedd712932a41045ba6dd18dee358966",
"src/core/callback.py": "9046a504d8324a32e428ff8f4d159d452160828d470e3205400473394d380fee",
"src/core/db/__init__.py": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
"src/core/db/models.py": "3f9293b6a34334a7d9256c5666dfd050264be44589bde49628ec677312c9abee",
"src/core/db/repo/__init__.py": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
"src/core/db/repo/auth.py": "63fb17b55cf05a4b05c5f0b08d3e4f6dc6c83981c7f9d89a0d798b0d270283f2",
"src/core/db/repo/chat.py": "fa1042b689e1e2242360d1432ca84ca49f35a6a2de03810135907333466e76fd",
"src/core/db/repo/message.py": "0d5610e60e516ac5cd87e4486605f0665b6394cacd2c13e2698ff314b282e3fc",
"src/core/db/repo/user.py": "f1d36be8530772e6a969687e78bc7bb9bfe7daf8be67d1e079acb1e6c9d7017b",
"src/core/db/session.py": "9d4c07446ccc0990843c7f978c487a9976f9d926bf1e69a57f88021f742c7c5f",
"src/core/db/types.py": "1e8890cfa43c31ce77ce0c95f0a8a535d0730835db16f33b086226bb189ad7aa",
"src/core/errors.py": "5f93764110b969832766be8a6302515edf2eecc44de4d43c4d350c9c20d31432",
"src/core/pagination.py": "3e1c7e5232dc27688f20c622f312ea10d5ce45e9d3960a4c1b61af3e885079c6",
"src/core/readiness.py": "4064b105e7157e5dfbf3591983e3d6cbf27daf418b764f9ea2ee5f3140772ee1",
"src/core/request_deadline.py": "908433803b2238b9b9bd004a5ca74010a05ee60fcb68b80f589bb3c7e1e3044a",
"src/core/request_limits.py": "69ce991f604b8c6f6a225c1f3c09002402c680ce89b2146fdedf5b816c7f836b",
"src/core/security.py": "64d6769b36090ab2824f19668f99d23669f838e82d6a785636c339b7c1876663",
"src/core/session_store.py": "874b3ffa5b52b5b6a4587dc785784f41b6958d1b3be5a6a62470623f2182a6c1",
"src/core/settings.py": "5a96b4a95d558982d4f7806b8957aa7b660ad899dc080a02f3a637b4e9a301e0",
"src/core/storage.py": "80b361c08a078574fa8204ddbda4b3806ccef9921d0744ba12c1bac4f6331d13",
"src/core/storage_bootstrap.py": "ea4ec70f9a3001c7c84f22bd414a2ad7e82866dc32de7a2ad02d0c5e2b1a5d39",
"src/core/upload_coordination.py": "9ee87e7cf79cad25af1e9454c7997f5d9312f1f978301ce801ef1596a7effe48",
"src/main.py": "8d3aae82b2a74a859ecd0d71bfe30dff85ea44e98d3aa1fedadaed0b41b2eba9",
"src/maintenance/__init__.py": "bd9fc4293e0380e6b62c869dfa75a798f83090c85490c9e6b42df87e8d344b71",
"src/maintenance/reconcile.py": "619a56167f1f72b7a3912be6d0e0a6d1453c1b27e775561515550de4e3f106e7",
"src/service/__init__.py": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
"src/service/attachment.py": "d96e09f9a2419f0ffa1047a539297361241debf06bfe0964ed4a12a318c5b025",
"src/service/auth.py": "c979b1bdf157d7468ec584093e56a16abbb6b3fb25da0a1cce6eecac792db5ce",
"src/service/chat.py": "baa2b0eb570fa0965a0e4b929313ecb1c96464997b592872f4ed193e22c48489",
"src/service/dto.py": "c44fdd911f063348efff8471277d8dcb0ffaf91672e139ad1d97c5140b813a29",
"src/service/exceptions.py": "32a232596795b28c1ca5ebbd19ed938cc6086263ceaf476716e9ae310da9f685",
"src/service/message.py": "87ea10afea7ce0d2b666015135e052cfa58af39977965712d3ca8c940ff9e977",
"src/service/user.py": "44e561c97aff49d358e5f9ed02cfe6ae85abdd384423fe9dcc7b9b05f13f4bbb",
"tests/README.md": "e0bfa7e196797f6a5bf6e44d8ad2ffeb82651927ff5d8484eb1c2dda1ec7dec5",
"tests/attachment_failover.py": "187ccd294301c5349714cbf6b3736a3f4d261f94962397db8a0cf41bd006449e",
"tests/attachments.py": "24c3c7a8b21b7943da8edd4524de550e99b42246f8af1b31eacaff9a4acb5da8",
"tests/auth_logging.py": "775d8b0024d7a06adc4965ebc3311a105039e08dba27339f19d6611a55c505ca",
"tests/callbacks.py": "15ae31258582a1dd396c1fbba40923ad62d160cc5c7ef0a7b9316085bd407f68",
"tests/client.py": "8d50976fc7c7bbb81e88a152f613c61ab25eaf53dba33c6a9dfab19f868d546d",
"tests/database.py": "f3861a319d62e70ccd59d88a5c8eeb4f59ae35ca5b58b4f1b8c3c9da99fb432a",
"tests/dependencies.py": "10d4964c56b0ab658413f5d422c45dcd489f307c6806b17d03d492f7074cc128",
"tests/error_headers.py": "093435d8ed7a897e5dea8af23e499b78d02a52ed22a50d8bccfaf2c107e921f7",
"tests/expiry.py": "7fb2f9aa4c9ecba789e826692d0e9b00b78019dffd4d19302eb0716f881cbf31",
"tests/extra.py": "d4b0df0ed2ad3713d88ae6df5fc347317481afd5cac252c9e2fab24b3ede9914",
"tests/fixtures/README.md": "c001783760b4f87a7a8441a7ba55f5d080ff48e1397d3581d72a88d7691f96c2",
"tests/fixtures/sample.png": "99ea7533c441f79cd630d15ce4d58d1ec4e06f6f0efb3b77a5c088305cd1bd75",
"tests/idempotency_db.py": "e34287187b0e5abfef8ebe9f954fdcefc7fbb315ba99151b5179ff0fdd92665f",
"tests/image_probe.py": "a9a4f89181c8e0fda6ce42e1a1af32fb42d8e3ae519e314207127c9b9b448b13",
"tests/lab3.py": "014ceba9d8fe4360257a59ab593cff25050f7c2a653a40b441f7cc290a9fe5a4",
"tests/lab4_review.py": "11a958ed47feb016abd50bb8148fb49930603f70f6842e33b8f6b1307cf50482",
"tests/load.py": "6d3511ea719c7a7e841083e73d435c86dcbfd9f4e5c2a07d62eb9614b01d9933",
"tests/passwords.py": "8e5fbb5f5ff504c61500954335b9704f94e168b6adea57da64f69919e781e5ac",
"tests/production.py": "2d09cfe976d11b3c89c7203bb8b0eeb84b0ead6f161fc718e73bca2688383ab0",
"tests/production_limits.py": "87d751175908196af89a65c9c5a606b54c870357c30f8285d5195900f3631641",
"tests/readiness.py": "780d6f07a945bdb55c6c1c124870ca9f74a6c8349ee564ce03b0a0c82a90c865",
"tests/reconciliation.py": "28e6bbba2cc928a715262a6a8da337c194eaec7933198c2b6337deffe8bdf6eb",
"tests/regressions.py": "e04157cc3ecd4d5db234bd05584d7229e68eb6d054646e804504dd589fb45471",
"tests/request_deadline.py": "e562fe4b251f5b148730aa9ba0a0364f952e88814b714d76edff152842c55d74",
"tests/resilience.py": "1f96663a174b3978d24eff66f2741f5f8c9b788d3242261d37a972720c52788b",
"tests/settings.py": "9e798922300d6614f3805922407e79754e231b362fc4e9e5f766521c70c6aefb",
"tests/smoke.py": "52ac38eb343ff7d43e7543588e1da58ca06c9fce74b2b0d0bf0e4982bc23c1db",
"tests/upload_memory.py": "4034e1dca090d5bb642e0bc59b0527c5d758c67e21aef3b9ab8e4a6653ac496c"
}
}
+200
View File
@@ -0,0 +1,200 @@
# Отчёт — лабораторная 4
- Автор, группа: **Каменский Андрей, БПИ2301**
- Целевая оценка: **5**, трек 2 «Согласованность двух хранилищ»; обязательный минимум и уровень 4 сохранены.
- Использованы исходное задание lab4, контракт и публичные проверки предоставленного skeleton.
## Запуск из чистого клона
```sh
python3 scripts/setup-env.py
docker compose config --quiet
docker compose up -d --build --wait
python3 tests/smoke.py
python3 -m venv .venv
.venv/bin/python -m pip install -r requirements-student.txt
make -f student.mk verify-lab4 PYTHON=.venv/bin/python
```
Генератор создаёт локальный `.env` с новыми hex-паролями и правами 0600, значения
не печатает, существующий файл не перезаписывает. Для обновления сохранить прежние
пароли и volumes. Если ранее owner MinIO был записан в `S3_ACCESS_KEY_ID` /
`S3_SECRET_ACCESS_KEY`, перенести его в `MINIO_ROOT_USER` / `MINIO_ROOT_PASSWORD`,
а для API задать отдельного пользователя. Для стенда с прежними значениями по
умолчанию перенос не нужен. Уже существующий пароль администратора не меняется автоматически.
`docker compose down` сохраняет данные. `docker compose down --volumes` — отдельная
команда осознанного удаления учебных данных; сценарии сохранности её не используют.
Clean-start удаляет только собственный UUID-проект с временными volumes.
Версии закреплены: Python 3.13.0, PostgreSQL 16.6-bookworm, Redis 7.4.2-bookworm,
HAProxy 3.0.12-alpine, SQLAlchemy 2.0.44, asyncpg 0.30.0, Alembic 1.17.0,
minio-py 7.2.20, Pillow 13.0.0. MinIO community собирается из commit
`9e49d5e7a648f00e26f2246f4dc28e6b07f8c84a` релиза RELEASE.2025-10-15T17-29-55Z;
готовый официальный образ не требуется. Первый build занимает несколько минут.
## Архитектура и данные
Клиент → HAProxy → API × 2 → PostgreSQL + Redis + приватный MinIO.
Отдельный reconciler обращается к PostgreSQL и S3; bootstrap и migration —
завершающиеся задачи до запуска API. Публикуется только `127.0.0.1:8080` LB;
у API, PostgreSQL, Redis и MinIO нет опубликованных портов. Консоль S3 выключена.
| Компонент | Назначение | Постоянные данные / права |
| --- | --- | --- |
| PostgreSQL | Пользователи, чаты, сообщения, Attachment, идемпотентность, журнал и наблюдения | postgres_data |
| Redis | Сессии с абсолютным expiry, AOF appendfsync always, кэш профиля | redis_data; TTL после рестарта не продлевается |
| MinIO | Неизменённые оригиналы PNG/JPEG | minio_data; приватный bucket messenger-attachments |
| API | Авторизация, проверка картинок, синхронный upload и авторизованный download | Get/Put своего префикса; нет удаления и администрирования S3 |
| Reconciler | Обнаружение orphan/missing и повторяемые исправления | List/Get/Delete своего bucket/prefix; нет PutObject и admin |
| Migration / bootstrap | Миграции до 008, bucket, пользователи и политики | Owner credentials только в bootstrap/MinIO |
Обязательная основа API включает Bearer-сессии, PostgreSQL/Redis, два API за LB, X-Request-Id,
X-Instance-Id, пагинация, доступ к чатам и атомарная идемпотентность на 24 часа.
Идемпотентность теперь сравнивает текст и упорядоченный список вложений.
Миграция 007 создаёт `attachments` и `message_attachments`, разрешает пустой текст
при вложении. Связи с чатом защищены составными FK. Позиции 0–9 с UNIQUE на сообщение
ограничивают число файлов десятью, повтор ID запрещён. Вложение можно повторно
использовать в сообщениях того же чата. Миграция 008 добавляет `upload_intents`,
`storage_findings` и внутреннюю отметку `storage_missing_since`.
S3 object key назначает сервер, filename используется только для отображения.
API отдаёт оригинал побайтно, без redirect и перекодирования. MIME сравнивается
с определённым форматом; проверяются целостность и декодирование после раннего
лимита в 40 млн пикселей. Ограничение тела — 10 MiB, включая chunked-передачу.
Приём ограничен временем и параллелизмом; декодирование — одно на API-процесс.
Временный файл находится в tmpfs 64 MiB и закрывается после запроса. Скачивание
читает S3 порциями. Метаданные не раскрывают внутренний ключ или credentials.
## Согласованность PostgreSQL и S3
До PUT отдельным COMMIT фиксируется pending-намерение. Перед PUT загрузчик берёт
транзакционный advisory lock на ключ и повторно проверяет состояние. Он удерживает
блокировку до общего COMMIT Attachment и committed-намерения. Только после этого
возвращается 201 ready. При обрыве клиента до PUT постоянного объекта ещё нет.
Reconciler каждые 300 секунд перечисляет только наш bucket под originals/ с
пагинацией ListObjectsV2. На ключ берёт неблокирующий advisory lock: занятый
пропускается. Attachment защищает файл даже без сообщения. Старый pending без
Attachment закрывается; бесхозный объект удаляется после проверки возраста
объекта/намерения. Запас — 300 секунд, настраивается. Дополнительного ожидания
после первого обнаружения нет.
Ошибка DELETE не фиксируется как завершённая очистка: транзакция откатывается,
объект остаётся кандидатом при следующем проходе. Потерянный ответ DELETE также
безопасен для повторного запуска. При неизвестном результате COMMIT файл немедленно
не удаляется — это мог бы быть оригинал уже подтверждённого вложения.
Обратный проход HEAD обнаруживает Attachment без оригинала. Сообщения, связи и
метаданные сохраняются, чтение получает 503, новые ссылки — 409. Повтор уже
подтверждённого сообщения сохраняет прежний результат идемпотентности. После
восстановления файла размер и фактический SHA-256 должны совпасть. ETag не заменяет
SHA-256. Бесследное восстановление байтов из метаданных не обещается: нужна копия.
Dry-run выполняет проверки без записей и удаления. Apply перепроверяет условия
под блокировкой; параллельные изменения учитываются. Недоступность БД/S3, AccessDenied
или потеря bucket прерывают проход, а не объявляют все файлы отсутствующими.
Алгоритм, команды и ограничения подробно описаны в `LAB4_RECONCILIATION.md`.
## Готовность и ограничение ожидания
Liveness проверяет процесс. Readiness проверяет схему PostgreSQL, Redis и bucket;
бюджет ответа — 2 секунды, незавершённая отмена драйвера не задерживает HTTP.
Обычные бизнес-запросы имеют бюджет 5 секунд до заголовков. Таймаут не ждёт
зависшего rollback: обработчик отменяется, его слот сохраняется до реального
завершения. Предел незавершённых обработчиков — 64 на процесс. Это ограничивает
накопление работ при замороженной БД. Upload имеет отдельный бюджет приёма 30 секунд
и суммарный предел до заголовков 45 секунд; сокеты S3 ограничены 5 секундами.
Исправление проверено на действительно выполняющемся запросе: сначала история
удерживается SQL-блокировкой messages, наличие ожидающего SELECT подтверждается
через pg_stat_activity, затем PostgreSQL замораживается. История возвращает 503
примерно за 5 секунд, readiness — за 2 секунды; после unpause оба восстанавливаются
без перезапуска API. Одна проверка подключения не доказывала бы этот сценарий.
## Доказательства критериев
| Критерий | Повторяемая проверка | Результат / доказательство |
| --- | --- | --- |
| Контракт и прежнее API | make -f student.mk check validate; tests/smoke.py | lab4-final-structure/openapi/public-smoke.txt |
| PNG/JPEG, оригинал, SHA-256, ACL и 10 вложений | tests/attachments.py | lab4-final-attachments.txt |
| Отказ принявшей файл API | tests/attachment_failover.py | lab4-final-uploader-failover.txt |
| Restart API и всех хранилищ с прежним токеном | scripts/test-persistence.py | lab4-final-persistence-proof.txt: StartedAt до/после всех работающих ролей |
| Чистый build и пустые volumes | scripts/test-clean-lab4.py | lab4-clean-start.json, lab4-final-clean-start.txt: snapshot, build, миграция 008, smoke, вложения |
| Большой/повреждённый файл, MIME, чужой чат | tests/attachments.py; tests/lab4_review.py | lab4-final-attachments/reviewer-cases.txt |
| Обрыв, ошибка S3 PUT, COMMIT и DELETE, повтор очистки | tests/reconciliation.py | lab4-final-reconciliation.txt |
| 10 одновременных загрузок, пик RAM | tests/upload_memory.py | lab4-final-upload-memory.txt |
| Приватность S3, ограниченные роли, повторяемый bootstrap | tests/reconciliation.py; clean-start | unsigned GET 403; API не удаляет/не создаёт чужой bucket; reconciler не загружает |
| Полный трек 2: orphan/missing, dry-run, свежие/занятые файлы | tests/reconciliation.py | snapshot до/после, контролируемые сбои, повторный apply |
| Стоимость обхода, включая >1000 объектов | tests/reconciliation.py | 10/100/1005 объектов, три прогона, LIST/HEAD/SQL и время |
| Замечания преподавателя и восстановление после pause | tests/lab4_review.py; tests/request_deadline.py | lab4-final-reviewer-cases/request-deadline.txt; LAB4_AUDIT.md |
Имена файлов в таблице относятся к `evidence/`. Сводка всех команд и exit codes —
`evidence/lab4-final-summary.json`. Подробные наблюдения и исходные результаты
экспериментов — в JSON-строках соответствующих txt-файлов.
## Исследование и результаты
Гипотеза: журнал до PUT, единая блокировка и сверка устраняют бесхозные объекты
после частичных сбоев, сохраняя свежие и используемые файлы. Стоимость последовательного
обхода растёт примерно линейно по числу объектов. Проверки выполняются на отдельной
UUID-схеме PostgreSQL и приватном UUID-bucket; реальные данные текущего стенда не
удаляются. Используются реальные операции MinIO и аварийное завершение настоящего
кода загрузки после PUT. Дополнительно моделируются отказы БД, S3, потерянный ответ
удаления и публикация между dry-run и apply.
Стоимость dry-run измеряется для 10/100/1005 свежих бесхозных объектов по три раза.
Это metadata-профиль: LIST и HEAD, без чтения оригиналов. Для 1005 объектов нужны
две страницы LIST. Текущая реализация делает около пяти SQL statements на бесхозный
объект; для удалённой БД это заметная стоимость. Измерения итогового прогона приведены в таблице результатов ниже. Hash-проверка восстановления дополнительно
читает исходник и учитывается отдельно.
В опыте RAM временно допускаются пять загрузок на реплику при одном декодировании.
Две реплики принимают 10 одновременных PNG для двух размеров, затем проверяются
SHA-256 и скачанные байты. Cgroup memory.current измеряется каждые 20 мс, включая
tmpfs. После опыта восстанавливается обычный лимит одной загрузки на реплику.
Короткие пики между отсчётами могут быть пропущены; два размера не покрывают все
возможные картинки в 40 млн пикселей. Это не benchmark максимальных RPS.
## Итоговые измерения
Все 16 этапов `make -f student.mk verify-lab4` завершились с exit code 0. Интеграционный
набор сверки содержит 15 проверок, включая отказ DELETE до удаления
и прямой unsigned GET существующего объекта с результатом 403.
| Объектов | Медиана 3 обходов, с | LIST | HEAD | SQL statements |
| --- | --- | --- | --- | --- |
| 10 | 0.0181 | 1 | 10 | 53 |
| 100 | 0.1559 | 1 | 100 | 503 |
| 1005 | 1.9679 | 2 | 1005 | 5028 |
Оба профиля по 10 одновременных загрузок завершились без отказов: 20 ответов 201,
все SHA-256 и скачанные оригиналы совпали. Пики RAM: **124.71 / 128.91 MiB**
при 512 MiB на реплику. Размеры PNG: 197105 и
4923446 байт. Обычный UPLOAD_CONCURRENCY=1 восстановлен.
При замороженной PostgreSQL уже выполнявшаяся история вернула 503 за
**5.0988 с**, readiness — за **2.1109 с**.
После unpause восстановились 200 без рестарта API. Пустой стенд дошёл до миграции
008; API build --no-cache занял 32.829 с. Временный проект,
volumes и его теги образов удалены; действующие данные сохранены.
![Измеренная стоимость обхода и память API](evidence/lab4-research/results.png)
Усы на графике — min/max трёх запусков, не доверительный интервал.
Указанная RAM — максимум отсчётов, а не доказанный абсолютный пик между ними.
## Ограничения
Поддерживается один неверсионируемый bucket; worker отказывается работать с Enabled
или Suspended versioning. Все штатные писатели обязаны соблюдать блокировки;
прямые административные операции в S3 обходят эту координацию. Backup/restore
потерянных байтов не реализованы. PostgreSQL, Redis, MinIO, LB и Docker host остаются
едиными точками отказа. Не обещается отсутствие переходных ошибок при отказах.
Старые журнал и наблюдения пока сохраняются без автоматического сокращения истории.
Тест чистого запуска использует полный снимок рабочего каталога, включая новые
файлы, отдельные образы и пустые volumes; API строится с --no-cache. Кэш сборки
закреплённого MinIO может использоваться. Это проверка исходников сдачи, а не
утверждение, что текущий Git HEAD уже содержит все локальные изменения.
+3
View File
@@ -0,0 +1,3 @@
[alembic]
script_location = %(here)s/migrations
prepend_sys_path = .
+211
View File
@@ -0,0 +1,211 @@
x-logging: &logging
driver: json-file
options:
max-size: "10m"
max-file: "3"
x-app: &app
build: .
image: ${APP_IMAGE:-mtusi-messenger:lab4}
env_file: ${ENV_FILE:-.env}
logging: *logging
services:
minio:
build: ./infra/minio
image: ${MINIO_IMAGE:-mtusi-minio:RELEASE.2025-10-15T17-29-55Z}
logging: *logging
mem_limit: 512m
cpus: 1.0
environment:
MINIO_ROOT_USER: ${MINIO_ROOT_USER:-messenger}
MINIO_ROOT_PASSWORD: ${MINIO_ROOT_PASSWORD:-local-messenger-s3-password}
MINIO_BROWSER: "off"
MINIO_API_STALE_UPLOADS_EXPIRY: "24h"
MINIO_API_STALE_UPLOADS_CLEANUP_INTERVAL: "1h"
volumes:
- minio_data:/data
healthcheck:
test: ["CMD", "wget", "-q", "--spider", "http://127.0.0.1:9000/minio/health/live"]
interval: 2s
timeout: 3s
retries: 60
start_period: 10s
s3-bootstrap:
<<: *app
command: ["python", "-m", "src.core.storage_bootstrap"]
environment:
MINIO_ROOT_USER: ${MINIO_ROOT_USER:-messenger}
MINIO_ROOT_PASSWORD: ${MINIO_ROOT_PASSWORD:-local-messenger-s3-password}
S3_RECONCILE_ACCESS_KEY_ID: ${S3_RECONCILE_ACCESS_KEY_ID:-messenger-reconciler}
S3_RECONCILE_SECRET_ACCESS_KEY: ${S3_RECONCILE_SECRET_ACCESS_KEY:-local-messenger-reconciler-password}
DATABASE_URL: postgresql://unused:unused@postgres/unused
REDIS_URL: redis://redis:6379/0
S3_ENDPOINT: http://minio:9000
S3_BUCKET: ${S3_BUCKET:-messenger-attachments}
S3_ACCESS_KEY_ID: ${S3_ACCESS_KEY_ID:-messenger-api}
S3_SECRET_ACCESS_KEY: ${S3_SECRET_ACCESS_KEY:-local-messenger-api-password}
depends_on:
minio:
condition: service_healthy
healthcheck:
disable: true
postgres:
logging: *logging
image: postgres:16.6-bookworm
cpus: ${POSTGRES_CPUS:-1.0}
mem_limit: 512m
environment:
POSTGRES_DB: ${POSTGRES_DB:-messenger}
POSTGRES_USER: ${POSTGRES_USER:-messenger}
POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:?Задай POSTGRES_PASSWORD в .env}
volumes:
- postgres_data:/var/lib/postgresql/data
healthcheck:
test: ["CMD-SHELL", "pg_isready -U $$POSTGRES_USER -d $$POSTGRES_DB"]
interval: 2s
timeout: 3s
retries: 30
redis:
logging: *logging
image: redis:7.4.2-bookworm
cpus: 0.25
mem_limit: 128m
command: ["redis-server", "--appendonly", "yes", "--appendfsync", "always", "--maxmemory", "64mb", "--maxmemory-policy", "noeviction"]
volumes:
- redis_data:/data
healthcheck:
test: ["CMD", "redis-cli", "ping"]
interval: 2s
timeout: 3s
retries: 30
migration:
<<: *app
command: ["alembic", "upgrade", "head"]
cpus: 0.5
mem_limit: 256m
environment:
# Schema migrations do not access S3 or administer MinIO.
MINIO_ROOT_USER: ""
MINIO_ROOT_PASSWORD: ""
S3_ACCESS_KEY_ID: ""
S3_SECRET_ACCESS_KEY: ""
S3_RECONCILE_ACCESS_KEY_ID: ""
S3_RECONCILE_SECRET_ACCESS_KEY: ""
REDIS_URL: &redis_url redis://redis:6379/0
DATABASE_URL: &database_url postgresql://${POSTGRES_USER:-messenger}:${POSTGRES_PASSWORD:?Задай POSTGRES_PASSWORD в .env}@postgres:5432/${POSTGRES_DB:-messenger}
depends_on:
postgres:
condition: service_healthy
healthcheck:
disable: true
api:
<<: *app
cpus: ${API_CPUS:-0.5}
mem_limit: ${API_MEMORY:-512m}
stop_grace_period: 15s
deploy:
replicas: ${API_REPLICAS:-2}
read_only: true
tmpfs:
- /tmp:rw,noexec,nosuid,size=64m
cap_drop: [ALL]
security_opt: ["no-new-privileges:true"]
environment:
S3_ENDPOINT: http://minio:9000
S3_BUCKET: ${S3_BUCKET:-messenger-attachments}
S3_ACCESS_KEY_ID: ${S3_ACCESS_KEY_ID:-messenger-api}
S3_SECRET_ACCESS_KEY: ${S3_SECRET_ACCESS_KEY:-local-messenger-api-password}
# Do not inherit privileged S3 credentials from env_file into API containers.
MINIO_ROOT_USER: ""
MINIO_ROOT_PASSWORD: ""
S3_RECONCILE_ACCESS_KEY_ID: ""
S3_RECONCILE_SECRET_ACCESS_KEY: ""
UPLOAD_CONCURRENCY: ${UPLOAD_CONCURRENCY:-1}
APP_HOST: 0.0.0.0
APP_PORT: 8080
DATABASE_URL: *database_url
REDIS_URL: *redis_url
SESSION_TTL_SECONDS: ${SESSION_TTL_SECONDS:-3600}
LOG_LEVEL: ${LOG_LEVEL:-INFO}
APP_WORKERS: 1
DATABASE_POOL_SIZE: ${DATABASE_POOL_SIZE:-10}
DATABASE_POOL_TIMEOUT_SECONDS: 2
DATABASE_CONNECT_TIMEOUT_SECONDS: 1
DATABASE_COMMAND_TIMEOUT_SECONDS: 3
DATABASE_STATEMENT_TIMEOUT_MS: 2500
SHUTDOWN_TIMEOUT_SECONDS: 10
HTTP_REQUEST_TIMEOUT_SECONDS: ${HTTP_REQUEST_TIMEOUT_SECONDS:-5}
expose: ["8080"]
depends_on:
s3-bootstrap:
condition: service_completed_successfully
migration:
condition: service_completed_successfully
redis:
condition: service_healthy
healthcheck:
interval: 2s
timeout: 3s
retries: 30
start_period: 10s
reconciler:
<<: *app
command: ["python", "-m", "src.maintenance.reconcile", "--apply", "--interval", "300"]
mem_limit: 256m
cpus: 0.5
read_only: true
cap_drop: [ALL]
security_opt: ["no-new-privileges:true"]
environment:
DATABASE_URL: *database_url
REDIS_URL: *redis_url
S3_ENDPOINT: http://minio:9000
S3_BUCKET: ${S3_BUCKET:-messenger-attachments}
S3_RECONCILE_ACCESS_KEY_ID: ${S3_RECONCILE_ACCESS_KEY_ID:-messenger-reconciler}
S3_RECONCILE_SECRET_ACCESS_KEY: ${S3_RECONCILE_SECRET_ACCESS_KEY:-local-messenger-reconciler-password}
RECONCILE_GRACE_SECONDS: ${RECONCILE_GRACE_SECONDS:-300}
MINIO_ROOT_USER: ""
MINIO_ROOT_PASSWORD: ""
S3_ACCESS_KEY_ID: ""
S3_SECRET_ACCESS_KEY: ""
depends_on:
migration:
condition: service_completed_successfully
s3-bootstrap:
condition: service_completed_successfully
healthcheck:
test: ["CMD", "python", "-c", "import os; os.kill(1, 0)"]
interval: 10s
timeout: 3s
retries: 3
start_period: 2s
lb:
image: haproxy:3.0.12-alpine
logging: *logging
cpus: 0.5
mem_limit: 128m
read_only: true
tmpfs: ["/tmp:rw,noexec,nosuid,size=4m"]
security_opt: ["no-new-privileges:true"]
ports:
- "127.0.0.1:${APP_PORT:-8080}:8080"
volumes:
- ./infra/haproxy.cfg:/usr/local/etc/haproxy/haproxy.cfg:ro
depends_on:
api:
condition: service_healthy
stop_signal: SIGUSR1
stop_grace_period: 15s
volumes:
redis_data:
postgres_data:
minio_data:
+250
View File
@@ -0,0 +1,250 @@
{
"project": "lab4-clean-81041e6e",
"empty_volumes": true,
"source": "complete working snapshot including new files",
"build_cache": "API rebuilt with --no-cache; pinned MinIO build may use BuildKit cache",
"api_build": {
"seconds": 51.866,
"exit_code": 0
},
"minio_build": {
"seconds": 1.964,
"exit_code": 0
},
"schema_revision": "008",
"public_smoke": "PASS: lab4 public API scenario; infrastructure and grading evidence remain separate.",
"attachments": "PASS: PNG/JPEG bytes, metadata, ACL, chat boundaries, limits and idempotency",
"reconciler": {
"mode": "dry-run",
"bucket": "messenger-attachments",
"prefix": "originals/",
"grace_seconds": 300.0,
"counts": {
"objects_scanned": 11,
"protected_referenced": 11,
"attachments_scanned": 11,
"healthy": 11
},
"samples": [
{
"action": "protected_referenced",
"object_key": "originals/0998d02e-da4c-4840-b0d7-3b823469000e"
},
{
"action": "protected_referenced",
"object_key": "originals/0afe9186-dab8-458d-8013-1c1d8d79e613"
},
{
"action": "protected_referenced",
"object_key": "originals/1390631b-9a1c-4dc8-b9c8-35762269ddad"
},
{
"action": "protected_referenced",
"object_key": "originals/6e863904-e4e8-439d-94d5-520d88e0042a"
},
{
"action": "protected_referenced",
"object_key": "originals/7b5c868c-4fc8-4268-a7b3-ef7fbffdcc3f"
},
{
"action": "protected_referenced",
"object_key": "originals/7f672038-98bb-490b-8649-15ad9bd9ae88"
},
{
"action": "protected_referenced",
"object_key": "originals/ab226893-27e5-45bc-a72a-0fcced3191af"
},
{
"action": "protected_referenced",
"object_key": "originals/b95724e7-9ca4-4d11-9763-cb80b2ada04a"
},
{
"action": "protected_referenced",
"object_key": "originals/d1be5f8e-a73a-4620-b333-e30f44f4c368"
},
{
"action": "protected_referenced",
"object_key": "originals/d738c9d2-b106-4c92-862f-330f26f81150"
},
{
"action": "protected_referenced",
"object_key": "originals/e0a838a7-d602-453c-a4d3-19944bd0e213"
},
{
"action": "healthy",
"object_key": "originals/0998d02e-da4c-4840-b0d7-3b823469000e"
},
{
"action": "healthy",
"object_key": "originals/0afe9186-dab8-458d-8013-1c1d8d79e613"
},
{
"action": "healthy",
"object_key": "originals/1390631b-9a1c-4dc8-b9c8-35762269ddad"
},
{
"action": "healthy",
"object_key": "originals/6e863904-e4e8-439d-94d5-520d88e0042a"
},
{
"action": "healthy",
"object_key": "originals/7b5c868c-4fc8-4268-a7b3-ef7fbffdcc3f"
},
{
"action": "healthy",
"object_key": "originals/7f672038-98bb-490b-8649-15ad9bd9ae88"
},
{
"action": "healthy",
"object_key": "originals/ab226893-27e5-45bc-a72a-0fcced3191af"
},
{
"action": "healthy",
"object_key": "originals/b95724e7-9ca4-4d11-9763-cb80b2ada04a"
},
{
"action": "healthy",
"object_key": "originals/d1be5f8e-a73a-4620-b333-e30f44f4c368"
},
{
"action": "healthy",
"object_key": "originals/d738c9d2-b106-4c92-862f-330f26f81150"
},
{
"action": "healthy",
"object_key": "originals/e0a838a7-d602-453c-a4d3-19944bd0e213"
}
],
"content_bytes_read": 0,
"result": "ok",
"elapsed_seconds": 0.126615,
"db_statements": 70,
"s3_requests": {
"VERSIONING": 1,
"LIST": 1,
"HEAD": 11
},
"process_peak_rss_kib": 79372
},
"services": [
{
"service": "api",
"state": "running",
"health": "healthy"
},
{
"service": "api",
"state": "running",
"health": "healthy"
},
{
"service": "lb",
"state": "running",
"health": ""
},
{
"service": "minio",
"state": "running",
"health": "healthy"
},
{
"service": "postgres",
"state": "running",
"health": "healthy"
},
{
"service": "reconciler",
"state": "running",
"health": "healthy"
},
{
"service": "redis",
"state": "running",
"health": "healthy"
}
],
"code_manifest": {
"Dockerfile.dockerignore": "62c0534ad74d9f0e2982e97d1fbadb66d80c493ed237df5bcb9fbb797062eb38",
"requirements-student.txt": "83af5551944a4384b3afd4e2a663cf7329a5bc952ad748a5379018509b9298d4",
"student.env.example": "08edfd4f68f801cd8db6000dfa040f9be7ff10a11c6bbdf7544f6c996fc2f909",
"student.mk": "dea22dba57c5a474576ea6d7c4fe6e4e13e2d8b4baf0c5ec82b227d5aba47780",
"Dockerfile": "f6d3a539fd5b0787c366c76dc0e02086857eb465790bcaa599ab7a36ea2f5c35",
"alembic.ini": "024bf3fe092ea4f8e6bb6309cba89e67b53bada366dee6859339297f090fdda1",
"compose.yaml": "86f40a2b6485fd9ba18b33171d7cd1c99e36b9b5e2e1ac0409e2aabd45af0793",
"infra/README.md": "0e804fa51debba4c38d3cc84abf4704897665e0335b272060363f03aadd6354f",
"infra/haproxy.cfg": "6640795207cee655e5c22d685d73b2a57ae1a987156783ad5226d57d7ed6d59c",
"infra/minio/Dockerfile": "632a16d3468aa0290a0dcb69cdbdba7a8827ada9ab56d5b9903d1ba8eaf182d7",
"infra/s3/api-policy.json": "ab08e1c66eeb8e872768cba5b72a2ebc2d82f31353c2ad5c5c20a88200ca1782",
"infra/s3/reconciler-policy.json": "80fc157de3beb754a713644ed213c18d1fb571f13b5c062576fc3602cd3177cc",
"migrations/env.py": "67360cd30a7dd1295ee80b1991c773d817bc601b30cd32d88fb38769c91144f9",
"migrations/script.py.mako": "d7558dcb7ce01d3e44830898336d3027de66e5ffdb1491c0cd27f6159b021902",
"migrations/versions/001_initial.py": "72862742da825a042bb63deef80e22cbef79da8a9b0f369644c344211c8a5a87",
"migrations/versions/002_redis_sessions.py": "5bdd751818e8577f81cbb96cd28031b569f62afff43ee72660f980bc0ee7614a",
"migrations/versions/003_admin.py": "24fcc923b12d0b68e401c7b47642563de3d5b5808821e4fefed8d69e48eb8b6d",
"migrations/versions/004_idempotency.py": "4f51289fd202cde682bf1256f9f4bfc2f17c35fc00ada7d1c4bf36182968e9b9",
"migrations/versions/005_message_unicode.py": "0851e4ae1e4d3ca8e11b00cb7714827c0de1651d9bb49cd2bfb4525cd1f2c999",
"migrations/versions/006_unicode_names.py": "fb087985717e280b7b6f67348e9cd8abb9c193ab759cff23a6e5628ecd2818ac",
"migrations/versions/007_attachments.py": "c4936a499313cd22f32fac9538d5892cfe2f2eb49aa8427d54dc72b73c7b5a7c",
"migrations/versions/008_reconciliation.py": "84fd1650ee4338c57f68328221cb82c9e75b69c52512b58907be9660677a3963",
"requirements.txt": "977716fbc3ee1b11681500aa61cf1d561ec1d4267a1f2c35dbbed8bdcf7493e0",
"src/__init__.py": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
"src/__main__.py": "b1b472fa858b203911db455eb5c25965b961510985ec4d2c94f627d378aaa9f8",
"src/api/__init__.py": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
"src/api/dependencies.py": "73c3f94d7c14d6c34031214933340124ebc4e22730b2b1bf8a2eb89a0d42e986",
"src/api/router.py": "4ac01f4ab0e646e0782c760a29fe7b5caa577046eb1ae981328daa1510393915",
"src/api/v1/__init__.py": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
"src/api/v1/routers/__init__.py": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
"src/api/v1/routers/attachments.py": "c95476d41d5794e2dbe6d24b1ced381035d6626889b0b14def2f21485e2e6658",
"src/api/v1/routers/auth/__init__.py": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
"src/api/v1/routers/auth/callback.py": "69a2cde6ac37f445e64d9afdea55437240846d158460e6fc5601ff0ce2045d2c",
"src/api/v1/routers/auth/router.py": "075648602d66bdc3497c4714d9789b2ea5661501478b05ba845b65c55a725fd8",
"src/api/v1/routers/auth/schemas.py": "ba3345570c35b8a9e55751202f9c8a27f7d338cfcd85b300c196a43ac03aa311",
"src/api/v1/routers/chats/__init__.py": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
"src/api/v1/routers/chats/router.py": "85cac2d5ade6917c99e4e6a82053f681e1d253eca4fe3eee726e9f7621635bce",
"src/api/v1/routers/chats/schemas.py": "00e0fc283069cca6c7929ef8d704aa1e577e6bfb555a496eb1b8170231c3b240",
"src/api/v1/routers/messages/__init__.py": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
"src/api/v1/routers/messages/router.py": "88f020fc60fdbf00f574308aa7b811416e308588fad27ff78ccc0f3d3b77f032",
"src/api/v1/routers/messages/schemas.py": "fa82dfb70f2f8f344c3e3577a8df4e5e365241ddcc9f2bcd43021ab952a40316",
"src/api/v1/routers/users/__init__.py": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
"src/api/v1/routers/users/router.py": "fedd9cb7da2fb21caccd8ae2080d013719b4f13382dc795de880fb8ca87f857f",
"src/api/v1/routers/users/schemas.py": "c30356333a3f6bd1b80b8cf6f4208d550201adfaaa0667e1db074c4aecc70dd7",
"src/api/v1/schemas.py": "403d5821588d8abcc33a285cd2689be5eba0e7ab0373d1e17856ff0464934766",
"src/core/__init__.py": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
"src/core/cache.py": "1973038f948f2eff50b18ba9c0ea3aa1eedd712932a41045ba6dd18dee358966",
"src/core/callback.py": "9046a504d8324a32e428ff8f4d159d452160828d470e3205400473394d380fee",
"src/core/db/__init__.py": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
"src/core/db/models.py": "3f9293b6a34334a7d9256c5666dfd050264be44589bde49628ec677312c9abee",
"src/core/db/repo/__init__.py": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
"src/core/db/repo/auth.py": "63fb17b55cf05a4b05c5f0b08d3e4f6dc6c83981c7f9d89a0d798b0d270283f2",
"src/core/db/repo/chat.py": "fa1042b689e1e2242360d1432ca84ca49f35a6a2de03810135907333466e76fd",
"src/core/db/repo/message.py": "0d5610e60e516ac5cd87e4486605f0665b6394cacd2c13e2698ff314b282e3fc",
"src/core/db/repo/user.py": "f1d36be8530772e6a969687e78bc7bb9bfe7daf8be67d1e079acb1e6c9d7017b",
"src/core/db/session.py": "9d4c07446ccc0990843c7f978c487a9976f9d926bf1e69a57f88021f742c7c5f",
"src/core/db/types.py": "1e8890cfa43c31ce77ce0c95f0a8a535d0730835db16f33b086226bb189ad7aa",
"src/core/errors.py": "5f93764110b969832766be8a6302515edf2eecc44de4d43c4d350c9c20d31432",
"src/core/pagination.py": "3e1c7e5232dc27688f20c622f312ea10d5ce45e9d3960a4c1b61af3e885079c6",
"src/core/readiness.py": "4064b105e7157e5dfbf3591983e3d6cbf27daf418b764f9ea2ee5f3140772ee1",
"src/core/request_deadline.py": "908433803b2238b9b9bd004a5ca74010a05ee60fcb68b80f589bb3c7e1e3044a",
"src/core/request_limits.py": "69ce991f604b8c6f6a225c1f3c09002402c680ce89b2146fdedf5b816c7f836b",
"src/core/security.py": "64d6769b36090ab2824f19668f99d23669f838e82d6a785636c339b7c1876663",
"src/core/session_store.py": "874b3ffa5b52b5b6a4587dc785784f41b6958d1b3be5a6a62470623f2182a6c1",
"src/core/settings.py": "5a96b4a95d558982d4f7806b8957aa7b660ad899dc080a02f3a637b4e9a301e0",
"src/core/storage.py": "80b361c08a078574fa8204ddbda4b3806ccef9921d0744ba12c1bac4f6331d13",
"src/core/storage_bootstrap.py": "ea4ec70f9a3001c7c84f22bd414a2ad7e82866dc32de7a2ad02d0c5e2b1a5d39",
"src/core/upload_coordination.py": "9ee87e7cf79cad25af1e9454c7997f5d9312f1f978301ce801ef1596a7effe48",
"src/main.py": "8d3aae82b2a74a859ecd0d71bfe30dff85ea44e98d3aa1fedadaed0b41b2eba9",
"src/maintenance/__init__.py": "bd9fc4293e0380e6b62c869dfa75a798f83090c85490c9e6b42df87e8d344b71",
"src/maintenance/reconcile.py": "619a56167f1f72b7a3912be6d0e0a6d1453c1b27e775561515550de4e3f106e7",
"src/service/__init__.py": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
"src/service/attachment.py": "d96e09f9a2419f0ffa1047a539297361241debf06bfe0964ed4a12a318c5b025",
"src/service/auth.py": "c979b1bdf157d7468ec584093e56a16abbb6b3fb25da0a1cce6eecac792db5ce",
"src/service/chat.py": "baa2b0eb570fa0965a0e4b929313ecb1c96464997b592872f4ed193e22c48489",
"src/service/dto.py": "c44fdd911f063348efff8471277d8dcb0ffaf91672e139ad1d97c5140b813a29",
"src/service/exceptions.py": "32a232596795b28c1ca5ebbd19ed938cc6086263ceaf476716e9ae310da9f685",
"src/service/message.py": "87ea10afea7ce0d2b666015135e052cfa58af39977965712d3ca8c940ff9e977",
"src/service/user.py": "44e561c97aff49d358e5f9ed02cfe6ae85abdd384423fe9dcc7b9b05f13f4bbb"
},
"result": "PASS",
"temporary_project_and_volumes_removed": true,
"temporary_image_tags_removed": true
}
+1
View File
@@ -0,0 +1 @@
PASS: PNG/JPEG bytes, metadata, ACL, chat boundaries, limits and idempotency
+169
View File
@@ -0,0 +1,169 @@
{
"project": "lab4-clean-81041e6e",
"empty_volumes": true,
"source": "complete working snapshot including new files",
"build_cache": "API rebuilt with --no-cache; pinned MinIO build may use BuildKit cache",
"api_build": {
"seconds": 51.866,
"exit_code": 0
},
"minio_build": {
"seconds": 1.964,
"exit_code": 0
},
"schema_revision": "008",
"public_smoke": "PASS: lab4 public API scenario; infrastructure and grading evidence remain separate.",
"attachments": "PASS: PNG/JPEG bytes, metadata, ACL, chat boundaries, limits and idempotency",
"reconciler": {
"mode": "dry-run",
"bucket": "messenger-attachments",
"prefix": "originals/",
"grace_seconds": 300.0,
"counts": {
"objects_scanned": 11,
"protected_referenced": 11,
"attachments_scanned": 11,
"healthy": 11
},
"samples": [
{
"action": "protected_referenced",
"object_key": "originals/0998d02e-da4c-4840-b0d7-3b823469000e"
},
{
"action": "protected_referenced",
"object_key": "originals/0afe9186-dab8-458d-8013-1c1d8d79e613"
},
{
"action": "protected_referenced",
"object_key": "originals/1390631b-9a1c-4dc8-b9c8-35762269ddad"
},
{
"action": "protected_referenced",
"object_key": "originals/6e863904-e4e8-439d-94d5-520d88e0042a"
},
{
"action": "protected_referenced",
"object_key": "originals/7b5c868c-4fc8-4268-a7b3-ef7fbffdcc3f"
},
{
"action": "protected_referenced",
"object_key": "originals/7f672038-98bb-490b-8649-15ad9bd9ae88"
},
{
"action": "protected_referenced",
"object_key": "originals/ab226893-27e5-45bc-a72a-0fcced3191af"
},
{
"action": "protected_referenced",
"object_key": "originals/b95724e7-9ca4-4d11-9763-cb80b2ada04a"
},
{
"action": "protected_referenced",
"object_key": "originals/d1be5f8e-a73a-4620-b333-e30f44f4c368"
},
{
"action": "protected_referenced",
"object_key": "originals/d738c9d2-b106-4c92-862f-330f26f81150"
},
{
"action": "protected_referenced",
"object_key": "originals/e0a838a7-d602-453c-a4d3-19944bd0e213"
},
{
"action": "healthy",
"object_key": "originals/0998d02e-da4c-4840-b0d7-3b823469000e"
},
{
"action": "healthy",
"object_key": "originals/0afe9186-dab8-458d-8013-1c1d8d79e613"
},
{
"action": "healthy",
"object_key": "originals/1390631b-9a1c-4dc8-b9c8-35762269ddad"
},
{
"action": "healthy",
"object_key": "originals/6e863904-e4e8-439d-94d5-520d88e0042a"
},
{
"action": "healthy",
"object_key": "originals/7b5c868c-4fc8-4268-a7b3-ef7fbffdcc3f"
},
{
"action": "healthy",
"object_key": "originals/7f672038-98bb-490b-8649-15ad9bd9ae88"
},
{
"action": "healthy",
"object_key": "originals/ab226893-27e5-45bc-a72a-0fcced3191af"
},
{
"action": "healthy",
"object_key": "originals/b95724e7-9ca4-4d11-9763-cb80b2ada04a"
},
{
"action": "healthy",
"object_key": "originals/d1be5f8e-a73a-4620-b333-e30f44f4c368"
},
{
"action": "healthy",
"object_key": "originals/d738c9d2-b106-4c92-862f-330f26f81150"
},
{
"action": "healthy",
"object_key": "originals/e0a838a7-d602-453c-a4d3-19944bd0e213"
}
],
"content_bytes_read": 0,
"result": "ok",
"elapsed_seconds": 0.126615,
"db_statements": 70,
"s3_requests": {
"VERSIONING": 1,
"LIST": 1,
"HEAD": 11
},
"process_peak_rss_kib": 79372
},
"services": [
{
"service": "api",
"state": "running",
"health": "healthy"
},
{
"service": "api",
"state": "running",
"health": "healthy"
},
{
"service": "lb",
"state": "running",
"health": ""
},
{
"service": "minio",
"state": "running",
"health": "healthy"
},
{
"service": "postgres",
"state": "running",
"health": "healthy"
},
{
"service": "reconciler",
"state": "running",
"health": "healthy"
},
{
"service": "redis",
"state": "running",
"health": "healthy"
}
],
"result": "PASS",
"temporary_project_and_volumes_removed": true,
"temporary_image_tags_removed": true
}
+1
View File
@@ -0,0 +1 @@
PASS: all 34 supplied lab4 files are unchanged
+1
View File
@@ -0,0 +1 @@
56 files already formatted
+10
View File
@@ -0,0 +1,10 @@
{
"parallel_repeats": 16,
"instances": [
"87c60c75-1a12-40b1-b894-8ebbc04b2483",
"b5f5d168-fe8b-4054-b929-c9d27e2a1b9d"
],
"messages_created": 1,
"checks": "normalization, conflict, key scope, invalid keys, access, logout, headers",
"result": "PASS"
}
+1
View File
@@ -0,0 +1 @@
PASS: full OpenAPI 3.1 and JSON Schema validation; application NOT tested.
@@ -0,0 +1,5 @@
ДО: {"api": {"98f0f98b0a3204072109e7ac33d23328b3690741de6d0af66504456eca9f2e87": {"StartedAt": "2026-11-12T16:32:52.949322844Z", "Pid": 72655}, "3e2f859111ee06ecf7031a1e6278444a21fe86884a8d1fd6d892c090daf084e7": {"StartedAt": "2026-11-12T16:32:40.408286672Z", "Pid": 70767}}, "postgres": {"6a69cf97a9616755a9ab550c99f331bc44c1ed0f455ad54b5b1dd791f64f6659": {"StartedAt": "2026-11-12T16:06:49.350909551Z", "Pid": 27184}}, "redis": {"a250306cb10a275ec58b8193706aecd7d807aaaeb684e0f3ef58f21728994c07": {"StartedAt": "2026-11-12T16:06:49.304222759Z", "Pid": 27105}}, "minio": {"20ccbcfbb4d4d082ff34977ce7fb6165afeb22ebceee39d7898dee1715d77735": {"StartedAt": "2026-11-12T16:06:49.326347968Z", "Pid": 27181}}, "reconciler": {"5834498f828da11f7bad5ce7a81bdf733e421476b072fcf90e0889cf63c6f2b7": {"StartedAt": "2026-11-12T16:09:50.86824801Z", "Pid": 46678}}, "lb": {"fcd305f6da7afe13c8c928b4872ae34a376057f62ce0ad902e8d49919d94306a": {"StartedAt": "2026-11-12T16:07:02.572707168Z", "Pid": 28939}}}
Executing explicit persistence hook; hook output suppressed to avoid leaking secrets.
PASS: persistence preserved confirmed data and existing session. Hook scope needs operator evidence.
ПОСЛЕ: {"api": {"0a486aee12275d60ceecaf52c53cbecd6140c14da6ee1959a5622d06842f413c": {"StartedAt": "2026-11-12T16:33:08.707126296Z", "Pid": 74888}, "1ef42d31462e8faff07675f8e603062c06cb11a939c8bc37b74ed6c854a13b42": {"StartedAt": "2026-11-12T16:33:08.631547546Z", "Pid": 74834}}, "postgres": {"6a69cf97a9616755a9ab550c99f331bc44c1ed0f455ad54b5b1dd791f64f6659": {"StartedAt": "2026-11-12T16:33:02.306663876Z", "Pid": 74002}}, "redis": {"a250306cb10a275ec58b8193706aecd7d807aaaeb684e0f3ef58f21728994c07": {"StartedAt": "2026-11-12T16:33:02.349753418Z", "Pid": 74070}}, "minio": {"20ccbcfbb4d4d082ff34977ce7fb6165afeb22ebceee39d7898dee1715d77735": {"StartedAt": "2026-11-12T16:33:02.273735376Z", "Pid": 73962}}, "reconciler": {"5834498f828da11f7bad5ce7a81bdf733e421476b072fcf90e0889cf63c6f2b7": {"StartedAt": "2026-11-12T16:33:16.106929883Z", "Pid": 75892}}, "lb": {"fcd305f6da7afe13c8c928b4872ae34a376057f62ce0ad902e8d49919d94306a": {"StartedAt": "2026-11-12T16:33:15.070868049Z", "Pid": 75711}}}
PASS: StartedAt изменился у API, PostgreSQL, Redis, MinIO, reconciler и LB; прежний токен и данные сохранены
+1
View File
@@ -0,0 +1 @@
PASS: lab4 public API scenario; infrastructure and grading evidence remain separate.
+1
View File
@@ -0,0 +1 @@
All checks passed!
+1
View File
@@ -0,0 +1 @@
PASS: bounded readiness response, one pending probe, recovery after cancellation
+18
View File
@@ -0,0 +1,18 @@
{"check": "direct unsigned GET of an existing S3 object returns 403", "result": "PASS"}
{"check": "deployed API cannot delete; reconciler cannot upload; both are confined to originals/", "result": "PASS"}
{"check": "real upload atomically commits Attachment and intent; image is referenced by a message", "result": "PASS"}
{"check": "S3 PUT failure leaves an accounted pending attempt, no ready attachment", "result": "PASS"}
Метаданные загрузки не подтверждены; требуется сверка S3/БД
{"check": "DB commit failure after S3 PUT leaves a durable discoverable orphan", "result": "PASS"}
{"check": "process death after real PUT preserves intent; PostgreSQL releases the upload lock", "result": "PASS"}
{"check": "dry-run changes neither DB records nor S3 objects", "result": "PASS"}
{"check": "apply cleans old orphan/empty attempt; preserves active, fresh, referenced and late-committed objects", "result": "PASS"}
{"check": "missing original is quarantined with 503; metadata and message link survive", "result": "PASS"}
{"check": "missing content blocks new links, but confirmed idempotency replays stay intact", "result": "PASS"}
{"check": "recovery requires exact SHA-256; repeat apply is safe", "result": "PASS"}
{"check": "S3 AccessDenied and unavailable DB abort safely, without false missing/deletion", "result": "PASS"}
{"check": "lost DELETE response is repaired on repeat; no live object is affected", "result": "PASS"}
{"check": "failed S3 DELETE preserves pending; recovery retries and actually removes the orphan", "result": "PASS"}
{"experiment": "scan_cost", "runs": [{"objects": 10, "repeat": 1, "seconds": 0.0219, "s3_requests": {"LIST": 1, "HEAD": 10}, "db_statements": 53}, {"objects": 10, "repeat": 2, "seconds": 0.0174, "s3_requests": {"LIST": 1, "HEAD": 10}, "db_statements": 53}, {"objects": 10, "repeat": 3, "seconds": 0.0181, "s3_requests": {"LIST": 1, "HEAD": 10}, "db_statements": 53}, {"objects": 100, "repeat": 1, "seconds": 0.1851, "s3_requests": {"LIST": 1, "HEAD": 100}, "db_statements": 503}, {"objects": 100, "repeat": 2, "seconds": 0.2289, "s3_requests": {"LIST": 1, "HEAD": 100}, "db_statements": 503}, {"objects": 100, "repeat": 3, "seconds": 0.1565, "s3_requests": {"LIST": 1, "HEAD": 100}, "db_statements": 503}, {"objects": 1005, "repeat": 1, "seconds": 2.0142, "s3_requests": {"LIST": 2, "HEAD": 1005}, "db_statements": 5028}, {"objects": 1005, "repeat": 2, "seconds": 2.2763, "s3_requests": {"LIST": 2, "HEAD": 1005}, "db_statements": 5028}, {"objects": 1005, "repeat": 3, "seconds": 1.7439, "s3_requests": {"LIST": 2, "HEAD": 1005}, "db_statements": 5028}]}
{"check": "1005 objects cross ListObjectsV2 pagination; cost measured at 3 sizes x 3 runs", "result": "PASS"}
{"result": "PASS", "checks": ["direct unsigned GET of an existing S3 object returns 403", "deployed API cannot delete; reconciler cannot upload; both are confined to originals/", "real upload atomically commits Attachment and intent; image is referenced by a message", "S3 PUT failure leaves an accounted pending attempt, no ready attachment", "DB commit failure after S3 PUT leaves a durable discoverable orphan", "process death after real PUT preserves intent; PostgreSQL releases the upload lock", "dry-run changes neither DB records nor S3 objects", "apply cleans old orphan/empty attempt; preserves active, fresh, referenced and late-committed objects", "missing original is quarantined with 503; metadata and message link survive", "missing content blocks new links, but confirmed idempotency replays stay intact", "recovery requires exact SHA-256; repeat apply is safe", "S3 AccessDenied and unavailable DB abort safely, without false missing/deletion", "lost DELETE response is repaired on repeat; no live object is affected", "failed S3 DELETE preserves pending; recovery retries and actually removes the orphan", "1005 objects cross ListObjectsV2 pagination; cost measured at 3 sizes x 3 runs"], "isolated_resources": true}
+1
View File
@@ -0,0 +1 @@
PASS: bounded response before slow rollback, retained capacity, no late response, recovery
+96
View File
@@ -0,0 +1,96 @@
{
"result": "PASS",
"checks": [
{
"case": "username_control_characters",
"result": "PASS",
"status": 400
},
{
"case": "truncated_png",
"result": "PASS",
"status": 415
},
{
"case": "header_only_png",
"result": "PASS",
"status": 415
},
{
"case": "mismatched_mime",
"result": "PASS",
"status": 415
},
{
"case": "DEL_filename",
"result": "PASS",
"status": 400
},
{
"case": "missing_filename",
"result": "PASS",
"status": 400
},
{
"case": "pixels",
"dimensions": [
8000,
5000
],
"result": "PASS",
"status": 201
},
{
"case": "pixels",
"dimensions": [
8000,
5001
],
"result": "PASS",
"status": 413
},
{
"case": "pixels",
"dimensions": [
20000,
10000
],
"result": "PASS",
"status": 413
},
{
"case": "API_cannot_create_foreign_bucket",
"result": "PASS"
},
{
"case": "S3_credentials_confined_to_intended_services",
"result": "PASS"
},
{
"case": "client_abort_and_oversized_chunked_body",
"result": "PASS",
"oversized_status": 413,
"durable_state_unchanged": true
},
{
"case": "PostgreSQL_frozen_after_SQL_started",
"result": "PASS",
"history": {
"status": 503,
"seconds": 5.1996,
"request_id_present": true,
"instance_id_present": true
},
"readiness": {
"status": 503,
"seconds": 2.0638,
"request_id_present": true,
"instance_id_present": true
}
},
{
"case": "PostgreSQL_resume_without_API_restart",
"result": "PASS"
}
]
}
+17
View File
@@ -0,0 +1,17 @@
Проверка: course-files
Проверка: quality
Проверка: format
Проверка: structure
Проверка: openapi
Проверка: request-deadline
Проверка: readiness-budget
Проверка: public-smoke
Проверка: attachments
Проверка: idempotency
Проверка: reviewer-cases
Проверка: reconciliation
Проверка: upload-memory
Проверка: uploader-failover
Проверка: persistence-proof
Проверка: clean-start
PASS: все итоговые проверки лабораторной 4
+1
View File
@@ -0,0 +1 @@
PASS: offline skeleton structure, local refs and Python syntax; application NOT tested.
+101
View File
@@ -0,0 +1,101 @@
{
"result": "PASS",
"checks": [
{
"check": "course-files",
"exit_code": 0,
"seconds": 0.036,
"evidence": "evidence/lab4-final-course-files.txt"
},
{
"check": "quality",
"exit_code": 0,
"seconds": 0.04,
"evidence": "evidence/lab4-final-quality.txt"
},
{
"check": "format",
"exit_code": 0,
"seconds": 0.04,
"evidence": "evidence/lab4-final-format.txt"
},
{
"check": "structure",
"exit_code": 0,
"seconds": 0.075,
"evidence": "evidence/lab4-final-structure.txt"
},
{
"check": "openapi",
"exit_code": 0,
"seconds": 0.442,
"evidence": "evidence/lab4-final-openapi.txt"
},
{
"check": "request-deadline",
"exit_code": 0,
"seconds": 1.078,
"evidence": "evidence/lab4-final-request-deadline.txt"
},
{
"check": "readiness-budget",
"exit_code": 0,
"seconds": 4.182,
"evidence": "evidence/lab4-final-readiness-budget.txt"
},
{
"check": "public-smoke",
"exit_code": 0,
"seconds": 2.766,
"evidence": "evidence/lab4-final-public-smoke.txt"
},
{
"check": "attachments",
"exit_code": 0,
"seconds": 3.092,
"evidence": "evidence/lab4-final-attachments.txt"
},
{
"check": "idempotency",
"exit_code": 0,
"seconds": 1.767,
"evidence": "evidence/lab4-final-idempotency.txt"
},
{
"check": "reviewer-cases",
"exit_code": 0,
"seconds": 14.156,
"evidence": "evidence/lab4-final-reviewer-cases.txt"
},
{
"check": "reconciliation",
"exit_code": 0,
"seconds": 13.908,
"evidence": "evidence/lab4-final-reconciliation.txt"
},
{
"check": "upload-memory",
"exit_code": 0,
"seconds": 38.052,
"evidence": "evidence/lab4-final-upload-memory.txt"
},
{
"check": "uploader-failover",
"exit_code": 0,
"seconds": 12.548,
"evidence": "evidence/lab4-final-uploader-failover.txt"
},
{
"check": "persistence-proof",
"exit_code": 0,
"seconds": 17.937,
"evidence": "evidence/lab4-final-persistence-proof.txt"
},
{
"check": "clean-start",
"exit_code": 0,
"seconds": 80.091,
"evidence": "evidence/lab4-final-clean-start.txt"
}
]
}
+1
View File
@@ -0,0 +1 @@
{"result": "PASS", "api_replicas": 2, "uploads_per_replica_limit": 5, "decode_concurrency_per_replica": 1, "temporary_storage_per_replica_bytes": 67108864, "profiles": [{"dimensions": [256, 256], "file_bytes": 197174, "concurrent_uploads": 10, "responses": [{"status": 201, "seconds": 0.6791}, {"status": 201, "seconds": 0.7479}, {"status": 201, "seconds": 0.6845}, {"status": 201, "seconds": 0.6778}, {"status": 201, "seconds": 0.7513}, {"status": 201, "seconds": 0.6638}, {"status": 201, "seconds": 0.4756}, {"status": 201, "seconds": 0.6777}, {"status": 201, "seconds": 0.6768}, {"status": 201, "seconds": 0.4765}]}, {"dimensions": [1280, 1280], "file_bytes": 4923511, "concurrent_uploads": 10, "responses": [{"status": 201, "seconds": 0.9695}, {"status": 201, "seconds": 1.0506}, {"status": 201, "seconds": 0.7052}, {"status": 201, "seconds": 1.0433}, {"status": 201, "seconds": 0.9752}, {"status": 201, "seconds": 0.8131}, {"status": 201, "seconds": 0.7254}, {"status": 201, "seconds": 0.6902}, {"status": 201, "seconds": 0.888}, {"status": 201, "seconds": 1.0417}]}], "memory": [{"baseline_bytes": 102842368, "sampled_peak_bytes": 137437184, "samples": 750, "interval_seconds": 0.02, "cgroup_limit_bytes": 536870912}, {"baseline_bytes": 108802048, "sampled_peak_bytes": 126369792, "samples": 750, "interval_seconds": 0.02, "cgroup_limit_bytes": 536870912}], "limitations": ["20ms sampling can miss short peaks", "two synthetic image sizes do not cover the worst-case 40MP input", "cgroup memory includes Python, image decoding and tmpfs; experiment is not a throughput benchmark", "deployment restores the default admission limit of 1 after this experiment"]}
@@ -0,0 +1 @@
PASS: exact uploading replica stopped; another replica returns identical original
+29
View File
@@ -0,0 +1,29 @@
{
"result": "PASS",
"files": {
"contracts/openapi.json": {
"sha256": "c5c0ebdcf205018126c5bb91e2512b11f543827e76baa21d776210d05a0b2cca",
"matches_course_lab4": true
},
"tests/smoke.py": {
"sha256": "52ac38eb343ff7d43e7543588e1da58ca06c9fce74b2b0d0bf0e4982bc23c1db",
"matches_course_lab4": true
},
"tests/client.py": {
"sha256": "8d50976fc7c7bbb81e88a152f613c61ab25eaf53dba33c6a9dfab19f868d546d",
"matches_course_lab4": true
},
"tests/resilience.py": {
"sha256": "1f96663a174b3978d24eff66f2741f5f8c9b788d3242261d37a972720c52788b",
"matches_course_lab4": true
},
"tests/load.py": {
"sha256": "6d3511ea719c7a7e841083e73d435c86dcbfd9f4e5c2a07d62eb9614b01d9933",
"matches_course_lab4": true
},
"tests/fixtures/sample.png": {
"sha256": "99ea7533c441f79cd630d15ce4d58d1ec4e06f6f0efb3b77a5c088305cd1bd75",
"matches_course_lab4": true
}
}
}
+225
View File
@@ -0,0 +1,225 @@
{
"scan_runs": [
{
"objects": 10,
"repeat": 1,
"seconds": 0.0193,
"s3_requests": {
"LIST": 1,
"HEAD": 10
},
"db_statements": 53
},
{
"objects": 10,
"repeat": 2,
"seconds": 0.0181,
"s3_requests": {
"LIST": 1,
"HEAD": 10
},
"db_statements": 53
},
{
"objects": 10,
"repeat": 3,
"seconds": 0.0172,
"s3_requests": {
"LIST": 1,
"HEAD": 10
},
"db_statements": 53
},
{
"objects": 100,
"repeat": 1,
"seconds": 0.1674,
"s3_requests": {
"LIST": 1,
"HEAD": 100
},
"db_statements": 503
},
{
"objects": 100,
"repeat": 2,
"seconds": 0.1533,
"s3_requests": {
"LIST": 1,
"HEAD": 100
},
"db_statements": 503
},
{
"objects": 100,
"repeat": 3,
"seconds": 0.1559,
"s3_requests": {
"LIST": 1,
"HEAD": 100
},
"db_statements": 503
},
{
"objects": 1005,
"repeat": 1,
"seconds": 1.6628,
"s3_requests": {
"LIST": 2,
"HEAD": 1005
},
"db_statements": 5028
},
{
"objects": 1005,
"repeat": 2,
"seconds": 1.9679,
"s3_requests": {
"LIST": 2,
"HEAD": 1005
},
"db_statements": 5028
},
{
"objects": 1005,
"repeat": 3,
"seconds": 1.9842,
"s3_requests": {
"LIST": 2,
"HEAD": 1005
},
"db_statements": 5028
}
],
"upload_experiment": {
"result": "PASS",
"api_replicas": 2,
"uploads_per_replica_limit": 5,
"decode_concurrency_per_replica": 1,
"temporary_storage_per_replica_bytes": 67108864,
"profiles": [
{
"dimensions": [
256,
256
],
"file_bytes": 197105,
"concurrent_uploads": 10,
"responses": [
{
"status": 201,
"seconds": 0.8672
},
{
"status": 201,
"seconds": 0.9497
},
{
"status": 201,
"seconds": 0.9495
},
{
"status": 201,
"seconds": 0.8663
},
{
"status": 201,
"seconds": 0.8577
},
{
"status": 201,
"seconds": 0.9492
},
{
"status": 201,
"seconds": 0.9498
},
{
"status": 201,
"seconds": 0.8513
},
{
"status": 201,
"seconds": 0.9494
},
{
"status": 201,
"seconds": 0.8673
}
]
},
{
"dimensions": [
1280,
1280
],
"file_bytes": 4923278,
"concurrent_uploads": 10,
"responses": [
{
"status": 201,
"seconds": 1.0416
},
{
"status": 201,
"seconds": 1.1384
},
{
"status": 201,
"seconds": 0.8325
},
{
"status": 201,
"seconds": 0.994
},
{
"status": 201,
"seconds": 1.0969
},
{
"status": 201,
"seconds": 0.9037
},
{
"status": 201,
"seconds": 1.0042
},
{
"status": 201,
"seconds": 1.1211
},
{
"status": 201,
"seconds": 0.9889
},
{
"status": 201,
"seconds": 1.018
}
]
}
],
"memory": [
{
"baseline_bytes": 101765120,
"sampled_peak_bytes": 130772992,
"samples": 750,
"interval_seconds": 0.02,
"cgroup_limit_bytes": 536870912
},
{
"baseline_bytes": 96137216,
"sampled_peak_bytes": 135176192,
"samples": 750,
"interval_seconds": 0.02,
"cgroup_limit_bytes": 536870912
}
],
"limitations": [
"20ms sampling can miss short peaks",
"two synthetic image sizes do not cover the worst-case 40MP input",
"cgroup memory includes Python, image decoding and tmpfs; experiment is not a throughput benchmark",
"deployment restores the default admission limit of 1 after this experiment"
]
}
}
Binary file not shown.

After

Width:  |  Height:  |  Size: 65 KiB

File diff suppressed because it is too large Load Diff

After

Width:  |  Height:  |  Size: 53 KiB

+3
View File
@@ -0,0 +1,3 @@
Container mtusi2026lab1-postgres-1 Paused
Container mtusi2026lab1-postgres-1 Unpaused
FAIL: in-flight history did not return within 8 seconds while PostgreSQL was frozen
+2
View File
@@ -0,0 +1,2 @@
PASS: unavailable S3 yields controlled readiness 503; liveness stays 200
PASS: S3 recovery preserves original and existing session
+1
View File
@@ -0,0 +1 @@
{"architecture":"aarch64","docker_cpus":10,"docker_memory_bytes":8218034176,"docker_version":"28.5.1"}
+43
View File
@@ -0,0 +1,43 @@
global
log stdout format raw local0
maxconn 2048
stats socket /tmp/haproxy.sock mode 600 level admin
stats socket ipv4@127.0.0.1:9999 level admin
defaults
log global
mode http
option httplog
timeout connect 1s
timeout client 15s
timeout server 12s
timeout http-request 7s
timeout http-keep-alive 2s
timeout check 1s
# Не повторяем POST автоматически: неизвестный результат повторяет клиент
# с исходным Idempotency-Key. Соединения к недоступному API не ждут долго.
retries 0
resolvers docker
nameserver dns 127.0.0.11:53
resolve_retries 3
timeout resolve 1s
timeout retry 1s
hold valid 1s
hold obsolete 1s
hold nx 1s
hold timeout 1s
hold refused 1s
accepted_payload_size 8192
frontend public
bind :8080
default_backend api_pool
backend api_pool
balance roundrobin
option httpchk
http-check send meth GET uri /health/ready ver HTTP/1.1 hdr Host api
http-check expect status 200
default-server inter 1s fastinter 500ms downinter 1s fall 2 rise 2
server-template api 1-16 api:8080 check resolvers docker resolve-prefer ipv4 init-addr none
+20
View File
@@ -0,0 +1,20 @@
# MinIO community distribution is source-only; pin the reviewed release commit.
FROM golang:1.24.8-alpine3.22 AS build
RUN apk add --no-cache git
WORKDIR /source
RUN git init . \
&& git remote add origin https://github.com/minio/minio.git \
&& git fetch --depth 1 origin 9e49d5e7a648f00e26f2246f4dc28e6b07f8c84a \
&& git checkout --detach FETCH_HEAD
ENV CGO_ENABLED=0 GOMAXPROCS=2
RUN go build -p 2 -trimpath -o /minio .
FROM alpine:3.22.2
RUN apk add --no-cache ca-certificates \
&& addgroup -S minio && adduser -S -G minio minio \
&& mkdir /data && chown minio:minio /data
COPY --from=build /minio /usr/local/bin/minio
USER minio
EXPOSE 9000
ENTRYPOINT ["minio"]
CMD ["server", "/data", "--console-address", ":9001"]
+20
View File
@@ -0,0 +1,20 @@
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": ["s3:ListBucket", "s3:GetBucketLocation"],
"Resource": ["arn:aws:s3:::${bucket}"]
},
{
"Effect": "Allow",
"Action": [
"s3:GetObject",
"s3:PutObject",
"s3:AbortMultipartUpload",
"s3:ListMultipartUploadParts"
],
"Resource": ["arn:aws:s3:::${bucket}/originals/*"]
}
]
}
+15
View File
@@ -0,0 +1,15 @@
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": ["s3:ListBucket", "s3:GetBucketLocation", "s3:GetBucketVersioning"],
"Resource": ["arn:aws:s3:::${bucket}"]
},
{
"Effect": "Allow",
"Action": ["s3:GetObject", "s3:DeleteObject"],
"Resource": ["arn:aws:s3:::${bucket}/originals/*"]
}
]
}
+34
View File
@@ -0,0 +1,34 @@
import asyncio
from alembic import context
from sqlalchemy import pool
from sqlalchemy.ext.asyncio import create_async_engine
from src.core.db.models import Base
from src.core.settings import settings
url = settings.sqlalchemy_database_url
target_metadata = Base.metadata
def run_migrations(connection):
context.configure(connection=connection, target_metadata=target_metadata, compare_type=True)
with context.begin_transaction():
context.run_migrations()
async def run_online():
engine = create_async_engine(url, poolclass=pool.NullPool)
try:
async with engine.connect() as connection:
await connection.run_sync(run_migrations)
finally:
await engine.dispose()
if context.is_offline_mode():
context.configure(url=url, target_metadata=target_metadata, literal_binds=True)
with context.begin_transaction():
context.run_migrations()
else:
asyncio.run(run_online())
+17
View File
@@ -0,0 +1,17 @@
"""${message}"""
from alembic import op
import sqlalchemy as sa
${imports if imports else ""}
revision = ${repr(up_revision)}
down_revision = ${repr(down_revision)}
branch_labels = ${repr(branch_labels)}
depends_on = ${repr(depends_on)}
def upgrade():
${upgrades if upgrades else "pass"}
def downgrade():
${downgrades if downgrades else "pass"}
+60
View File
@@ -0,0 +1,60 @@
"""Пользователи, чаты, участники, сообщения и сессии."""
from alembic import op
import sqlalchemy as sa
revision = '001'
down_revision = None
branch_labels = None
depends_on = None
def upgrade():
op.create_table(
'users',
sa.Column('id', sa.Uuid(), primary_key=True),
sa.Column('username', sa.String(32), nullable=False, unique=True),
sa.Column('display_name', sa.String(100), nullable=False),
sa.Column('password_hash', sa.Text(), nullable=False),
sa.Column('created_at', sa.DateTime(timezone=True), nullable=False),
sa.CheckConstraint("username ~ '^[a-z0-9_]{3,32}$'"),
sa.CheckConstraint('length(trim(display_name)) > 0'),
)
op.create_table(
'chats',
sa.Column('id', sa.Uuid(), primary_key=True),
sa.Column('title', sa.String(100), nullable=False),
sa.Column('created_at', sa.DateTime(timezone=True), nullable=False),
sa.CheckConstraint('length(trim(title)) > 0'),
)
op.create_table(
'chat_members',
sa.Column('chat_id', sa.Uuid(), sa.ForeignKey('chats.id', ondelete='CASCADE'), primary_key=True),
sa.Column('user_id', sa.Uuid(), sa.ForeignKey('users.id'), primary_key=True),
)
op.create_index('chat_members_user_idx', 'chat_members', ['user_id', 'chat_id'])
op.create_table(
'messages',
sa.Column('id', sa.Uuid(), primary_key=True),
sa.Column('chat_id', sa.Uuid(), sa.ForeignKey('chats.id'), nullable=False),
sa.Column('sender_id', sa.Uuid(), sa.ForeignKey('users.id'), nullable=False),
sa.Column('text', sa.String(4000), nullable=False),
sa.Column('created_at', sa.DateTime(timezone=True), nullable=False),
sa.ForeignKeyConstraint(['chat_id', 'sender_id'], ['chat_members.chat_id', 'chat_members.user_id']),
sa.CheckConstraint('length(trim(text)) > 0'),
)
op.create_index('messages_history_idx', 'messages', ['chat_id', 'created_at', 'id'])
op.create_table(
'sessions',
sa.Column('token_hash', sa.Text(), primary_key=True),
sa.Column('user_id', sa.Uuid(), sa.ForeignKey('users.id', ondelete='CASCADE'), nullable=False),
sa.Column('expires_at', sa.DateTime(timezone=True), nullable=False),
)
op.create_index('sessions_expiry_idx', 'sessions', ['expires_at'])
def downgrade():
op.drop_table('sessions')
op.drop_table('messages')
op.drop_table('chat_members')
op.drop_table('chats')
op.drop_table('users')
+22
View File
@@ -0,0 +1,22 @@
"""Сессии перенесены в Redis."""
from alembic import op
import sqlalchemy as sa
revision = '002'
down_revision = '001'
branch_labels = None
depends_on = None
def upgrade():
op.drop_table('sessions')
def downgrade():
op.create_table(
'sessions',
sa.Column('token_hash', sa.Text(), primary_key=True),
sa.Column('user_id', sa.Uuid(), sa.ForeignKey('users.id', ondelete='CASCADE'), nullable=False),
sa.Column('expires_at', sa.DateTime(timezone=True), nullable=False),
)
op.create_index('sessions_expiry_idx', 'sessions', ['expires_at'])
+16
View File
@@ -0,0 +1,16 @@
"""Признак системного администратора."""
from alembic import op
import sqlalchemy as sa
revision = '003'
down_revision = '002'
branch_labels = None
depends_on = None
def upgrade():
op.add_column('users', sa.Column('is_admin', sa.Boolean(), nullable=False, server_default=sa.false()))
def downgrade():
op.drop_column('users', 'is_admin')
+25
View File
@@ -0,0 +1,25 @@
"""Общая идемпотентность сообщений, совместимая с предыдущей схемой."""
from alembic import op
import sqlalchemy as sa
revision = "004"
down_revision = "003"
branch_labels = None
depends_on = None
def upgrade():
op.create_table(
"message_requests",
sa.Column("sender_id", sa.Uuid(), sa.ForeignKey("users.id"), primary_key=True),
sa.Column("chat_id", sa.Uuid(), sa.ForeignKey("chats.id"), primary_key=True),
sa.Column("key", sa.String(128), primary_key=True),
sa.Column("request_text", sa.String(4000), nullable=False),
sa.Column("message_id", sa.Uuid(), sa.ForeignKey("messages.id"), nullable=True),
sa.Column("expires_at", sa.DateTime(timezone=True), nullable=False),
)
def downgrade():
op.drop_table("message_requests")
@@ -0,0 +1,55 @@
"""Сохранять весь допустимый Unicode сообщений, включая U+0000, без потерь."""
import sqlalchemy as sa
from alembic import op
revision = "005"
down_revision = "004"
branch_labels = None
depends_on = None
def upgrade():
op.drop_constraint("messages_text_check", "messages", type_="check")
op.alter_column(
"messages",
"text",
existing_type=sa.String(4000),
type_=sa.LargeBinary(),
existing_nullable=False,
postgresql_using="convert_to(text, 'UTF8')",
)
op.alter_column(
"message_requests",
"request_text",
existing_type=sa.String(4000),
type_=sa.LargeBinary(),
existing_nullable=False,
postgresql_using="convert_to(request_text, 'UTF8')",
)
op.create_check_constraint(
"messages_text_bytes_check", "messages", "octet_length(text) BETWEEN 1 AND 16000"
)
def downgrade():
# convert_from откажет при наличии U+0000: не удаляем символы или строки
# молча. Откат возможен только если все данные представимы в PostgreSQL text.
op.drop_constraint("messages_text_bytes_check", "messages", type_="check")
op.alter_column(
"messages",
"text",
existing_type=sa.LargeBinary(),
type_=sa.String(4000),
existing_nullable=False,
postgresql_using="convert_from(text, 'UTF8')",
)
op.alter_column(
"message_requests",
"request_text",
existing_type=sa.LargeBinary(),
type_=sa.String(4000),
existing_nullable=False,
postgresql_using="convert_from(request_text, 'UTF8')",
)
op.create_check_constraint("messages_text_check", "messages", "length(trim(text)) > 0")
+40
View File
@@ -0,0 +1,40 @@
"""Сохранение допустимого Unicode имён и названий, включая U+0000."""
import sqlalchemy as sa
from alembic import op
revision = "006"
down_revision = "005"
branch_labels = None
depends_on = None
def upgrade():
for table, column in [("users", "display_name"), ("chats", "title")]:
op.drop_constraint(f"{table}_{column}_check", table, type_="check")
op.alter_column(
table,
column,
existing_type=sa.String(100),
type_=sa.LargeBinary(),
existing_nullable=False,
postgresql_using=f"convert_to({column}, 'UTF8')",
)
op.create_check_constraint(
f"{table}_{column}_bytes_check", table, f"octet_length({column}) BETWEEN 1 AND 400"
)
def downgrade():
# PostgreSQL откажет при U+0000 и откатит транзакцию вместо потери символов.
for table, column in [("users", "display_name"), ("chats", "title")]:
op.drop_constraint(f"{table}_{column}_bytes_check", table, type_="check")
op.alter_column(
table,
column,
existing_type=sa.LargeBinary(),
type_=sa.String(100),
existing_nullable=False,
postgresql_using=f"convert_from({column}, 'UTF8')",
)
op.create_check_constraint(f"{table}_{column}_check", table, f"length(trim({column})) > 0")
+65
View File
@@ -0,0 +1,65 @@
"""Private S3 attachment metadata and ordered message links."""
from alembic import op
import sqlalchemy as sa
revision = "007"
down_revision = "006"
branch_labels = None
depends_on = None
def upgrade():
op.create_table(
"attachments",
sa.Column("id", sa.Uuid(), primary_key=True),
sa.Column("chat_id", sa.Uuid(), sa.ForeignKey("chats.id"), nullable=False),
sa.Column("owner_id", sa.Uuid(), sa.ForeignKey("users.id"), nullable=False),
sa.Column("filename", sa.String(255), nullable=False),
sa.Column("object_key", sa.Text(), nullable=False, unique=True),
sa.Column("content_type", sa.String(32), nullable=False),
sa.Column("size_bytes", sa.BigInteger(), nullable=False),
sa.Column("sha256", sa.String(64), nullable=False),
sa.Column("created_at", sa.DateTime(timezone=True), nullable=False),
sa.Column("updated_at", sa.DateTime(timezone=True), nullable=False),
sa.UniqueConstraint("chat_id", "id"),
sa.CheckConstraint("size_bytes BETWEEN 1 AND 10485760"),
sa.CheckConstraint("content_type IN ('image/png', 'image/jpeg')"),
)
op.create_index("attachments_chat_idx", "attachments", ["chat_id"])
op.create_unique_constraint("messages_chat_id_id_key", "messages", ["chat_id", "id"])
op.create_table(
"message_attachments",
sa.Column("message_id", sa.Uuid(), primary_key=True),
sa.Column("attachment_id", sa.Uuid(), primary_key=True),
sa.Column("chat_id", sa.Uuid(), nullable=False),
sa.Column("position", sa.Integer(), nullable=False),
sa.ForeignKeyConstraint(
["chat_id", "message_id"], ["messages.chat_id", "messages.id"], ondelete="CASCADE"
),
sa.ForeignKeyConstraint(
["chat_id", "attachment_id"], ["attachments.chat_id", "attachments.id"]
),
sa.UniqueConstraint("message_id", "position"),
sa.CheckConstraint("position BETWEEN 0 AND 9"),
)
op.add_column("message_requests", sa.Column(
"request_attachment_ids", sa.Text(), nullable=False, server_default=""
))
op.drop_constraint("messages_text_bytes_check", "messages", type_="check")
op.create_check_constraint(
"messages_text_bytes_check", "messages", "octet_length(text) BETWEEN 0 AND 16000"
)
def downgrade():
# Refuse downgrade if attachment-only messages cannot satisfy the old schema.
op.drop_constraint("messages_text_bytes_check", "messages", type_="check")
op.create_check_constraint(
"messages_text_bytes_check", "messages", "octet_length(text) BETWEEN 1 AND 16000"
)
op.drop_column("message_requests", "request_attachment_ids")
op.drop_table("message_attachments")
op.drop_constraint("messages_chat_id_id_key", "messages", type_="unique")
op.drop_index("attachments_chat_idx", "attachments")
op.drop_table("attachments")
+37
View File
@@ -0,0 +1,37 @@
"""Durable upload intents, missing-content marker and reconciliation observations."""
import sqlalchemy as sa
from alembic import op
revision = "008"
down_revision = "007"
branch_labels = None
depends_on = None
def upgrade():
op.add_column("attachments", sa.Column("storage_missing_since", sa.DateTime(timezone=True)))
op.create_table(
"upload_intents",
sa.Column("object_key", sa.Text(), primary_key=True),
sa.Column("state", sa.String(16), nullable=False),
sa.Column("created_at", sa.DateTime(timezone=True), nullable=False,
server_default=sa.func.now()),
sa.CheckConstraint("state IN ('pending', 'committed', 'abandoned')"),
)
op.create_table(
"storage_findings",
sa.Column("object_key", sa.Text(), primary_key=True),
sa.Column("kind", sa.String(16), primary_key=True),
sa.Column("fingerprint", sa.Text()),
sa.Column("first_seen", sa.DateTime(timezone=True), nullable=False),
sa.Column("last_seen", sa.DateTime(timezone=True), nullable=False),
sa.Column("resolved_at", sa.DateTime(timezone=True)),
sa.CheckConstraint("kind IN ('orphan', 'missing')"),
)
def downgrade():
op.drop_table("storage_findings")
op.drop_table("upload_intents")
op.drop_column("attachments", "storage_missing_since")
+8
View File
@@ -0,0 +1,8 @@
[tool.ruff]
cache-dir = ".venv/.ruff_cache"
target-version = "py313"
line-length = 100
include = ["src/**/*.py"]
[tool.ruff.lint]
select = ["E4", "E7", "E9", "F", "I"]
+21
View File
@@ -0,0 +1,21 @@
annotated-doc==0.0.5
annotated-types==0.8.0
anyio==4.15.1
click==8.5.0
fastapi==0.141.1
h11==0.16.0
idna==3.20
pydantic==2.13.5
pydantic-core==2.46.5
starlette==1.7.0
typing-extensions==4.16.0
typing-inspection==0.4.4
uvicorn==0.53.0
asyncpg==0.30.0
redis==5.2.1
argon2-cffi==25.1.0
SQLAlchemy[asyncio]==2.0.44
alembic==1.17.0
pydantic-settings==2.15.0
minio==7.2.20
Pillow==13.0.0
+63
View File
@@ -0,0 +1,63 @@
"""Export all public working files, including new files; exclude local secrets/state."""
import hashlib
import json
import os
import tarfile
from pathlib import Path
import subprocess
import sys
ROOT=Path(__file__).resolve().parents[1]
subprocess.run([sys.executable,str(ROOT/'scripts/check-course-files.py')],check=True)
paths=subprocess.check_output(['git','ls-files','--cached','--others','--exclude-standard','-z'],cwd=ROOT).split(b'\0')
files={}
for raw in paths:
if not raw:continue
name=os.fsdecode(raw)
if name=='SOURCE_MANIFEST.json':continue
path=ROOT/name
if path.is_file():files[name]=hashlib.sha256(path.read_bytes()).hexdigest()
# Actual non-example credentials must not occur in exported source/evidence.
from dotenv import dotenv_values
example=dotenv_values(ROOT/'student.env.example')
private=[v.encode() for k,v in dotenv_values(ROOT/'.env').items()
if v and len(v)>=12 and v!=example.get(k)
and any(word in k for word in ('PASSWORD','SECRET','TOKEN','API_KEY','DATABASE_URL'))]
unsafe=[]
for name in files:
path=ROOT/name
if name.startswith(('.env','secrets/','backups/','data/')) and name!='.env.example':
unsafe.append(name)
elif any(secret in path.read_bytes() for secret in private):unsafe.append(name)
if unsafe:
raise SystemExit('Не экспортированы файлы с приватными данными: '+', '.join(unsafe))
proof=json.loads((ROOT/'evidence/lab4-clean-start.json').read_text())
changed=[name for name,digest in proof['code_manifest'].items() if files.get(name)!=digest]
if changed:raise SystemExit('После clean-start изменился код: '+', '.join(changed))
required=('Dockerfile','compose.yaml','src/core/request_deadline.py','src/maintenance/reconcile.py',
'student.mk','student.env.example','requirements-student.txt','STUDENT_README.md',
'STUDENT_REPORT.md','course-files.sha256.json','Dockerfile.dockerignore',
'src/core/storage_bootstrap.py','infra/s3/api-policy.json','infra/s3/reconciler-policy.json',
'migrations/versions/008_reconciliation.py',
'scripts/setup-env.py','scripts/check-course-files.py','scripts/test-reconciliation.sh','tests/reconciliation.py',
'tests/lab4_review.py','tests/fixtures/sample.png')
assert all(name in files for name in required),'Required source missing from export'
manifest={'format':1,'lab':4,'author':'Каменский Андрей, БПИ2301',
'clean_start_code_matches':True,'private_credentials_scan':'PASS','files':files}
(ROOT/'SOURCE_MANIFEST.json').write_text(json.dumps(manifest,ensure_ascii=False,indent=2)+'\n')
destination=ROOT/'dist';destination.mkdir(exist_ok=True)
archive=destination/'mtusi2026lab4-submission.tar.gz'
with tarfile.open(archive,'w:gz') as output:
for name in sorted([*files,'SOURCE_MANIFEST.json']):
output.add(ROOT/name,arcname='mtusi2026lab4/'+name,recursive=False)
with tarfile.open(archive,'r:gz') as source:
bundled={member.name.removeprefix('mtusi2026lab4/') for member in source.getmembers()}
assert set(files).issubset(bundled) and 'SOURCE_MANIFEST.json' in bundled
assert '.env' not in bundled and not any(name.startswith(('.git/','.venv/')) for name in bundled)
receipt={'result':'PASS','archive':str(archive.relative_to(ROOT)),
'sha256':hashlib.sha256(archive.read_bytes()).hexdigest(),
'source_files':len(files),'required_files_present':True,'clean_start_code_matches':True,
'private_credentials_scan':'PASS','local_env_excluded':True,'course_files_unchanged':True}
# Receipt is separate to avoid a circular archive hash in its own contents.
(destination/'submission-receipt.json').write_text(json.dumps(receipt,ensure_ascii=False,indent=2)+'\n')
print(json.dumps(receipt,ensure_ascii=False,indent=2))
+38
View File
@@ -0,0 +1,38 @@
"""Plot measured scan cost and per-container memory from final acceptance outputs."""
import json
import statistics
from pathlib import Path
import matplotlib
matplotlib.use('Agg')
import matplotlib.pyplot as plt
root=Path(__file__).resolve().parents[1]
def json_rows(name):
result=[]
for line in (root/'evidence'/name).read_text().splitlines():
try:result.append(json.loads(line))
except ValueError:pass
return result
runs=next(r['runs'] for r in json_rows('lab4-final-reconciliation.txt') if r.get('experiment')=='scan_cost')
memory=next(r for r in json_rows('lab4-final-upload-memory.txt') if r.get('result')=='PASS')
fig,axes=plt.subplots(1,2,figsize=(11,4),layout='constrained')
sizes=[10,100,1005]
medians=[statistics.median(r['seconds'] for r in runs if r['objects']==n) for n in sizes]
lows=[m-min(r['seconds'] for r in runs if r['objects']==n) for n,m in zip(sizes,medians)]
highs=[max(r['seconds'] for r in runs if r['objects']==n)-m for n,m in zip(sizes,medians)]
axes[0].bar([str(n) for n in sizes],medians,color='#3766a3',yerr=[lows,highs],capsize=5)
axes[0].set(title='Metadata scan: median and range of 3 runs',xlabel='Objects',ylabel='Seconds')
axes[0].grid(axis='y',alpha=.2)
base=[r['baseline_bytes']/1024**2 for r in memory['memory']]
peak=[r['sampled_peak_bytes']/1024**2 for r in memory['memory']]
axes[1].bar([-.18,.82],base,width=.36,label='Baseline',color='#9bb8d9')
axes[1].bar([.18,1.18],peak,width=.36,label='Sampled peak',color='#3766a3')
axes[1].set(xticks=[0,1],xticklabels=['API 1','API 2'],ylabel='Cgroup memory, MiB',
title='10 concurrent PNG uploads; 20 ms sampling',ylim=(0,max(peak)*1.3))
axes[1].text(.02,.95,'Container limit: 512 MiB',transform=axes[1].transAxes,va='top')
axes[1].legend(loc='upper right');axes[1].grid(axis='y',alpha=.2)
output=root/'evidence/lab4-research';output.mkdir(exist_ok=True)
fig.savefig(output/'results.png',dpi=180)
fig.savefig(output/'results.svg')
(output/'results.json').write_text(json.dumps({'scan_runs':runs,'upload_experiment':memory},ensure_ascii=False,indent=2)+'\n')
print('Created evidence/lab4-research/results.png and results.json')
+31
View File
@@ -0,0 +1,31 @@
"""Управление только API-контейнерами текущего Compose-проекта."""
import json
import os
import subprocess
from pathlib import Path
ROOT = Path(__file__).resolve().parents[1]
def docker(*args):
return subprocess.check_output(["docker", *args], cwd=ROOT, text=True).strip()
def compose(*args):
return docker("compose", "--env-file", os.environ.get("ENV_FILE", ".env"), *args)
def containers():
return compose("ps", "--all", "-q", "api").split()
def describe(container):
# Никогда не выводим Config.Env: там credentials.
return json.loads(docker("inspect", "--format", "{{json .State}}", container))
def instance_id(container):
code = "import urllib.request; r=urllib.request.urlopen('http://127.0.0.1:8080/health/ready', timeout=2); print(r.headers['X-Instance-Id'])"
return docker("exec", container, "python", "-c", code)
+7
View File
@@ -0,0 +1,7 @@
#!/bin/sh
set -eu
cd "$(dirname "$0")/.."
# Полный restart работающих ролей; volumes не удаляются.
docker compose --env-file "${ENV_FILE:-.env}" restart postgres redis minio
docker compose --env-file "${ENV_FILE:-.env}" up -d --wait --force-recreate api
docker compose --env-file "${ENV_FILE:-.env}" restart reconciler lb
+26
View File
@@ -0,0 +1,26 @@
"""Create local synthetic credentials without overwriting an existing .env."""
import argparse
import os
import secrets
from pathlib import Path
root=Path(__file__).resolve().parents[1]
parser=argparse.ArgumentParser(description=__doc__)
parser.add_argument('--output',type=Path,default=root/'.env')
args=parser.parse_args()
values={
'POSTGRES_PASSWORD':secrets.token_hex(24),
'ADMIN_PASSWORD':secrets.token_hex(24),
'MINIO_ROOT_PASSWORD':secrets.token_hex(24),
'S3_SECRET_ACCESS_KEY':secrets.token_hex(24),
'S3_RECONCILE_SECRET_ACCESS_KEY':secrets.token_hex(24),
}
lines=(root/'student.env.example').read_text().splitlines()
content='\n'.join(key+'='+values[key] if '=' in line and (key:=line.split('=',1)[0]) in values else line for line in lines)+'\n'
try:
descriptor=os.open(args.output,os.O_WRONLY|os.O_CREAT|os.O_EXCL,0o600)
except FileExistsError:
parser.exit(1,'Файл уже существует; его настройки и пароли сохранены.\n')
with os.fdopen(descriptor,'w') as stream:
stream.write(content)
print('Создан файл локальных настроек с новыми паролями; значения не выводятся.')
+34
View File
@@ -0,0 +1,34 @@
"""Сопоставить X-Instance-Id реальному контейнеру и оставить его остановленным."""
import json
import os
import time
from replicas import containers, describe, docker, instance_id
target = os.environ["TARGET_INSTANCE_ID"]
running = [c for c in containers() if describe(c)["Running"]]
if len(running) < 2:
raise SystemExit("Need at least two running API containers")
for container in running:
if instance_id(container) == target:
before = describe(container)
started = time.monotonic()
docker("stop", "--time", "10", container)
after = describe(container)
assert not after["Running"]
print(
json.dumps(
{
"container": container[:12],
"instance_id": target,
"started_at": before["StartedAt"],
"finished_at": after["FinishedAt"],
"stop_seconds": round(time.monotonic() - started, 3),
"exit_code": after["ExitCode"],
}
)
)
break
else:
raise SystemExit("Requested instance not found in this Compose project")
+4
View File
@@ -0,0 +1,4 @@
#!/bin/sh
set -eu
cd "$(dirname "$0")/.."
exec "${PYTHON:-python3}" scripts/stop-one.py
+92
View File
@@ -0,0 +1,92 @@
"""Build the complete source snapshot and boot a separate stack with empty volumes.
The active project and its data are untouched. Credentials and source copies are
kept in a temporary directory; only our UUID-named test project is removed.
"""
import hashlib
import json
import os
import secrets
import shutil
import socket
import subprocess
import sys
import time
from pathlib import Path
from tempfile import TemporaryDirectory
ROOT=Path(__file__).resolve().parents[1]
project='lab4-clean-'+secrets.token_hex(4)
with socket.socket() as sock:
sock.bind(('127.0.0.1',0));port=sock.getsockname()[1]
inventory=subprocess.run(['git','ls-files','--cached','--others','--exclude-standard','-z'],cwd=ROOT,capture_output=True)
if inventory.returncode==0:
files=inventory.stdout.split(b'\0')
else:
manifest_path=ROOT/'SOURCE_MANIFEST.json'
if not manifest_path.is_file():
raise SystemExit('Нужен Git clone или архив с SOURCE_MANIFEST.json')
files=[os.fsencode(name) for name in json.loads(manifest_path.read_text())['files']]
proof={'project':project,'empty_volumes':True,'source':'complete working snapshot including new files',
'build_cache':'API rebuilt with --no-cache; pinned MinIO build may use BuildKit cache'}
with TemporaryDirectory(prefix='lab4-clean-') as temporary:
source=Path(temporary)/'source';source.mkdir()
manifest={}
for raw in files:
if not raw:continue
relative=Path(os.fsdecode(raw))
original=ROOT/relative
if not original.is_file():continue
target=source/relative;target.parent.mkdir(parents=True,exist_ok=True)
shutil.copy2(original,target)
if relative.parts[0] in ('src','migrations','infra') or str(relative) in ('Dockerfile','Dockerfile.dockerignore','requirements.txt','requirements-student.txt',
'student.env.example','student.mk','compose.yaml','alembic.ini'):
manifest[str(relative)]=hashlib.sha256(original.read_bytes()).hexdigest()
subprocess.run([sys.executable,str(source/'scripts/setup-env.py')],cwd=source,check=True,capture_output=True)
env_file=source/'.env'
text=env_file.read_text().replace('APP_PORT=8080','APP_PORT='+str(port))
env_file.write_text(text)
environment={**os.environ,'COMPOSE_PROJECT_NAME':project,'ENV_FILE':str(env_file),
'APP_PORT':str(port),'APP_IMAGE':'mtusi-messenger:'+project,
'MINIO_IMAGE':'mtusi-minio:'+project}
# A clean launch must not inherit deployment overrides from the current shell.
for name in ('POSTGRES_PASSWORD','POSTGRES_USER','POSTGRES_DB','MINIO_ROOT_USER',
'MINIO_ROOT_PASSWORD','S3_ACCESS_KEY_ID','S3_SECRET_ACCESS_KEY','S3_RECONCILE_ACCESS_KEY_ID',
'S3_RECONCILE_SECRET_ACCESS_KEY','UPLOAD_CONCURRENCY','API_REPLICAS','API_MEMORY'):
environment.pop(name,None)
command=['docker','compose','--env-file',str(env_file)]
def run(*args,timeout=300):
return subprocess.run(args,cwd=source,env=environment,text=True,check=True,
capture_output=True,timeout=timeout)
def run_build(*args):
started=time.perf_counter()
result=run(*command,'build',*args,timeout=900)
return {'seconds':round(time.perf_counter()-started,3),'exit_code':result.returncode}
try:
proof['api_build']=run_build('--no-cache','api')
proof['minio_build']=run_build('minio')
run(*command,'up','-d','--no-build','--wait',timeout=180)
version=run(*command,'exec','-T','postgres','sh','-c',
'exec psql -U "$POSTGRES_USER" -d "$POSTGRES_DB" -Atc "SELECT version_num FROM alembic_version"').stdout.strip()
assert version=='008',version
proof['schema_revision']=version
proof['public_smoke']=run(sys.executable,'tests/smoke.py','--base-url',f'http://127.0.0.1:{port}').stdout.strip()
proof['attachments']=run(sys.executable,'tests/attachments.py','--base-url',f'http://127.0.0.1:{port}').stdout.strip()
proof['reconciler']=json.loads(run(*command,'exec','-T','reconciler','python','-m','src.maintenance.reconcile').stdout)
assert proof['reconciler']['result']=='ok'
rows=run(*command,'ps','--format','json').stdout
proof['services']=[{'service':r['Service'],'state':r['State'],'health':r.get('Health','')}
for r in (json.loads(line) for line in rows.splitlines() if line.strip())]
proof['code_manifest']=manifest
proof['result']='PASS'
except subprocess.CalledProcessError as error:
# Never dump compose config/environment; build/application outputs exclude credentials.
print((error.stdout+error.stderr)[-4000:])
raise
finally:
run(*command,'down','--volumes','--remove-orphans',timeout=90)
proof['temporary_project_and_volumes_removed']=True
run('docker','image','rm',environment['APP_IMAGE'],environment['MINIO_IMAGE'],timeout=60)
proof['temporary_image_tags_removed']=True
(ROOT/'evidence/lab4-clean-start.json').write_text(json.dumps(proof,ensure_ascii=False,indent=2)+'\n')
print(json.dumps({k:v for k,v in proof.items() if k!='code_manifest'},ensure_ascii=False,indent=2))
+8
View File
@@ -0,0 +1,8 @@
#!/bin/sh
set -eu
cd "$(dirname "$0")/.."
# Сохраняет обычный TTL и восстанавливает API даже при падении проверки.
restore() { docker compose up -d --wait --force-recreate api; }
trap restore EXIT
SESSION_TTL_SECONDS=2 docker compose up -d --wait --force-recreate api
"${PYTHON:-python3}" tests/expiry.py
+46
View File
@@ -0,0 +1,46 @@
"""Исходный persistence-сценарий плюс доказательство рестарта API и всех хранилищ."""
import argparse
import json
from pathlib import Path
import subprocess
import sys
ROOT = Path(__file__).resolve().parents[1]
def states():
result = {}
for service in ('api', 'postgres', 'redis', 'minio', 'reconciler', 'lb'):
ids = subprocess.check_output(['docker', 'compose', 'ps', '-q', service], cwd=ROOT, text=True).split()
if not ids:
raise RuntimeError('Не запущен сервис ' + service)
result[service] = {}
for container in ids:
state = json.loads(subprocess.check_output(['docker', 'inspect', '--format', '{{json .State}}', container], cwd=ROOT, text=True))
result[service][container] = {'StartedAt': state['StartedAt'], 'Pid': state['Pid']}
return result
def main():
parser = argparse.ArgumentParser(description=__doc__)
parser.add_argument('--base-url', default='http://localhost:8080')
parser.add_argument('--action-script', required=True)
parser.add_argument('--ca-file')
args = parser.parse_args()
before = states()
print('ДО: ' + json.dumps(before), flush=True)
command = [sys.executable, str(ROOT / 'tests/resilience.py'), '--mode', 'persistence',
'--action-script', args.action_script, '--base-url', args.base_url]
if args.ca_file:
command += ['--ca-file', args.ca_file]
subprocess.run(command, cwd=ROOT, check=True)
after = states()
print('ПОСЛЕ: ' + json.dumps(after), flush=True)
for service in before:
if before[service] == after[service]:
raise AssertionError('Сервис не перезапущен: ' + service)
print('PASS: StartedAt изменился у API, PostgreSQL, Redis, MinIO, reconciler и LB; прежний токен и данные сохранены')
if __name__ == '__main__':
main()
+7
View File
@@ -0,0 +1,7 @@
#!/bin/sh
set -eu
cd "$(dirname "$0")/.."
# Pass the DB address via environment, without printing it or placing it in argv.
api_container_id=$(docker compose ps -q api | head -n 1)
test_database_url=$(docker exec "$api_container_id" python -c 'import os; print(os.environ["DATABASE_URL"])')
DATABASE_URL="$test_database_url" docker compose run --rm --no-deps -T -e DATABASE_URL s3-bootstrap python < tests/reconciliation.py
+11
View File
@@ -0,0 +1,11 @@
#!/bin/sh
set -eu
cd "$(dirname "$0")/.."
# Temporary profile: 5 admitted uploads per replica, serialized image decoding.
# Restore the ordinary project configuration even when the experiment fails.
restore_upload_profile() {
docker compose up -d --wait api >/dev/null 2>&1
}
trap restore_upload_profile EXIT INT TERM
UPLOAD_CONCURRENCY=5 docker compose up -d --wait api >/dev/null 2>&1
"${PYTHON:-python3}" tests/upload_memory.py
+51
View File
@@ -0,0 +1,51 @@
"""Sequential acceptance checks, reviewer cases, research and reproducible clean startup."""
import json
import os
import subprocess
import sys
import time
from pathlib import Path
from dotenv import dotenv_values
ROOT=Path(__file__).resolve().parents[1]
EVIDENCE=ROOT/'evidence'
EVIDENCE.mkdir(exist_ok=True)
python=sys.executable
port=os.environ.get('APP_PORT') or dotenv_values(ROOT/'.env').get('APP_PORT') or '8080'
base_url=os.environ.get('BASE_URL') or 'http://127.0.0.1:'+str(port)
api=subprocess.check_output(['docker','compose','ps','-q','api'],cwd=ROOT,text=True).split()[0]
checks=[
('course-files',[python,'scripts/check-course-files.py'],None),
('quality',[python,'-m','ruff','check','src'],None),
('format',[python,'-m','ruff','format','--check','src'],None),
('structure',[python,'scripts/check_contract.py'],None),
('openapi',[python,'scripts/validate_openapi.py'],None),
('request-deadline',['docker','exec','-i',api,'python'],'tests/request_deadline.py'),
('readiness-budget',['docker','exec','-i',api,'python'],'tests/readiness.py'),
('public-smoke',[python,'tests/smoke.py'],None),
('attachments',[python,'tests/attachments.py'],None),
('idempotency',[python,'tests/idempotency.py'],None),
('reviewer-cases',[python,'tests/lab4_review.py'],None),
('reconciliation',['scripts/test-reconciliation.sh'],None),
('upload-memory',['scripts/test-upload-memory.sh'],None),
('uploader-failover',[python,'tests/attachment_failover.py'],None),
('persistence-proof',[python,'scripts/test-persistence.py','--action-script','scripts/restart.sh','--base-url',base_url],None),
('clean-start',[python,'scripts/test-clean-lab4.py'],None),
]
summary=[]
for name,command,input_file in checks:
print('Проверка: '+name,flush=True)
started=time.perf_counter()
source=open(ROOT/input_file,'rb') if input_file else None
try:
with (EVIDENCE/('lab4-final-'+name+'.txt')).open('wb') as output:
result=subprocess.run(command,cwd=ROOT,env={**os.environ,'PYTHON':python,'BASE_URL':base_url},stdin=source,
stdout=output,stderr=subprocess.STDOUT,timeout=1000 if name=='clean-start' else 180)
summary.append({'check':name,'exit_code':result.returncode,'seconds':round(time.perf_counter()-started,3),
'evidence':'evidence/lab4-final-'+name+'.txt'})
if result.returncode:
raise RuntimeError('Не прошла проверка '+name+'; см. '+summary[-1]['evidence'])
finally:
if source:source.close()
(EVIDENCE/'lab4-final-summary.json').write_text(json.dumps({'result':'PASS','checks':summary},ensure_ascii=False,indent=2)+'\n')
print('PASS: все итоговые проверки лабораторной 4',flush=True)
View File
+13
View File
@@ -0,0 +1,13 @@
import uvicorn
from src.core.settings import settings
if __name__ == "__main__":
uvicorn.run(
"src.main:app",
host=settings.app_host,
port=settings.app_port,
workers=settings.app_workers,
log_level=settings.log_level.lower(),
timeout_graceful_shutdown=settings.shutdown_timeout_seconds,
)
View File
+106
View File
@@ -0,0 +1,106 @@
import base64
import binascii
import re
from typing import Annotated
from fastapi import Depends, Request
from fastapi.security import HTTPAuthorizationCredentials, HTTPBearer
from fastapi.security.http import HTTPBase, HTTPBasicCredentials
from sqlalchemy.ext.asyncio import AsyncSession
from src.core.db.session import get_db_session
from src.core.errors import ApiError
from src.core.settings import settings
from src.service.auth import AuthService
from src.service.chat import ChatService
from src.service.dto import UserDTO
from src.service.exceptions import InvalidSessionException
from src.service.message import MessageService
from src.service.user import UserService
bearer_scheme = HTTPBearer(
scheme_name="bearerAuth",
description="Вставьте токен из ответа на вход, без префикса Bearer.",
auto_error=False,
)
basic_scheme = HTTPBase(scheme="basic", scheme_name="basicAuth", auto_error=False)
async def get_basic_credentials(
request: Request,
credentials: Annotated[HTTPAuthorizationCredentials | None, Depends(basic_scheme)],
) -> HTTPBasicCredentials:
if await request.body():
raise ApiError(400, "invalid_request", "Вход не принимает тело запроса")
try:
authorization = request.headers.getlist("authorization")
if len(authorization) != 1 or len(authorization[0]) > settings.authorization_max_length:
raise ValueError
if credentials is None or credentials.scheme.lower() != "basic":
raise ValueError
decoded = base64.b64decode(credentials.credentials, validate=True).decode("utf-8")
username, separator, password = decoded.partition(":")
if (
not separator
or re.fullmatch(r"[a-z0-9_]{3,32}", username) is None
or not 12 <= len(password) <= 128
or not password.strip()
):
raise ValueError
except (ValueError, UnicodeError, binascii.Error):
raise ApiError(401, "unauthorized", "Неверный логин или пароль") from None
return HTTPBasicCredentials(username=username, password=password)
def get_user_service(
db_session: Annotated[AsyncSession, Depends(get_db_session, scope="function")],
) -> UserService:
return UserService(db_session=db_session)
def get_chat_service(
db_session: Annotated[AsyncSession, Depends(get_db_session, scope="function")],
) -> ChatService:
return ChatService(db_session=db_session)
def get_message_service(
db_session: Annotated[AsyncSession, Depends(get_db_session, scope="function")],
) -> MessageService:
return MessageService(db_session=db_session)
def get_auth_service(
db_session: Annotated[AsyncSession, Depends(get_db_session, scope="function")],
) -> AuthService:
return AuthService(
db_session=db_session,
session_ttl_seconds=settings.session_ttl_seconds,
)
def get_bearer_token(
request: Request,
credentials: Annotated[HTTPAuthorizationCredentials | None, Depends(bearer_scheme)],
) -> str:
if credentials is None or len(request.headers.getlist("authorization")) != 1:
raise ApiError(401, "unauthorized", "Требуется Bearer-токен")
token = credentials.credentials
if (
credentials.scheme.lower() != "bearer"
or not token
or len(token) > 512
or any(c.isspace() for c in token)
):
raise ApiError(401, "unauthorized", "Требуется Bearer-токен")
return token
async def get_current_user(
auth: Annotated[AuthService, Depends(get_auth_service)],
token: Annotated[str, Depends(get_bearer_token)],
) -> UserDTO:
try:
return await auth.get_user(token=token)
except InvalidSessionException as error:
raise ApiError(401, "unauthorized", str(error)) from error
+17
View File
@@ -0,0 +1,17 @@
from fastapi import APIRouter
from src.api.v1.routers.attachments import router as attachments_router
from src.api.v1.routers.auth.router import router as auth_router
from src.api.v1.routers.chats.router import router as chats_router
from src.api.v1.routers.messages.router import router as messages_router
from src.api.v1.routers.users.router import router as users_router
router = APIRouter(prefix="/api/v1", tags=["Версия 1"])
router.include_router(users_router)
router.include_router(chats_router)
router.include_router(messages_router)
router.include_router(auth_router)
router.include_router(attachments_router)
View File
View File
+118
View File
@@ -0,0 +1,118 @@
from datetime import datetime
from typing import Annotated, Literal
from uuid import UUID
from anyio import to_thread
from fastapi import APIRouter, Depends, Query, Request
from fastapi.responses import StreamingResponse
from pydantic import BaseModel, Field
from sqlalchemy.ext.asyncio import AsyncSession
from src.api.dependencies import get_current_user
from src.core.db.models import Attachment
from src.core.db.session import get_db_session
from src.core.errors import ApiError
from src.core.settings import settings
from src.core.storage import STORAGE_ERRORS, get_storage, unavailable
from src.service.attachment import AttachmentService
from src.service.dto import UserDTO
router = APIRouter(tags=["Вложения"])
class AttachmentOut(BaseModel):
id: UUID
chat_id: UUID
owner_id: UUID
filename: str
content_type: str
size_bytes: int
sha256: str
status: Literal["ready"] = "ready"
variants: list = Field(default_factory=list)
error_code: None = None
created_at: datetime
updated_at: datetime
def to_output(attachment: Attachment) -> AttachmentOut:
return AttachmentOut.model_validate(attachment, from_attributes=True)
def get_service(
session: Annotated[AsyncSession, Depends(get_db_session, scope="function")],
) -> AttachmentService:
return AttachmentService(session)
@router.post(
"/chats/{chat_id}/attachments",
status_code=201,
openapi_extra={
"requestBody": {
"required": True,
"content": {
mime: {"schema": {"type": "string", "format": "binary"}}
for mime in ("image/png", "image/jpeg")
},
}
},
)
async def upload_attachment(
chat_id: UUID,
request: Request,
user: Annotated[UserDTO, Depends(get_current_user)],
service: Annotated[AttachmentService, Depends(get_service)],
filename: Annotated[str, Query(min_length=1, max_length=255)],
) -> AttachmentOut:
if len(request.query_params.getlist("filename")) != 1:
raise ApiError(400, "invalid_request", "Неоднозначное имя файла")
return to_output(await service.upload(request, chat_id, user.id, filename))
@router.get("/attachments/{attachment_id}")
async def get_attachment(
attachment_id: UUID,
user: Annotated[UserDTO, Depends(get_current_user)],
service: Annotated[AttachmentService, Depends(get_service)],
) -> AttachmentOut:
return to_output(await service.get(attachment_id, user.id))
@router.get("/attachments/{attachment_id}/content")
async def download_attachment(
attachment_id: UUID,
request: Request,
user: Annotated[UserDTO, Depends(get_current_user)],
service: Annotated[AttachmentService, Depends(get_service)],
variant: str = "original",
):
attachment = await service.get(attachment_id, user.id)
if len(request.query_params.getlist("variant")) > 1:
raise ApiError(400, "invalid_request", "Неоднозначный вариант")
if variant not in {"original", "thumbnail", "crop", "optimized"}:
raise ApiError(400, "invalid_request", "Некорректный вариант")
if variant != "original":
raise ApiError(404, "not_found", "Вариант не найден")
try:
response = await to_thread.run_sync(
lambda: get_storage().get_object(settings.s3_bucket, attachment.object_key)
)
except STORAGE_ERRORS as error:
raise unavailable(error) from error
async def content():
try:
while chunk := await to_thread.run_sync(response.read, 64 * 1024):
yield chunk
finally:
response.close()
response.release_conn()
return StreamingResponse(
content(),
media_type=attachment.content_type,
headers={
"Content-Length": str(attachment.size_bytes),
},
)
View File
+31
View File
@@ -0,0 +1,31 @@
import logging
from sqlalchemy.ext.asyncio import AsyncSession, async_sessionmaker
from src.core.db.repo.auth import fetch_user_credentials
from src.core.security import verify_password_async
from src.core.settings import settings
from src.service.user import UserService
logger = logging.getLogger(__name__)
async def create_admin(session_factory: async_sessionmaker[AsyncSession]) -> None:
async with session_factory.begin() as session:
admin = await UserService(db_session=session).create_admin(
username=settings.admin_username,
display_name=settings.admin_display_name,
password=settings.admin_password.get_secret_value(),
)
if admin is None and settings.app_env == "production":
credentials = await fetch_user_credentials(session, settings.admin_username)
if credentials is None or not await verify_password_async(
settings.admin_password.get_secret_value(), credentials.password_hash
):
raise RuntimeError(
"Пароль существующего администратора не совпадает с настройкой production"
)
if admin is None:
logger.info("Администратор уже существует")
else:
logger.info("Администратор создан: пользователь=%s", admin.id)
+50
View File
@@ -0,0 +1,50 @@
from dataclasses import asdict
from typing import Annotated
from fastapi import APIRouter, Depends, Response
from fastapi.security import HTTPBasicCredentials
from src.api.dependencies import (
get_auth_service,
get_basic_credentials,
get_bearer_token,
get_current_user,
)
from src.api.v1.routers.auth.schemas import SessionOut
from src.api.v1.routers.users.schemas import UserOut
from src.core.errors import ApiError
from src.service.auth import AuthService
from src.service.dto import UserDTO
from src.service.exceptions import InvalidCredentialsException
router = APIRouter(prefix="/auth/sessions", tags=["Сессии"])
@router.post("", status_code=201, response_model=SessionOut)
async def login(
credentials: Annotated[HTTPBasicCredentials, Depends(get_basic_credentials)],
auth: Annotated[AuthService, Depends(get_auth_service)],
) -> SessionOut:
try:
result = await auth.login(
username=credentials.username,
password=credentials.password,
)
except InvalidCredentialsException as error:
raise ApiError(401, "unauthorized", str(error)) from error
return SessionOut(
token=result.token,
token_type=result.token_type,
expires_at=result.expires_at,
user=UserOut(**asdict(result.user)),
)
@router.delete("/current", status_code=204)
async def logout(
current_user: Annotated[UserDTO, Depends(get_current_user)],
token: Annotated[str, Depends(get_bearer_token)],
auth: Annotated[AuthService, Depends(get_auth_service)],
) -> Response:
await auth.logout(token=token)
return Response(status_code=204)
+13
View File
@@ -0,0 +1,13 @@
from datetime import datetime
from typing import Literal
from pydantic import BaseModel
from src.api.v1.routers.users.schemas import UserOut
class SessionOut(BaseModel):
token: str
token_type: Literal["Bearer"]
expires_at: datetime
user: UserOut
+86
View File
@@ -0,0 +1,86 @@
from typing import Annotated
from uuid import UUID
from fastapi import APIRouter, Depends, Query, status
from src.api.dependencies import get_chat_service, get_current_user
from src.api.v1.routers.chats.schemas import ChatOut, CreateChatIn, GetChatOut
from src.api.v1.schemas import PaginationQuery
from src.core.errors import ApiError
from src.core.pagination import decode_cursor, encode_cursor
from src.service.chat import ChatService
from src.service.dto import ChatDTO, UserDTO
from src.service.exceptions import ChatNotFoundException, InvalidChatMembersException
router = APIRouter(prefix="/chats", tags=["Чаты"])
def _to_chat_out(chat: ChatDTO) -> ChatOut:
return ChatOut(
id=chat.id,
title=chat.title,
member_ids=list(chat.member_ids),
created_at=chat.created_at,
)
@router.post("", status_code=status.HTTP_201_CREATED)
async def create_chat(
chat_in: CreateChatIn,
current_user: Annotated[UserDTO, Depends(get_current_user)],
chat_service: Annotated[ChatService, Depends(get_chat_service)],
) -> ChatOut:
try:
chat = await chat_service.create_chat(
title=chat_in.title,
member_ids=chat_in.member_ids,
current_user_id=current_user.id,
)
except InvalidChatMembersException as error:
raise ApiError(400, "invalid_request", str(error)) from error
return _to_chat_out(chat)
@router.get("", status_code=status.HTTP_200_OK)
async def get_chats(
pagination: Annotated[PaginationQuery, Query()],
current_user: Annotated[UserDTO, Depends(get_current_user)],
chat_service: Annotated[ChatService, Depends(get_chat_service)],
) -> GetChatOut:
after = None
if pagination.cursor is not None:
after = decode_cursor(
pagination.cursor,
expected_kind="chats",
expected_owner_id=current_user.id,
)
chats = await chat_service.get_chats(
current_user_id=current_user.id, limit=pagination.limit + 1, after=after
)
page = chats[: pagination.limit]
next_cursor = None
if len(chats) > pagination.limit:
last = page[-1]
next_cursor = encode_cursor("chats", current_user.id, last.created_at, last.id)
return GetChatOut(
items=[_to_chat_out(chat) for chat in page],
next_cursor=next_cursor,
)
@router.get("/{chat_id}", summary="Получить доступный чат")
async def get_chat(
chat_id: UUID,
current_user: Annotated[UserDTO, Depends(get_current_user)],
chat_service: Annotated[ChatService, Depends(get_chat_service)],
) -> ChatOut:
try:
chat = await chat_service.get_chat(
chat_id=chat_id,
current_user_id=current_user.id,
)
except ChatNotFoundException as error:
raise ApiError(404, "not_found", str(error)) from error
return _to_chat_out(chat)
+42
View File
@@ -0,0 +1,42 @@
from datetime import datetime
from uuid import UUID
from pydantic import BaseModel, ConfigDict, Field, field_validator
class CreateChatIn(BaseModel):
model_config = ConfigDict(extra="forbid")
title: str = Field(min_length=1, max_length=100)
member_ids: list[UUID] = Field(min_length=1, max_length=100)
@field_validator("title")
@classmethod
def title_must_not_be_blank(cls, value: str) -> str:
value.encode("utf-8")
if not value.strip():
raise ValueError("title не может состоять только из пробелов")
return value
@field_validator("member_ids")
@classmethod
def member_ids_must_be_unique(cls, value: list[UUID]) -> list[UUID]:
if len(value) != len(set(value)):
raise ValueError("member_ids не должен содержать дубликаты")
return value
class ChatOut(BaseModel):
model_config = ConfigDict(extra="forbid")
id: UUID
title: str
member_ids: list[UUID]
created_at: datetime
class GetChatOut(BaseModel):
model_config = ConfigDict(extra="forbid")
items: list[ChatOut]
next_cursor: str | None
+96
View File
@@ -0,0 +1,96 @@
import re
from typing import Annotated
from uuid import UUID
from fastapi import APIRouter, Depends, Header, Query, Request, status
from src.api.dependencies import get_current_user, get_message_service
from src.api.v1.routers.messages.schemas import (
CreateMessageIn,
MessageOut,
MessagePageOut,
)
from src.api.v1.schemas import PaginationQuery
from src.core.errors import ApiError
from src.core.pagination import decode_cursor, encode_cursor
from src.service.dto import MessageDTO, UserDTO
from src.service.exceptions import ChatNotFoundException, IdempotencyConflictException
from src.service.message import MessageService
router = APIRouter(prefix="/chats", tags=["Сообщения"])
def _to_message_out(message: MessageDTO) -> MessageOut:
return MessageOut(
id=message.id,
chat_id=message.chat_id,
sender_id=message.sender_id,
text=message.text,
attachment_ids=list(message.attachment_ids),
created_at=message.created_at,
)
@router.post("/{chat_id}/messages", status_code=status.HTTP_201_CREATED)
async def create_message(
chat_id: UUID,
message_in: CreateMessageIn,
request: Request,
current_user: Annotated[UserDTO, Depends(get_current_user)],
message_service: Annotated[MessageService, Depends(get_message_service)],
idempotency_key: Annotated[str, Header()],
) -> MessageOut:
if (
len(request.headers.getlist("idempotency-key")) != 1
or re.fullmatch(r"[A-Za-z0-9._:-]{1,128}", idempotency_key) is None
):
raise ApiError(400, "invalid_request", "Требуется корректный Idempotency-Key")
try:
message = await message_service.create_message(
chat_id=chat_id,
sender_id=current_user.id,
text=message_in.text,
attachment_ids=message_in.attachment_ids,
idempotency_key=idempotency_key,
)
except ChatNotFoundException as error:
raise ApiError(404, "not_found", str(error)) from error
except IdempotencyConflictException as error:
raise ApiError(409, "conflict", "Ключ уже использован для другого сообщения") from error
return _to_message_out(message)
@router.get("/{chat_id}/messages", status_code=status.HTTP_200_OK)
async def get_messages(
chat_id: UUID,
pagination: Annotated[PaginationQuery, Query()],
current_user: Annotated[UserDTO, Depends(get_current_user)],
message_service: Annotated[MessageService, Depends(get_message_service)],
) -> MessagePageOut:
after = None
if pagination.cursor is not None:
after = decode_cursor(
pagination.cursor,
expected_kind="messages",
expected_owner_id=chat_id,
)
try:
messages = await message_service.get_messages(
chat_id=chat_id,
current_user_id=current_user.id,
limit=pagination.limit + 1,
after=after,
)
except ChatNotFoundException as error:
raise ApiError(404, "not_found", str(error)) from error
page = messages[: pagination.limit]
next_cursor = None
if len(messages) > pagination.limit:
last = page[-1]
next_cursor = encode_cursor("messages", chat_id, last.created_at, last.id)
return MessagePageOut(
items=[_to_message_out(message) for message in page],
next_cursor=next_cursor,
)
+43
View File
@@ -0,0 +1,43 @@
from datetime import datetime
from uuid import UUID
from pydantic import BaseModel, ConfigDict, Field, field_validator, model_validator
class CreateMessageIn(BaseModel):
model_config = ConfigDict(extra="forbid")
text: str = Field(max_length=4000)
attachment_ids: list[UUID] = Field(default_factory=list, max_length=10)
@field_validator("text")
@classmethod
def text_must_not_be_blank(cls, value: str) -> str:
value.encode("utf-8")
return value
@model_validator(mode="after")
def validate_message(self):
if not self.text.strip() and not self.attachment_ids:
raise ValueError("Требуется текст или вложение")
if len(set(self.attachment_ids)) != len(self.attachment_ids):
raise ValueError("Вложения не должны повторяться")
return self
class MessageOut(BaseModel):
model_config = ConfigDict(extra="forbid")
id: UUID
chat_id: UUID
sender_id: UUID
text: str
attachment_ids: list[UUID]
created_at: datetime
class MessagePageOut(BaseModel):
model_config = ConfigDict(extra="forbid")
items: list[MessageOut]
next_cursor: str | None
+44
View File
@@ -0,0 +1,44 @@
from typing import Annotated
from fastapi import APIRouter, Depends, status
from src.api.dependencies import get_current_user, get_user_service
from src.api.v1.routers.users.schemas import CreateUserIn, UserOut
from src.core.errors import ApiError
from src.service.dto import UserDTO
from src.service.exceptions import UserAlreadyExistsException
from src.service.user import UserService
router = APIRouter(prefix="/users", tags=["Пользователи"])
def _to_user_out(user: UserDTO) -> UserOut:
return UserOut(
id=user.id,
username=user.username,
display_name=user.display_name,
created_at=user.created_at,
)
@router.post("", status_code=status.HTTP_201_CREATED)
async def create_user(
user_in: CreateUserIn,
user_service: Annotated[UserService, Depends(get_user_service)],
) -> UserOut:
try:
user = await user_service.create_user(
password=user_in.password,
username=user_in.username,
display_name=user_in.display_name,
)
except UserAlreadyExistsException as error:
raise ApiError(409, "conflict", str(error)) from error
return _to_user_out(user)
@router.get("/me", status_code=status.HTTP_200_OK)
async def get_me(
current_user: Annotated[UserDTO, Depends(get_current_user)],
) -> UserOut:
return _to_user_out(current_user)
+29
View File
@@ -0,0 +1,29 @@
from datetime import datetime
from uuid import UUID
from pydantic import BaseModel, ConfigDict, Field, field_validator
class CreateUserIn(BaseModel):
model_config = ConfigDict(extra="forbid")
username: str = Field(pattern=r"^[a-z0-9_]{3,32}$")
password: str = Field(min_length=12, max_length=128)
display_name: str = Field(min_length=1, max_length=100)
@field_validator("display_name", "password")
@classmethod
def required_string_must_not_be_blank(cls, value: str) -> str:
value.encode("utf-8")
if not value.strip():
raise ValueError("Обязательная строка не может состоять только из пробелов")
return value
class UserOut(BaseModel):
model_config = ConfigDict(extra="forbid")
id: UUID
username: str
display_name: str
created_at: datetime
+21
View File
@@ -0,0 +1,21 @@
import re
from pydantic import BaseModel, ConfigDict, Field, field_validator
from src.core.settings import settings
class PaginationQuery(BaseModel):
model_config = ConfigDict(extra="forbid")
limit: int = Field(default=50, ge=1, le=100)
cursor: str | None = Field(default=None, min_length=1, max_length=settings.cursor_max_length)
@field_validator("limit", mode="before")
@classmethod
def limit_must_be_integer(cls, value):
if isinstance(value, bool) or isinstance(value, float):
raise ValueError("limit должен быть целым числом")
if isinstance(value, str) and re.fullmatch(r"[0-9]+", value) is None:
raise ValueError("limit должен содержать десятичные цифры")
return value
View File
+68
View File
@@ -0,0 +1,68 @@
"""Клиент Redis и необязательный кэш профилей пользователей."""
import logging
from redis.asyncio import Redis
from redis.exceptions import RedisError
from src.core.settings import settings
logger = logging.getLogger(__name__)
cache: Redis | None = None
def open_cache():
global cache
cache = Redis.from_url(
settings.redis_url.get_secret_value(),
decode_responses=True,
max_connections=settings.redis_max_connections,
socket_connect_timeout=settings.redis_connect_timeout_seconds,
socket_timeout=settings.redis_read_timeout_seconds,
retry_on_timeout=settings.redis_retry_on_timeout,
)
async def close_cache():
global cache
if cache is not None:
await cache.aclose()
cache = None
async def get(key: str) -> str | None:
if cache is None:
return None
try:
return await cache.get(key)
except UnicodeError:
logger.warning("Повреждённый UTF-8 в кэше профиля; читаем PostgreSQL")
await delete(key)
return None
except (RedisError, OSError):
logger.warning("Redis недоступен; читаем профиль из PostgreSQL")
return None
async def set(key: str, value: str):
if cache is None:
return
try:
await cache.set(key, value, ex=settings.profile_cache_ttl_seconds)
except (RedisError, OSError):
logger.warning("Redis недоступен; пропускаем запись кэша")
async def delete(key: str) -> None:
if cache is None:
return
try:
await cache.delete(key)
except (RedisError, OSError):
logger.warning("Redis недоступен; пропускаем удаление кэша профиля")
def get_client() -> Redis:
if cache is None:
raise RedisError("Клиент Redis не настроен")
return cache
+24
View File
@@ -0,0 +1,24 @@
from collections.abc import AsyncIterator
from contextlib import asynccontextmanager
from fastapi import FastAPI
from src.api.v1.routers.auth.callback import create_admin
from src.core import readiness
from src.core.db import session as database
STARTUP_CALLBACKS = (create_admin,)
@asynccontextmanager
async def lifespan(app: FastAPI) -> AsyncIterator[None]:
async with database.database_lifespan(app):
session_factory = database.session_factory
if session_factory is None:
raise RuntimeError("Фабрика сессий не запущена")
for callback in STARTUP_CALLBACKS:
await callback(session_factory)
try:
yield
finally:
await readiness.close()
View File
+160
View File
@@ -0,0 +1,160 @@
from datetime import datetime
from uuid import UUID
from sqlalchemy import (
BigInteger,
Boolean,
CheckConstraint,
DateTime,
ForeignKey,
ForeignKeyConstraint,
Index,
Integer,
String,
Text,
UniqueConstraint,
false,
)
from sqlalchemy.orm import DeclarativeBase, Mapped, mapped_column, relationship
from src.core.db.types import Utf8Text
class Base(DeclarativeBase):
pass
class User(Base):
__tablename__ = "users"
__table_args__ = (
CheckConstraint("username ~ '^[a-z0-9_]{3,32}$'"),
CheckConstraint(
"octet_length(display_name) BETWEEN 1 AND 400", name="users_display_name_bytes_check"
),
)
id: Mapped[UUID] = mapped_column(primary_key=True)
username: Mapped[str] = mapped_column(String(32), unique=True)
display_name: Mapped[str] = mapped_column(Utf8Text())
password_hash: Mapped[str] = mapped_column(Text)
is_admin: Mapped[bool] = mapped_column(Boolean, default=False, server_default=false())
created_at: Mapped[datetime] = mapped_column(DateTime(timezone=True))
class Chat(Base):
__tablename__ = "chats"
__table_args__ = (
CheckConstraint("octet_length(title) BETWEEN 1 AND 400", name="chats_title_bytes_check"),
)
id: Mapped[UUID] = mapped_column(primary_key=True)
title: Mapped[str] = mapped_column(Utf8Text())
created_at: Mapped[datetime] = mapped_column(DateTime(timezone=True))
members: Mapped[list["ChatMember"]] = relationship(order_by="ChatMember.user_id")
class ChatMember(Base):
__tablename__ = "chat_members"
__table_args__ = (Index("chat_members_user_idx", "user_id", "chat_id"),)
chat_id: Mapped[UUID] = mapped_column(
ForeignKey("chats.id", ondelete="CASCADE"), primary_key=True
)
user_id: Mapped[UUID] = mapped_column(ForeignKey("users.id"), primary_key=True)
class Message(Base):
__tablename__ = "messages"
__table_args__ = (
ForeignKeyConstraint(
["chat_id", "sender_id"], ["chat_members.chat_id", "chat_members.user_id"]
),
CheckConstraint("octet_length(text) BETWEEN 0 AND 16000", name="messages_text_bytes_check"),
UniqueConstraint("chat_id", "id"),
Index("messages_history_idx", "chat_id", "created_at", "id"),
)
id: Mapped[UUID] = mapped_column(primary_key=True)
chat_id: Mapped[UUID] = mapped_column(ForeignKey("chats.id"))
sender_id: Mapped[UUID] = mapped_column(ForeignKey("users.id"))
attachments: Mapped[list["MessageAttachment"]] = relationship(
lazy="selectin", order_by="MessageAttachment.position"
)
text: Mapped[str] = mapped_column(Utf8Text())
created_at: Mapped[datetime] = mapped_column(DateTime(timezone=True))
class MessageRequest(Base):
# Таблица обслуживает только POST /chats/{chat_id}/messages: метод и путь
# однозначно заданы таблицей и chat_id. Общая область ключа: sender/chat/key.
__tablename__ = "message_requests"
sender_id: Mapped[UUID] = mapped_column(ForeignKey("users.id"), primary_key=True)
chat_id: Mapped[UUID] = mapped_column(ForeignKey("chats.id"), primary_key=True)
key: Mapped[str] = mapped_column(String(128), primary_key=True)
request_text: Mapped[str] = mapped_column(Utf8Text())
request_attachment_ids: Mapped[str] = mapped_column(Text, default="", server_default="")
message_id: Mapped[UUID | None] = mapped_column(ForeignKey("messages.id"))
expires_at: Mapped[datetime] = mapped_column(DateTime(timezone=True))
class Attachment(Base):
__tablename__ = "attachments"
__table_args__ = (
UniqueConstraint("chat_id", "id"),
CheckConstraint("size_bytes BETWEEN 1 AND 10485760"),
CheckConstraint("content_type IN ('image/png', 'image/jpeg')"),
Index("attachments_chat_idx", "chat_id"),
)
id: Mapped[UUID] = mapped_column(primary_key=True)
chat_id: Mapped[UUID] = mapped_column(ForeignKey("chats.id"))
owner_id: Mapped[UUID] = mapped_column(ForeignKey("users.id"))
filename: Mapped[str] = mapped_column(String(255))
object_key: Mapped[str] = mapped_column(Text, unique=True)
content_type: Mapped[str] = mapped_column(String(32))
size_bytes: Mapped[int] = mapped_column(BigInteger)
sha256: Mapped[str] = mapped_column(String(64))
created_at: Mapped[datetime] = mapped_column(DateTime(timezone=True))
updated_at: Mapped[datetime] = mapped_column(DateTime(timezone=True))
storage_missing_since: Mapped[datetime | None] = mapped_column(DateTime(timezone=True))
class MessageAttachment(Base):
__tablename__ = "message_attachments"
__table_args__ = (
ForeignKeyConstraint(
["chat_id", "message_id"], ["messages.chat_id", "messages.id"], ondelete="CASCADE"
),
ForeignKeyConstraint(
["chat_id", "attachment_id"], ["attachments.chat_id", "attachments.id"]
),
UniqueConstraint("message_id", "position"),
CheckConstraint("position BETWEEN 0 AND 9"),
)
message_id: Mapped[UUID] = mapped_column(primary_key=True)
attachment_id: Mapped[UUID] = mapped_column(primary_key=True)
chat_id: Mapped[UUID] = mapped_column()
position: Mapped[int] = mapped_column(Integer)
class UploadIntent(Base):
__tablename__ = "upload_intents"
__table_args__ = (CheckConstraint("state IN ('pending', 'committed', 'abandoned')"),)
object_key: Mapped[str] = mapped_column(Text, primary_key=True)
state: Mapped[str] = mapped_column(String(16))
created_at: Mapped[datetime] = mapped_column(DateTime(timezone=True))
class StorageFinding(Base):
__tablename__ = "storage_findings"
__table_args__ = (CheckConstraint("kind IN ('orphan', 'missing')"),)
object_key: Mapped[str] = mapped_column(Text, primary_key=True)
kind: Mapped[str] = mapped_column(String(16), primary_key=True)
fingerprint: Mapped[str | None] = mapped_column(Text)
first_seen: Mapped[datetime] = mapped_column(DateTime(timezone=True))
last_seen: Mapped[datetime] = mapped_column(DateTime(timezone=True))
resolved_at: Mapped[datetime | None] = mapped_column(DateTime(timezone=True))
View File
+16
View File
@@ -0,0 +1,16 @@
from sqlalchemy import select
from sqlalchemy.ext.asyncio import AsyncSession
from src.core.db.models import User
from src.core.db.repo.user import to_user
from src.service.dto import UserCredentialsDTO
async def fetch_user_credentials(
session: AsyncSession,
username: str,
) -> UserCredentialsDTO | None:
user = await session.scalar(select(User).where(User.username == username))
if user is None:
return None
return UserCredentialsDTO(user=to_user(user), password_hash=user.password_hash)
+59
View File
@@ -0,0 +1,59 @@
from datetime import datetime
from uuid import UUID
from sqlalchemy import select, tuple_
from sqlalchemy.ext.asyncio import AsyncSession
from sqlalchemy.orm import selectinload
from src.core.db.models import Chat, ChatMember
from src.service.dto import ChatDTO
def to_chat(chat: Chat) -> ChatDTO:
return ChatDTO(
chat.id, chat.title, tuple(member.user_id for member in chat.members), chat.created_at
)
async def fetch_chat_by_id(session: AsyncSession, chat_id: UUID) -> ChatDTO | None:
chat = await session.scalar(
select(Chat).options(selectinload(Chat.members)).where(Chat.id == chat_id),
)
return to_chat(chat) if chat else None
async def fetch_chats(
session: AsyncSession,
user_id: UUID,
limit: int,
after: tuple[datetime, UUID] | None = None,
) -> list[ChatDTO]:
query = (
select(Chat)
.options(selectinload(Chat.members))
.join(ChatMember)
.where(ChatMember.user_id == user_id)
)
if after is not None:
query = query.where(tuple_(Chat.created_at, Chat.id) > after)
chats = await session.scalars(query.order_by(Chat.created_at, Chat.id).limit(limit))
return [to_chat(chat) for chat in chats]
async def create_chat(
session: AsyncSession,
chat_id: UUID,
title: str,
member_ids: list[UUID],
created_at: datetime,
) -> ChatDTO:
chat = Chat(
id=chat_id,
title=title,
created_at=created_at,
members=[ChatMember(user_id=user_id) for user_id in member_ids],
)
session.add(chat)
# ORM сохраняет чат и участников в транзакции текущего запроса.
await session.flush()
return to_chat(chat)
+148
View File
@@ -0,0 +1,148 @@
from datetime import datetime
from uuid import UUID
from sqlalchemy import select, tuple_
from sqlalchemy.ext.asyncio import AsyncSession
from src.core.db.models import Attachment, Message, MessageAttachment, MessageRequest
from src.service.dto import MessageDTO
def to_message(message: Message) -> MessageDTO:
return MessageDTO(
message.id,
message.chat_id,
message.sender_id,
message.text,
message.created_at,
tuple(link.attachment_id for link in message.attachments),
)
def history_query(chat_id: UUID, limit: int, after: tuple[datetime, UUID] | None = None):
query = select(Message).where(Message.chat_id == chat_id)
if after is not None:
query = query.where(tuple_(Message.created_at, Message.id) > after)
return query.order_by(Message.created_at, Message.id).limit(limit)
async def fetch_messages_by_chat_id(
session: AsyncSession,
chat_id: UUID,
limit: int,
after: tuple[datetime, UUID] | None = None,
) -> list[MessageDTO]:
messages = await session.scalars(history_query(chat_id, limit, after))
return [to_message(message) for message in messages]
async def create_message(
session: AsyncSession,
message_id: UUID,
chat_id: UUID,
sender_id: UUID,
text: str,
created_at: datetime,
attachment_ids: list[UUID] | None = None,
) -> MessageDTO:
message = Message(
id=message_id,
chat_id=chat_id,
sender_id=sender_id,
text=text,
created_at=created_at,
attachments=[
MessageAttachment(chat_id=chat_id, attachment_id=aid, position=i)
for i, aid in enumerate(attachment_ids or [])
],
)
session.add(message)
await session.flush()
return to_message(message)
async def create_idempotent_message(
session: AsyncSession,
message_id: UUID,
chat_id: UUID,
sender_id: UUID,
text: str,
created_at: datetime,
idempotency_key: str,
attachment_ids: list[UUID] | None = None,
) -> MessageDTO:
from sqlalchemy import func, update
from sqlalchemy import text as sql_text
from sqlalchemy.dialects.postgresql import insert
from src.core.errors import ApiError
from src.service.exceptions import IdempotencyConflictException
attachment_ids = attachment_ids or []
request_attachments = ",".join(str(aid) for aid in attachment_ids)
if attachment_ids:
found = set(
await session.scalars(
select(Attachment.id).where(
Attachment.chat_id == chat_id, Attachment.id.in_(attachment_ids)
)
)
)
if found != set(attachment_ids):
raise ApiError(404, "not_found", "Вложение не найдено")
identity = (
MessageRequest.sender_id == sender_id,
MessageRequest.chat_id == chat_id,
MessageRequest.key == idempotency_key,
)
# UNIQUE/UPSERT сериализует конкурентные повторы даже на разных процессах.
# Проигравший ждёт COMMIT; при rollback он сам получает право на создание.
values = dict(
sender_id=sender_id,
chat_id=chat_id,
key=idempotency_key,
request_text=text,
request_attachment_ids=request_attachments,
message_id=None,
expires_at=func.clock_timestamp() + sql_text("interval '24 hours'"),
)
claim = (
insert(MessageRequest)
.values(**values)
.on_conflict_do_update(
index_elements=["sender_id", "chat_id", "key"],
set_={
k: v
for k, v in values.items()
if k in {"request_text", "request_attachment_ids", "message_id", "expires_at"}
},
where=MessageRequest.expires_at <= func.clock_timestamp(),
)
.returning(MessageRequest.key)
)
owned = await session.scalar(claim)
if owned is None:
existing = (await session.execute(select(MessageRequest).where(*identity))).scalar_one()
if existing.request_text != text or existing.request_attachment_ids != request_attachments:
raise IdempotencyConflictException
message = await session.get(Message, existing.message_id)
if message is None:
raise RuntimeError("Нарушена атомарность результата идемпотентности")
return to_message(message)
if attachment_ids:
missing = await session.scalar(
select(Attachment.id)
.where(Attachment.id.in_(attachment_ids), Attachment.storage_missing_since.is_not(None))
.limit(1)
)
if missing is not None:
raise ApiError(409, "conflict", "Оригинал вложения недоступен")
message = await create_message(
session, message_id, chat_id, sender_id, text, created_at, attachment_ids
)
await session.execute(update(MessageRequest).where(*identity).values(message_id=message.id))
# COMMIT сообщения и ключа выполняется вместе в get_db_session до HTTP 201.
return message
+120
View File
@@ -0,0 +1,120 @@
import json
import re
from dataclasses import asdict
from datetime import datetime, timezone
from uuid import UUID
from sqlalchemy import func, select
from sqlalchemy.dialects.postgresql import insert
from sqlalchemy.ext.asyncio import AsyncSession
from src.core import cache
from src.core.db.models import User
from src.service.dto import UserDTO
def to_user(user: User) -> UserDTO:
return UserDTO(user.id, user.username, user.display_name, user.created_at)
async def fetch_user_by_id(session: AsyncSession, user_id: UUID) -> UserDTO | None:
key = f"user:v1:{user_id}"
cached = await cache.get(key)
if cached is not None:
try:
data = json.loads(cached)
if (
not isinstance(data, dict)
or set(data) != {"id", "username", "display_name", "created_at"}
or not all(isinstance(value, str) for value in data.values())
):
raise ValueError
created_at = datetime.fromisoformat(data["created_at"])
if created_at.tzinfo is None:
raise ValueError
data["display_name"].encode("utf-8")
user = UserDTO(
UUID(data["id"]),
data["username"],
data["display_name"],
created_at.astimezone(timezone.utc),
)
if (
user.id != user_id
or re.fullmatch(r"[a-z0-9_]{3,32}", user.username) is None
or not 1 <= len(user.display_name) <= 100
or not user.display_name.strip()
or user.created_at.tzinfo is None
):
raise ValueError
return user
except (ValueError, KeyError, TypeError, OverflowError):
await cache.delete(key)
model = await session.get(User, user_id)
user = to_user(model) if model else None
if user:
await cache.set(key, json.dumps(asdict(user), default=str))
return user
async def fetch_user_by_username(session: AsyncSession, username: str) -> UserDTO | None:
model = await session.scalar(select(User).where(User.username == username))
return to_user(model) if model else None
async def create_user(
session: AsyncSession,
user_id: UUID,
username: str,
display_name: str,
created_at: datetime,
password_hash: str,
) -> UserDTO:
user = User(
id=user_id,
username=username,
display_name=display_name,
created_at=created_at,
password_hash=password_hash,
)
session.add(user)
await session.flush()
return to_user(user)
async def users_exist(session: AsyncSession, user_ids: list[UUID]) -> bool:
count = await session.scalar(
select(func.count()).select_from(User).where(User.id.in_(user_ids))
)
return count == len(user_ids)
async def create_admin(
session: AsyncSession,
user_id: UUID,
username: str,
display_name: str,
password_hash: str,
created_at: datetime,
) -> UserDTO | None:
user = await session.scalar(
insert(User)
.values(
id=user_id,
username=username,
display_name=display_name,
password_hash=password_hash,
created_at=created_at,
is_admin=True,
)
.on_conflict_do_nothing(index_elements=[User.username])
.returning(User)
)
return to_user(user) if user else None
async def admin_exists(session: AsyncSession, username: str) -> bool:
user_id = await session.scalar(
select(User.id).where(User.username == username, User.is_admin.is_(True))
)
return user_id is not None
+48
View File
@@ -0,0 +1,48 @@
from contextlib import asynccontextmanager
from sqlalchemy.ext.asyncio import AsyncSession, async_sessionmaker, create_async_engine
from src.core.cache import close_cache, open_cache
from src.core.settings import settings
session_factory: async_sessionmaker[AsyncSession] | None = None
def create_engine():
return create_async_engine(
settings.sqlalchemy_database_url,
pool_size=settings.database_pool_size,
max_overflow=settings.database_max_overflow,
pool_timeout=settings.database_pool_timeout_seconds,
pool_pre_ping=settings.database_pool_pre_ping,
hide_parameters=True,
connect_args={
"timeout": settings.database_connect_timeout_seconds,
"command_timeout": settings.database_command_timeout_seconds,
"server_settings": {"statement_timeout": str(settings.database_statement_timeout_ms)},
},
)
@asynccontextmanager
async def database_lifespan(app):
global session_factory
engine = create_engine()
session_factory = async_sessionmaker(engine, expire_on_commit=False)
open_cache()
try:
yield
finally:
await close_cache()
await engine.dispose()
session_factory = None
async def get_db_session():
if session_factory is None:
raise RuntimeError("Фабрика сессий не запущена")
async with session_factory() as session:
# Одна транзакция на запрос: аутентификация и бизнес-операция вместе.
# Depends(scope='function') завершает COMMIT до отправки ответа.
async with session.begin():
yield session
+15
View File
@@ -0,0 +1,15 @@
"""Unicode-строки в UTF-8 bytea: PostgreSQL text не допускает U+0000."""
from sqlalchemy import LargeBinary
from sqlalchemy.types import TypeDecorator
class Utf8Text(TypeDecorator[str]):
impl = LargeBinary
cache_ok = True
def process_bind_param(self, value: str | None, dialect) -> bytes | None:
return None if value is None else value.encode("utf-8")
def process_result_value(self, value: bytes | None, dialect) -> str | None:
return None if value is None else value.decode("utf-8")
+29
View File
@@ -0,0 +1,29 @@
from fastapi import Request
from fastapi.responses import JSONResponse
class ApiError(Exception):
def __init__(self, status_code: int, code: str, message: str) -> None:
self.status_code = status_code
self.code = code
self.message = message
super().__init__(message)
def error_response(
request: Request,
status_code: int,
code: str,
message: str,
) -> JSONResponse:
request_id = getattr(request.state, "request_id", "неизвестен")
return JSONResponse(
status_code=status_code,
content={
"error": {
"code": code,
"message": message,
"request_id": request_id,
}
},
)

Some files were not shown because too many files have changed in this diff Show More