Files
mtusi2026lab4/REPORT.md
T

38 lines
3.2 KiB
Markdown

# Отчёт — лабораторная 4
- Автор, группа: Афанасьев Андрей / БПИ2304
- Целевая оценка; выбранный трек 5, если нужен: 3; трек не заявлен
- Commit/PR: TODO после публикации
- Использованные источники, библиотеки и помощь ИИ: TODO
## Запуск из чистого clone
Требуется Docker Compose. Запуск: `cp .env.example .env`, затем `docker compose --env-file .env up -d --build --wait`; проверка: `make test`. Для persistence используется `scripts/restart.sh`, для failover — `scripts/stop-one.sh api1`. Остановка без удаления данных: `docker compose down`; volumes удаляются отдельно только намеренно.
## Архитектура и решения
Перенесены две API-реплики, Nginx, PostgreSQL, Bearer-сессии и идемпотентность lab3. Добавлены MinIO с именованным volume `s3_data`, таблицы `attachments`/`message_attachments` и API загрузки/метаданных/скачивания. PostgreSQL хранит только метаданные, байты — в приватном bucket. Загрузка ограничена 10 MiB и проверяет PNG/JPEG сигнатуру; доступ проверяется членством в чате.
## Доказательства критериев
| Критерий README | Команда/сценарий | Наблюдаемый результат | Файл доказательства |
| --- | --- | --- | --- |
| Публичный smoke | make test | Проверка API, вложений и checksum | tests/ |
| Остальные пункты уровня 3 | persistence/failover hooks | Общие PostgreSQL и MinIO volumes | scripts/ |
| Все пункты уровня 4, если заявлен | TODO | TODO | TODO |
| Выбранный трек 5, если заявлен | TODO | TODO | TODO |
TODO: добавить отдельную строку для каждого заявленного критерия. PASS без команды и наблюдения не является доказательством. Проверка инфраструктурного hook требует подтверждения, какие реальные процессы/хранилища перезапущены.
## Эксперименты и отказы
Для целевой оценки 3 отдельный исследовательский трек не заявлялся.
| Воздействие | Что ожидаем | Что наблюдали | Время восстановления / потеря данных |
| --- | --- | --- | --- |
| TODO | TODO | TODO | TODO |
## Ограничения и следующие шаги
Стенд рассчитан на отказ одной API-реплики и перезапуск с сохранением volumes. PostgreSQL и MinIO остаются едиными точками отказа. Административная консоль MinIO наружу не публикуется.