5.9 KiB
Отчёт — лабораторная 3
- Автор, группа: TODO
- Целевая оценка; выбранный трек 5, если нужен: TODO
- Commit/PR: TODO после публикации
- Использованные источники, библиотеки и помощь ИИ: TODO
Запуск из чистого clone
Локальные секреты не входят в Git. Перед первым запуском оператор создаёт каталог
secrets/, генерирует пароль PostgreSQL и общий для всех API-реплик ключ подписи
курсоров длиной не менее 32 байт. Значение database_url должно использовать имя
Compose-сервиса postgres, а не localhost. Пример генерации синтетических
локальных значений без их вывода в терминал:
mkdir -p secrets
openssl rand -hex 32 > secrets/postgres_password.txt
openssl rand -base64 48 > secrets/cursor_signing_key.txt
printf 'postgres://messenger:%s@postgres:5432/messenger?sslmode=disable' \
"$(cat secrets/postgres_password.txt)" > secrets/database_url.txt
chmod 600 secrets/*.txt
cp .env.example .env
Полная последовательность запуска, проверки LB и безопасной остановки будет зафиксирована после завершения новой Compose-топологии lab3.
Архитектура и решения
Перенесённая основа lab2 разделена на явные слои:
internal/domain— сущности и бизнес-инварианты без HTTP/JSON-зависимостей;internal/application— сценарии, команды и узкие порты репозиториев;internal/adapter/postgres,memory,redis,cache— реализации внешних зависимостей и кэширующий декоратор;internal/transport/http/dto— wire-модели HTTP-контракта и преобразование domain → response DTO;internal/transport/http/handlers— тонкие обработчики, по одному нетривиальному endpoint на файл;cmd/server— composition root, единственное место сборки зависимостей.
PostgreSQL остаётся источником истины для пользователей, сессий, чатов и сообщений. Redis содержит только удаляемую производную копию неизменяемых данных чата; его отказ не делает API неготовым и не отменяет подтверждённую запись в PostgreSQL.
Пагинационный курсор теперь формируется в application-слое из канонических
полей границы (created_at, id, scope_id) и подписывается HMAC-SHA-256. Подпись
не скрывает payload, но обнаруживает подмену. В scope входит пользователь для
списка чатов и чат для истории сообщений. Все реплики обязаны использовать один
CURSOR_SIGNING_KEY или CURSOR_SIGNING_KEY_FILE; в Compose используется Docker
secret cursor_signing_key. Репозитории получают только уже проверенную
типизированную границу и ничего не знают о формате HTTP-курсора.
.env.example перечисляет реально читаемые приложением параметры PostgreSQL,
пула, readiness/shutdown, Redis-кэша и ключа курсора. API_REPLICAS и
IDEMPOTENCY_TTL_SECONDS зарезервированы для следующих этапов lab3. Секретных
значений в шаблоне нет: там указаны только пути внутри контейнера.
Доказательства критериев
| Критерий README | Команда/сценарий | Наблюдаемый результат | Файл доказательства |
|---|---|---|---|
| Публичный smoke | make test | TODO | TODO |
| Остальные пункты уровня 3 | TODO | TODO | TODO |
| Все пункты уровня 4, если заявлен | TODO | TODO | TODO |
| Выбранный трек 5, если заявлен | TODO | TODO | TODO |
TODO: добавить отдельную строку для каждого заявленного критерия. PASS без команды и наблюдения не является доказательством. Проверка инфраструктурного hook требует подтверждения, какие реальные процессы/хранилища перезапущены.
Эксперименты и отказы
TODO: гипотеза, hardware/лимиты, версии, объём данных, профиль нагрузки, concurrency/arrival rate, длительность/прогрев, повторы, успешные RPS, ошибки, p50/p95/p99, CPU/RAM. Сохранить raw summary без tokens и объяснить ограничения измерения.
| Воздействие | Что ожидаем | Что наблюдали | Время восстановления / потеря данных |
|---|---|---|---|
| TODO | TODO | TODO | TODO |
Ограничения и следующие шаги
TODO: какие отказы выдерживаются и какие нет; что не реализовано; где учебное упрощение; какое улучшение подтверждено, а какое пока гипотеза.