Обновить REPORT.md

This commit is contained in:
2026-11-06 20:04:34 +03:00
parent d228560474
commit c7fe5451d5
+2 -15
View File
@@ -1,6 +1,6 @@
# Лабораторная 4 — S3-хранилище и вложения
Автор: Савин Александр, БВТ2303. Целевая оценка: **5, трек 2 — согласованность двух хранилищ** (включает уровни 3 и 4). Дата локальных проверок: 6 ноября 2026 года. Основа — собственная реализация lab3; при подготовке использовался Codex. Задание, обязательный контракт и публичные тесты сохранены. Репозиторий: [healby/mtusi2026lab4](https://gitea.privcloud.tech/healby/mtusi2026lab4).
Автор: Савин Александр, БВТ2303. Целевая оценка: **5, трек 2 — согласованность двух хранилищ**.
## Запуск из чистого clone
@@ -31,12 +31,10 @@ make research-consistency
make research-memory
```
Все зависимости запускаются этим проектом. .env создаётся один раз с тремя разными случайными паролями и правами 600; существующий файл не перезаписывается. APP_PORT по умолчанию 8084, чтобы сохранить работающие lab2:8080 и lab3:8083. Хранилища/volumes предыдущих лабораторных не подключаются. API_REPLICAS, API_CPUS и API_IMAGE управляют числом, CPU и образом API; остальные обязательные значения описаны в compose.yaml/.env.example. Секреты исключены из Git и Docker build context. Credentials в environment доступны оператору Docker — учебное упрощение.
Все зависимости запускаются этим проектом. .env создаётся один раз с тремя разными случайными паролями и правами 600; существующий файл не перезаписывается. APP_PORT по умолчанию 8084. Хранилища/volumes предыдущих лабораторных не подключаются. API_REPLICAS, API_CPUS и API_IMAGE управляют числом, CPU и образом API; остальные обязательные значения описаны в compose.yaml/.env.example. Секреты исключены из Git и Docker build context. Credentials в environment доступны оператору Docker — учебное упрощение.
Остановка без потери данных: `./scripts/compose.sh down`; возврат: `./scripts/compose.sh up -d`. Намеренное удаление **всех учебных данных lab4**: `./scripts/compose.sh down -v`; для проверок команда не нужна.
Для OpenAPI и графиков создать отдельное окружение:
```sh
python3 -m venv .venv
.venv/bin/python -m pip install -r requirements-dev.txt -r requirements-research.txt
@@ -228,14 +226,3 @@ make reconcile-apply # те же правила с реальным испра
Готовые, но ещё не прикреплённые вложения автоматически не удаляются: клиент может сослаться на них позже. Failed-записи и связи сохраняются для диагностики; tombstone retention отдельно не реализован. Изменять приватные объекты напрямую допускается только оператору; ключи приложения неизменяемы и не переиспользуются. Защита от произвольных злонамеренных изменений root/SQL-администратора и от несогласованного восстановления всей БД вне модели этой работы.
## Вопросы на защите
**Почему не volume одной API?** Другой контейнер не обязан видеть её локальные файлы. У нас единое объектное хранилище, а API не привязаны к месту хранения оригинала.
**Когда вернуть 201?** После приёма и проверки всех байтов, успешного S3 PUT и фиксации ready в PostgreSQL.
**PUT прошёл, COMMIT — нет: что дальше?** Pending-намерение уже устойчиво сохранено. После grace reconciler сверяет обе стороны под lock и безопасно завершает очистку. Если COMMIT на самом деле прошёл, ready-запись сохраняется.
**Почему приватного bucket недостаточно?** Он защищает прямой S3-доступ, но API всё равно должна проверить Bearer и членство в нужном чате. Случайный ключ не заменяет ACL.
Первичные источники: [S3 PutObject](https://docs.aws.amazon.com/boto3/latest/reference/services/s3/client/put_object.html), [Pillow Image](https://pillow.readthedocs.io/en/stable/reference/Image.html), [MinIO mc policy attach](https://docs.min.io/aistor/reference/cli/admin/mc-admin-policy/mc-admin-policy-attach/). Реальные версии серверов проверены локально; API и дополнительные библиотеки закреплены в requirements.txt.