ЛР 4: S3-хранилище (SeaweedFS) и вложения

This commit is contained in:
kalibr456
2026-10-21 21:25:10 +03:00
parent ec540a1a72
commit 5c3a31db2e
81 changed files with 6847 additions and 25 deletions
+8 -8
View File
@@ -1,14 +1,14 @@
## Лабораторная 4
Автор / группа: TODO
Целевая оценка (3/4/5): TODO
Трек 5, если заявлен: TODO
Автор / группа: Бабиченко Максим, БВТ2303
Целевая оценка (3/4/5): 4
Трек 5, если заявлен: не заявлен
Что реализовано и что перенесено: TODO
Команды запуска из чистого clone: TODO
Результаты проверок и ссылка на REPORT.md: TODO
Ограничения / известные ошибки: TODO
Источники и использование ИИ: TODO
Что реализовано и что перенесено: перенесён весь lab3 (API на FastAPI, PostgreSQL, сессии в Redis, HAProxy + 2 реплики, идемпотентность, migrate, свои тесты). Добавлены: SeaweedFS (`s3`) с приватным bucket и volume `s3data` (MinIO недоступен в публичных реестрах); идемпотентный bootstrap `s3-init`; отдельный ключ API с правами только на свой bucket; миграция 004 (`attachments`, `message_attachments` с составными FK по `chat_id`); синхронная загрузка PNG/JPEG с потоковыми лимитами (10 MiB, 40 Мпикс до распаковки, MIME по содержимому, проверка целостности без декодирования в память), скачивание через API с проверкой участника; `attachment_ids` в сообщениях; запись «строка-намерение -> PUT -> ready» и сервис `janitor` (очистка брошенных загрузок и объектов-сирот с grace period, dry-run, отчёт о missing). Подробности — REPORT.md.
Команды запуска из чистого clone: `Copy-Item .env.example .env; python scripts/init_secrets.py; docker compose up -d --build --wait; python student-tests/collect_evidence.py` (полностью — REPORT.md, раздел «Запуск из чистого clone»).
Результаты проверок и ссылка на REPORT.md: evidence/summary.md и evidence/*.txt; таблицы замеров — REPORT.md, раздел «Эксперименты и отказы».
Ограничения / известные ошибки: один узел (lb, postgres, redis, s3 — SPOF); повтор загрузки после потерянного ответа создаёт второе вложение (так по контракту); missing-объекты janitor только находит. См. REPORT.md, «Ограничения».
Источники и использование ИИ: библиотеки и документация перечислены в REPORT.md; при написании кода и тестов использовался ИИ-ассистент (Claude), код проверен и прогнан мной.
- [ ] Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами.
- [ ] Контракт и публичные тесты не ослаблены.