5.8 KiB
Отчёт — лабораторная 4
- Автор, группа: Ситникова Дарья Евгеньевна, БВТ2303
- Целевая оценка: 4; трек на 5 не заявлен
- Commit/PR: TODO после публикации
- Использованные источники, библиотеки и помощь ИИ: собственная реализация lab3; Go, pgx/v5, go-redis/v9, golang.org/x/crypto (версии в go.mod); Codex — перенос основы проекта. Дополняется по мере реализации.
Текущий этап: перенос основы из lab3
06.11.2026 перенесены исходники Go, модуль и зависимости, Dockerfile, миграции PostgreSQL, конфигурация HAProxy, Compose, собственные тесты и скрипты управления стендом. Собственные тесты скопированы из текущего рабочего дерева lab3, включая незакоммиченные доработки. Публичные tests, contracts и документы задания lab4 сохранены.
Основа: две API-реплики за HAProxy, общие PostgreSQL-сессии и сообщения, Redis-кэш, идемпотентная отправка сообщений. Проект Compose переименован в messenger-lab4, volume — в postgres_lab4_data_v1, порт LB по умолчанию — 8084. Данные и секреты lab3 не переносились. Путь Go-модуля сохранён из предыдущей реализации.
S3 и вложения пока не реализованы. Результаты lab3 не являются доказательствами выполнения lab4. Собственные тесты и hooks перенесены как основа; после добавления S3 их потребуется дополнить. Новые результаты проверок и экспериментов будут записываться в evidence/.
Подготовка и запуск перенесённой основы из корня репозитория:
./scripts/init-local.ps1
docker compose --env-file .env config --quiet
docker compose --env-file .env up -d --build --wait --wait-timeout 180
# API: http://127.0.0.1:8084
# Остановка с сохранением данных:
docker compose down
Это запуск основы lab3; публичный smoke lab4 требует ещё не реализованные вложения.
Проверки переноса: go test ./..., go vet ./..., scripts/check_contract.py и docker compose --env-file .env.example config --quiet завершились успешно. HTTP-тесты повторены вне песочницы после блокировки localhost в первом запуске. Стенд не запускался. Результаты.
Запуск из чистого clone
TODO: версии runtime/образов, prerequisites, команды создания локальных secrets/.env, build, миграций, запуска, ожидания готовности, тестов и остановки. Указать необходимые действия оператора. Не вставлять секреты. Отдельно указать безопасную остановку и команду намеренного удаления учебных данных.
Архитектура и решения
TODO: схема процессов/хранилищ, источник истины, транзакционные границы, ограничения. Что перенесено из lab3, что изменено в этой работе. Соответствие переменных из .env.example реальной конфигурации.
Доказательства критериев
| Критерий 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: какие отказы выдерживаются и какие нет; что не реализовано; где учебное упрощение; какое улучшение подтверждено, а какое пока гипотеза.