1 Commits
Author SHA1 Message Date
rey 3d67e677d0 Prepare verified laboratory 3 implementation and evidence 2026-11-17 17:31:17 +03:00
176 changed files with 21076 additions and 38 deletions
+3
View File
@@ -18,3 +18,6 @@ __pycache__
node_modules
evidence
.DS_Store
.stress
student-tests
.local/
+14 -14
View File
@@ -1,18 +1,18 @@
## Лабораторная 3
Автор / группа: TODO
Целевая оценка (3/4/5): TODO
Трек 5, если заявлен: TODO
Автор / группа: Медведев Андрей Михайлович, БПИ2303
Целевая оценка (3/4/5): 5
Трек 5: 1 «Цена масштабирования»
Что реализовано и что перенесено: TODO
Команды запуска из чистого clone: TODO
Результаты проверок и ссылка на REPORT.md: TODO
Ограничения / известные ошибки: TODO
Источники и использование ИИ: TODO
Что реализовано и что перенесено: Две API на k3s за Pingap, общие сессии и транзакционная идемпотентность. Выполнены 16 измерений 1/2/4 реплик и пула, построены графики и проверен rollout под нагрузкой. При том же суммарном бюджете две API дали меньший p95, чем четыре; уменьшение пула не подтвердило улучшение. Собственный Go core перенесён из предыдущей лабы с объявленными изменениями API.
Команды запуска из чистого clone: RUN.md, начиная с bun --no-env-file scripts/k3s.ts up.
Результаты проверок и ссылка на REPORT.md: REPORT.md; фактический вывод в evidence/, хеши проверенных исходников в evidence/SOURCE.sha256.
Ограничения / известные ошибки: один host и общие зависимости; ограничения измерений и сценариев перечислены в REPORT.md.
Источники и использование ИИ: оригинальный skeleton и собственная предыдущая работа; Codex использован для кода, тестов и отчёта. Независимый review native runtime сохранён в evidence/k3s/REVIEW.md; прежний backend review — в evidence/REVIEW.md.
- [ ] Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами.
- [ ] Контракт и публичные тесты не ослаблены.
- [ ] make check и make test выполнены; приложен реальный вывод.
- [ ] Сценарии отказов/безопасности своего уровня воспроизведены.
- [ ] Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens.
- [ ] README задания сохранён, REPORT.md содержит инструкцию именно моего решения.
- [x] Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами; native эксперименты и ограничения описаны в REPORT.md.
- [x] Контракт и публичные тесты не ослаблены.
- [x] make check и make test выполнены; приложен реальный вывод.
- [x] Сценарии отказов/безопасности своего уровня воспроизведены.
- [x] Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens.
- [x] README задания сохранён, REPORT.md и RUN.md описывают моё решение.
+4
View File
@@ -30,3 +30,7 @@ coverage/
.vscode/
# Keep small, sanitized evidence summaries in evidence/ under version control.
# Inspect git diff --cached: ignore rules are not a secret scanner.
.stress
.trash-1792138598/
.local/
+29
View File
@@ -0,0 +1,29 @@
# syntax=docker/dockerfile:1
# Сборка: тег и digest закреплены, модули строго по go.sum (-mod=readonly).
# Вместо слоя `go mod download` — cache mount: go.mod объявляет ещё и dev-
# инструменты (oapi-codegen, golangci-lint), а `go mod download` тянул бы их
# в образ сборки; `go build` скачивает только то, что нужно бинарнику.
FROM golang:1.27.2-alpine@sha256:f92b6ef800e499660581efdabdf25d9d817a9d124eaf900924f0504e7e27e12d AS build
WORKDIR /src
ENV CGO_ENABLED=0 GOFLAGS=-mod=readonly
COPY backend/ ./
RUN --mount=type=cache,target=/go/pkg/mod \
--mount=type=cache,target=/root/.cache/go-build \
go build -trimpath -ldflags='-s -w' -o /out/messenger ./cmd/app
# Runtime: только статический бинарник, без shell и пакетного менеджера,
# пользователь nonroot (uid 65532).
FROM gcr.io/distroless/static-debian13:nonroot@sha256:e2e927ec666bae08560abb3c55d0659eceabb657f56b6782ab500a9fc7f555e3
COPY --from=build /out/messenger /messenger
USER 65532:65532
# GOMEMLIMIT рассчитан на запуск с --memory=256m (REPORT.md): GC начинает
# работать активнее до того, как ядро убьёт процесс по OOM.
ENV APP_HOST=0.0.0.0 APP_PORT=8080 GOMEMLIMIT=200MiB
EXPOSE 8080
# curl в образе нет: healthcheck — тот же бинарник с флагом.
HEALTHCHECK --interval=10s --timeout=3s --start-period=5s --retries=3 \
CMD ["/messenger", "-healthcheck"]
STOPSIGNAL SIGTERM
# Exec-форма: сервер — PID 1 и сам получает SIGTERM.
ENTRYPOINT ["/messenger"]
+70 -24
View File
@@ -1,37 +1,83 @@
# Отчёт — лабораторная 3
# Лабораторная 3. k3s, Pingap и взаимозаменяемые API
- Автор, группа: TODO
- Целевая оценка; выбранный трек 5, если нужен: TODO
- Commit/PR: TODO после публикации
- Использованные источники, библиотеки и помощь ИИ: TODO
Автор: Медведев Андрей Михайлович, БПИ2303. Целевая оценка — 5, трек 1 «Цена масштабирования». Основной стенд перенесён на k3s + Pingap по выбору автора. Исходное задание предлагает Compose/Swarm; принятие альтернативы преподавателем не заявляется. Оригинальные README, COURSE, контракты и публичные tests сохранены.
## Запуск из чистого clone
Код, тесты и отчёт подготовлены с помощью Codex. Инструкция запуска — [RUN.md](RUN.md). Исторический вариант Compose/HAProxy описан в [архивном отчёте](docs/archive/compose-report.md); его численные результаты не выдаются за измерения Pingap.
TODO: версии runtime/образов, prerequisites, команды создания локальных secrets/.env, build, миграций, запуска, ожидания готовности, тестов и остановки. Указать необходимые действия оператора. Не вставлять секреты. Отдельно указать безопасную остановку и команду намеренного удаления учебных данных.
## Архитектура и запуск
## Архитектура и решения
Клиент обращается к localhost:28203. Порт ведёт через k3d к Service типа LoadBalancer и Deployment Pingap. Pingap получает адреса API через headless Service с clusterIP: None; отдельный ingress-controller не используется, Traefik выключен при создании кластера. Внешние маршруты находятся в TOML в git и попадают в ConfigMap через Kustomize.
TODO: схема процессов/хранилищ, источник истины, транзакционные границы, ограничения. Что перенесено из lab2, что изменено в этой работе. Соответствие переменных из .env.example реальной конфигурации.
В стенде один server k3s 1.37.1 и две API-реплики. Pingap 0.16.0 и сторонние образы закреплены digest. Собственный образ получает tag из hash Dockerfile и backend. Перед использованием проверяются pinned RepoDigest, соответствие alias и наличие образа в containerd. Экспорт linux/amd64 устраняет ошибку импорта неполного многоплатформенного index Docker29.
## Доказательства критериев
PostgreSQL и Valkey общие для API. Каждая API возвращает реальное имя своего Pod в X-Instance-Id. Сессии проверяются в PostgreSQL при каждом защищённом запросе; Valkey кэширует только неизменяемые профили. Sticky sessions нет. В API нет постоянных пользовательских файлов или локальных сессий. PostgreSQL и Valkey используют PVC; у API нет опубликованного host-порта в обход Pingap.
| Критерий README | Команда/сценарий | Наблюдаемый результат | Файл доказательства |
| --- | --- | --- | --- |
| Публичный smoke | make test | TODO | TODO |
| Остальные пункты уровня 3 | TODO | TODO | TODO |
| Все пункты уровня 4, если заявлен | TODO | TODO | TODO |
| Выбранный трек 5, если заявлен | TODO | TODO | TODO |
Миграции выполняет отдельный Job до запуска API. Readiness PostgreSQL проверяет TCP, затем runner выполняет настоящий SELECT 1: временный сервер инициализации PostgreSQL по Unix-сокету не должен запускать миграции преждевременно. Повторный up сохраняет volumes; произвольные несовместимые миграции под трафиком не заявляются.
TODO: добавить отдельную строку для каждого заявленного критерия. PASS без команды и наблюдения не является доказательством. Проверка инфраструктурного hook требует подтверждения, какие реальные процессы/хранилища перезапущены.
## Общая идемпотентность
## Эксперименты и отказы
Idempotency-Key обязателен для POST сообщения. Его область — пользователь и чат, TTL — 24 часа. PostgreSQL хранит hash семантического payload и ссылку на результат. Резервирование ключа, списание квоты и создание сообщения находятся в одной транзакции. Конкурентные одинаковые запросы получают один Message с 201, другой payload даёт 409; откат не сохраняет сообщение или окончательный результат ключа.
TODO: гипотеза, hardware/лимиты, версии, объём данных, профиль нагрузки, concurrency/arrival rate, длительность/прогрев, повторы, успешные RPS, ошибки, p50/p95/p99, CPU/RAM. Сохранить raw summary без tokens и объяснить ограничения измерения.
Вход Basic разрешён только для создания сессии, бизнес-запросы требуют opaque Bearer. Пароли используют Argon2id, токены — 32 случайных байта с хранением только SHA-256. Logout удаляет persisted session и действует на всех репликах. Пагинация ограничена 100 элементами и использует ключ (created_at,id); это не snapshot конкурентных транзакций.
| Воздействие | Что ожидаем | Что наблюдали | Время восстановления / потеря данных |
| --- | --- | --- | --- |
| TODO | TODO | TODO | TODO |
## Ресурсы, обнаружение и остановка
## Ограничения и следующие шаги
По умолчанию каждая API имеет limit 1 CPU и 512 МиБ, GOMEMLIMIT=400MiB; PostgreSQL — 2 CPU/768 МиБ, Valkey — 0,25 CPU/128 МиБ, Pingap — 0,5 CPU/128 МиБ. K3d server ограничен 8 ГиБ. Пул PostgreSQL API по умолчанию равен 8, одновременно выполняются не более четырёх HTTP-запросов, очередь ограничена 32, ожидание очереди — 1 секунда. Обычный request context равен 5 секундам; SQL connect/statement/lock timeouts — 1/2/1 секундам.
TODO: какие отказы выдерживаются и какие нет; что не реализовано; где учебное упрощение; какое улучшение подтверждено, а какое пока гипотеза.
DNS discovery Pingap обновляется раз в секунду. Активная HTTP-проверка /health/ready имеет частоту 1 секунду и connection/read timeout по 1 секунде. Это настройки обнаружения, а фактическое восстановление проверяется публичным failover-сценарием. При shutdown API предусмотрены preStop 15 секунд и собственный drain до 8 секунд при pod grace 35 секунд. Для Pingap заданы последовательные grace 8 + shutdown 10 секунд при pod grace 25 секунд.
Аварийный hook scale-down выбирает фактически обслуживший Pod, проверяет UID и нативный container ID и останавливает именно его процесс. CRI inventory подтверждает отсутствие RUNNING-процесса этого Pod UID, включая возможную смену контейнера при устаревшем Pod.status. Hook оставляет одну API-реплику; configure возвращает две. Штатный rollout использует maxSurge=1, maxUnavailable=0 и ждёт завершения старых подов, а не только Deployment Ready.
## Подтверждённые проверки k3s-варианта
- Публичный smoke и HTTP acceptance прошли: регистрация, Basic/Bearer, logout, rollback, pagination, конкурентная регистрация, двенадцать одинаковых POST, конфликт payload и одна сессия через разные реальные API. Вывод — evidence/k3s/smoke.txt и acceptance.txt.
- Два публичных failover-сценария подтвердили доступ к данным и отсутствие дублей после остановки разных API-процессов. Pod UID, container ID и survivor записаны отдельно; файлы — evidence/k3s/failover-1.txt, failover-2.txt и stopped-*-after.json. Эти функциональные проверки не используются как бенчмарк пропускной способности host.
- Полный restart API, PostgreSQL, Valkey и Pingap сохранил подтверждённые сообщения и исходный токен. before/after принадлежат одному run_id; отдельная проверка требует замены всех исходных workload Pod UID. Файлы — evidence/k3s/persistence.txt и restart-postcondition.txt.
- Проверка stdin через настоящий scoped wrapper выполнила SELECT в PostgreSQL. Cleanup дополнительно читает нулевое количество собственных пользователей после удаления; пустой stdin и один exit0 psql не считаются успехом.
- Unit-тесты проверяют чужой cluster/context, Namespace UID, partial claim, image identity, target overrides, обходы resource scope, сохранение основной ошибки при teardown и блокировку измерений при активной или неизвестной игре. Формат и lint новых TypeScript helpers проверены отдельно.
- Offline skeleton check и полная OpenAPI validation прошли. Go-код и нормативные контракты при переносе не менялись; его предыдущие race/lint результаты остаются в evidence/ и относятся к тому же backend.
## Трек 1. Цена масштабирования
Полная серия k3s/Pingap выполнена на AMD Ryzen 7 5700X, 8 cores/16 threads, Linux x86_64. До и после измерений game-running возвращал ровно 1. Отдельный случайный кластер и его БД принадлежали только эксперименту; после завершения кластер удалён до записи complete summary. Исходные данные — [summary.json](evidence/k3s/research/run-R4F28Q/summary.json), hardware.json и отдельные JSON каждого прогона.
Профиль — closed-loop POST текстовых сообщений одного отправителя, concurrency 16, длительность 5 секунд, два повтора. БД очищается между прогонами. Перед измерением runner ждёт rollout, удаления terminating Pod и реального DNS/HTTP через Pingap, проверяет число API, limits и pool_max. Генератор создаёт пользователей, сессию и чат до запуска часов; отдельного длительного прогрева нет. После каждого прогона проверяются сохранённые сообщения и неизменность Pod UID. В каждом наборе осталось от 398 до 612 сообщений.
В серии с постоянным бюджетом суммарные limits API равны 2 CPU/2048 МиБ: одна API получает 2 CPU/2048 МиБ, две — по 1 CPU/1024 МиБ, четыре — по 0,5 CPU/512 МиБ. В растущей серии каждая API получает 1 CPU/512 МиБ: всего 1/2/4 CPU и 512/1024/2048 МиБ. Остальные компоненты не масштабируются. Requests API остаются по 100m CPU/128 МиБ; это одинаковый опыт по суммарным limits, без утверждения о пропорциональных reservations.
Таблица показывает среднее двух успешных RPS и среднее двух p50/p95/p99; ошибки суммированы. Это средние перцентилей, а не перцентили объединённого распределения.
| Серия / API | Успешные RPS | p50, мс | p95, мс | p99, мс | Ошибки |
| --- | ---: | ---: | ---: | ---: | ---: |
| Постоянный бюджет / 1 | 117,05 | 133,48 | 175,29 | 204,46 | 0 |
| Постоянный бюджет / 2 | 115,47 | 133,55 | 275,40 | 363,95 | 0 |
| Постоянный бюджет / 4 | 98,08 | 121,03 | 467,08 | 1025,96 | 0 |
| Рост бюджета / 1 | 116,82 | 129,36 | 171,00 | 200,46 | 0 |
| Рост бюджета / 2 | 104,94 | 141,83 | 329,44 | 529,45 | 0 |
| Рост бюджета / 4 | 116,12 | 108,49 | 337,80 | 484,03 | 0 |
| Пул 8 / 1 | 117,10 | 129,32 | 175,24 | 225,22 | 0 |
| Пул 1 / 1 | 113,17 | 133,45 | 187,42 | 279,27 | 0 |
График [масштабирования](evidence/k3s/research/run-R4F28Q/scaling.svg) показывает средние и диапазоны двух повторов; график [пула](evidence/k3s/research/run-R4F28Q/pool.svg) показывает средние столбцами. Во всех 16 прогонах HTTP-ошибок было ноль. Самый большой наблюдавшийся API cgroup memory.peak — 108,29 МиБ. Summary содержит реальные CPU usage counters и память каждого API, а также десять снимков pg_stat_activity за прогон. CPU counters накопительные; доля загрузки CPU из одного такого снимка не выводится.
### Насыщение и подтверждённое улучшение
Рост числа API не дал пропорционального роста throughput. При постоянном бюджете средние RPS равны 117,05 → 115,47 → 98,08; при росте ресурсов — 116,82 → 104,94 → 116,12. Разброс у четырёх API заметен: 77,31–118,84 RPS в постоянном бюджете. Поэтому это наблюдаемое насыщение данного горячего отправителя, а не точный универсальный предел сервера.
В постоянной серии суммы числа сессий, ожидающих Lock/transactionid, по двадцати снимкам равны 58 → 133 → 244 при 1 → 2 → 4 API; IO/WalSync присутствует в 18/19/20 снимках. Это счётчик наблюдений, а не число уникальных сессий или процент времени. Код CreateMessage в repository.go резервирует idempotency key и вызывает ChargeMessage в одной транзакции; SQL обновляет message_count одной строки users до COMMIT. Такой отправитель сериализует записи по общей строке, а COMMIT ждёт WAL. Эти наблюдения объясняют, почему добавление API не устраняет узкое место PostgreSQL.
Подтверждённое улучшение для допустимой отказоустойчивой конфигурации — использовать две API вместо четырёх при тех же 2 CPU/2048 МиБ суммарных limits. Средний p95 снизился 467,08 → 275,40 мс, на 41,04%. Оба p95 двух API, 267,10 и 283,71 мс, ниже обоих результатов четырёх API, 342,11 и 592,05 мс. Две реплики сохраняют возможность выдержать проверенный отказ одной API. Средние RPS выросли, но диапазоны перекрываются, поэтому устойчивое улучшение throughput не заявляется. Это экспериментальная конфигурация; обычный запуск по-прежнему даёт двум API по 512 МиБ.
Отдельная гипотеза уменьшить SQL-пул 8 → 1 проверена в порядке ABBA при одной API и неизменных 2 CPU/2048 МиБ. Она не подтвердилась: средний p95 175,24 → 187,42 мс и RPS 117,10 → 113,17. Настройка pool=1 не объявляется улучшением и не становится default. Отрицательный результат сохранён вместе с остальными данными.
### Rollout под нагрузкой
При двух API Deployment заменил обе исходные реплики под непрерывной 30-секундной нагрузкой, concurrency 8, maxSurge=1/maxUnavailable=0. После появления новых UID и завершения старых подов генератор ещё работал, а количество сообщений выросло 39 → 2028. Идентификаторы и счётчики находятся в replacements.json.
За весь прогон получено 2725 успешных запросов, 0 HTTP-ошибок, 90,61 RPS; p50/p95/p99 равны 58,55/219,17/566,77 мс. Проверена замена подов одного образа, не upgrade с несовместимой миграцией. Нулевые ошибки в этом опыте не являются общим обещанием zero downtime.
Первый незавершённый запуск был отвергнут из-за многострочного json_agg при разборе метрик. Вывод исправлен приведением к jsonb::text; таблица и графики используют только полностью завершённый run-R4F28Q. Диагностический RED сохранён отдельно в research-json-red.json.
## Ограничения
Это один Docker-host и один k3s server. Отказ API-процесса проверен, отказ host, PostgreSQL или единственного входа не покрыт HA. Local-path PVC переживает проверяемый restart, но не заменяет удалённый backup и репликацию. Closed-loop генератор имеет coordinated omission; latency относится к успешным запросам, ошибки считаются отдельно. Переходные ошибки фиксируются, обещания zero downtime нет.
+97
View File
@@ -0,0 +1,97 @@
# Запуск лабораторной 3 на k3s + Pingap
Автор: Медведев Андрей Михайлович, БПИ2303. Все команды выполняются из корня этой лабы. Исходное задание сохранено в README.md, контракт — в contracts/; описание реализации и результаты находятся в REPORT.md.
Проверенный host — Linux x86_64 с Docker 29.9.2, k3d 5.9.0, kubectl 1.37.1 и Bun 1.4.4. В кластере используется закреплённый k3s 1.37.1 и Pingap 0.16.0. Для публичных проверок нужен Python 3.9+; для проверок Go и генератора PNG — Go 1.27.2. Большие сборки и эксперименты выполняются на тестовом host, не на Mac.
## Запуск с нуля
```sh
bun --no-env-file scripts/k3s.ts up
```
Команда создаёт отдельный одноузловой кластер vp-lab3-medvedev, собирает API, проверяет и импортирует образы, создаёт Secrets и PVC, ждёт реального SQL-запроса, выполняет миграции отдельным Job и проверяет HTTP через Pingap. На первом запуске отсутствующие публичные образы скачиваются по закреплённым digest; имеющийся кеш используется повторно. При импорте выбирается linux/amd64, чтобы не переносить отсутствующие части многоплатформенного image index.
API доступен по http://127.0.0.1:28203. Кластер не меняет глобальный kubeconfig. Его приватный kubeconfig и синтетические credentials находятся в .local/, исключённом из git и Docker context. Повторный запуск сохраняет PVC и данные.
## Проверки
```sh
python3 -m venv .venv
.venv/bin/pip install -r requirements-dev.txt
make check PYTHON=.venv/bin/python
make validate PYTHON=.venv/bin/python
make test BASE_URL=http://127.0.0.1:28203
BASE_URL=http://127.0.0.1:28203 bun --no-env-file student-tests/acceptance.ts
bun --no-env-file student-tests/kube-stdin.ts
bun test student-tests/k3s-model.test.ts
```
HTTP acceptance удаляет только собственный случайный набор; публичные проверки сохраняют свои синтетические записи для демонстрации. Проверка stdin действительно выполняет SELECT в PostgreSQL, а не ограничивается exit status процесса psql.
Остановка обслужившей реплики и её восстановление:
```sh
make test-failover BASE_URL=http://127.0.0.1:28203 ACTION_SCRIPT=scripts/stop-one.sh
bun --no-env-file scripts/k3s.ts configure
```
Повторите обе команды для следующей реплики. TARGET_INSTANCE_ID задаёт публичный тест. Hook проверяет Pod UID, масштабирует API до одной реплики и аварийно останавливает процесс выбранного пода; нативный CRI inventory подтверждает отсутствие работающего процесса с его UID. Свидетельства сохраняются в evidence/k3s/stop-one-before.json и stop-one-after.json. Для штатной замены используется обычный rollout с readiness и preStop, без аварийного kill.
Полный рестарт компонентов с прежним токеном и данными:
```sh
make test-persistence BASE_URL=http://127.0.0.1:28203 ACTION_SCRIPT=scripts/restart.sh
```
Hook записывает реальные Pod UID до и после рестарта и дожидается API через Pingap. PostgreSQL, Valkey и Pingap входят в сценарий. Проверки backend выполняются отдельно:
```sh
cd backend
go test -race ./...
go tool golangci-lint run
go generate ./...
```
После них вернитесь в корень лабы. Контракты и публичные тесты сохранены, версия OpenAPI не менялась при переносе.
## Исследование трека 1
Запуск на тестовом host с установленным game-running, только без игры:
```sh
bun --no-env-file student-tests/research.ts
```
Runner создаёт отдельный случайный кластер на localhost:28303, проверяет реальные лимиты API и размер SQL-пула, выполняет серии 1/2/4 при постоянном и растущем бюджете, ABBA пула и rollout под непрерывной нагрузкой. Между прогонами очищается только БД этого исследовательского кластера. После проверки кластер удаляется до публикации PASS.
Отдельный повтор четырёх запусков пула:
```sh
bun --no-env-file student-tests/research.ts --pool-only
```
Новые файлы появляются в evidence/k3s/research/run-*. Графики строятся из summary.json завершённого запуска через student-tests/plot_research.py; dependencies указаны в student-tests/requirements-plots.txt. Результаты старого Compose/HAProxy исследования находятся в историческом отчёте docs/archive/compose-report.md и не являются замерами Pingap.
Повторное построение графиков из приложенных измерений:
```sh
.venv/bin/pip install -r student-tests/requirements-plots.txt
.venv/bin/python student-tests/plot_research.py evidence/k3s/research/run-R4F28Q/summary.json
```
## Остановка и удаление своего стенда
Остановка сохраняет кластер и PVC:
```sh
bun --no-env-file scripts/k3s.ts stop
```
Повторный up возвращает сохранённые данные. Полное удаление кластера вместе с его учебными данными выполняется явно из работающего стенда:
```sh
bun --no-env-file scripts/k3s.ts destroy
```
Если кластер был остановлен, сначала выполните up. Runtime проверяет собственный claim, immutable ID server-контейнера и Namespace UID; чужой кластер или заменённый namespace автоматически не принимаются. Оригинальное задание предлагает Compose/Swarm; k3s выбран автором как альтернативный стенд, и принятие этого варианта преподавателем не заявляется.
+36
View File
@@ -0,0 +1,36 @@
version: "2"
run:
allow-parallel-runners: true
linters:
default: standard
enable: [depguard]
settings:
errcheck:
# Close тела ответа и файла, открытого на чтение: ошибке некуда деться.
exclude-functions:
- (io.ReadCloser).Close
- (*os.File).Close
depguard:
rules:
# Гексагон: ядро и use-case'ы зависят от портов, а не от адаптеров и транспорта.
inner-pure:
files: ["**/internal/domain/**", "**/internal/application/**"]
deny:
- pkg: backend/internal/adapter
desc: домен и приложение зависят от портов, не от адаптеров
- pkg: backend/internal/config
desc: конфиг читает только cmd
- pkg: net/http
desc: HTTP только в adapter/handler
- pkg: github.com/go-chi
desc: роутер только в adapter/handler
- pkg: github.com/rs/zerolog
desc: логирование на границе, в адаптерах
domain-core:
files: ["**/internal/domain/**"]
deny:
- pkg: backend/internal/application
desc: домен не знает о use-case'ах
exclusions:
paths:
- ".*\\.gen\\.go$"
+133
View File
@@ -0,0 +1,133 @@
package main
import (
"context"
"errors"
"flag"
"fmt"
"net/http"
"os"
"os/signal"
"syscall"
"time"
"backend/db"
"backend/internal/adapter/handler"
"backend/internal/adapter/password"
"backend/internal/adapter/repository/postgres"
"backend/internal/application/usecase"
"backend/internal/config"
"backend/pkg/logger"
"backend/pkg/server"
"github.com/jackc/pgx/v5/pgxpool"
"github.com/redis/go-redis/v9"
)
func main() {
healthcheck := flag.Bool("healthcheck", false, "проверить /health/ready и выйти (для Docker HEALTHCHECK)")
migrate := flag.Bool("migrate", false, "apply migrations and exit")
flag.Parse()
cfg, err := config.Load()
if err != nil {
fmt.Fprintln(os.Stderr, "config:", err)
os.Exit(1)
}
if *healthcheck {
os.Exit(probe(cfg.Port))
}
log := logger.New(cfg.LogLevel)
dsn, err := config.ReadSecret(cfg.DatabaseURLFile)
if err != nil {
log.Fatal().Msg("database secret unavailable")
}
if *migrate {
if err = db.Migrate(context.Background(), dsn); err != nil {
log.Fatal().Err(err).Msg("migration failed")
}
return
}
pc, err := pgxpool.ParseConfig(dsn)
if err != nil {
log.Fatal().Msg("invalid database configuration")
}
pc.MaxConns = cfg.MaxConns
pc.MinConns = 0
pc.ConnConfig.ConnectTimeout = time.Second
pc.ConnConfig.RuntimeParams["statement_timeout"] = "2000"
pc.ConnConfig.RuntimeParams["lock_timeout"] = "1000"
pool, err := pgxpool.NewWithConfig(context.Background(), pc)
if err != nil {
log.Fatal().Msg("database initialization failed")
}
defer pool.Close()
var cache *redis.Client
if url, e := config.ReadSecret(cfg.CacheURLFile); e == nil {
opts, e := redis.ParseURL(url)
if e != nil {
log.Fatal().Msg("invalid cache configuration")
}
opts.MaxRetries = 0
opts.DialTimeout = 80 * time.Millisecond
opts.ReadTimeout = 80 * time.Millisecond
opts.WriteTimeout = 80 * time.Millisecond
cache = redis.NewClient(opts)
defer func() { _ = cache.Close() }()
}
store := postgres.New(pool, cache)
app := usecase.NewMessenger(store)
auth := usecase.NewAuth(store, password.New(), app, time.Duration(cfg.SessionTTLSeconds)*time.Second, time.Now)
h := handler.New(app, auth, pool.Ping, handler.Limits{
MaxBodyBytes: cfg.MaxBodyBytes,
MaxInflight: cfg.MaxInflight,
MaxQueue: cfg.MaxQueue,
QueueTimeout: cfg.QueueTimeout,
}, func() any {
return map[string]any{"pool_total": pool.Stat().TotalConns(), "pool_acquired": pool.Stat().AcquiredConns(), "pool_max": pool.Stat().MaxConns()}
}, &log)
srv := server.New(cfg.Addr(), h.Router())
ctx, stop := signal.NotifyContext(context.Background(), syscall.SIGTERM, syscall.SIGINT)
defer stop()
serveErr := make(chan error, 1)
go func() { serveErr <- srv.ListenAndServe() }()
log.Info().Str("addr", cfg.Addr()).Str("env", cfg.Env).
Int("max_inflight", cfg.MaxInflight).
Int("max_queue", cfg.MaxQueue).Msg("server started")
select {
case err := <-serveErr:
log.Fatal().Err(err).Msg("server failed")
case <-ctx.Done():
}
started := time.Now()
log.Info().Dur("timeout", cfg.ShutdownTimeout).Msg("shutdown signal received, draining")
h.Drain()
shutdownCtx, cancel := context.WithTimeout(context.Background(), cfg.ShutdownTimeout)
defer cancel()
if err := srv.Shutdown(shutdownCtx); err != nil {
log.Error().Err(err).Msg("shutdown timed out, open requests aborted")
}
if err := <-serveErr; err != nil && !errors.Is(err, http.ErrServerClosed) {
log.Error().Err(err).Msg("server error")
}
log.Info().Dur("took", time.Since(started)).Msg("shutdown complete")
}
// probe — healthcheck без curl в образе distroless: сам бинарник ходит в
// /health/ready и возвращает код выхода для Docker.
func probe(port int) int {
client := http.Client{Timeout: 2 * time.Second}
resp, err := client.Get(fmt.Sprintf("http://127.0.0.1:%d/health/ready", port))
if err != nil {
return 1
}
defer resp.Body.Close()
if resp.StatusCode != http.StatusOK {
return 1
}
return 0
}
+13
View File
@@ -0,0 +1,13 @@
package: handler
generate:
models: true
chi-server: true
strict-server: true
output: api.gen.go
output-options:
# date-time -> handler.Timestamp: ровно 6 цифр дробной части (см. timestamp.go)
type-mapping:
string:
formats:
date-time:
type: Timestamp
+25
View File
@@ -0,0 +1,25 @@
package db
import (
"context"
"database/sql"
"embed"
_ "github.com/jackc/pgx/v5/stdlib"
"github.com/pressly/goose/v3"
)
//go:embed migrations/*.sql
var migrations embed.FS
func Migrate(ctx context.Context, dsn string) error {
conn, err := sql.Open("pgx", dsn)
if err != nil {
return err
}
defer func() { _ = conn.Close() }()
goose.SetBaseFS(migrations)
if err = goose.SetDialect("postgres"); err != nil {
return err
}
return goose.UpContext(ctx, conn, "migrations")
}
+44
View File
@@ -0,0 +1,44 @@
-- +goose Up
CREATE TABLE users (
id uuid PRIMARY KEY,
username text NOT NULL UNIQUE CHECK (username ~ '^[a-z0-9_]{3,32}$'),
display_name text NOT NULL CHECK (char_length(display_name) BETWEEN 1 AND 100),
password_hash text NOT NULL,
created_at timestamptz NOT NULL DEFAULT clock_timestamp(),
chat_count integer NOT NULL DEFAULT 0 CHECK (chat_count BETWEEN 0 AND 1000),
message_count integer NOT NULL DEFAULT 0 CHECK (message_count BETWEEN 0 AND 1000000)
);
CREATE TABLE chats (
id uuid PRIMARY KEY,
title text NOT NULL CHECK (char_length(title) BETWEEN 1 AND 100),
created_at timestamptz NOT NULL DEFAULT clock_timestamp()
);
CREATE TABLE chat_members (
chat_id uuid NOT NULL REFERENCES chats(id),
user_id uuid NOT NULL REFERENCES users(id),
PRIMARY KEY (chat_id, user_id)
);
CREATE INDEX member_chats ON chat_members(user_id,chat_id);
CREATE INDEX chats_order ON chats(created_at,id);
CREATE TABLE messages (
id uuid PRIMARY KEY,
chat_id uuid NOT NULL REFERENCES chats(id),
sender_id uuid NOT NULL REFERENCES users(id),
text text NOT NULL CHECK (char_length(text) BETWEEN 1 AND 4000),
created_at timestamptz NOT NULL DEFAULT clock_timestamp(),
FOREIGN KEY (chat_id,sender_id) REFERENCES chat_members(chat_id,user_id)
);
CREATE INDEX messages_history ON messages(chat_id,created_at,id);
CREATE TABLE sessions (
token_hash text PRIMARY KEY CHECK (length(token_hash)=64),
user_id uuid NOT NULL REFERENCES users(id),
expires_at timestamptz NOT NULL
);
CREATE INDEX sessions_user ON sessions(user_id,expires_at);
-- +goose Down
DROP TABLE sessions;
DROP TABLE messages;
DROP TABLE chat_members;
DROP TABLE chats;
DROP TABLE users;
@@ -0,0 +1,12 @@
-- +goose Up
CREATE TABLE idempotency (
user_id uuid NOT NULL REFERENCES users(id),
chat_id uuid NOT NULL REFERENCES chats(id),
key text NOT NULL CHECK (key ~ '^[A-Za-z0-9._:-]{1,128}$'),
payload_hash text NOT NULL CHECK (length(payload_hash)=64),
message_id uuid NOT NULL REFERENCES messages(id) DEFERRABLE INITIALLY DEFERRED,
expires_at timestamptz NOT NULL,
PRIMARY KEY(user_id,chat_id,key)
);
-- +goose Down
DROP TABLE idempotency;
+41
View File
@@ -0,0 +1,41 @@
-- name: CreateUser :one
INSERT INTO users(id,username,display_name,password_hash) VALUES($1,$2,$3,$4)
RETURNING id,username,display_name,created_at;
-- name: GetUser :one
SELECT id,username,display_name,created_at FROM users WHERE id=$1;
-- name: Credentials :one
SELECT id,password_hash FROM users WHERE username=$1;
-- name: ChargeChat :one
UPDATE users SET chat_count=chat_count+1 WHERE id=$1 AND chat_count<1000 RETURNING id;
-- name: ChargeMessage :one
UPDATE users SET message_count=message_count+1 WHERE id=$1 AND message_count<1000000 RETURNING id;
-- name: InsertChat :one
INSERT INTO chats(id,title) VALUES($1,$2) RETURNING id,title,created_at;
-- name: InsertMembers :exec
INSERT INTO chat_members(chat_id,user_id) SELECT $1,unnest($2::uuid[]);
-- name: GetChat :one
SELECT c.id,c.title,c.created_at,ARRAY(SELECT user_id FROM chat_members WHERE chat_id=c.id ORDER BY user_id)::uuid[] AS members
FROM chats c WHERE c.id=$1;
-- name: ListChats :many
SELECT c.id,c.title,c.created_at,ARRAY(SELECT user_id FROM chat_members WHERE chat_id=c.id ORDER BY user_id)::uuid[] AS members
FROM chats c JOIN chat_members m ON m.chat_id=c.id
WHERE m.user_id=sqlc.arg(member_id) AND (c.created_at,c.id)>(sqlc.arg(after_time)::timestamptz,sqlc.arg(after_id)::uuid)
ORDER BY c.created_at,c.id LIMIT sqlc.arg(page_limit);
-- name: InsertMessage :one
INSERT INTO messages(id,chat_id,sender_id,text) VALUES($1,$2,$3,$4) RETURNING id,chat_id,sender_id,text,created_at;
-- name: ListMessages :many
SELECT id,chat_id,sender_id,text,created_at FROM messages
WHERE chat_id=$1 AND (created_at,id)>(sqlc.arg(after_time)::timestamptz,sqlc.arg(after_id)::uuid)
ORDER BY created_at,id LIMIT sqlc.arg(page_limit);
-- name: LockSessionOwner :one
SELECT id FROM users WHERE id=$1 FOR UPDATE;
-- name: DeleteExpiredSessions :exec
DELETE FROM sessions WHERE user_id=$1 AND expires_at<=clock_timestamp();
-- name: InsertSession :one
INSERT INTO sessions(token_hash,user_id,expires_at)
SELECT $1,$2,$3 WHERE (SELECT count(*) FROM sessions WHERE user_id=$2)<100
RETURNING user_id;
-- name: AuthenticateSession :one
SELECT user_id FROM sessions WHERE token_hash=$1 AND expires_at>clock_timestamp();
-- name: RevokeSession :exec
DELETE FROM sessions WHERE token_hash=$1;
+11
View File
@@ -0,0 +1,11 @@
-- name: ReserveKey :one
INSERT INTO idempotency(user_id,chat_id,key,payload_hash,message_id,expires_at)
VALUES($1,$2,$3,$4,$5,clock_timestamp()+interval '24 hours')
ON CONFLICT(user_id,chat_id,key) DO UPDATE SET payload_hash=excluded.payload_hash,
message_id=excluded.message_id,expires_at=excluded.expires_at
WHERE idempotency.expires_at<=clock_timestamp()
RETURNING message_id;
-- name: ReplayMessage :one
SELECT m.id,m.chat_id,m.sender_id,m.text,m.created_at,i.payload_hash
FROM idempotency i JOIN messages m ON m.id=i.message_id
WHERE i.user_id=$1 AND i.chat_id=$2 AND i.key=$3;
+16
View File
@@ -0,0 +1,16 @@
version: '2'
sql:
- schema: ../migrations
queries: queries
engine: postgresql
gen:
go:
package: queries
out: ../../internal/adapter/repository/postgres/queries
sql_package: pgx/v5
emit_empty_slices: true
overrides:
- db_type: uuid
go_type: github.com/google/uuid.UUID
- db_type: timestamptz
go_type: time.Time
+321
View File
@@ -0,0 +1,321 @@
module backend
go 1.27.2
tool (
github.com/golangci/golangci-lint/v2/cmd/golangci-lint
github.com/oapi-codegen/oapi-codegen/v2/cmd/oapi-codegen
github.com/pressly/goose/v3/cmd/goose
github.com/sqlc-dev/sqlc/cmd/sqlc
)
require (
github.com/go-chi/chi/v5 v5.5.0
github.com/google/uuid v1.6.0
github.com/oapi-codegen/runtime v1.7.0
github.com/rs/zerolog v1.35.1
github.com/spf13/viper v1.21.0
)
require (
4d63.com/gocheckcompilerdirectives v1.4.0 // indirect
4d63.com/gochecknoglobals v0.2.2 // indirect
cel.dev/expr v0.25.3 // indirect
charm.land/lipgloss/v2 v2.0.6 // indirect
codeberg.org/chavacava/garif v0.2.1 // indirect
codeberg.org/polyfloyd/go-errorlint v1.9.0 // indirect
dev.gaijin.team/go/exhaustruct/v4 v4.0.0 // indirect
dev.gaijin.team/go/exhaustruct/v5 v5.2.0 // indirect
dev.gaijin.team/go/golib v0.8.1 // indirect
filippo.io/edwards25519 v1.2.0 // indirect
github.com/4meepo/tagalign v1.4.4 // indirect
github.com/Abirdcfly/dupword v0.1.8 // indirect
github.com/AdminBenni/iota-mixing v1.0.0 // indirect
github.com/AlwxSin/noinlineerr v1.0.6 // indirect
github.com/Antonboom/errname v1.1.2 // indirect
github.com/Antonboom/nilnil v1.1.2 // indirect
github.com/Antonboom/testifylint v1.6.4 // indirect
github.com/Azure/azure-sdk-for-go/sdk/azcore v1.24.0 // indirect
github.com/Azure/azure-sdk-for-go/sdk/azidentity v1.15.0 // indirect
github.com/Azure/azure-sdk-for-go/sdk/internal v1.13.0 // indirect
github.com/AzureAD/microsoft-authentication-library-for-go v1.10.1 // indirect
github.com/BurntSushi/toml v1.6.0 // indirect
github.com/ClickHouse/ch-go v0.75.0 // indirect
github.com/ClickHouse/clickhouse-go-linter v1.2.1 // indirect
github.com/ClickHouse/clickhouse-go/v2 v2.51.0 // indirect
github.com/Djarvur/go-err113 v0.1.1 // indirect
github.com/Masterminds/semver/v3 v3.5.0 // indirect
github.com/MirrexOne/unqueryvet v1.5.4 // indirect
github.com/OpenPeeDeeP/depguard/v2 v2.2.1 // indirect
github.com/alecthomas/chroma/v2 v2.27.0 // indirect
github.com/alecthomas/go-check-sumtype v0.5.1-0.20260828200218-ae6904d28606 // indirect
github.com/alexkohler/nakedret/v2 v2.0.6 // indirect
github.com/alexkohler/prealloc v1.1.0 // indirect
github.com/alfatraining/structtag v1.0.0 // indirect
github.com/alingse/asasalint v0.0.11 // indirect
github.com/alingse/nilnesserr v0.2.0 // indirect
github.com/andybalholm/brotli v1.3.0 // indirect
github.com/antlr4-go/antlr/v4 v4.13.1 // indirect
github.com/apapsch/go-jsonmerge/v2 v2.0.0 // indirect
github.com/ashanbrown/forbidigo/v2 v2.3.1 // indirect
github.com/ashanbrown/makezero/v2 v2.2.1 // indirect
github.com/beorn7/perks v1.0.1 // indirect
github.com/bkielbasa/cyclop v1.2.3 // indirect
github.com/blizzy78/varnamelen v0.8.0 // indirect
github.com/bombsimon/wsl/v4 v4.7.0 // indirect
github.com/bombsimon/wsl/v5 v5.9.0 // indirect
github.com/breml/bidichk v0.3.3 // indirect
github.com/breml/errchkjson v0.4.1 // indirect
github.com/butuzov/ireturn v0.4.1 // indirect
github.com/butuzov/mirror v1.3.3 // indirect
github.com/catenacyber/perfsprint v0.10.1 // indirect
github.com/ccojocar/zxcvbn-go v1.0.4 // indirect
github.com/cespare/xxhash/v2 v2.3.0 // indirect
github.com/charithe/durationcheck v0.0.11 // indirect
github.com/charmbracelet/colorprofile v0.4.3 // indirect
github.com/charmbracelet/ultraviolet v0.0.0-20260811164956-006e29f97886 // indirect
github.com/charmbracelet/x/ansi v0.11.8 // indirect
github.com/charmbracelet/x/term v0.2.2 // indirect
github.com/charmbracelet/x/termios v0.1.1 // indirect
github.com/charmbracelet/x/windows v0.2.2 // indirect
github.com/ckaznocha/intrange v0.3.1 // indirect
github.com/clipperhouse/displaywidth v0.11.0 // indirect
github.com/clipperhouse/uax29/v2 v2.7.0 // indirect
github.com/coder/websocket v1.8.15 // indirect
github.com/coreos/go-semver v0.3.1 // indirect
github.com/cubicdaiya/gonp v1.0.4 // indirect
github.com/curioswitch/go-reassign v0.3.0 // indirect
github.com/daixiang0/gci v0.13.7 // indirect
github.com/dave/dst v0.27.3 // indirect
github.com/davecgh/go-spew v1.1.2-0.20180830191138-d8f796af33cc // indirect
github.com/denis-tingaikin/go-header v0.5.0 // indirect
github.com/dlclark/regexp2/v2 v2.2.1 // indirect
github.com/dprotaso/go-yit v0.0.0-20220510233725-9ba8df137936 // indirect
github.com/dustin/go-humanize v1.1.0 // indirect
github.com/elastic/go-sysinfo v1.15.5 // indirect
github.com/elastic/go-windows v1.0.2 // indirect
github.com/ettle/strcase v0.2.0 // indirect
github.com/fatih/color v1.19.0 // indirect
github.com/fatih/structtag v1.2.0 // indirect
github.com/firefart/nonamedreturns v1.0.8 // indirect
github.com/fsnotify/fsnotify v1.9.0 // indirect
github.com/fzipp/gocyclo v0.6.0 // indirect
github.com/getkin/kin-openapi v0.142.0 // indirect
github.com/ghostiam/protogetter v1.0.1 // indirect
github.com/go-critic/go-critic v0.15.0 // indirect
github.com/go-faster/city v1.0.1 // indirect
github.com/go-faster/errors v0.8.0 // indirect
github.com/go-openapi/jsonpointer v0.23.1 // indirect
github.com/go-openapi/swag/jsonname v0.26.0 // indirect
github.com/go-sql-driver/mysql v1.10.1 // indirect
github.com/go-toolsmith/astcast v1.1.0 // indirect
github.com/go-toolsmith/astcopy v1.1.0 // indirect
github.com/go-toolsmith/astequal v1.2.0 // indirect
github.com/go-toolsmith/astfmt v1.1.0 // indirect
github.com/go-toolsmith/astp v1.1.0 // indirect
github.com/go-toolsmith/strparse v1.1.0 // indirect
github.com/go-toolsmith/typep v1.1.0 // indirect
github.com/go-viper/mapstructure/v2 v2.5.0 // indirect
github.com/go-xmlfmt/xmlfmt v1.1.3 // indirect
github.com/gobwas/glob v0.2.3 // indirect
github.com/godoc-lint/godoc-lint v0.11.4 // indirect
github.com/gofrs/flock v0.13.1 // indirect
github.com/golang-jwt/jwt/v4 v4.5.2 // indirect
github.com/golang-jwt/jwt/v5 v5.3.1 // indirect
github.com/golang-sql/civil v0.0.0-20220223132316-b832511892a9 // indirect
github.com/golang-sql/sqlexp v0.1.0 // indirect
github.com/golang/protobuf v1.5.4 // indirect
github.com/golangci/asciicheck v0.5.0 // indirect
github.com/golangci/canonicalheader v0.0.0-20260827115959-a25c71c521f6 // indirect
github.com/golangci/dupl v0.0.0-20260401084720-c99c5cf5c202 // indirect
github.com/golangci/go-printf-func-name v0.1.1 // indirect
github.com/golangci/gofmt v0.0.0-20260820135601-e84e05053792 // indirect
github.com/golangci/golangci-lint/v2 v2.14.0 // indirect
github.com/golangci/golines v0.15.0 // indirect
github.com/golangci/misspell v0.8.0 // indirect
github.com/golangci/plugin-module-register v0.1.2 // indirect
github.com/golangci/revgrep v0.8.0 // indirect
github.com/golangci/rowserrcheck v0.0.0-20260419091836-c5f79b8a11ba // indirect
github.com/golangci/swaggoswag v0.0.0-20250504205917-77f2aca3143e // indirect
github.com/golangci/unconvert v0.0.0-20250410112200-a129a6e6413e // indirect
github.com/google/cel-go v0.28.0 // indirect
github.com/google/go-cmp v0.7.0 // indirect
github.com/gordonklaus/ineffassign v0.2.0 // indirect
github.com/gostaticanalysis/analysisutil v0.7.1 // indirect
github.com/gostaticanalysis/comment v1.5.0 // indirect
github.com/gostaticanalysis/forcetypeassert v0.2.0 // indirect
github.com/gostaticanalysis/nilerr v0.1.2 // indirect
github.com/hashicorp/go-immutable-radix/v2 v2.1.0 // indirect
github.com/hashicorp/go-version v1.9.0 // indirect
github.com/hashicorp/golang-lru/v2 v2.0.7 // indirect
github.com/hexops/gotextdiff v1.0.3 // indirect
github.com/inconshreveable/mousetrap v1.1.0 // indirect
github.com/jackc/pgpassfile v1.0.0 // indirect
github.com/jackc/pgservicefile v0.0.0-20240606120523-5a60cdf6a761 // indirect
github.com/jackc/pgx/v5 v5.13.0 // indirect
github.com/jackc/puddle/v2 v2.2.3 // indirect
github.com/jgautheron/goconst v1.11.0 // indirect
github.com/jinzhu/inflection v1.0.0 // indirect
github.com/jjti/go-spancheck v0.6.5 // indirect
github.com/joho/godotenv v1.5.1 // indirect
github.com/jonboulle/clockwork v0.5.0 // indirect
github.com/julz/importas v0.2.0 // indirect
github.com/karamaru-alpha/copyloopvar v1.2.2 // indirect
github.com/kisielk/errcheck v1.20.0 // indirect
github.com/kkHAIKE/contextcheck v1.1.6 // indirect
github.com/klauspost/compress v1.20.4 // indirect
github.com/kulti/thelper v0.7.1 // indirect
github.com/kunwardeep/paralleltest v1.0.15 // indirect
github.com/kylelemons/godebug v1.1.0 // indirect
github.com/ldez/exptostd v0.4.5 // indirect
github.com/ldez/gomoddirectives v0.10.0 // indirect
github.com/ldez/grignotin v0.10.1 // indirect
github.com/ldez/structtags v0.6.1 // indirect
github.com/ldez/tagliatelle v0.8.0 // indirect
github.com/ldez/usetesting v0.5.0 // indirect
github.com/leonklingele/grouper v1.1.2 // indirect
github.com/lucasb-eyer/go-colorful v1.4.1 // indirect
github.com/macabu/inamedparam v0.2.0 // indirect
github.com/manuelarte/embeddedstructfieldcheck v0.4.0 // indirect
github.com/manuelarte/funcorder v0.6.0 // indirect
github.com/maratori/testableexamples v1.0.1 // indirect
github.com/maratori/testpackage v1.1.2 // indirect
github.com/matoous/godox v1.1.0 // indirect
github.com/mattn/go-colorable v0.1.15 // indirect
github.com/mattn/go-isatty v0.0.24 // indirect
github.com/mattn/go-runewidth v0.0.24 // indirect
github.com/matttproud/golang_protobuf_extensions v1.0.1 // indirect
github.com/mfridman/interpolate v0.0.2 // indirect
github.com/mfridman/xflag v0.1.0 // indirect
github.com/mgechev/revive v1.17.0 // indirect
github.com/microsoft/go-mssqldb v1.11.2 // indirect
github.com/mitchellh/go-homedir v1.1.0 // indirect
github.com/moricho/tparallel v0.3.2 // indirect
github.com/muesli/cancelreader v0.2.2 // indirect
github.com/nakabonne/nestif v0.3.1 // indirect
github.com/ncruces/go-sqlite3 v0.32.0 // indirect
github.com/ncruces/go-strftime v1.1.0 // indirect
github.com/ncruces/julianday v1.0.0 // indirect
github.com/nishanths/exhaustive v0.13.0 // indirect
github.com/nishanths/predeclared v0.2.2 // indirect
github.com/nunnatsa/ginkgolinter v0.24.0 // indirect
github.com/oapi-codegen/oapi-codegen/v2 v2.8.0 // indirect
github.com/oasdiff/yaml v0.1.1 // indirect
github.com/oasdiff/yaml3 v0.0.14 // indirect
github.com/paulmach/orb v0.14.0 // indirect
github.com/pelletier/go-toml/v2 v2.4.3 // indirect
github.com/pganalyze/pg_query_go/v6 v6.2.2 // indirect
github.com/pierrec/lz4/v4 v4.1.33 // indirect
github.com/pingcap/errors v0.11.5-0.20250523034308-74f78ae071ee // indirect
github.com/pingcap/failpoint v0.0.0-20240528011301-b51a646c7c86 // indirect
github.com/pingcap/log v1.1.0 // indirect
github.com/pingcap/tidb/pkg/parser v0.0.0-20260418072757-ce92298d1124 // indirect
github.com/pkg/browser v0.0.0-20240102092130-5ac0b6a4141c // indirect
github.com/pressly/goose/v3 v3.30.0 // indirect
github.com/prometheus/client_golang v1.12.1 // indirect
github.com/prometheus/client_model v0.2.0 // indirect
github.com/prometheus/common v0.32.1 // indirect
github.com/prometheus/procfs v0.23.0 // indirect
github.com/quasilyte/go-ruleguard v0.4.5 // indirect
github.com/quasilyte/go-ruleguard/dsl v0.3.23 // indirect
github.com/quasilyte/gogrep v0.5.0 // indirect
github.com/quasilyte/regex/syntax v0.0.0-20210819130434-b3f0c404a727 // indirect
github.com/quasilyte/stdinfo v0.0.0-20220114132959-f7386bf02567 // indirect
github.com/raeperd/recvcheck v0.3.1 // indirect
github.com/redis/go-redis/v9 v9.23.0 // indirect
github.com/remyoudompheng/bigfft v0.0.0-20230129092748-24d4a6f8daec // indirect
github.com/rivo/uniseg v0.4.7 // indirect
github.com/riza-io/grpc-go v0.2.0 // indirect
github.com/rogpeppe/go-internal v1.16.0 // indirect
github.com/ryancurrah/gomodguard v1.4.1 // indirect
github.com/ryancurrah/gomodguard/v2 v2.1.3 // indirect
github.com/ryanrolds/sqlclosecheck v0.6.0 // indirect
github.com/sagikazarmark/locafero v0.11.0 // indirect
github.com/sanposhiho/wastedassign/v2 v2.1.0 // indirect
github.com/santhosh-tekuri/jsonschema/v6 v6.0.3 // indirect
github.com/sashamelentyev/interfacebloat v1.1.0 // indirect
github.com/sashamelentyev/usestdlibvars v1.29.0 // indirect
github.com/securego/gosec/v2 v2.29.0 // indirect
github.com/segmentio/asm v1.2.1 // indirect
github.com/sethvargo/go-retry v0.5.0 // indirect
github.com/shopspring/decimal v1.6.0 // indirect
github.com/sirupsen/logrus v1.10.2 // indirect
github.com/sivchari/containedctx v1.0.3 // indirect
github.com/sonatard/noctx v0.5.1 // indirect
github.com/sourcegraph/conc v0.3.1-0.20240121214520-5f936abd7ae8 // indirect
github.com/sourcegraph/go-diff v0.9.0 // indirect
github.com/speakeasy-api/jsonpath v0.6.3 // indirect
github.com/speakeasy-api/openapi v1.24.0 // indirect
github.com/spf13/afero v1.15.0 // indirect
github.com/spf13/cast v1.10.0 // indirect
github.com/spf13/cobra v1.10.2 // indirect
github.com/spf13/pflag v1.0.10 // indirect
github.com/sqlc-dev/doubleclick v1.0.0 // indirect
github.com/sqlc-dev/sqlc v1.31.1 // indirect
github.com/ssgreg/nlreturn/v2 v2.2.1 // indirect
github.com/stbenjam/no-sprintf-host-port v0.3.1 // indirect
github.com/stretchr/objx v0.5.3 // indirect
github.com/stretchr/testify v1.12.1 // indirect
github.com/subosito/gotenv v1.6.0 // indirect
github.com/tetafro/godot v1.5.6 // indirect
github.com/tetratelabs/wazero v1.11.0 // indirect
github.com/timakin/bodyclose v0.0.0-20260723120731-857993a2939c // indirect
github.com/timonwong/loggercheck v0.12.0 // indirect
github.com/tomarrell/wrapcheck/v2 v2.12.0 // indirect
github.com/tommy-muehle/go-mnd/v2 v2.5.1 // indirect
github.com/tursodatabase/libsql-client-go v0.0.0-20260528064733-9d5d30a29a60 // indirect
github.com/ultraware/funlen v0.2.0 // indirect
github.com/ultraware/whitespace v0.2.0 // indirect
github.com/uudashr/gocognit v1.2.1 // indirect
github.com/uudashr/iface v1.5.1 // indirect
github.com/vertica/vertica-sql-go v1.3.9 // indirect
github.com/vmware-labs/yaml-jsonpath v0.3.2 // indirect
github.com/wasilibs/go-pgquery v0.0.0-20250409022910-10ac41983c07 // indirect
github.com/wasilibs/wazero-helpers v0.0.0-20240620070341-3dff1577cd52 // indirect
github.com/xen0n/gosmopolitan v1.3.0 // indirect
github.com/xo/terminfo v1.0.0 // indirect
github.com/yagipy/maintidx v1.0.0 // indirect
github.com/yandex-cloud/go-genproto v0.137.0 // indirect
github.com/ydb-platform/ydb-go-genproto v0.0.0-20260810123728-f0c151ab31b9 // indirect
github.com/ydb-platform/ydb-go-sdk-auth-environ v0.5.3 // indirect
github.com/ydb-platform/ydb-go-sdk/v3 v3.156.1 // indirect
github.com/ydb-platform/ydb-go-yc v0.12.5 // indirect
github.com/ydb-platform/ydb-go-yc-metadata v0.6.2 // indirect
github.com/yeya24/promlinter v0.3.0 // indirect
github.com/ykadowak/zerologlint v0.1.5 // indirect
github.com/ziutek/mymysql v1.5.4 // indirect
gitlab.com/bosi/decorder v0.4.2 // indirect
go-simpler.org/musttag v0.14.0 // indirect
go-simpler.org/sloglint v0.12.0 // indirect
go.augendre.info/arangolint v0.4.0 // indirect
go.augendre.info/fatcontext v0.10.1 // indirect
go.opentelemetry.io/otel v1.47.0 // indirect
go.opentelemetry.io/otel/trace v1.47.0 // indirect
go.uber.org/atomic v1.12.0 // indirect
go.uber.org/multierr v1.11.0 // indirect
go.uber.org/zap v1.28.0 // indirect
go.yaml.in/yaml/v3 v3.0.6 // indirect
golang.org/x/crypto v0.59.0 // indirect
golang.org/x/exp v0.0.0-20261109185158-a52e3aef5920 // indirect
golang.org/x/exp/typeparams v0.0.0-20260811152304-ee035b5b010f // indirect
golang.org/x/mod v0.42.0 // indirect
golang.org/x/net v0.62.0 // indirect
golang.org/x/sync v0.25.0 // indirect
golang.org/x/sys v0.50.0 // indirect
golang.org/x/text v0.44.0 // indirect
golang.org/x/tools v0.52.1-0.20261106145633-d407941a339a // indirect
google.golang.org/genproto/googleapis/api v0.0.0-20261110000943-09e21b237f2c // indirect
google.golang.org/genproto/googleapis/rpc v0.0.0-20261110000943-09e21b237f2c // indirect
google.golang.org/grpc v1.85.0 // indirect
google.golang.org/protobuf v1.36.12 // indirect
gopkg.in/natefinch/lumberjack.v2 v2.2.1 // indirect
gopkg.in/yaml.v3 v3.0.1 // indirect
honnef.co/go/tools v0.8.1 // indirect
howett.net/plist v1.0.1 // indirect
modernc.org/libc v1.80.2 // indirect
modernc.org/mathutil v1.7.1 // indirect
modernc.org/memory v1.12.1 // indirect
modernc.org/sqlite v1.62.0 // indirect
mvdan.cc/gofumpt v0.12.0 // indirect
mvdan.cc/unparam v0.0.0-20260823230713-2fa3d841b0c8 // indirect
)
+1275
View File
File diff suppressed because it is too large Load Diff
File diff suppressed because it is too large Load Diff
+102
View File
@@ -0,0 +1,102 @@
package handler
import (
"context"
"net/http"
"backend/internal/domain/model"
)
// Реализация StrictServerInterface: вызвать use-case и перевести результат в
// API-модели. Ошибки уходят в writeError, он один решает про HTTP-статус.
func (h *API) Liveness(context.Context, LivenessRequestObject) (LivenessResponseObject, error) {
return Liveness200JSONResponse{Body: Health{Status: Ok}}, nil
}
// Readiness rejects draining instances and unavailable required dependencies.
func (h *API) Readiness(ctx context.Context, _ ReadinessRequestObject) (ReadinessResponseObject, error) {
if !h.ready.Load() {
return nil, errDraining
}
if err := h.probe(ctx); err != nil {
return nil, model.ErrUnavailable
}
return Readiness200JSONResponse{Body: Health{Status: Ok}}, nil
}
func (h *API) RegisterUser(ctx context.Context, req RegisterUserRequestObject) (RegisterUserResponseObject, error) {
if req.Body.Password == nil {
return nil, &model.ValidationError{Message: "password is required"}
}
user, err := h.auth.Register(ctx, req.Body.Username, req.Body.DisplayName, *req.Body.Password)
if err != nil {
return nil, err
}
return RegisterUser201JSONResponse{Body: toUser(user)}, nil
}
func (h *API) CurrentUser(ctx context.Context, _ CurrentUserRequestObject) (CurrentUserResponseObject, error) {
return CurrentUser200JSONResponse{Body: toUser(currentUser(ctx))}, nil
}
func (h *API) CreateChat(ctx context.Context, req CreateChatRequestObject) (CreateChatResponseObject, error) {
chat, err := h.app.CreateChat(ctx, currentUser(ctx).ID, req.Body.Title, req.Body.MemberIds)
if err != nil {
return nil, err
}
return CreateChat201JSONResponse{Body: toChat(chat)}, nil
}
func (h *API) ListChats(ctx context.Context, req ListChatsRequestObject) (ListChatsResponseObject, error) {
page, err := h.app.ListChats(ctx, currentUser(ctx).ID, req.Params.Limit, req.Params.Cursor)
if err != nil {
return nil, err
}
return ListChats200JSONResponse{Body: ChatPage{Items: mapAll(page.Items, toChat), NextCursor: page.NextCursor}}, nil
}
func (h *API) GetChat(ctx context.Context, req GetChatRequestObject) (GetChatResponseObject, error) {
chat, err := h.app.GetChat(ctx, currentUser(ctx).ID, req.ChatId)
if err != nil {
return nil, err
}
return GetChat200JSONResponse{Body: toChat(chat)}, nil
}
func (h *API) CreateMessage(ctx context.Context, req CreateMessageRequestObject) (CreateMessageResponseObject, error) {
r := ctx.Value(sessionRequestKey{}).(*http.Request)
msg, err := h.app.SendMessage(ctx, currentUser(ctx).ID, req.ChatId, req.Body.Text, r.Header.Get("Idempotency-Key"))
if err != nil {
return nil, err
}
return CreateMessage201JSONResponse{Body: toMessage(msg)}, nil
}
func (h *API) ListMessages(ctx context.Context, req ListMessagesRequestObject) (ListMessagesResponseObject, error) {
page, err := h.app.ListMessages(ctx, currentUser(ctx).ID, req.ChatId, req.Params.Limit, req.Params.Cursor)
if err != nil {
return nil, err
}
return ListMessages200JSONResponse{Body: MessagePage{Items: mapAll(page.Items, toMessage), NextCursor: page.NextCursor}}, nil
}
func toUser(u model.User) User {
return User{Id: u.ID, Username: u.Username, DisplayName: u.DisplayName, CreatedAt: Timestamp(u.CreatedAt)}
}
func toChat(c model.Chat) Chat {
return Chat{Id: c.ID, Title: c.Title, MemberIds: c.MemberIDs, CreatedAt: Timestamp(c.CreatedAt)}
}
func toMessage(m model.Message) Message {
return Message{Id: m.ID, ChatId: m.ChatID, SenderId: m.SenderID, Text: m.Text, CreatedAt: Timestamp(m.CreatedAt)}
}
func mapAll[T, R any](items []T, f func(T) R) []R {
out := make([]R, len(items))
for i, item := range items {
out[i] = f(item)
}
return out
}
+43
View File
@@ -0,0 +1,43 @@
package handler
import (
"backend/internal/domain/model"
"context"
"net/http"
"strings"
"time"
"unicode/utf8"
)
type sessionRequestKey struct{}
func (h *API) CreateSession(ctx context.Context, _ CreateSessionRequestObject) (CreateSessionResponseObject, error) {
r := ctx.Value(sessionRequestKey{}).(*http.Request)
username, password, ok := r.BasicAuth()
if !ok || len(username) > 32 || len(password) > 512 || utf8.RuneCountInString(password) > 128 {
return nil, model.ErrUnauthorized
}
s, err := h.auth.Login(ctx, username, password)
if err != nil {
return nil, err
}
return CreateSession201JSONResponse{Body: Session{Token: s.Token, TokenType: Bearer, ExpiresAt: Timestamp(s.ExpiresAt), User: toUser(s.User)}}, nil
}
func (h *API) RevokeSession(ctx context.Context, _ RevokeSessionRequestObject) (RevokeSessionResponseObject, error) {
r := ctx.Value(sessionRequestKey{}).(*http.Request)
parts := strings.Fields(r.Header.Get("Authorization"))
if err := h.auth.Logout(ctx, parts[1]); err != nil {
return nil, err
}
return RevokeSession204Response{}, nil
}
func (h *API) requestContext(next http.Handler) http.Handler {
return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
ctx, cancel := context.WithTimeout(r.Context(), 5*time.Second)
defer cancel()
if r.URL.Path == "/api/v1/auth/sessions" {
w.Header().Set("WWW-Authenticate", `Basic realm="messenger", charset="UTF-8"`)
}
next.ServeHTTP(w, r.WithContext(context.WithValue(ctx, sessionRequestKey{}, r)))
})
}
@@ -0,0 +1,82 @@
package handler
import (
"encoding/json"
"errors"
"net/http"
"backend/internal/domain/model"
)
var (
errRouteNotFound = errors.New("route not found")
errMethodNotAllowed = errors.New("method not allowed")
errPayloadTooLarge = errors.New("payload too large")
errOverloaded = errors.New("overloaded")
errDraining = errors.New("draining")
)
type apiError struct {
status int
code ErrorErrorCode
message string
}
// classify — единственное место, где ошибка превращается в HTTP-статус.
func classify(err error) apiError {
var invalid *model.ValidationError
switch {
case errors.As(err, &invalid):
return apiError{http.StatusBadRequest, InvalidRequest, invalid.Message}
case errors.Is(err, model.ErrUnauthorized):
return apiError{http.StatusUnauthorized, Unauthorized, "нужна действующая сессия"}
case errors.Is(err, model.ErrNotFound), errors.Is(err, errRouteNotFound):
return apiError{http.StatusNotFound, NotFound, "объект не найден"}
case errors.Is(err, errMethodNotAllowed):
return apiError{http.StatusMethodNotAllowed, InvalidRequest, "метод не поддерживается"}
case errors.Is(err, model.ErrUsernameTaken):
return apiError{http.StatusConflict, Conflict, "username уже занят"}
case errors.Is(err, model.ErrConflict):
return apiError{http.StatusConflict, Conflict, "конфликт запроса"}
case errors.Is(err, model.ErrUnavailable):
return apiError{http.StatusServiceUnavailable, Unavailable, "зависимость недоступна"}
case errors.Is(err, errPayloadTooLarge):
return apiError{http.StatusRequestEntityTooLarge, PayloadTooLarge, "тело запроса больше допустимого"}
case errors.Is(err, model.ErrStorageFull):
return apiError{http.StatusServiceUnavailable, Unavailable, "хранилище заполнено, запись невозможна; чтение работает"}
case errors.Is(err, errOverloaded):
return apiError{http.StatusServiceUnavailable, Unavailable, "сервер перегружен, повторите позже"}
case errors.Is(err, errDraining):
return apiError{http.StatusServiceUnavailable, Unavailable, "сервер останавливается"}
default:
return apiError{http.StatusInternalServerError, InternalError, "внутренняя ошибка"}
}
}
func (h *API) writeError(w http.ResponseWriter, r *http.Request, err error) {
e := classify(err)
if e.status == http.StatusInternalServerError {
h.log.Error().Err(err).Str("request_id", requestIDFrom(r.Context())).Msg("unexpected error")
}
if errors.Is(err, errOverloaded) {
w.Header().Set("Retry-After", "1")
}
var body Error
body.Error.Code = e.code
body.Error.Message = e.message
body.Error.RequestId = requestIDFrom(r.Context())
w.Header().Set("Content-Type", "application/json")
w.WriteHeader(e.status)
_ = json.NewEncoder(w).Encode(body)
}
// bodyError — JSON синтаксически верен (это проверил jsonBody), но не
// подходит к схеме: лишнее поле или неверный тип.
func (h *API) bodyError(w http.ResponseWriter, r *http.Request, _ error) {
h.writeError(w, r, &model.ValidationError{Message: "тело запроса не соответствует схеме: лишнее поле или неверный тип"})
}
// paramError — path или query параметр не разобрался (UUID, целое число).
func (h *API) paramError(w http.ResponseWriter, r *http.Request, _ error) {
h.writeError(w, r, &model.ValidationError{Message: "некорректный параметр запроса"})
}
+78
View File
@@ -0,0 +1,78 @@
package handler
import (
"net/http"
"sync/atomic"
"time"
)
// gate ограничивает одновременную обработку запросов API: не больше inflight
// в работе и не больше queue в ожидании слота. Лишние сразу получают 503 с
// Retry-After, ждавшие дольше timeout — тоже 503. Так перегрузка превращается
// в быстрый предсказуемый отказ, а не в рост горутин, памяти и задержки.
type gate struct {
slots chan struct{} // nil — без лимита
maxQueue int64
timeout time.Duration
waiting atomic.Int64
rejected atomic.Int64
}
func newGate(inflight, queue int, timeout time.Duration) *gate {
g := &gate{maxQueue: int64(queue), timeout: timeout}
if inflight > 0 {
g.slots = make(chan struct{}, inflight)
}
return g
}
func (g *gate) middleware(reject func(http.ResponseWriter, *http.Request, error)) func(http.Handler) http.Handler {
return func(next http.Handler) http.Handler {
return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
if g.slots == nil {
next.ServeHTTP(w, r)
return
}
if !g.acquire(r) {
g.rejected.Add(1)
reject(w, r, errOverloaded)
return
}
defer func() { <-g.slots }()
next.ServeHTTP(w, r)
})
}
}
func (g *gate) acquire(r *http.Request) bool {
select {
case g.slots <- struct{}{}:
return true
default:
}
if g.waiting.Add(1) > g.maxQueue {
g.waiting.Add(-1)
return false
}
defer g.waiting.Add(-1)
timer := time.NewTimer(g.timeout)
defer timer.Stop()
select {
case g.slots <- struct{}{}:
return true
case <-timer.C:
return false
case <-r.Context().Done():
return false
}
}
type gateStats struct {
Inflight int `json:"inflight"`
Waiting int64 `json:"waiting"`
Rejected int64 `json:"rejected"`
}
func (g *gate) stats() gateStats {
return gateStats{Inflight: len(g.slots), Waiting: g.waiting.Load(), Rejected: g.rejected.Load()}
}
@@ -0,0 +1,102 @@
package handler
import (
"errors"
"net/http"
"net/http/httptest"
"sync"
"testing"
"time"
)
// gatedServer пропускает запросы через gate в обработчик, который держит слот,
// пока тест не закроет release.
func gatedServer(t *testing.T, g *gate) (*httptest.Server, chan struct{}, chan struct{}) {
t.Helper()
entered, release := make(chan struct{}, 10), make(chan struct{})
reject := func(w http.ResponseWriter, _ *http.Request, err error) {
if !errors.Is(err, errOverloaded) {
t.Errorf("unexpected error %v", err)
}
w.Header().Set("Retry-After", "1")
w.WriteHeader(http.StatusServiceUnavailable)
}
h := g.middleware(reject)(http.HandlerFunc(func(w http.ResponseWriter, _ *http.Request) {
entered <- struct{}{}
<-release
w.WriteHeader(http.StatusOK)
}))
srv := httptest.NewServer(h)
t.Cleanup(srv.Close)
return srv, entered, release
}
func get(t *testing.T, url string) int {
t.Helper()
resp, err := http.Get(url)
if err != nil {
t.Error(err)
return 0
}
resp.Body.Close()
return resp.StatusCode
}
func waitFor(t *testing.T, cond func() bool) {
t.Helper()
deadline := time.Now().Add(2 * time.Second)
for !cond() {
if time.Now().After(deadline) {
t.Fatal("condition not reached")
}
time.Sleep(time.Millisecond)
}
}
func TestGateRejectsBeyondQueueAndRecovers(t *testing.T) {
t.Parallel()
g := newGate(1, 1, time.Minute)
srv, entered, release := gatedServer(t, g)
statuses := make(chan int, 2)
var wg sync.WaitGroup
wg.Go(func() { statuses <- get(t, srv.URL) }) // занимает слот
<-entered
wg.Go(func() { statuses <- get(t, srv.URL) }) // ждёт в очереди
waitFor(t, func() bool { return g.waiting.Load() == 1 })
if code := get(t, srv.URL); code != http.StatusServiceUnavailable {
t.Fatalf("third request: %d, want 503", code)
}
close(release)
wg.Wait()
close(statuses)
for code := range statuses {
if code != http.StatusOK {
t.Fatalf("admitted request got %d", code)
}
}
if code := get(t, srv.URL); code != http.StatusOK {
t.Fatalf("after load: %d, want recovery to 200", code)
}
if g.stats().Rejected != 1 {
t.Fatalf("rejected %d", g.stats().Rejected)
}
}
func TestGateTimesOutQueuedRequest(t *testing.T) {
t.Parallel()
g := newGate(1, 10, 20*time.Millisecond)
srv, entered, release := gatedServer(t, g)
defer close(release)
go get(t, srv.URL)
<-entered
start := time.Now()
if code := get(t, srv.URL); code != http.StatusServiceUnavailable {
t.Fatalf("queued request: %d, want 503 after timeout", code)
}
if time.Since(start) > time.Second {
t.Fatal("queue timeout not applied")
}
}
@@ -0,0 +1,95 @@
package handler
import (
"context"
"net/http"
"sync/atomic"
"time"
"backend/internal/application/usecase"
"github.com/go-chi/chi/v5"
"github.com/rs/zerolog"
)
// Limits — защитные лимиты HTTP-слоя (трек 5 «управляемая деградация»).
// Нулевое значение отключает лимит.
type Limits struct {
MaxBodyBytes int64 // больше — 413
MaxInflight int // одновременно обрабатываемые запросы API
MaxQueue int // ждущие свободного слота; больше — сразу 503
QueueTimeout time.Duration // дольше ждал слот — 503
}
// API — driving HTTP-адаптер: реализует StrictServerInterface из api.gen.go.
//
//go:generate go tool oapi-codegen -config ../../../codegen.yaml ../../../../contracts/openapi.json
type API struct {
app *usecase.Messenger
auth *usecase.Auth
probe func(context.Context) error
limits Limits
gate *gate
storeStats func() any
ready atomic.Bool
log *zerolog.Logger
}
// New собирает HTTP-адаптер. storeStats отдаёт состояние хранилища для
// /debug/stats.
func New(app *usecase.Messenger, auth *usecase.Auth, probe func(context.Context) error, limits Limits, storeStats func() any, log *zerolog.Logger) *API {
h := &API{
app: app,
auth: auth,
probe: probe,
limits: limits,
gate: newGate(limits.MaxInflight, limits.MaxQueue, limits.QueueTimeout),
storeStats: storeStats,
log: log,
}
h.ready.Store(true)
return h
}
// Drain переводит /health/ready в 503 перед остановкой сервера.
func (h *API) Drain() { h.ready.Store(false) }
func (h *API) Router() http.Handler {
r := chi.NewRouter()
r.Use(requestID, h.recoverer, h.accessLog, h.requestContext)
r.NotFound(func(w http.ResponseWriter, r *http.Request) {
h.writeError(w, r, errRouteNotFound)
})
r.MethodNotAllowed(func(w http.ResponseWriter, r *http.Request) {
h.writeError(w, r, errMethodNotAllowed)
})
strict := NewStrictHandlerWithOptions(h, nil, StrictHTTPServerOptions{
RequestErrorHandlerFunc: h.bodyError,
ResponseErrorHandlerFunc: h.writeError,
})
api := ServerInterfaceWrapper{Handler: strict, ErrorHandlerFunc: h.paramError}
// Health и статистика — мимо очереди: под перегрузкой они должны отвечать.
r.Get("/health/live", api.Liveness)
r.Get("/health/ready", api.Readiness)
r.Get("/debug/stats", h.stats)
r.Route("/api/v1", func(r chi.Router) {
r.Use(h.gate.middleware(h.writeError))
r.With(h.jsonBody).Post("/users", api.RegisterUser)
r.Post("/auth/sessions", api.CreateSession)
// Сначала аутентификация, потом тело и доступ к ресурсу.
r.Group(func(r chi.Router) {
r.Use(h.authenticate, h.validQuery, h.jsonBody)
r.Delete("/auth/sessions/current", api.RevokeSession)
r.Get("/users/me", api.CurrentUser)
r.Post("/chats", api.CreateChat)
r.Get("/chats", api.ListChats)
r.Get("/chats/{chat_id}", api.GetChat)
r.Post("/chats/{chat_id}/messages", api.CreateMessage)
r.Get("/chats/{chat_id}/messages", api.ListMessages)
})
})
return r
}
+53
View File
@@ -0,0 +1,53 @@
package handler
import (
"bytes"
"encoding/json"
"time"
)
// Timestamp подставляется кодогенератором вместо time.Time (codegen.yaml,
// type-mapping): RFC 3339 UTC с ровно шестью цифрами дробной части.
// time.Time срезает хвостовые нули, а fromisoformat в Python 3.9–3.10
// (на нём публичные тесты) понимает дробную часть только из 3 или 6 цифр.
type Timestamp time.Time
const timestampLayout = "2006-01-02T15:04:05.000000Z"
func (t Timestamp) MarshalJSON() ([]byte, error) {
return []byte(`"` + time.Time(t).UTC().Format(timestampLayout) + `"`), nil
}
func (t *Timestamp) UnmarshalJSON(data []byte) error {
var parsed time.Time
if err := json.Unmarshal(data, &parsed); err != nil {
return err
}
*t = Timestamp(parsed)
return nil
}
// Тела запросов с лишними полями — 400 по контракту, а сгенерированный
// декодер их молча игнорирует. Строгий разбор подключается методами на
// сгенерированных типах.
func (c *CreateUser) UnmarshalJSON(data []byte) error {
type plain CreateUser
return decodeStrict(data, (*plain)(c))
}
func (c *CreateChat) UnmarshalJSON(data []byte) error {
type plain CreateChat
return decodeStrict(data, (*plain)(c))
}
func (c *CreateMessage) UnmarshalJSON(data []byte) error {
type plain CreateMessage
return decodeStrict(data, (*plain)(c))
}
func decodeStrict(data []byte, dst any) error {
dec := json.NewDecoder(bytes.NewReader(data))
dec.DisallowUnknownFields()
return dec.Decode(dst)
}
@@ -0,0 +1,161 @@
package handler
import (
"bytes"
"context"
"encoding/json"
"errors"
"io"
"net/http"
"net/url"
"os"
"runtime/debug"
"strings"
"time"
"unicode/utf8"
"backend/internal/domain/model"
"github.com/go-chi/chi/v5"
"github.com/go-chi/chi/v5/middleware"
"github.com/google/uuid"
)
type ctxKey int
const (
requestIDKey ctxKey = iota
userKey
)
// requestID ставит X-Request-Id в каждый ответ, включая ошибки и health.
func requestID(next http.Handler) http.Handler {
instance, _ := os.Hostname()
if instance == "" {
instance = uuid.NewString()
}
return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
id := uuid.NewString()
w.Header().Set("X-Request-Id", id)
w.Header().Set("X-Instance-Id", instance)
next.ServeHTTP(w, r.WithContext(context.WithValue(r.Context(), requestIDKey, id)))
})
}
func requestIDFrom(ctx context.Context) string {
id, _ := ctx.Value(requestIDKey).(string)
return id
}
// recoverer превращает панику в 500 без деталей; стек — только в лог.
func (h *API) recoverer(next http.Handler) http.Handler {
return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
defer func() {
rec := recover()
if rec == nil {
return
}
if rec == http.ErrAbortHandler {
panic(rec)
}
h.log.Error().Interface("panic", rec).Bytes("stack", debug.Stack()).
Str("request_id", requestIDFrom(r.Context())).Msg("panic")
h.writeError(w, r, errors.New("panic"))
}()
next.ServeHTTP(w, r)
})
}
// accessLog пишет метод, шаблон маршрута, статус и длительность. Тело, query
// и заголовки не логируются: там текст сообщений и идентификаторы.
func (h *API) accessLog(next http.Handler) http.Handler {
return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
start := time.Now()
ww := middleware.NewWrapResponseWriter(w, r.ProtoMajor)
next.ServeHTTP(ww, r)
route := chi.RouteContext(r.Context()).RoutePattern()
if route == "" {
route = "unmatched"
}
event := h.log.Info()
if ww.Status() >= http.StatusInternalServerError {
event = h.log.Warn()
}
event.Str("request_id", requestIDFrom(r.Context())).
Str("method", r.Method).
Str("route", route).
Int("status", ww.Status()).
Dur("duration", time.Since(start)).
Msg("request")
})
}
// authenticate verifies persisted Bearer sessions for protected business routes.
// The session-creation endpoint separately validates Basic credentials.
func (h *API) authenticate(next http.Handler) http.Handler {
return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
parts := strings.Fields(r.Header.Get("Authorization"))
if len(parts) != 2 || !strings.EqualFold(parts[0], "Bearer") {
w.Header().Set("WWW-Authenticate", `Bearer realm="messenger"`)
h.writeError(w, r, model.ErrUnauthorized)
return
}
user, err := h.auth.Authenticate(r.Context(), parts[1])
if err != nil {
if errors.Is(err, model.ErrUnauthorized) {
w.Header().Set("WWW-Authenticate", `Bearer realm="messenger"`)
}
h.writeError(w, r, err)
return
}
next.ServeHTTP(w, r.WithContext(context.WithValue(r.Context(), userKey, user)))
})
}
// validQuery отсекает query с битым %-экранированием: url.Values молча
// выбросил бы такой параметр, и cursor=%%% превратился бы в «с начала».
func (h *API) validQuery(next http.Handler) http.Handler {
return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
if _, err := url.ParseQuery(r.URL.RawQuery); err != nil {
h.writeError(w, r, &model.ValidationError{Message: "некорректная строка запроса"})
return
}
next.ServeHTTP(w, r)
})
}
func currentUser(ctx context.Context) model.User {
user, _ := ctx.Value(userKey).(model.User)
return user
}
// jsonBody читает тело POST с лимитом размера (иначе 413) и отсекает
// синтаксически неверный JSON (400) до кодогенерированного декодера: тот
// читает только первое JSON-значение и пропустил бы мусор после него.
func (h *API) jsonBody(next http.Handler) http.Handler {
return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
if r.Method != http.MethodPost {
next.ServeHTTP(w, r)
return
}
reader := io.Reader(r.Body)
if h.limits.MaxBodyBytes > 0 {
reader = http.MaxBytesReader(w, r.Body, h.limits.MaxBodyBytes)
}
body, err := io.ReadAll(reader)
var tooLarge *http.MaxBytesError
switch {
case errors.As(err, &tooLarge):
h.writeError(w, r, errPayloadTooLarge)
return
case err != nil:
h.writeError(w, r, &model.ValidationError{Message: "тело запроса не прочитано"})
return
case !utf8.Valid(body) || !json.Valid(body):
h.writeError(w, r, &model.ValidationError{Message: "некорректный JSON"})
return
}
r.Body = io.NopCloser(bytes.NewReader(body))
next.ServeHTTP(w, r)
})
}
+47
View File
@@ -0,0 +1,47 @@
package handler
import (
"bufio"
"encoding/json"
"net/http"
"os"
"runtime"
"runtime/debug"
"strconv"
"strings"
)
// stats — расширение за пределами контракта (contracts/extensions.md): память
// процесса, учтённый объём хранилища и очередь. Нужен для графиков трека 5.
func (h *API) stats(w http.ResponseWriter, _ *http.Request) {
var mem runtime.MemStats
runtime.ReadMemStats(&mem)
w.Header().Set("Content-Type", "application/json")
_ = json.NewEncoder(w).Encode(map[string]any{
"rss_bytes": rssBytes(),
"heap_alloc": mem.HeapAlloc,
"heap_sys": mem.HeapSys,
"go_memory_limit": debug.SetMemoryLimit(-1),
"num_gc": mem.NumGC,
"goroutines": runtime.NumGoroutine(),
"gate": h.gate.stats(),
"store": h.storeStats(),
})
}
// rssBytes читает VmRSS из /proc (только Linux, то есть в контейнере); иначе 0.
func rssBytes() int64 {
f, err := os.Open("/proc/self/status")
if err != nil {
return 0
}
defer f.Close()
sc := bufio.NewScanner(f)
for sc.Scan() {
if kb, ok := strings.CutPrefix(sc.Text(), "VmRSS:"); ok {
n, _ := strconv.ParseInt(strings.TrimSpace(strings.TrimSuffix(kb, "kB")), 10, 64)
return n * 1024
}
}
return 0
}
@@ -0,0 +1,21 @@
package handler
import (
"bytes"
"net/http"
"net/http/httptest"
"testing"
)
func TestRejectsInvalidUTF8BeforeJSONDecoding(t *testing.T) {
body := append([]byte(`{"display_name":"`), 0xff)
body = append(body, []byte(`"}`)...)
request := httptest.NewRequest(http.MethodPost, "/api/v1/users", bytes.NewReader(body))
response := httptest.NewRecorder()
h := &API{limits: Limits{MaxBodyBytes: 65536}}
called := false
requestID(h.jsonBody(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) { called = true; w.WriteHeader(204) }))).ServeHTTP(response, request)
if response.Code != 400 || called {
t.Fatalf("invalid UTF-8 reached decoder: status=%d called=%t", response.Code, called)
}
}
@@ -0,0 +1,36 @@
package password
import (
"backend/internal/domain/port"
"crypto/rand"
"crypto/subtle"
"encoding/base64"
"fmt"
"golang.org/x/crypto/argon2"
"strings"
)
type Argon struct{}
func New() port.Passwords { return Argon{} }
func (Argon) Hash(password string) (string, error) {
salt := make([]byte, 16)
if _, err := rand.Read(salt); err != nil {
return "", err
}
hash := argon2.IDKey([]byte(password), salt, 2, 32*1024, 1, 32)
return fmt.Sprintf("argon2id$v19$m32768t2p1$%s$%s", base64.RawStdEncoding.EncodeToString(salt), base64.RawStdEncoding.EncodeToString(hash)), nil
}
func (Argon) Verify(password, encoded string) bool {
parts := strings.Split(encoded, "$")
if len(parts) != 5 || parts[0] != "argon2id" || parts[1] != "v19" || parts[2] != "m32768t2p1" {
return false
}
salt, e1 := base64.RawStdEncoding.DecodeString(parts[3])
want, e2 := base64.RawStdEncoding.DecodeString(parts[4])
if e1 != nil || e2 != nil || len(salt) != 16 || len(want) != 32 {
return false
}
got := argon2.IDKey([]byte(password), salt, 2, 32*1024, 1, 32)
return subtle.ConstantTimeCompare(got, want) == 1
}
@@ -0,0 +1,347 @@
// Code generated by sqlc. DO NOT EDIT.
// versions:
// sqlc v1.31.1
// source: core.sql
package queries
import (
"context"
"time"
"github.com/google/uuid"
)
const authenticateSession = `-- name: AuthenticateSession :one
SELECT user_id FROM sessions WHERE token_hash=$1 AND expires_at>clock_timestamp()
`
func (q *Queries) AuthenticateSession(ctx context.Context, tokenHash string) (uuid.UUID, error) {
row := q.db.QueryRow(ctx, authenticateSession, tokenHash)
var user_id uuid.UUID
err := row.Scan(&user_id)
return user_id, err
}
const chargeChat = `-- name: ChargeChat :one
UPDATE users SET chat_count=chat_count+1 WHERE id=$1 AND chat_count<1000 RETURNING id
`
func (q *Queries) ChargeChat(ctx context.Context, id uuid.UUID) (uuid.UUID, error) {
row := q.db.QueryRow(ctx, chargeChat, id)
var id_2 uuid.UUID
err := row.Scan(&id_2)
return id_2, err
}
const chargeMessage = `-- name: ChargeMessage :one
UPDATE users SET message_count=message_count+1 WHERE id=$1 AND message_count<1000000 RETURNING id
`
func (q *Queries) ChargeMessage(ctx context.Context, id uuid.UUID) (uuid.UUID, error) {
row := q.db.QueryRow(ctx, chargeMessage, id)
var id_2 uuid.UUID
err := row.Scan(&id_2)
return id_2, err
}
const createUser = `-- name: CreateUser :one
INSERT INTO users(id,username,display_name,password_hash) VALUES($1,$2,$3,$4)
RETURNING id,username,display_name,created_at
`
type CreateUserParams struct {
ID uuid.UUID
Username string
DisplayName string
PasswordHash string
}
type CreateUserRow struct {
ID uuid.UUID
Username string
DisplayName string
CreatedAt time.Time
}
func (q *Queries) CreateUser(ctx context.Context, arg CreateUserParams) (CreateUserRow, error) {
row := q.db.QueryRow(ctx, createUser,
arg.ID,
arg.Username,
arg.DisplayName,
arg.PasswordHash,
)
var i CreateUserRow
err := row.Scan(
&i.ID,
&i.Username,
&i.DisplayName,
&i.CreatedAt,
)
return i, err
}
const credentials = `-- name: Credentials :one
SELECT id,password_hash FROM users WHERE username=$1
`
type CredentialsRow struct {
ID uuid.UUID
PasswordHash string
}
func (q *Queries) Credentials(ctx context.Context, username string) (CredentialsRow, error) {
row := q.db.QueryRow(ctx, credentials, username)
var i CredentialsRow
err := row.Scan(&i.ID, &i.PasswordHash)
return i, err
}
const deleteExpiredSessions = `-- name: DeleteExpiredSessions :exec
DELETE FROM sessions WHERE user_id=$1 AND expires_at<=clock_timestamp()
`
func (q *Queries) DeleteExpiredSessions(ctx context.Context, userID uuid.UUID) error {
_, err := q.db.Exec(ctx, deleteExpiredSessions, userID)
return err
}
const getChat = `-- name: GetChat :one
SELECT c.id,c.title,c.created_at,ARRAY(SELECT user_id FROM chat_members WHERE chat_id=c.id ORDER BY user_id)::uuid[] AS members
FROM chats c WHERE c.id=$1
`
type GetChatRow struct {
ID uuid.UUID
Title string
CreatedAt time.Time
Members []uuid.UUID
}
func (q *Queries) GetChat(ctx context.Context, id uuid.UUID) (GetChatRow, error) {
row := q.db.QueryRow(ctx, getChat, id)
var i GetChatRow
err := row.Scan(
&i.ID,
&i.Title,
&i.CreatedAt,
&i.Members,
)
return i, err
}
const getUser = `-- name: GetUser :one
SELECT id,username,display_name,created_at FROM users WHERE id=$1
`
type GetUserRow struct {
ID uuid.UUID
Username string
DisplayName string
CreatedAt time.Time
}
func (q *Queries) GetUser(ctx context.Context, id uuid.UUID) (GetUserRow, error) {
row := q.db.QueryRow(ctx, getUser, id)
var i GetUserRow
err := row.Scan(
&i.ID,
&i.Username,
&i.DisplayName,
&i.CreatedAt,
)
return i, err
}
const insertChat = `-- name: InsertChat :one
INSERT INTO chats(id,title) VALUES($1,$2) RETURNING id,title,created_at
`
type InsertChatParams struct {
ID uuid.UUID
Title string
}
func (q *Queries) InsertChat(ctx context.Context, arg InsertChatParams) (Chat, error) {
row := q.db.QueryRow(ctx, insertChat, arg.ID, arg.Title)
var i Chat
err := row.Scan(&i.ID, &i.Title, &i.CreatedAt)
return i, err
}
const insertMembers = `-- name: InsertMembers :exec
INSERT INTO chat_members(chat_id,user_id) SELECT $1,unnest($2::uuid[])
`
type InsertMembersParams struct {
ChatID uuid.UUID
Column2 []uuid.UUID
}
func (q *Queries) InsertMembers(ctx context.Context, arg InsertMembersParams) error {
_, err := q.db.Exec(ctx, insertMembers, arg.ChatID, arg.Column2)
return err
}
const insertMessage = `-- name: InsertMessage :one
INSERT INTO messages(id,chat_id,sender_id,text) VALUES($1,$2,$3,$4) RETURNING id,chat_id,sender_id,text,created_at
`
type InsertMessageParams struct {
ID uuid.UUID
ChatID uuid.UUID
SenderID uuid.UUID
Text string
}
func (q *Queries) InsertMessage(ctx context.Context, arg InsertMessageParams) (Message, error) {
row := q.db.QueryRow(ctx, insertMessage,
arg.ID,
arg.ChatID,
arg.SenderID,
arg.Text,
)
var i Message
err := row.Scan(
&i.ID,
&i.ChatID,
&i.SenderID,
&i.Text,
&i.CreatedAt,
)
return i, err
}
const insertSession = `-- name: InsertSession :one
INSERT INTO sessions(token_hash,user_id,expires_at)
SELECT $1,$2,$3 WHERE (SELECT count(*) FROM sessions WHERE user_id=$2)<100
RETURNING user_id
`
type InsertSessionParams struct {
TokenHash string
UserID uuid.UUID
ExpiresAt time.Time
}
func (q *Queries) InsertSession(ctx context.Context, arg InsertSessionParams) (uuid.UUID, error) {
row := q.db.QueryRow(ctx, insertSession, arg.TokenHash, arg.UserID, arg.ExpiresAt)
var user_id uuid.UUID
err := row.Scan(&user_id)
return user_id, err
}
const listChats = `-- name: ListChats :many
SELECT c.id,c.title,c.created_at,ARRAY(SELECT user_id FROM chat_members WHERE chat_id=c.id ORDER BY user_id)::uuid[] AS members
FROM chats c JOIN chat_members m ON m.chat_id=c.id
WHERE m.user_id=$1 AND (c.created_at,c.id)>($2::timestamptz,$3::uuid)
ORDER BY c.created_at,c.id LIMIT $4
`
type ListChatsParams struct {
MemberID uuid.UUID
AfterTime time.Time
AfterID uuid.UUID
PageLimit int32
}
type ListChatsRow struct {
ID uuid.UUID
Title string
CreatedAt time.Time
Members []uuid.UUID
}
func (q *Queries) ListChats(ctx context.Context, arg ListChatsParams) ([]ListChatsRow, error) {
rows, err := q.db.Query(ctx, listChats,
arg.MemberID,
arg.AfterTime,
arg.AfterID,
arg.PageLimit,
)
if err != nil {
return nil, err
}
defer rows.Close()
items := []ListChatsRow{}
for rows.Next() {
var i ListChatsRow
if err := rows.Scan(
&i.ID,
&i.Title,
&i.CreatedAt,
&i.Members,
); err != nil {
return nil, err
}
items = append(items, i)
}
if err := rows.Err(); err != nil {
return nil, err
}
return items, nil
}
const listMessages = `-- name: ListMessages :many
SELECT id,chat_id,sender_id,text,created_at FROM messages
WHERE chat_id=$1 AND (created_at,id)>($2::timestamptz,$3::uuid)
ORDER BY created_at,id LIMIT $4
`
type ListMessagesParams struct {
ChatID uuid.UUID
AfterTime time.Time
AfterID uuid.UUID
PageLimit int32
}
func (q *Queries) ListMessages(ctx context.Context, arg ListMessagesParams) ([]Message, error) {
rows, err := q.db.Query(ctx, listMessages,
arg.ChatID,
arg.AfterTime,
arg.AfterID,
arg.PageLimit,
)
if err != nil {
return nil, err
}
defer rows.Close()
items := []Message{}
for rows.Next() {
var i Message
if err := rows.Scan(
&i.ID,
&i.ChatID,
&i.SenderID,
&i.Text,
&i.CreatedAt,
); err != nil {
return nil, err
}
items = append(items, i)
}
if err := rows.Err(); err != nil {
return nil, err
}
return items, nil
}
const lockSessionOwner = `-- name: LockSessionOwner :one
SELECT id FROM users WHERE id=$1 FOR UPDATE
`
func (q *Queries) LockSessionOwner(ctx context.Context, id uuid.UUID) (uuid.UUID, error) {
row := q.db.QueryRow(ctx, lockSessionOwner, id)
var id_2 uuid.UUID
err := row.Scan(&id_2)
return id_2, err
}
const revokeSession = `-- name: RevokeSession :exec
DELETE FROM sessions WHERE token_hash=$1
`
func (q *Queries) RevokeSession(ctx context.Context, tokenHash string) error {
_, err := q.db.Exec(ctx, revokeSession, tokenHash)
return err
}
@@ -0,0 +1,32 @@
// Code generated by sqlc. DO NOT EDIT.
// versions:
// sqlc v1.31.1
package queries
import (
"context"
"github.com/jackc/pgx/v5"
"github.com/jackc/pgx/v5/pgconn"
)
type DBTX interface {
Exec(context.Context, string, ...interface{}) (pgconn.CommandTag, error)
Query(context.Context, string, ...interface{}) (pgx.Rows, error)
QueryRow(context.Context, string, ...interface{}) pgx.Row
}
func New(db DBTX) *Queries {
return &Queries{db: db}
}
type Queries struct {
db DBTX
}
func (q *Queries) WithTx(tx pgx.Tx) *Queries {
return &Queries{
db: tx,
}
}
@@ -0,0 +1,78 @@
// Code generated by sqlc. DO NOT EDIT.
// versions:
// sqlc v1.31.1
// source: idempotency.sql
package queries
import (
"context"
"time"
"github.com/google/uuid"
)
const replayMessage = `-- name: ReplayMessage :one
SELECT m.id,m.chat_id,m.sender_id,m.text,m.created_at,i.payload_hash
FROM idempotency i JOIN messages m ON m.id=i.message_id
WHERE i.user_id=$1 AND i.chat_id=$2 AND i.key=$3
`
type ReplayMessageParams struct {
UserID uuid.UUID
ChatID uuid.UUID
Key string
}
type ReplayMessageRow struct {
ID uuid.UUID
ChatID uuid.UUID
SenderID uuid.UUID
Text string
CreatedAt time.Time
PayloadHash string
}
func (q *Queries) ReplayMessage(ctx context.Context, arg ReplayMessageParams) (ReplayMessageRow, error) {
row := q.db.QueryRow(ctx, replayMessage, arg.UserID, arg.ChatID, arg.Key)
var i ReplayMessageRow
err := row.Scan(
&i.ID,
&i.ChatID,
&i.SenderID,
&i.Text,
&i.CreatedAt,
&i.PayloadHash,
)
return i, err
}
const reserveKey = `-- name: ReserveKey :one
INSERT INTO idempotency(user_id,chat_id,key,payload_hash,message_id,expires_at)
VALUES($1,$2,$3,$4,$5,clock_timestamp()+interval '24 hours')
ON CONFLICT(user_id,chat_id,key) DO UPDATE SET payload_hash=excluded.payload_hash,
message_id=excluded.message_id,expires_at=excluded.expires_at
WHERE idempotency.expires_at<=clock_timestamp()
RETURNING message_id
`
type ReserveKeyParams struct {
UserID uuid.UUID
ChatID uuid.UUID
Key string
PayloadHash string
MessageID uuid.UUID
}
func (q *Queries) ReserveKey(ctx context.Context, arg ReserveKeyParams) (uuid.UUID, error) {
row := q.db.QueryRow(ctx, reserveKey,
arg.UserID,
arg.ChatID,
arg.Key,
arg.PayloadHash,
arg.MessageID,
)
var message_id uuid.UUID
err := row.Scan(&message_id)
return message_id, err
}
@@ -0,0 +1,55 @@
// Code generated by sqlc. DO NOT EDIT.
// versions:
// sqlc v1.31.1
package queries
import (
"time"
"github.com/google/uuid"
)
type Chat struct {
ID uuid.UUID
Title string
CreatedAt time.Time
}
type ChatMember struct {
ChatID uuid.UUID
UserID uuid.UUID
}
type Idempotency struct {
UserID uuid.UUID
ChatID uuid.UUID
Key string
PayloadHash string
MessageID uuid.UUID
ExpiresAt time.Time
}
type Message struct {
ID uuid.UUID
ChatID uuid.UUID
SenderID uuid.UUID
Text string
CreatedAt time.Time
}
type Session struct {
TokenHash string
UserID uuid.UUID
ExpiresAt time.Time
}
type User struct {
ID uuid.UUID
Username string
DisplayName string
PasswordHash string
CreatedAt time.Time
ChatCount int32
MessageCount int32
}
@@ -0,0 +1,223 @@
package postgres
import (
"context"
"encoding/json"
"errors"
"time"
"backend/internal/adapter/repository/postgres/queries"
"backend/internal/domain/model"
"backend/internal/domain/repository"
"github.com/google/uuid"
"github.com/jackc/pgx/v5"
"github.com/jackc/pgx/v5/pgconn"
"github.com/jackc/pgx/v5/pgxpool"
"github.com/redis/go-redis/v9"
)
//go:generate go tool sqlc generate -f ../../../../db/sqlc/sqlc.yaml
type Store struct {
pool *pgxpool.Pool
q *queries.Queries
cache *redis.Client
}
func New(pool *pgxpool.Pool, cache *redis.Client) repository.Persistent {
return &Store{pool, queries.New(pool), cache}
}
func mapErr(err error) error {
if err == nil {
return nil
}
if errors.Is(err, pgx.ErrNoRows) {
return model.ErrNotFound
}
var pg *pgconn.PgError
if errors.As(err, &pg) {
switch pg.Code {
case "23505":
return model.ErrUsernameTaken
case "23503":
return model.ErrUnknownMember
case "23514":
return &model.ValidationError{Message: "constraint violation"}
}
}
return model.ErrUnavailable
}
func (s *Store) CreateUser(ctx context.Context, d model.UserDraft) (model.User, error) {
row, err := s.q.CreateUser(ctx, queries.CreateUserParams{ID: uuid.New(), Username: d.Username, DisplayName: d.DisplayName, PasswordHash: d.PasswordHash})
return model.User{ID: row.ID, Username: row.Username, DisplayName: row.DisplayName, CreatedAt: row.CreatedAt}, mapErr(err)
}
func (s *Store) GetUser(ctx context.Context, id uuid.UUID) (model.User, error) {
key := "profile:" + id.String()
if s.cache != nil {
c, cancel := context.WithTimeout(ctx, 80*time.Millisecond)
raw, err := s.cache.Get(c, key).Bytes()
cancel()
if err == nil {
var u model.User
if json.Unmarshal(raw, &u) == nil && u.ID == id {
return u, nil
}
}
}
row, err := s.q.GetUser(ctx, id)
if err != nil {
return model.User{}, mapErr(err)
}
user := model.User{ID: row.ID, Username: row.Username, DisplayName: row.DisplayName, CreatedAt: row.CreatedAt}
if s.cache != nil {
raw, e := json.Marshal(user)
if e == nil {
c, cancel := context.WithTimeout(ctx, 80*time.Millisecond)
_ = s.cache.Set(c, key, raw, time.Minute).Err()
cancel()
}
}
return user, nil
}
func (s *Store) CreateChat(ctx context.Context, d model.ChatDraft) (model.Chat, error) {
tx, err := s.pool.Begin(ctx)
if err != nil {
return model.Chat{}, mapErr(err)
}
defer func() { _ = tx.Rollback(ctx) }()
q := s.q.WithTx(tx)
if _, err = q.ChargeChat(ctx, d.Creator); err != nil {
if errors.Is(err, pgx.ErrNoRows) {
return model.Chat{}, model.ErrStorageFull
}
return model.Chat{}, mapErr(err)
}
row, err := q.InsertChat(ctx, queries.InsertChatParams{ID: uuid.New(), Title: d.Title})
if err != nil {
return model.Chat{}, mapErr(err)
}
if err = q.InsertMembers(ctx, queries.InsertMembersParams{ChatID: row.ID, Column2: d.MemberIDs}); err != nil {
return model.Chat{}, mapErr(err)
}
if err = tx.Commit(ctx); err != nil {
return model.Chat{}, mapErr(err)
}
return model.Chat{ID: row.ID, Title: row.Title, CreatedAt: row.CreatedAt, MemberIDs: d.MemberIDs}, nil
}
func (s *Store) GetChat(ctx context.Context, id uuid.UUID) (model.Chat, error) {
r, e := s.q.GetChat(ctx, id)
return model.Chat{ID: r.ID, Title: r.Title, CreatedAt: r.CreatedAt, MemberIDs: r.Members}, mapErr(e)
}
func position(q model.PageQuery) (time.Time, uuid.UUID) {
if q.After == nil {
return time.Unix(0, 0).UTC(), uuid.Nil
}
return q.After.CreatedAt, q.After.ID
}
func (s *Store) ListChats(ctx context.Context, id uuid.UUID, p model.PageQuery) ([]model.Chat, bool, error) {
at, aid := position(p)
rows, err := s.q.ListChats(ctx, queries.ListChatsParams{MemberID: id, AfterTime: at, AfterID: aid, PageLimit: int32(p.Limit + 1)})
if err != nil {
return nil, false, mapErr(err)
}
more := len(rows) > p.Limit
if more {
rows = rows[:p.Limit]
}
out := make([]model.Chat, len(rows))
for i, r := range rows {
out[i] = model.Chat{ID: r.ID, Title: r.Title, CreatedAt: r.CreatedAt, MemberIDs: r.Members}
}
return out, more, nil
}
func (s *Store) CreateMessage(ctx context.Context, d model.MessageDraft) (model.Message, error) {
tx, err := s.pool.Begin(ctx)
if err != nil {
return model.Message{}, mapErr(err)
}
defer func() { _ = tx.Rollback(ctx) }()
q := s.q.WithTx(tx)
messageID := uuid.New()
reserved, e := q.ReserveKey(ctx, queries.ReserveKeyParams{UserID: d.SenderID, ChatID: d.ChatID, Key: d.Key, PayloadHash: d.PayloadHash, MessageID: messageID})
if errors.Is(e, pgx.ErrNoRows) {
r, e := q.ReplayMessage(ctx, queries.ReplayMessageParams{UserID: d.SenderID, ChatID: d.ChatID, Key: d.Key})
if e != nil {
return model.Message{}, mapErr(e)
}
if r.PayloadHash != d.PayloadHash {
return model.Message{}, model.ErrConflict
}
return model.Message{ID: r.ID, ChatID: r.ChatID, SenderID: r.SenderID, Text: r.Text, CreatedAt: r.CreatedAt}, nil
}
if e != nil {
return model.Message{}, mapErr(e)
}
messageID = reserved
if _, err = q.ChargeMessage(ctx, d.SenderID); err != nil {
if errors.Is(err, pgx.ErrNoRows) {
return model.Message{}, model.ErrStorageFull
}
return model.Message{}, mapErr(err)
}
r, err := q.InsertMessage(ctx, queries.InsertMessageParams{ID: messageID, ChatID: d.ChatID, SenderID: d.SenderID, Text: d.Text})
if err != nil {
return model.Message{}, mapErr(err)
}
if err = tx.Commit(ctx); err != nil {
return model.Message{}, mapErr(err)
}
return model.Message{ID: r.ID, ChatID: r.ChatID, SenderID: r.SenderID, Text: r.Text, CreatedAt: r.CreatedAt}, nil
}
func (s *Store) ListMessages(ctx context.Context, id uuid.UUID, p model.PageQuery) ([]model.Message, bool, error) {
at, aid := position(p)
rows, err := s.q.ListMessages(ctx, queries.ListMessagesParams{ChatID: id, AfterTime: at, AfterID: aid, PageLimit: int32(p.Limit + 1)})
if err != nil {
return nil, false, mapErr(err)
}
more := len(rows) > p.Limit
if more {
rows = rows[:p.Limit]
}
out := make([]model.Message, len(rows))
for i, r := range rows {
out[i] = model.Message{ID: r.ID, ChatID: r.ChatID, SenderID: r.SenderID, Text: r.Text, CreatedAt: r.CreatedAt}
}
return out, more, nil
}
func (s *Store) Credentials(ctx context.Context, name string) (uuid.UUID, string, error) {
r, e := s.q.Credentials(ctx, name)
if errors.Is(e, pgx.ErrNoRows) {
return uuid.Nil, "", model.ErrUnauthorized
}
return r.ID, r.PasswordHash, mapErr(e)
}
func (s *Store) CreateSession(ctx context.Context, hash string, id uuid.UUID, expiry time.Time) error {
tx, e := s.pool.Begin(ctx)
if e != nil {
return mapErr(e)
}
defer func() { _ = tx.Rollback(ctx) }()
q := s.q.WithTx(tx)
if _, e = q.LockSessionOwner(ctx, id); e != nil {
return mapErr(e)
}
if e = q.DeleteExpiredSessions(ctx, id); e != nil {
return mapErr(e)
}
if _, e = q.InsertSession(ctx, queries.InsertSessionParams{TokenHash: hash, UserID: id, ExpiresAt: expiry}); e != nil {
if errors.Is(e, pgx.ErrNoRows) {
return model.ErrStorageFull
}
return mapErr(e)
}
return mapErr(tx.Commit(ctx))
}
func (s *Store) AuthenticateSession(ctx context.Context, hash string) (uuid.UUID, error) {
r, e := s.q.AuthenticateSession(ctx, hash)
if errors.Is(e, pgx.ErrNoRows) {
return uuid.Nil, model.ErrUnauthorized
}
return r, mapErr(e)
}
func (s *Store) RevokeSession(ctx context.Context, hash string) error {
return mapErr(s.q.RevokeSession(ctx, hash))
}
@@ -0,0 +1,86 @@
package usecase
import (
"context"
"crypto/rand"
"crypto/sha256"
"encoding/base64"
"encoding/hex"
"time"
"unicode/utf8"
"backend/internal/domain/model"
"backend/internal/domain/port"
)
type Auth struct {
sessions port.Sessions
passwords port.Passwords
messenger *Messenger
ttl time.Duration
now func() time.Time
}
type Session struct {
Token string
ExpiresAt time.Time
User model.User
}
func NewAuth(s port.Sessions, p port.Passwords, m *Messenger, ttl time.Duration, now func() time.Time) *Auth {
return &Auth{s, p, m, ttl, now}
}
func (a *Auth) Register(ctx context.Context, username, name, password string) (model.User, error) {
if n := utf8.RuneCountInString(password); n < 12 || n > 128 || !utf8.ValidString(password) {
return model.User{}, &model.ValidationError{Message: "password: 12–128 Unicode characters"}
}
draft, err := model.NewUserDraft(username, name)
if err != nil {
return model.User{}, err
}
hash, err := a.passwords.Hash(password)
if err != nil {
return model.User{}, err
}
draft.PasswordHash = hash
return a.messenger.repo.CreateUser(ctx, draft)
}
func (a *Auth) Login(ctx context.Context, username, password string) (Session, error) {
id, hash, err := a.sessions.Credentials(ctx, username)
if err != nil {
return Session{}, err
}
if !a.passwords.Verify(password, hash) {
return Session{}, model.ErrUnauthorized
}
user, err := a.messenger.repo.GetUser(ctx, id)
if err != nil {
return Session{}, err
}
raw := make([]byte, 32)
if _, err = rand.Read(raw); err != nil {
return Session{}, err
}
token := base64.RawURLEncoding.EncodeToString(raw)
expires := a.now().UTC().Add(a.ttl)
if err = a.sessions.CreateSession(ctx, TokenHash(token), id, expires); err != nil {
return Session{}, err
}
return Session{token, expires, user}, nil
}
func TokenHash(token string) string {
sum := sha256.Sum256([]byte(token))
return hex.EncodeToString(sum[:])
}
func (a *Auth) Authenticate(ctx context.Context, token string) (model.User, error) {
if len(token) != 43 {
return model.User{}, model.ErrUnauthorized
}
id, err := a.sessions.AuthenticateSession(ctx, TokenHash(token))
if err != nil {
return model.User{}, err
}
return a.messenger.repo.GetUser(ctx, id)
}
func (a *Auth) Logout(ctx context.Context, token string) error {
return a.sessions.RevokeSession(ctx, TokenHash(token))
}
@@ -0,0 +1,102 @@
package usecase
import (
"context"
"backend/internal/domain/model"
"backend/internal/domain/repository"
"github.com/google/uuid"
)
const chatsCursorScope = "chats"
// Page — страница списка; NextCursor == nil, если следующей записи нет.
type Page[T any] struct {
Items []T
NextCursor *string
}
type Messenger struct {
repo repository.Repository
}
func NewMessenger(repo repository.Repository) *Messenger {
return &Messenger{repo: repo}
}
func (m *Messenger) CreateChat(ctx context.Context, caller uuid.UUID, title string, memberIDs []uuid.UUID) (model.Chat, error) {
draft, err := model.NewChatDraft(caller, title, memberIDs)
if err != nil {
return model.Chat{}, err
}
return m.repo.CreateChat(ctx, draft)
}
func (m *Messenger) ListChats(ctx context.Context, caller uuid.UUID, limit *int, cursor *string) (Page[model.Chat], error) {
q, err := model.NewPageQuery(limit, cursor, chatsCursorScope)
if err != nil {
return Page[model.Chat]{}, err
}
chats, more, err := m.repo.ListChats(ctx, caller, q)
if err != nil {
return Page[model.Chat]{}, err
}
return newPage(chats, more, chatsCursorScope, model.Chat.Position), nil
}
// GetChat отдаёт чат только участнику; постороннему — ErrNotFound, чтобы не
// раскрывать существование чужого чата.
func (m *Messenger) GetChat(ctx context.Context, caller, chatID uuid.UUID) (model.Chat, error) {
chat, err := m.repo.GetChat(ctx, chatID)
if err != nil {
return model.Chat{}, err
}
if !chat.HasMember(caller) {
return model.Chat{}, model.ErrNotFound
}
return chat, nil
}
// SendMessage сначала проверяет доступ, затем тело: посторонний получает 404
// даже на невалидное сообщение. Проверка членства и запись не атомарны, но
// участники чата неизменяемы, а чаты не удаляются, поэтому гонки здесь нет.
func (m *Messenger) SendMessage(ctx context.Context, caller, chatID uuid.UUID, text, key string) (model.Message, error) {
if _, err := m.GetChat(ctx, caller, chatID); err != nil {
return model.Message{}, err
}
draft, err := model.NewMessageDraft(chatID, caller, text)
if err != nil {
return model.Message{}, err
}
draft, err = model.WithKey(draft, key)
if err != nil {
return model.Message{}, err
}
return m.repo.CreateMessage(ctx, draft)
}
func (m *Messenger) ListMessages(ctx context.Context, caller, chatID uuid.UUID, limit *int, cursor *string) (Page[model.Message], error) {
if _, err := m.GetChat(ctx, caller, chatID); err != nil {
return Page[model.Message]{}, err
}
scope := "messages:" + chatID.String()
q, err := model.NewPageQuery(limit, cursor, scope)
if err != nil {
return Page[model.Message]{}, err
}
messages, more, err := m.repo.ListMessages(ctx, chatID, q)
if err != nil {
return Page[model.Message]{}, err
}
return newPage(messages, more, scope, model.Message.Position), nil
}
func newPage[T any](items []T, more bool, scope string, position func(T) model.Position) Page[T] {
page := Page[T]{Items: items}
if more && len(items) > 0 {
next := model.EncodeCursor(scope, position(items[len(items)-1]))
page.NextCursor = &next
}
return page
}
+86
View File
@@ -0,0 +1,86 @@
package config
import (
"fmt"
"os"
"strings"
"time"
"github.com/spf13/viper"
)
// Config приходит только из окружения (12-factor): в контейнер не копируются
// ни .env, ни файлы конфигурации. Значения по умолчанию — ниже.
type Config struct {
Host string `mapstructure:"APP_HOST"`
Port int `mapstructure:"APP_PORT"`
Env string `mapstructure:"APP_ENV"`
LogLevel string `mapstructure:"LOG_LEVEL"`
ShutdownTimeout time.Duration `mapstructure:"SHUTDOWN_TIMEOUT"`
MaxBodyBytes int64 `mapstructure:"MAX_BODY_BYTES"`
MaxInflight int `mapstructure:"MAX_INFLIGHT"`
MaxQueue int `mapstructure:"MAX_QUEUE"`
QueueTimeout time.Duration `mapstructure:"QUEUE_TIMEOUT"`
DatabaseURLFile string `mapstructure:"DATABASE_URL_FILE"`
CacheURLFile string `mapstructure:"CACHE_URL_FILE"`
SessionTTLSeconds int `mapstructure:"SESSION_TTL_SECONDS"`
MaxConns int32 `mapstructure:"PG_MAX_CONNS"`
}
var defaults = map[string]any{
"APP_HOST": "0.0.0.0",
"APP_PORT": 8080,
"APP_ENV": "lab",
"LOG_LEVEL": "info",
"SHUTDOWN_TIMEOUT": "8s",
"MAX_BODY_BYTES": 64 << 10,
"MAX_INFLIGHT": 4,
"MAX_QUEUE": 32,
"QUEUE_TIMEOUT": "1s",
"DATABASE_URL_FILE": "/run/secrets/database_url",
"CACHE_URL_FILE": "/run/secrets/cache_url",
"SESSION_TTL_SECONDS": 3600,
"PG_MAX_CONNS": 8,
}
func Load() (Config, error) {
v := viper.New()
for key, value := range defaults {
v.SetDefault(key, value)
}
v.AutomaticEnv()
var cfg Config
if err := v.Unmarshal(&cfg); err != nil {
return Config{}, fmt.Errorf("parse config: %w", err)
}
if cfg.ShutdownTimeout <= 0 || cfg.ShutdownTimeout > 9*time.Second {
return Config{}, fmt.Errorf("SHUTDOWN_TIMEOUT must be in (0, 9s]: docker stop ждёт 10 с")
}
if cfg.SessionTTLSeconds < 1 || cfg.SessionTTLSeconds > 86400 {
return Config{}, fmt.Errorf("SESSION_TTL_SECONDS must be 1..86400")
}
if cfg.MaxConns < 1 || cfg.MaxConns > 64 {
return Config{}, fmt.Errorf("PG_MAX_CONNS must be 1..64")
}
if cfg.MaxInflight < 1 || cfg.MaxInflight > 4 || cfg.MaxQueue < 0 || cfg.MaxQueue > 128 || cfg.QueueTimeout <= 0 || cfg.QueueTimeout > 2*time.Second {
return Config{}, fmt.Errorf("HTTP gate exceeds the tested resource budget")
}
if cfg.MaxBodyBytes < 1 || cfg.MaxBodyBytes > 65536 {
return Config{}, fmt.Errorf("MAX_BODY_BYTES must be 1..65536")
}
return cfg, nil
}
func (c Config) Addr() string { return fmt.Sprintf("%s:%d", c.Host, c.Port) }
func ReadSecret(path string) (string, error) {
b, e := os.ReadFile(path)
if e != nil {
return "", fmt.Errorf("required secret file unavailable")
}
v := strings.TrimSpace(string(b))
if v == "" {
return "", fmt.Errorf("required secret is empty")
}
return v, nil
}
+24
View File
@@ -0,0 +1,24 @@
package config
import "testing"
func TestRejectsConfigurationOutsideResourceBudget(t *testing.T) {
for _, tc := range []struct{ key, value string }{{"MAX_INFLIGHT", "0"}, {"MAX_INFLIGHT", "5"}, {"MAX_QUEUE", "-1"}, {"MAX_QUEUE", "129"}, {"QUEUE_TIMEOUT", "0s"}, {"QUEUE_TIMEOUT", "3s"}, {"MAX_BODY_BYTES", "0"}, {"MAX_BODY_BYTES", "65537"}, {"PG_MAX_CONNS", "0"}, {"PG_MAX_CONNS", "65"}, {"SESSION_TTL_SECONDS", "0"}, {"SESSION_TTL_SECONDS", "86401"}} {
t.Run(tc.key+tc.value, func(t *testing.T) {
t.Setenv(tc.key, tc.value)
if _, e := Load(); e == nil {
t.Fatal("accepted configuration beyond tested bounds")
}
})
}
}
func TestPoolSizeIsConfigurableWithinBounds(t *testing.T) {
t.Setenv("PG_MAX_CONNS", "1")
cfg, e := Load()
if e != nil {
t.Fatal(e)
}
if cfg.MaxConns != 1 {
t.Fatal("configured pool size ignored")
}
}
+52
View File
@@ -0,0 +1,52 @@
package model
import (
"slices"
"time"
"github.com/google/uuid"
)
const maxChatMembers = 100
// Chat неизменяем после создания: участники задаются один раз, удаления в API нет.
type Chat struct {
ID uuid.UUID
Title string
MemberIDs []uuid.UUID
CreatedAt time.Time
}
func (c Chat) HasMember(userID uuid.UUID) bool {
return slices.Contains(c.MemberIDs, userID)
}
// ChatDraft — проверенные данные нового чата. Существование участников
// проверяет хранилище атомарно с созданием.
type ChatDraft struct {
Creator uuid.UUID
Title string
MemberIDs []uuid.UUID
}
func NewChatDraft(creator uuid.UUID, title string, memberIDs []uuid.UUID) (ChatDraft, error) {
if err := requireText("title", title, 1, 100); err != nil {
return ChatDraft{}, err
}
if len(memberIDs) == 0 || len(memberIDs) > maxChatMembers {
return ChatDraft{}, invalidf("member_ids: от 1 до %d участников", maxChatMembers)
}
seen := make(map[uuid.UUID]struct{}, len(memberIDs))
for _, id := range memberIDs {
if _, dup := seen[id]; dup {
return ChatDraft{}, invalidf("member_ids: повторяющийся участник")
}
seen[id] = struct{}{}
}
if _, ok := seen[creator]; !ok {
return ChatDraft{}, invalidf("member_ids: должен содержать создателя чата")
}
return ChatDraft{Creator: creator, Title: title, MemberIDs: slices.Clone(memberIDs)}, nil
}
func (c Chat) Position() Position { return Position{CreatedAt: c.CreatedAt, ID: c.ID} }
+32
View File
@@ -0,0 +1,32 @@
package model
import (
"errors"
"fmt"
)
var (
ErrUnavailable = errors.New("dependency unavailable")
ErrConflict = errors.New("conflict")
ErrNotFound = errors.New("not found")
ErrUnauthorized = errors.New("unauthorized")
ErrUsernameTaken = errors.New("username taken")
// ErrStorageFull — исчерпан бюджет памяти хранилища. Подтверждённые данные
// не вытесняются, поэтому новые записи отклоняются, а чтение продолжает работать.
ErrStorageFull = errors.New("storage full")
// ErrUnknownMember возвращает хранилище, если среди участников нового чата
// есть несуществующий пользователь; для клиента это ошибка ввода (400).
ErrUnknownMember error = &ValidationError{Message: "member_ids: неизвестный пользователь"}
)
// ValidationError — нарушение правил входных данных; Message безопасно
// показывать клиенту.
type ValidationError struct {
Message string
}
func (e *ValidationError) Error() string { return e.Message }
func invalidf(format string, args ...any) error {
return &ValidationError{Message: fmt.Sprintf(format, args...)}
}
+51
View File
@@ -0,0 +1,51 @@
package model
import (
"crypto/sha256"
"encoding/hex"
"regexp"
"time"
"github.com/google/uuid"
)
const MaxMessageRunes = 4000
type Message struct {
ID uuid.UUID
ChatID uuid.UUID
SenderID uuid.UUID
Text string
CreatedAt time.Time
}
// MessageDraft — проверенное сообщение; отправитель берётся из идентификации,
// а не из тела запроса.
type MessageDraft struct {
ChatID uuid.UUID
SenderID uuid.UUID
Text string
Key string
PayloadHash string
}
var keyPattern = regexp.MustCompile(`^[A-Za-z0-9._:-]{1,128}$`)
func WithKey(d MessageDraft, key string) (MessageDraft, error) {
if !keyPattern.MatchString(key) {
return MessageDraft{}, invalidf("Idempotency-Key: 1–128 ASCII characters required")
}
sum := sha256.Sum256([]byte(d.Text))
d.Key = key
d.PayloadHash = hex.EncodeToString(sum[:])
return d, nil
}
func NewMessageDraft(chatID, senderID uuid.UUID, text string) (MessageDraft, error) {
if err := requireText("text", text, 1, MaxMessageRunes); err != nil {
return MessageDraft{}, err
}
return MessageDraft{ChatID: chatID, SenderID: senderID, Text: text}, nil
}
func (m Message) Position() Position { return Position{CreatedAt: m.CreatedAt, ID: m.ID} }
+126
View File
@@ -0,0 +1,126 @@
package model
import (
"errors"
"strings"
"testing"
"time"
"github.com/google/uuid"
)
func isValidationError(err error) bool {
var v *ValidationError
return errors.As(err, &v)
}
func TestNewUserDraft(t *testing.T) {
t.Parallel()
cases := []struct {
name, username, display string
ok bool
}{
{"minimal", "abc", "A", true},
{"max username 32", strings.Repeat("a", 32), "A", true},
{"username too short", "ab", "A", false},
{"username too long", strings.Repeat("a", 33), "A", false},
{"uppercase rejected", "Alice", "A", false},
{"cyrillic username rejected", "алиса", "A", false},
{"display 100 emoji ok", "abc", strings.Repeat("😀", 100), true},
{"display 101 code points rejected", "abc", strings.Repeat("ж", 101), false},
{"display whitespace only", "abc", " \t\n", false},
{"display empty", "abc", "", false},
}
for _, tc := range cases {
t.Run(tc.name, func(t *testing.T) {
t.Parallel()
_, err := NewUserDraft(tc.username, tc.display)
if tc.ok && err != nil {
t.Fatalf("unexpected error: %v", err)
}
if !tc.ok && !isValidationError(err) {
t.Fatalf("want ValidationError, got %v", err)
}
})
}
}
func TestNewChatDraft(t *testing.T) {
t.Parallel()
me, other := uuid.New(), uuid.New()
tooMany := []uuid.UUID{me}
for range 100 {
tooMany = append(tooMany, uuid.New())
}
cases := []struct {
name string
members []uuid.UUID
ok bool
}{
{"creator only", []uuid.UUID{me}, true},
{"two members", []uuid.UUID{me, other}, true},
{"empty", nil, false},
{"creator missing", []uuid.UUID{other}, false},
{"duplicate member", []uuid.UUID{me, other, other}, false},
{"over 100 members", tooMany, false},
}
for _, tc := range cases {
t.Run(tc.name, func(t *testing.T) {
t.Parallel()
_, err := NewChatDraft(me, "Чат", tc.members)
if tc.ok != (err == nil) {
t.Fatalf("ok=%v, err=%v", tc.ok, err)
}
})
}
}
func TestNewMessageDraftLimitsInCodePoints(t *testing.T) {
t.Parallel()
if _, err := NewMessageDraft(uuid.New(), uuid.New(), strings.Repeat("👋", MaxMessageRunes)); err != nil {
t.Fatalf("4000 four-byte code points must pass: %v", err)
}
if _, err := NewMessageDraft(uuid.New(), uuid.New(), strings.Repeat("a", MaxMessageRunes+1)); !isValidationError(err) {
t.Fatalf("4001 code points must be rejected, got %v", err)
}
}
func TestCursorRoundTripAndScope(t *testing.T) {
t.Parallel()
pos := Position{CreatedAt: time.Date(2026, 9, 1, 12, 0, 0, 123456000, time.UTC), ID: uuid.New()}
cursor := EncodeCursor("messages:a", pos)
q, err := NewPageQuery(nil, &cursor, "messages:a")
if err != nil || q.After == nil || *q.After != pos || q.Limit != DefaultPageLimit {
t.Fatalf("round trip failed: %+v, %v", q, err)
}
if _, err := NewPageQuery(nil, &cursor, "messages:b"); !isValidationError(err) {
t.Fatalf("cursor of another resource must be rejected, got %v", err)
}
for _, bad := range []string{"", "!!!", EncodeCursor("x", pos)[:5]} {
if _, err := NewPageQuery(nil, &bad, "messages:a"); !isValidationError(err) {
t.Fatalf("garbage cursor %q must be rejected, got %v", bad, err)
}
}
}
func TestPageLimitBounds(t *testing.T) {
t.Parallel()
for limit, ok := range map[int]bool{0: false, 1: true, 100: true, 101: false, -1: false} {
_, err := NewPageQuery(&limit, nil, "chats")
if ok != (err == nil) {
t.Errorf("limit=%d: ok=%v, err=%v", limit, ok, err)
}
}
}
func TestPositionOrderTiesBrokenByID(t *testing.T) {
t.Parallel()
at := time.Now()
low := Position{CreatedAt: at, ID: uuid.MustParse("00000000-0000-4000-8000-000000000001")}
high := Position{CreatedAt: at, ID: uuid.MustParse("ffffffff-0000-4000-8000-000000000000")}
later := Position{CreatedAt: at.Add(time.Microsecond), ID: low.ID}
if !high.After(low) || low.After(high) || !later.After(high) || low.After(low) {
t.Fatal("order must be (created_at, id) ascending")
}
}
+84
View File
@@ -0,0 +1,84 @@
package model
import (
"bytes"
"encoding/base64"
"strconv"
"strings"
"time"
"github.com/google/uuid"
)
const (
DefaultPageLimit = 50
MaxPageLimit = 100
)
// Position — ключ keyset-пагинации: история упорядочена по (created_at, id).
type Position struct {
CreatedAt time.Time
ID uuid.UUID
}
// After сообщает, стоит ли p строго после other в порядке (created_at, id).
func (p Position) After(other Position) bool {
if !p.CreatedAt.Equal(other.CreatedAt) {
return p.CreatedAt.After(other.CreatedAt)
}
return bytes.Compare(p.ID[:], other.ID[:]) > 0
}
// PageQuery — проверенный запрос страницы: limit 1–100 и позиция после
// последнего элемента предыдущей страницы (nil — с начала).
type PageQuery struct {
Limit int
After *Position
}
// NewPageQuery проверяет limit и курсор. scope привязывает курсор к ресурсу:
// курсор истории одного чата не подходит к другому чату или к списку чатов.
func NewPageQuery(limit *int, cursor *string, scope string) (PageQuery, error) {
q := PageQuery{Limit: DefaultPageLimit}
if limit != nil {
if *limit < 1 || *limit > MaxPageLimit {
return PageQuery{}, invalidf("limit: от 1 до %d", MaxPageLimit)
}
q.Limit = *limit
}
if cursor != nil {
pos, err := decodeCursor(*cursor, scope)
if err != nil {
return PageQuery{}, err
}
q.After = &pos
}
return q, nil
}
// EncodeCursor делает непрозрачную для клиента строку из позиции и scope.
func EncodeCursor(scope string, p Position) string {
raw := scope + "|" + strconv.FormatInt(p.CreatedAt.UnixMicro(), 10) + "|" + p.ID.String()
return base64.RawURLEncoding.EncodeToString([]byte(raw))
}
func decodeCursor(cursor, scope string) (Position, error) {
errBad := invalidf("cursor: некорректное значение")
raw, err := base64.RawURLEncoding.DecodeString(cursor)
if err != nil {
return Position{}, errBad
}
parts := strings.Split(string(raw), "|")
if len(parts) != 3 || parts[0] != scope {
return Position{}, errBad
}
micros, err := strconv.ParseInt(parts[1], 10, 64)
if err != nil {
return Position{}, errBad
}
id, err := uuid.Parse(parts[2])
if err != nil {
return Position{}, errBad
}
return Position{CreatedAt: time.UnixMicro(micros).UTC(), ID: id}, nil
}
@@ -0,0 +1,13 @@
package model
import "testing"
func TestRejectsNULInPersistedText(t *testing.T) {
for _, field := range []string{"display_name", "title", "text"} {
t.Run(field, func(t *testing.T) {
if err := requireText(field, "a\x00b", 1, 4000); err == nil {
t.Fatal("PostgreSQL text must reject NUL as a validation error")
}
})
}
}
+24
View File
@@ -0,0 +1,24 @@
package model
import (
"strings"
"unicode/utf8"
)
// requireText проверяет обязательную строку: длина в Unicode code points
// (не в байтах) и запрет строк только из пробельных символов.
func requireText(field, value string, minLen, maxLen int) error {
if strings.ContainsRune(value, 0) {
return invalidf("%s: NUL недопустим в PostgreSQL text", field)
}
if !utf8.ValidString(value) {
return invalidf("%s: некорректный UTF-8", field)
}
if strings.TrimSpace(value) == "" {
return invalidf("%s: пустая строка", field)
}
if n := utf8.RuneCountInString(value); n < minLen || n > maxLen {
return invalidf("%s: длина должна быть от %d до %d символов", field, minLen, maxLen)
}
return nil
}
+34
View File
@@ -0,0 +1,34 @@
package model
import (
"regexp"
"time"
"github.com/google/uuid"
)
var usernamePattern = regexp.MustCompile(`^[a-z0-9_]{3,32}$`)
type User struct {
ID uuid.UUID
Username string
DisplayName string
CreatedAt time.Time
}
// UserDraft — проверенные данные нового пользователя; ID и время назначает хранилище.
type UserDraft struct {
Username string
DisplayName string
PasswordHash string
}
func NewUserDraft(username, displayName string) (UserDraft, error) {
if !usernamePattern.MatchString(username) {
return UserDraft{}, invalidf("username: допустимо [a-z0-9_], от 3 до 32 символов")
}
if err := requireText("display_name", displayName, 1, 100); err != nil {
return UserDraft{}, err
}
return UserDraft{Username: username, DisplayName: displayName}, nil
}
+18
View File
@@ -0,0 +1,18 @@
package port
import (
"context"
"github.com/google/uuid"
"time"
)
type Passwords interface {
Hash(string) (string, error)
Verify(string, string) bool
}
type Sessions interface {
Credentials(context.Context, string) (uuid.UUID, string, error)
CreateSession(context.Context, string, uuid.UUID, time.Time) error
AuthenticateSession(context.Context, string) (uuid.UUID, error)
RevokeSession(context.Context, string) error
}
@@ -0,0 +1,49 @@
// Package repository — порт персистентности. В lab1 его реализует хранилище
// в памяти процесса, с lab2 — PostgreSQL; ядро от этой замены не меняется.
package repository
import (
"context"
"backend/internal/domain/model"
"backend/internal/domain/port"
"github.com/google/uuid"
)
// Repository assigns IDs and database timestamps. Keyset order is (created_at, id);
// concurrent commits do not provide insertion order or a traversal snapshot.
// Каждый метод атомарен сам по себе.
type Repository interface {
UserRepository
ChatRepository
MessageRepository
}
type Persistent interface {
Repository
port.Sessions
}
type UserRepository interface {
// CreateUser: model.ErrUsernameTaken, model.ErrStorageFull.
CreateUser(ctx context.Context, draft model.UserDraft) (model.User, error)
// GetUser: model.ErrNotFound.
GetUser(ctx context.Context, id uuid.UUID) (model.User, error)
}
type ChatRepository interface {
// CreateChat: model.ErrUnknownMember, model.ErrStorageFull.
CreateChat(ctx context.Context, draft model.ChatDraft) (model.Chat, error)
// GetChat: model.ErrNotFound.
GetChat(ctx context.Context, id uuid.UUID) (model.Chat, error)
// ListChats возвращает чаты участника и признак, что есть следующая страница.
ListChats(ctx context.Context, memberID uuid.UUID, q model.PageQuery) ([]model.Chat, bool, error)
}
type MessageRepository interface {
// CreateMessage: model.ErrNotFound (нет чата), model.ErrStorageFull.
CreateMessage(ctx context.Context, draft model.MessageDraft) (model.Message, error)
// ListMessages возвращает страницу истории и признак следующей страницы.
ListMessages(ctx context.Context, chatID uuid.UUID, q model.PageQuery) ([]model.Message, bool, error)
}
+18
View File
@@ -0,0 +1,18 @@
package logger
import (
"os"
"time"
"github.com/rs/zerolog"
)
// New — JSON-логи в stdout, их собирает docker logs.
func New(level string) zerolog.Logger {
lvl, err := zerolog.ParseLevel(level)
if err != nil || level == "" {
lvl = zerolog.InfoLevel
}
zerolog.TimeFieldFormat = time.RFC3339Nano
return zerolog.New(os.Stdout).Level(lvl).With().Timestamp().Logger()
}
+29
View File
@@ -0,0 +1,29 @@
package server
import (
"context"
"net/http"
"time"
)
type Server struct {
httpServer *http.Server
}
func New(addr string, handler http.Handler) *Server {
return &Server{httpServer: &http.Server{
Addr: addr,
Handler: handler,
ReadHeaderTimeout: 5 * time.Second,
ReadTimeout: 15 * time.Second,
WriteTimeout: 15 * time.Second,
IdleTimeout: 60 * time.Second,
MaxHeaderBytes: 16 << 10,
}}
}
func (s *Server) ListenAndServe() error { return s.httpServer.ListenAndServe() }
// Shutdown сразу закрывает слушающий сокет (новые соединения не принимаются)
// и ждёт завершения начатых запросов, но не дольше ctx.
func (s *Server) Shutdown(ctx context.Context) error { return s.httpServer.Shutdown(ctx) }
+75
View File
@@ -0,0 +1,75 @@
name: vp-lab3-medvedev
x-api: &api
image: vp-medvedev-lab3:local
build: .
cpus: ${API_CPUS:-1}
mem_limit: ${API_MEMORY:-512m}
deploy:
replicas: ${API_REPLICAS:-2}
stop_grace_period: 10s
environment:
APP_PORT: 8080
SESSION_TTL_SECONDS: ${SESSION_TTL_SECONDS:-3600}
PG_MAX_CONNS: ${PG_MAX_CONNS:-8}
GOMEMLIMIT: ${GO_MEMORY_LIMIT:-400MiB}
secrets: [database_url, cache_url]
depends_on:
migrate: {condition: service_completed_successfully}
valkey: {condition: service_started}
networks: [private]
services:
postgres:
image: postgres:18.6@sha256:74935e72241653ca55e0414067e6d8763aceb8a810eb51b452253ec3dcfc4336
cpus: 2
mem_limit: 768m
environment:
POSTGRES_USER: messenger
POSTGRES_DB: messenger
POSTGRES_PASSWORD_FILE: /run/secrets/pg_password
secrets: [pg_password]
volumes: [postgres:/var/lib/postgresql]
healthcheck:
test: [CMD-SHELL, pg_isready -U messenger -d messenger]
interval: 2s
timeout: 2s
retries: 30
networks: [private]
valkey:
image: valkey/valkey:9@sha256:418652cfb58ef879d4978c33553735d7147016032d5aefaa14c828e611eb9dfd
cpus: 0.25
mem_limit: 128m
command: [valkey-server, /run/secrets/valkey_conf]
secrets: [valkey_conf]
volumes: [valkey:/data]
networks: [private]
migrate:
image: vp-medvedev-lab3:local
build: .
command: [-migrate]
cpus: 0.5
mem_limit: 256m
secrets: [database_url]
depends_on:
postgres: {condition: service_healthy}
networks: [private]
api:
<<: *api
lb:
image: haproxy:3.2-alpine@sha256:1c3568e520453cc8ba98c39501febcf450429c80e6cc27ecad779961d76e597c
cpus: 0.5
mem_limit: 128m
ports: ['127.0.0.1:${PUBLIC_PORT:-28203}:8080']
volumes: ['./config/haproxy.cfg:/usr/local/etc/haproxy/haproxy.cfg:ro']
depends_on:
api: {condition: service_started}
networks: [private]
volumes:
postgres:
valkey:
networks:
private:
secrets:
pg_password: {file: .local/pg_password}
database_url: {file: .local/database_url}
cache_url: {file: .local/cache_url}
valkey_conf: {file: .local/valkey.conf}
+27
View File
@@ -0,0 +1,27 @@
global
log stdout format raw local0
maxconn 256
defaults
mode http
log global
timeout connect 1s
timeout client 20s
timeout server 8s
retries 0
resolvers docker
nameserver dns 127.0.0.11:53
resolve_retries 2
timeout resolve 1s
timeout retry 1s
hold valid 1s
hold obsolete 1s
frontend public
bind :8080
default_backend api
backend api
balance roundrobin
option httpchk
http-check send meth GET uri /health/ready
http-check expect status 200
default-server inter 500ms fall 2 rise 1
server-template replica 1-4 api:8080 check resolvers docker resolve-prefer ipv4 init-addr none
+70
View File
@@ -0,0 +1,70 @@
apiVersion: v1
kind: Service
metadata:
name: api
spec:
clusterIP: None
selector: {app: api}
ports: [{name: http, port: 8080, targetPort: http}]
---
apiVersion: apps/v1
kind: Deployment
metadata:
name: api
labels: {app: api}
spec:
replicas: 2
revisionHistoryLimit: 2
strategy:
rollingUpdate: {maxSurge: 1, maxUnavailable: 0}
selector:
matchLabels: {app: api}
template:
metadata:
labels: {app: api}
spec:
automountServiceAccountToken: false
terminationGracePeriodSeconds: 35
securityContext: {runAsNonRoot: true, runAsUser: 65532, fsGroup: 65532}
containers:
- name: api
image: vp-messenger:local
imagePullPolicy: Never
ports: [{name: http, containerPort: 8080}]
env:
- {name: APP_HOST, value: 0.0.0.0}
- {name: APP_PORT, value: '8080'}
- {name: PG_MAX_CONNS, value: '8'}
- {name: SESSION_TTL_SECONDS, value: '3600'}
- {name: GOMEMLIMIT, value: 400MiB}
resources:
requests: {cpu: 100m, memory: 128Mi}
limits: {cpu: '1', memory: 512Mi}
securityContext:
allowPrivilegeEscalation: false
capabilities: {drop: [ALL]}
lifecycle:
preStop:
sleep: {seconds: 15}
readinessProbe:
httpGet: {path: /health/ready, port: http}
periodSeconds: 1
timeoutSeconds: 2
failureThreshold: 1
livenessProbe:
httpGet: {path: /health/live, port: http}
periodSeconds: 5
timeoutSeconds: 2
startupProbe:
httpGet: {path: /health/live, port: http}
periodSeconds: 1
failureThreshold: 60
volumeMounts: [{name: credentials, mountPath: /run/secrets, readOnly: true}]
volumes:
- name: credentials
secret:
secretName: app-config
defaultMode: 0440
items:
- {key: database_url, path: database_url}
- {key: cache_url, path: cache_url}
+9
View File
@@ -0,0 +1,9 @@
apiVersion: kustomize.config.k8s.io/v1beta1
kind: Kustomization
namespace: messenger
resources: [namespace.yaml, stores.yaml, api.yaml, pingap.yaml]
configMapGenerator:
- name: pingap-config
files: [pingap.toml]
generatorOptions:
disableNameSuffixHash: true
+6
View File
@@ -0,0 +1,6 @@
apiVersion: v1
kind: Namespace
metadata:
name: messenger
labels:
app.kubernetes.io/part-of: vp-coursework
+20
View File
@@ -0,0 +1,20 @@
[basic]
threads = 1
grace_period = "8s"
graceful_shutdown_timeout = "10s"
[upstreams.api]
addrs = ["api.messenger.svc.cluster.local:8080"]
discovery = "dns"
update_frequency = "1s"
health_check = "http://api/health/ready?connection_timeout=1s&read_timeout=1s&check_frequency=1s&success=1&failure=1"
connection_timeout = "1s"
read_timeout = "25s"
[locations.api]
path = "/"
upstream = "api"
[servers.http]
addr = "0.0.0.0:8080"
locations = ["api"]
+35
View File
@@ -0,0 +1,35 @@
apiVersion: v1
kind: Service
metadata: {name: pingap}
spec:
type: LoadBalancer
allocateLoadBalancerNodePorts: false
selector: {app: pingap}
ports: [{name: http, port: 80, targetPort: http}]
---
apiVersion: apps/v1
kind: Deployment
metadata: {name: pingap}
spec:
replicas: 1
selector: {matchLabels: {app: pingap}}
template:
metadata: {labels: {app: pingap}}
spec:
automountServiceAccountToken: false
terminationGracePeriodSeconds: 25
containers:
- name: pingap
image: vp-pingap:local
imagePullPolicy: Never
args: [-c, /etc/pingap/pingap.toml, --autoreload, --strict]
ports: [{name: http, containerPort: 8080}]
resources:
requests: {cpu: 50m, memory: 32Mi}
limits: {cpu: 500m, memory: 128Mi}
readinessProbe:
tcpSocket: {port: http}
periodSeconds: 1
volumeMounts: [{name: configuration, mountPath: /etc/pingap, readOnly: true}]
volumes:
- {name: configuration, configMap: {name: pingap-config}}
+96
View File
@@ -0,0 +1,96 @@
apiVersion: v1
kind: PersistentVolumeClaim
metadata: {name: postgres}
spec:
accessModes: [ReadWriteOnce]
resources: {requests: {storage: 1Gi}}
---
apiVersion: v1
kind: PersistentVolumeClaim
metadata: {name: valkey}
spec:
accessModes: [ReadWriteOnce]
resources: {requests: {storage: 1Gi}}
---
apiVersion: v1
kind: Service
metadata: {name: postgres}
spec:
selector: {app: postgres}
ports: [{port: 5432, targetPort: 5432}]
---
apiVersion: v1
kind: Service
metadata: {name: valkey}
spec:
selector: {app: valkey}
ports: [{port: 6379, targetPort: 6379}]
---
apiVersion: apps/v1
kind: Deployment
metadata: {name: postgres}
spec:
replicas: 1
strategy: {type: Recreate}
selector: {matchLabels: {app: postgres}}
template:
metadata: {labels: {app: postgres}}
spec:
automountServiceAccountToken: false
terminationGracePeriodSeconds: 20
containers:
- name: postgres
image: vp-postgres:local
imagePullPolicy: Never
env:
- {name: POSTGRES_USER, value: messenger}
- {name: POSTGRES_DB, value: messenger}
- {name: POSTGRES_PASSWORD_FILE, value: /run/secrets/pg_password}
resources:
requests: {cpu: 100m, memory: 128Mi}
limits: {cpu: '2', memory: 768Mi}
readinessProbe:
exec: {command: [pg_isready, -h, 127.0.0.1, -U, messenger, -d, messenger]}
periodSeconds: 2
volumeMounts:
- {name: data, mountPath: /var/lib/postgresql}
- {name: credentials, mountPath: /run/secrets, readOnly: true}
volumes:
- {name: data, persistentVolumeClaim: {claimName: postgres}}
- name: credentials
secret:
secretName: app-config
items: [{key: pg_password, path: pg_password}]
---
apiVersion: apps/v1
kind: Deployment
metadata: {name: valkey}
spec:
replicas: 1
strategy: {type: Recreate}
selector: {matchLabels: {app: valkey}}
template:
metadata: {labels: {app: valkey}}
spec:
automountServiceAccountToken: false
terminationGracePeriodSeconds: 10
containers:
- name: valkey
image: vp-valkey:local
imagePullPolicy: Never
command: [valkey-server, /run/secrets/valkey_conf]
resources:
requests: {cpu: 50m, memory: 32Mi}
limits: {cpu: 250m, memory: 128Mi}
readinessProbe:
tcpSocket: {port: 6379}
periodSeconds: 2
volumeMounts:
- {name: data, mountPath: /data}
- {name: credentials, mountPath: /run/secrets, readOnly: true}
volumes:
- {name: data, persistentVolumeClaim: {claimName: valkey}}
- name: credentials
secret:
secretName: app-config
items: [{key: valkey_conf, path: valkey_conf}]
+62
View File
@@ -0,0 +1,62 @@
# Лабораторная 3. Балансировка и отказ API-реплики
Автор: Медведев Андрей Михайлович, БПИ2303. Целевая оценка: 5, трек 1 «Цена масштабирования». Реализация, эксперименты и ограничения описаны ниже; оценку выставляет преподаватель. Исходный skeleton: https://gitea.privcloud.tech/mtusi2026/mtusi2026lab3. Команды находятся в [RUN.md](RUN.md). Код, тесты и отчёт подготовлены с помощью Codex и проверены независимым агентом.
## Архитектура
Клиент обращается к HAProxy, который распределяет запросы между двумя Go API. PostgreSQL и Valkey общие. Сессии проверяются в PostgreSQL; Valkey кэширует неизменяемые профили. Sticky sessions нет. API не публикуют свои порты на host, единственный вход привязан к localhost:28203. Контейнеры имеют CPU/RAM limits, container_name не задаётся.
HAProxy проверяет /health/ready каждые 500 мс, исключает backend после двух неудач и возвращает после одного успеха. Docker DNS разрешается повторно через resolver с коротким hold, а не только при старте LB. Конфигурация рассчитана на 1–4 реплики, включая эксперимент 1/2/4. Каждая API-реплика возвращает свой стабильный X-Instance-Id, соответствующий hostname контейнера. Автоматических прозрачных повторов произвольных POST нет.
SIGTERM переводит readiness в 503 и прекращает приём новых соединений. Graceful shutdown API ограничен 8 секундами, stop_grace_period контейнера равен 10 секундам. Для обычных запросов действует контекст 5 секунд; connection/statement/lock timeouts PostgreSQL согласованы с этим бюджетом.
## Общая идемпотентность
Idempotency-Key обязателен для POST сообщения и проверяется по ASCII pattern и длине 1–128. Область ключа задаётся пользователем и чатом; HTTP-операция фиксирована самим endpoint. В PostgreSQL хранятся hash семантического payload, ID сообщения и expiry на 24 часа.
Резервирование ключа, списание квоты, создание сообщения и ссылка результата выполняются одной транзакцией. Конкурентный повтор ждёт общий UNIQUE constraint; после подтверждения читает тот же Message с 201. Другой payload даёт 409. При откате нет ни сообщения, ни окончательного результата ключа. Неподтверждённый клиентский ответ можно повторить через другую реплику; сессия и доступ к чату проверяются заново.
Миграции запускает один отдельный service. Проверенная поочерёдная замена использует уже подготовленную совместимую схему. Произвольное несовместимое изменение схемы под трафиком не заявляется.
## Проверки обязательных уровней
Публичный smoke и дополнительные HTTP-проверки подтвердили авторизацию, страницы, rollback, конкурентную регистрацию, двенадцать одновременных повторов одного сообщения, конфликт payload и одну сессию через разные реплики. Результаты находятся в evidence/smoke.txt и evidence/acceptance.txt. Persistence сохранил данные и исходный токен после рестарта всех stores и API; файлы restart-before/after фиксируют реальные container ID и StartedAt.
Каждая API-реплика была остановлена по TARGET_INSTANCE_ID, вторая продолжила чтение и запись. Скрипт проверяет, что выбранный контейнер относится к нужному Compose-проекту; факт остановки записан в stopped-1/2.txt. Public failover учитывает переходные ошибки, проверяет сохранность и отсутствие дублей. Результаты находятся в evidence/failover-1.txt и evidence/failover-2.txt.
Обязательные операции предыдущей лабы сохраняют свои правила. Source check, OpenAPI validation, Go race tests, lint/depguard, Docker build и генерация проверяются отдельно от smoke. Авторские тестовые данные изолированы случайным prefix, cleanup отказывается удалять чат с посторонним участником. Compose manifest и project name закреплены явно.
## Исследование масштабирования
Гипотеза: дополнительные API помогают, только пока они являются узким местом. Нагрузка здесь намеренно состоит из отправки сообщений одним пользователем в один чат. Измерялся closed-loop клиент с concurrency 16, по 5 секунд, два повтора; база данных очищалась только внутри отдельного одноразового исследовательского проекта перед каждым запуском.
В первой серии суммарный бюджет API постоянен: 2 CPU и 2048 МиБ. Во второй каждая реплика получает 1 CPU и 512 МиБ. PostgreSQL, Valkey и LB сохраняют одинаковые ресурсы. Фактические NanoCpus, Memory, число контейнеров и PG_MAX_CONNS проверялись через Docker и API; снимались CPU/RAM и wait events PostgreSQL. Все запросы основной серии завершились без HTTP-ошибок.
| Серия | Реплики | CPU API суммарно | RAM API суммарно, МиБ | Успешные RPS, среднее | p95, мс, среднее |
| --- | --- | --- | --- | --- | --- |
| Постоянный бюджет | 1 | 2 | 2048 | 117,70 | 171,00 |
| Постоянный бюджет | 2 | 2 | 2048 | 112,99 | 287,81 |
| Постоянный бюджет | 4 | 2 | 2048 | 116,69 | 346,31 |
| Рост ресурсов | 1 | 1 | 512 | 116,71 | 175,68 |
| Рост ресурсов | 2 | 2 | 1024 | 117,87 | 258,62 |
| Рост ресурсов | 4 | 4 | 2048 | 117,09 | 342,18 |
Данные и диапазоны двух повторов сохранены в evidence/research/run-ImJmOz/. Графики scaling.svg и pool.svg строятся из исходных JSON, а не из переписанных вручную чисел.
Для этого профиля насыщение видно уже при одной реплике: добавление API/CPU не повышает throughput, а хвост latency растёт. В 160 снимках активных SQL-запросов ожидание WalSync наблюдалось 151 раз, transactionid 139 раз; категории могут одновременно присутствовать в одном снимке. В исходном коде каждое сообщение обновляет квоту одного sender, поэтому конкурентные транзакции сериализуются на его строке и подтверждают WAL. Число API не снимает эту общую границу.
## Подтверждённое улучшение
Отдельно проведена серия ABBA с pool=8 → 1 → 1 → 8 при неизменных 1 API, 2 CPU, 2048 МиБ и том же профиле. Результаты находятся в evidence/research/run-sB0hdP/. Средние успешные RPS составили 117,78 → 118,52, то есть практически не изменились. Средний p95 снизился с 166,86 до 145,97 мс; оба повтора с pool=1 оказались ниже обоих с pool=8.
Это подтверждённое улучшение хвостовой задержки на одном горячем sender: меньшая конкуренция за общий SQL-ресурс уменьшает очереди, но не ускоряет COMMIT. Для независимых пользователей и другого хранилища вывод не переносится автоматически. Общий default pool=8 сохранён; экспериментальная настройка доступна через PG_MAX_CONNS.
## Замена под нагрузкой и ограничения
В том же отдельном проекте обе исходные API по очереди заменены новыми контейнерами под непрерывной 30-секундной нагрузкой. Между заменами проверялась готовность двух реплик; успешные записи должны были продолжаться, а генератор оставаться активным. Сохранены старые ID и количества сообщений до/после каждой замены.
Получено 2684 успешных запроса и 46 переходных ошибок, доля ошибок 1,685%, успешные RPS 89,27. Это допустимые обнаруженные ошибки во время замены, а не zero-downtime обещание. Проверена замена контейнеров одного собранного образа; upgrade с несовместимой миграцией не испытывался.
Стенд находится на одном host и имеет единственные PostgreSQL, LB и storage. Поэтому отказ API проверен, а потеря host/БД/LB не покрыта. Closed-loop клиент имеет coordinated omission; latency относится только к успешным запросам, ошибки считаются отдельно. Серии короткие и не доказывают универсальный предел сервера. Объёмы, ресурсы, raw JSON и ограничения сохранены для повторения.
На защите показать две реальные реплики с одной сессией, конкурентный одинаковый ключ, остановку каждой реплики, повтор без дубля, persistence и графики. Объяснить, почему четыре API не превращают единственную PostgreSQL в отказоустойчивую БД и не отменяют транзакционную сериализацию.
+74
View File
@@ -0,0 +1,74 @@
# Запуск лабораторной 3
> Историческая инструкция Compose/HAProxy. Основной путь теперь описан в ../../RUN.md. Для старых action helpers явно задайте VP_RUNTIME=compose; прежний runner исследования сохранён как student-tests/research-compose.ts. Числа этого варианта не являются измерениями k3s/Pingap.
Автор: Медведев Андрей Михайлович, БПИ2303. Исходное задание и контракт сохранены в README.md и contracts/. Реализация находится в backend/, дополнительные проверки в student-tests/.
Нужны Docker Engine с Compose, Bun 1.4 и Python 3.9+. Для Go-тестов на хосте нужен Go 1.27.2 или новее. Проверенный стенд: Linux x86_64, Docker 29.9.2, Compose 5.6.1, Bun 1.4.4; образ компилируется Go 1.27.2. Образы PostgreSQL 18.6 и Valkey 9 закреплены digest в compose.yaml.
Команды выполняются из этого каталога. scripts/compose.sh закрепляет manifest и имя vp-lab3-medvedev, чтобы переменные другого проекта не перенаправили операции.
```sh
bun --no-env-file scripts/bootstrap.ts
./scripts/compose.sh up -d --build
BASE_URL=http://127.0.0.1:28203 bun --no-env-file student-tests/wait.ts
python3 -m venv .venv
.venv/bin/pip install -r requirements-dev.txt
make check
make validate PYTHON=.venv/bin/python
make test BASE_URL=http://127.0.0.1:28203
BASE_URL=http://127.0.0.1:28203 bun --no-env-file student-tests/acceptance.ts
make test-persistence BASE_URL=http://127.0.0.1:28203 ACTION_SCRIPT=scripts/restart.sh
cd backend
go test -race ./...
go tool golangci-lint run
go generate ./...
```
Bootstrap создаёт отдельные случайные учебные credentials в .local/ и не печатает их. Каталог исключён из git и Docker context. Существующие файлы не перезаписываются. Миграции запускает отдельный service migrate; API не выполняет их конкурентно.
HTTP доступен только через localhost. Все данные тестов синтетические; публичные тесты сохраняют свой набор данных для демонстрации, дополнительные acceptance-тесты удаляют только свой случайный набор. Пароли и сессии не выводятся в отчёты.
Обычная остановка сохраняет volumes:
```sh
./scripts/compose.sh stop
```
Повторный запуск с сохранением данных:
```sh
./scripts/compose.sh up -d
```
Только для намеренного полного сброса собственных учебных данных:
```sh
./scripts/compose.sh down --volumes
```
Для проверки отказа запустите публичный сценарий. Он передаёт реальный TARGET_INSTANCE_ID hook-скрипту; после проверки верните обе реплики и дождитесь готовности.
```sh
make test-failover BASE_URL=http://127.0.0.1:28203 ACTION_SCRIPT=scripts/stop-one.sh
./scripts/compose.sh up -d
BASE_URL=http://127.0.0.1:28203 bun --no-env-file student-tests/wait.ts
```
Чтобы проверить вторую реплику, повторите сценарий после восстановления; фактический остановленный контейнер записывается в evidence/stop-one-after.txt.
Трек 1 запускается на omarchy без игры; скрипт проверяет это до и после замеров. Он создаёт отдельный случайный Compose-проект на localhost:28303, сравнивает 1/2/4 реплики, выполняет ABBA для пула и замену под нагрузкой, затем удаляет только свои containers/volumes. Обычный демонстрационный стенд сохраняется.
```sh
bun --no-env-file student-tests/research.ts
bun --no-env-file student-tests/research.ts --pool-only
```
Первой команды достаточно для полного исследования; вторая отдельно повторяет четыре замера пула. Результат каждого запуска появляется в новом evidence/research/run-*. Для приложенных графиков:
```sh
.venv/bin/pip install -r requirements-plots.txt
.venv/bin/python student-tests/plot_research.py evidence/research/run-ImJmOz/summary.json --pool-summary evidence/research/run-sB0hdP/summary.json
```
Подтверждённые результаты и ограничения перечислены в REPORT.md. Автоматические проверки не выставляют оценку преподавателя.
+15
View File
@@ -0,0 +1,15 @@
# Implementation plan and boundaries
Archived: this inherited lab2 plan is retained as historical context only. The completed lab3 implementation, results and limitations are documented in ../../REPORT.md; startup instructions are in ../../RUN.md.
This repository carries our lab1 domain, pagination, HTTP/error handling, bounded queue and shutdown code into the original lab2 skeleton. The lab1 memory adapter and its obsolete HTTP identity tests are not carried forward.
PostgreSQL is authoritative for users, passwords, sessions, chats, membership and messages. Valkey caches immutable public profiles for 60 seconds; no chat/message/session cache is used. Authentication always reads the session from PostgreSQL, and cache failure falls back to PostgreSQL within an 80 ms budget. Logout deletes the persisted token hash. Cache contents contain no password or bearer token.
Transactions: chat allocation + chat row + membership; sender quota + message; session owner lock + expiry cleanup + session insertion. PostgreSQL constraints enforce username uniqueness and foreign keys. Maximums: 1000 created chats and 1,000,000 messages per owner; 100 unexpired sessions. No user data is silently deleted. The history index covers `(chat_id,created_at,id)` and queries fetch only `limit+1` rows. Keyset traversal is not a snapshot; writes whose wall-clock timestamps fall before a consumed cursor can be missed during concurrent traversal.
Argon2id uses a random 16-byte salt, 32 MiB, two iterations, one lane, 32-byte result. Tokens use 32 random bytes; PostgreSQL stores only SHA-256 of the token. SHA-256 is appropriate for high-entropy tokens, not passwords. The API gate bounds concurrent KDF calls to four. PostgreSQL pool: eight connections, statement timeout 2 s, lock timeout 1 s, connect timeout 1 s; request context 5 s.
Readiness checks PostgreSQL. Valkey is optional to safe operation; its absence is observable through cache hit statistics and failure tests, not an anonymous-authentication fallback. HTTP is bound to localhost and uses only generated synthetic data.
Research: compare history queries over at least 100,000 skewed messages; restore a backup into a new database, compare row counts and selected message bytes. See `REPORT.md` for actual results; planned experiments are not evidence.
+36
View File
@@ -0,0 +1,36 @@
# k3s and Pingap migration
Completed implementation specification. Native source, acceptance, measurements and reports are complete. Final ZIP verification and file hashes are recorded separately by the parent delivery workflow in DELIVERY.json.
Approved by the owner: replace the lab3 and lab4 runtime with k3s + Pingap, following the azur-games ingress pattern. Keep the existing Compose path until equivalent acceptance passes. Preserve original public contracts, tests and assignment files. No external publication or submission is authorized.
Use a separate single-server k3d cluster per lab on the test host, with an explicit private kubeconfig and context. Kubernetes resources and Pingap TOML live in git; generated synthetic credentials remain outside git and enter Kubernetes Secrets through stdin. This is a disposable coursework stand, not a multi-host HA cluster. No changes to the azur-games cluster are required.
Pingap is a Deployment behind a LoadBalancer Service. API uses a headless Service, DNS discovery and readiness. PostgreSQL, Valkey and lab4 RustFS use PVCs and private Services. Migrations and S3 bootstrap are bounded Jobs. User data stays outside API pods. Local k3d uses the already installed k3s image; image digests are pinned.
## Acceptance cases before implementation
| Situation | Example | Expected result | Level |
| --- | --- | --- | --- |
| Wrong target | foreign cluster/context, missing receipt, malformed name | reject before mutation | helper unit |
| Startup | new isolated cluster and empty volumes | migrations, dependencies, API and Pingap ready | integration |
| Discovery | two API pods, scale 1/2/4 | distinct real pod IDs, DNS updates | HTTP integration |
| API failure | delete the actual serving pod | surviving API serves within public test deadline, no duplicates | e2e |
| Rolling replacement | restart API Deployment during writes | readiness, continuing writes, measured errors | e2e |
| Persistence | restart API, PostgreSQL, Valkey, Pingap and S3 | old session, messages and original bytes survive | e2e |
| Private S3 | anonymous object read, unrelated bucket creation | denied | integration |
| Partial upload | S3 or SQL error after write | existing reconciliation guarantees preserved | isolated integration |
| Resource limits | fixed and growing API budget, pool ABBA | verify actual requests/limits and collect new measurements | experiment |
| Memory | ten uploads and extreme PNG decoder | bounded rejection and measured memory | experiment |
Failures include unavailable DNS/API/store, wrong namespace, unclaimed cluster, failed Jobs, stale readiness, rollout timeout and cleanup failure. Never turn a failed inventory read into permission to create or remove a cluster. Existing HAProxy evidence remains explicitly historical and is not relabeled as Pingap evidence.
## Progress
- [x] Runtime and guarded operational helpers; native image inventory, scoped stdin, Pod UID ownership and cleanup guards verified.
- [x] Equivalent public and student acceptance for lab3 and lab4. Smoke, full persistence, both failover scenarios and lab4 isolated reconciliation passed. Final HTTP acceptance passed409/457 assertions; SQL stdin and replaced original Pod UIDs verified.
- [x] New measurements and reports:16 lab3 samples plus a30-second rollout, ten concurrent image uploads and the extreme PNG/Adam7 memory Job. Game guards returned exactly1. Historical Compose numbers stay separate.
- [x] Independent runtime review and verified source sync:89 lab3 and115 lab4 source files match the remote checked copy.
- [x] Final native source and reports prepared for clean local commits and archive generation. CRC and complete byte-equality receipts are maintained separately in the parent DELIVERY.json.
Independent read-only runtime/model/experiment-helper review found no remaining confirmed P1/P2. All84 unit cases and read-only Biome formatting/lint passed. Checked native source hashes are retained with the evidence. Independent review also verified the new measurements/report, including the negative pool result and the41.04% p95 reduction at4→2 API with equal total limits.
+16
View File
@@ -0,0 +1,16 @@
# Closure review: VP laboratories 2–4
Проверено независимым агентом 12.11.2026. Объём — закрытие ранее найденных P1/P2 в текущих исходниках и operational helpers; полного повторного аудита не проводилось.
**Подтверждённых оставшихся ошибок в проверенном объёме не обнаружено.**
- Compose wrappers закрепляют файл и проект через явные `-f`/`-p`; research lab3 и reconciliation используют отдельные случайные проекты.
- Reconciliation runner создаёт отдельные volumes, а destructive integration дополнительно требует пустые DB/bucket. Штатный профиль включает reconciliation, S3 metadata и foreign-membership regression.
- Fixture cleanup проверяет чужое членство и подтверждает SQL COMMIT до удаления S3-оригиналов. Отказ SQL сохраняет байты.
- Game guards разрешают измерения только при exit status `1`; активная игра и неизвестное состояние блокируют запуск.
- Evidence сохраняется в отдельных каталогах запуска; итоговый PASS появляется после cleanup. Основная ошибка и ошибки уборки учитываются отдельно.
- Monitor имеет немедленный rejection handler и завершается до cleanup. Rolling workload joined при отказе; замены проверяют readiness, продолжающиеся успешные записи и незавершённость нагрузки.
- JSON middleware отвергает некорректный UTF-8 до декодирования; regression присутствует во всех трёх лабораторных.
- В прочитанных acceptance2/3 уже используются `$fixture$` и PASS после cleanup. Их новое выполнение в это ревью не входило.
Проверка выполнена чтением кода, текущего плана и diff. Стенды, тесты, сборки и измерительные helpers не запускались; результаты автора повторно не подтверждались. Секреты и `.local` не читались. Единственное изменение ревьюера — этот файл.
+89
View File
@@ -0,0 +1,89 @@
14b7f3ced177639c80c8c9b113bef7d4783940b628f14d8bb6fc634eaa3d19e0 .dockerignore
a45d7932ef14130aff8020bce79f043cccaf9692d697088a754d309a03f7d3e8 .github/workflows/contracts.yml
b85d1e62d1f6d9c478cd1ce31c123c31c09a9c8b0565cf236f39a928a20a640b .gitignore
314ecc42f648282ee0f8b758027f3bf8c1860679e388a1574ed88b07b70c400b Dockerfile
c05bd07058ae0949dd4905afdae7674bc7e3e63863a6cdf8b72661140d445826 Makefile
215578dee14bcef1b66759a68543083e0a624611efcdb785197307b50cb7725d backend/.golangci.yaml
d2a2661065473760696623b2bdfb93313c668f19130993c880bccf26d17c6912 backend/cmd/app/main.go
90459ce1de93d68af72228f24601279d33fe2384bebe5ada57a5bd15b28dd7dd backend/codegen.yaml
33044d905354f24fff194fefd35ee9327d63d6e5062ded8496e518b6ce38dbea backend/db/migrate.go
057db27dac8043c3142c9530f2e699f312161813dfe829f043915ee7c7e0f08e backend/db/migrations/00001_core.sql
97c98785547db8391c1fa0a685e4d4bcc810b8f79055c0e2fc6ef473cd38b37b backend/db/migrations/00002_idempotency.sql
bd945de5a2ad6d762e959888be4907d0927df524d535c9b5f4a80672f9e921fb backend/db/sqlc/queries/core.sql
391f1ff0f354471949037426935a12e77024467236b69012e9c4f733ed3aa606 backend/db/sqlc/queries/idempotency.sql
803b161e063692398c93152b11a08f9e42e1bf3c72a1e64553b82c494545fd10 backend/db/sqlc/sqlc.yaml
62e951c7ddec4b5d1a4b643522ac4ecc25baba71ac71c8d3c3c65c9fd5bb47f5 backend/go.mod
c80befc84323b33479f9ea9116d68ab1e3874597642ce0359c9dfe4733a568d9 backend/go.sum
3508f04c2fbab10a346e1bb70574875ec39d4e45e7fa637299b65477ea439efe backend/internal/adapter/handler/api.gen.go
1e1e911d81ed2ca7703923909aae1362adceb0a39cb5be1105fb8cd60f03a974 backend/internal/adapter/handler/api.go
183217c9d66dcfb08d3da92fda01df509484bd3146b36587d84e37fbda5f3b4b backend/internal/adapter/handler/auth.go
343035190d2e13beaeafd904a54e6f62226dc7d92bd6ae78c1b8bd39d42f60b0 backend/internal/adapter/handler/errors.go
b662058ebc59010f30d21da12404837aa2329fe5e5590761efdd9140c1d24e9c backend/internal/adapter/handler/gate.go
f7938bdeb5617ed3611303c54818000de9861dde5915fa2c6fa0f74e1fa33268 backend/internal/adapter/handler/gate_test.go
f1961eebd1c3b21cdcf4af67be7882da47c85aaba969cc0d8eca73844a26a342 backend/internal/adapter/handler/handler.go
964aee4c74d75f1249d2e15d10a4fcbfe0b8b7e4a02a41474911d12ec163bd0c backend/internal/adapter/handler/json.go
22ea82d94edd6272c6c1c2a221b999f29d6f58a4946877470be03342f9073e36 backend/internal/adapter/handler/middleware.go
5cd375e5a0db8cc3596293d323e635b86fef22d8ec680f310ab5a460f8176f64 backend/internal/adapter/handler/stats.go
eac6a14b5f3b0ea9aa5329337afc6db27e17f5c17999874da9ce3592dc7a4205 backend/internal/adapter/handler/utf8_test.go
94643bf4b61ca390f8dd56a241e02e1325a994fc40887ffa0e2b8f8e5aebb4c7 backend/internal/adapter/password/argon.go
513a218e594616b5c594cca27bf1652d5321b0d567402303e1e103a19bbb63d8 backend/internal/adapter/repository/postgres/queries/core.sql.go
4863732830879d4162be215ff245375b953359de23bcd821ed7abc5c32a36c0f backend/internal/adapter/repository/postgres/queries/db.go
d231780de17bb3d5ca1a769eb817d7c555d576fa815c5245a0ec6ee90c3f28ce backend/internal/adapter/repository/postgres/queries/idempotency.sql.go
c0db6538d3509079b15218e6493652be501841a7d5560454754dbff6a2789c51 backend/internal/adapter/repository/postgres/queries/models.go
bd70d2954ed260b96d3b9200b56dbbf96dea0d985eec336aa690ff860b766857 backend/internal/adapter/repository/postgres/repository.go
93802954db2c8eda3782acc71bca817947fd556986d3f6552c78c4b346d988ca backend/internal/application/usecase/auth.go
5e999c10089bd5148f8e5a897c38cd1c3299ebd5bd598a6f58bd168d8e51cc96 backend/internal/application/usecase/messenger.go
58795b18980c4dd938c73721ab937d06410af94edc156b7a7aa9b2c4c2388238 backend/internal/config/config.go
390e3b5a4682719a0b25a8eb9aefeda9a9d1c774d3f8d1f08062c79a58d8859a backend/internal/config/config_test.go
3f7454f48ef442c277fd2741ce5aeeccf03d590bd2d31b9b89fa39f0ba05de7f backend/internal/domain/model/chat.go
bd55666ad90ecaba3b0a1496ba5499580c0c67446284ce0b83e4dd7633cecbae backend/internal/domain/model/errors.go
f129b9822b9136bed8c0e02d96437e3c5085eda69847ade2ffcb1f82697121f4 backend/internal/domain/model/message.go
77bb8767ac1352bd3551e724eaaeaad4fe93eae248cc8c3008ee8b1c08adddca backend/internal/domain/model/model_test.go
cd6a07579bff01aa0d8a11b34fd000a804142b321cef302d386bdb95e9c7f953 backend/internal/domain/model/page.go
8c245eef99a97261daf0aa16fec9edd7bcd3253ec4144c50b4f8e56e45e2186e backend/internal/domain/model/postgres_text_test.go
c9410cacd9d1b2fd7f3f2cb7e4112e637ecc494f6e4b6da649f936ce0c9a0457 backend/internal/domain/model/text.go
c20c8b8d8a9c0327a3a24afd74f3051d78caed1d2f0851baf340ef61ac502a92 backend/internal/domain/model/user.go
465c1a1f19075b6f8301eef8dbd7fd9a8d20255716d72c97e946db04c2850dda backend/internal/domain/port/auth.go
4402ef91f87910199103f059b654d362106059a4f0ee89e9cadfe7e6d49fa0ee backend/internal/domain/repository/repository.go
d839f31015eee692065c31d2538a4cb4c841b0d89e690f0ab8baf80168510556 backend/pkg/logger/logger.go
3ce957e4e45a94453610217007a9dbf0e8b9723346ff9cc8a3e5aa8ff3676527 backend/pkg/server/server.go
41522570e101e67a4889e9bfd290027f363831781d4ce401874d771ec116fef6 compose.example.yaml
fc7ee75e5625d673dd9f72df9b67788353affb15384734243cb85ee72ce1cd8d compose.yaml
9aa30d231d71b762dbd8f5e42a8d19a6cabe3375f0fdf26bc5843b965dfa947b config/haproxy.cfg
0a71cec72903af556df85f939c7e347fc73a86a1a4ffc39fb9c8ded169b7df45 contracts/examples.json
99320becab20381c3d31983336dd4e0aef4bca992d672538f049b6684714a577 contracts/infrastructure.json
9c3787e5d08a60c59ae67eeb429e9d75fbf134992a4e1f0954e926db49e111be contracts/openapi.json
b83ce35e84323244b9d22e175d9c4c0f25c9a1ce1f932c36ecf30f0ba8dddad9 deploy/k3s/api.yaml
3c9479510ac6116d196fab0f3116a3145ef2377a8e04b7f936994c18113c69a9 deploy/k3s/kustomization.yaml
e1d475e64e0092e5c92c6ace235c70b92cd2b42b83a420e2edf880a3fb50b8b8 deploy/k3s/namespace.yaml
e436503ba6893e1f5fe0f1819471d5be2612d07b66790277293ef7e4ed7041d6 deploy/k3s/pingap.toml
2542ef86087c55961f8d66ac70f8d9f616211b95d67d44e9fba8a4d700e53e16 deploy/k3s/pingap.yaml
6dff977e5f1541e4713967844474a43c2150117a3ea666f737c788b6e7c234ee deploy/k3s/stores.yaml
bddb95ebba97431ee956256e677b0724485d571d54438aca07d54df72227098d examples/requests.http
acf873f5132bbd0af78dc878852baeb49dbfa026c072932f8bd70b958114e938 lab.json
4cefdb67007caf026d1613be7c519c01b4c8343db7c4f4b618677e01cf113525 requirements-dev.txt
01ea196f3a6db22c501209d7496bc774b4b04687fd5f30850acd863545852466 scripts/bootstrap.ts
7c4402c2a6ab80d3b4676e1866d6ecc87b6daea14c080bcb9be9a7e8b959d671 scripts/check_contract.py
a25717fd601ee8359a0c4b58f3f7e10f38dfcf875b96ed8707c314ceadc9e41e scripts/compose.sh
35a7507a45f2672095ae7a31a2e347421f16a81e78a76ccd4bf2c8e149dddb14 scripts/k3s-model.ts
4951d81ca55099c7459106392bccc72fdaeeb090bc85bc38e01b42425bbba77d scripts/k3s.ts
f9eaabbb88f14a49fdd8bd09de18de6959eefae9fb935a661afc0d500ef47a8c scripts/kube.sh
0328246ba75defbced992104e986fde973f63e3830d83251eced5953263e944b scripts/restart.example.sh
76af791797a37549b64446687484eab58c3825926a0fee9bc6d1375cdf024b07 scripts/restart.sh
1bcf34394520b89d95b7605ec56675be799eea920e83cfbba306d5dc0a6d9811 scripts/stop-one.example.sh
623ec85f2918c814dd7c12de14fe06c89bd9277afb60b431e59356aa45e6c876 scripts/stop-one.sh
63b69b19641e8f9e27a9b159bf8c67c612e3476193c17e93541ca6cfd48ff2fd scripts/up.sh
4e981acbfc10dac58817bf922d5896e996798551fedc1b2385130e1cddb13d54 scripts/validate_openapi.py
b77f4aa20f58ca84f0be5c3e3d83d9f84e6fd85eabf0992f33c7918c2bfdde74 student-tests/acceptance.ts
4693f4d130bdaa88fe5d61258b55f56844c7d67ee72b819ef4997b80d852cb95 student-tests/k3s-model.test.ts
41849faeeb5ea371eb56f0dc500f658ab46d142451727816501bb134b4b6e31e student-tests/kube-stdin.ts
1a69e392a1b0fc28869cc45c564225fe5e8cb8a784cf0a6ac1cbf3335c521205 student-tests/plot_research.py
de950d3b75e4ad1a760c121533e06390c84574f7dd0b53c0eaa742ab6d5c2f38 student-tests/requirements-plots.txt
2baadbdff936f4606a759cbfbae972eb2043e43e2081873d03f508b9bb7fd111 student-tests/research-compose.ts
daad32606eda2d00405881b1d04147e369ec4926e36191906d3a23d5bd36adbf student-tests/research.ts
7de6e4f405cb165f56e48f40889adc5ff39c9a8ec253de48e5633a0d961d960a student-tests/restart-evidence.ts
9dff91ee5a9876d5c4758d66a65b3b42c29a6d3071c7e510babae561a84cf35b student-tests/wait.ts
8d50976fc7c7bbb81e88a152f613c61ab25eaf53dba33c6a9dfab19f868d546d tests/client.py
6d3511ea719c7a7e841083e73d435c86dcbfd9f4e5c2a07d62eb9614b01d9933 tests/load.py
1f96663a174b3978d24eff66f2741f5f8c9b788d3242261d37a972720c52788b tests/resilience.py
52ac38eb343ff7d43e7543588e1da58ca06c9fce74b2b0d0bf0e4982bc23c1db tests/smoke.py
+1
View File
@@ -0,0 +1 @@
PASS lab3: 408 HTTP assertions, registration race, rollback, pagination, authentication, concurrent idempotency and replica sharing; fixture cleanup completed
+131
View File
@@ -0,0 +1,131 @@
#1 [internal] load local bake definitions
#1 reading from stdin 1.04kB done
#1 DONE 0.0s
#2 [migrate internal] load build definition from Dockerfile
#2 transferring dockerfile: 1.78kB 0.0s done
#2 DONE 0.1s
#3 [api] resolve image config for docker-image://docker.io/docker/dockerfile:1
#3 DONE 1.0s
#4 [api] docker-image://docker.io/docker/dockerfile:1@sha256:4edf897a3ffa55b89f906fc8cc78afdb3f1834cc9c7083565e611a8a7d5fe99e
#4 resolve docker.io/docker/dockerfile:1@sha256:4edf897a3ffa55b89f906fc8cc78afdb3f1834cc9c7083565e611a8a7d5fe99e
#4 resolve docker.io/docker/dockerfile:1@sha256:4edf897a3ffa55b89f906fc8cc78afdb3f1834cc9c7083565e611a8a7d5fe99e 0.3s done
#4 resolve docker.io/docker/dockerfile:1@sha256:4edf897a3ffa55b89f906fc8cc78afdb3f1834cc9c7083565e611a8a7d5fe99e 0.3s done
#4 CACHED
#5 [api internal] load metadata for gcr.io/distroless/static-debian13:nonroot@sha256:e2e927ec666bae08560abb3c55d0659eceabb657f56b6782ab500a9fc7f555e3
#5 ...
#6 [api internal] load metadata for docker.io/library/golang:1.27.2-alpine@sha256:f92b6ef800e499660581efdabdf25d9d817a9d124eaf900924f0504e7e27e12d
#6 DONE 0.4s
#5 [migrate internal] load metadata for gcr.io/distroless/static-debian13:nonroot@sha256:e2e927ec666bae08560abb3c55d0659eceabb657f56b6782ab500a9fc7f555e3
#5 DONE 31.2s
#7 [api internal] load .dockerignore
#7 transferring context: 226B 0.0s done
#7 DONE 0.1s
#8 [api internal] load build context
#8 DONE 0.0s
#9 [api stage-1 1/2] FROM gcr.io/distroless/static-debian13:nonroot@sha256:e2e927ec666bae08560abb3c55d0659eceabb657f56b6782ab500a9fc7f555e3
#9 resolve gcr.io/distroless/static-debian13:nonroot@sha256:e2e927ec666bae08560abb3c55d0659eceabb657f56b6782ab500a9fc7f555e3
#9 ...
#8 [migrate internal] load build context
#8 DONE 0.0s
#9 [migrate stage-1 1/2] FROM gcr.io/distroless/static-debian13:nonroot@sha256:e2e927ec666bae08560abb3c55d0659eceabb657f56b6782ab500a9fc7f555e3
#9 ...
#10 [api build 1/4] FROM docker.io/library/golang:1.27.2-alpine@sha256:f92b6ef800e499660581efdabdf25d9d817a9d124eaf900924f0504e7e27e12d
#10 resolve docker.io/library/golang:1.27.2-alpine@sha256:f92b6ef800e499660581efdabdf25d9d817a9d124eaf900924f0504e7e27e12d 0.4s done
#10 DONE 0.6s
#8 [api internal] load build context
#8 ...
#9 [migrate stage-1 1/2] FROM gcr.io/distroless/static-debian13:nonroot@sha256:e2e927ec666bae08560abb3c55d0659eceabb657f56b6782ab500a9fc7f555e3
#9 resolve gcr.io/distroless/static-debian13:nonroot@sha256:e2e927ec666bae08560abb3c55d0659eceabb657f56b6782ab500a9fc7f555e3 0.8s done
#9 DONE 0.9s
#8 [migrate internal] load build context
#8 transferring context: 131.27kB 0.2s done
#8 DONE 0.4s
#11 [api build 2/4] WORKDIR /src
#11 CACHED
#12 [api build 3/4] COPY backend/ ./
#12 DONE 0.9s
#13 [migrate build 4/4] RUN --mount=type=cache,target=/go/pkg/mod --mount=type=cache,target=/root/.cache/go-build go build -trimpath -ldflags='-s -w' -o /out/messenger ./cmd/app
#13 DONE 5.5s
#9 [api stage-1 1/2] FROM gcr.io/distroless/static-debian13:nonroot@sha256:e2e927ec666bae08560abb3c55d0659eceabb657f56b6782ab500a9fc7f555e3
#9 CACHED
#14 [api stage-1 2/2] COPY --from=build /out/messenger /messenger
#14 DONE 0.9s
#15 [api] exporting to image
#15 exporting layers
#15 exporting layers 1.4s done
#15 exporting manifest sha256:15b116d2b7ca5f2bb46513f70348161a0ad4efa6e57d1fbe5c994c7e2a19d68e
#15 exporting manifest sha256:15b116d2b7ca5f2bb46513f70348161a0ad4efa6e57d1fbe5c994c7e2a19d68e 0.5s done
#15 exporting config sha256:4b32867dcf2a904b9f1e0d29badb554945a643fc8b901f7d60eac9d81d5b5ced
#15 exporting config sha256:4b32867dcf2a904b9f1e0d29badb554945a643fc8b901f7d60eac9d81d5b5ced 0.5s done
#15 exporting attestation manifest sha256:36d1d100f23547fb93e2309f401b5c3d9fa182ebdba8172d59f654ca7aa15128
#15 exporting attestation manifest sha256:36d1d100f23547fb93e2309f401b5c3d9fa182ebdba8172d59f654ca7aa15128 0.7s done
#15 exporting manifest list sha256:7369359f8b08120b4fd2362f1ecf9dccfbf29f16368c09276784885821d60435
#15 exporting manifest list sha256:7369359f8b08120b4fd2362f1ecf9dccfbf29f16368c09276784885821d60435 0.3s done
#15 naming to docker.io/library/vp-medvedev-lab3:local
#15 naming to docker.io/library/vp-medvedev-lab3:local 0.2s done
#15 unpacking to docker.io/library/vp-medvedev-lab3:local
#15 unpacking to docker.io/library/vp-medvedev-lab3:local 0.6s done
#15 DONE 4.8s
#16 [migrate] exporting to image
#16 exporting layers 1.5s done
#16 exporting manifest sha256:0e735ec53a79c2cb5548e8bdb817740db6bbc2a61fd0c7e075b8f92eb42f8238 0.5s done
#16 exporting config sha256:f5c109fca6293d29084533cef4de6019a155cc684d5fdf0ec22d8aa27cd52e65 0.9s done
#16 exporting attestation manifest sha256:cb41ed80e30febbf0628a2ee0a137696fb271e0819a88a58881d39f23c90f315 0.5s done
#16 exporting manifest list sha256:690d1703ce0e0b391479b6006853144d1a895e58bc2d7490c5dca31a0bf67916 0.4s done
#16 naming to docker.io/library/vp-medvedev-lab3:local 0.1s done
#16 unpacking to docker.io/library/vp-medvedev-lab3:local 0.4s done
#16 DONE 4.9s
#17 [api] resolving provenance for metadata file
#17 DONE 0.0s
#18 [migrate] resolving provenance for metadata file
#18 DONE 0.0s
Image vp-medvedev-lab3:local Building
Image vp-medvedev-lab3:local Building
Image vp-medvedev-lab3:local Built
Image vp-medvedev-lab3:local Built
Container vp-lab3-medvedev-valkey-1 Running
Container vp-lab3-medvedev-postgres-1 Running
Container vp-lab3-medvedev-migrate-1 Recreate
Container vp-lab3-medvedev-migrate-1 Recreated
Container vp-lab3-medvedev-api-2 Recreate
Container vp-lab3-medvedev-api-1 Recreate
Container vp-lab3-medvedev-api-1 Recreated
Container vp-lab3-medvedev-api-2 Recreated
Container vp-lab3-medvedev-lb-1 Recreate
Container vp-lab3-medvedev-lb-1 Recreated
Container vp-lab3-medvedev-postgres-1 Waiting
Container vp-lab3-medvedev-postgres-1 Healthy
Container vp-lab3-medvedev-migrate-1 Starting
Container vp-lab3-medvedev-migrate-1 Started
Container vp-lab3-medvedev-migrate-1 Waiting
Container vp-lab3-medvedev-migrate-1 Exited
Container vp-lab3-medvedev-api-1 Starting
Container vp-lab3-medvedev-api-1 Started
Container vp-lab3-medvedev-api-2 Starting
Container vp-lab3-medvedev-api-2 Started
Container vp-lab3-medvedev-lb-1 Starting
Container vp-lab3-medvedev-lb-1 Started
+2
View File
@@ -0,0 +1,2 @@
/mnt/data/home/bench-saves/vp-labs-vuIKezo9/lab3/.venv/bin/python scripts/check_contract.py
PASS: offline skeleton structure, local refs and Python syntax; application NOT tested.
View File
+4
View File
@@ -0,0 +1,4 @@
python3 tests/resilience.py --mode failover --action-script "scripts/stop-one.sh" --base-url "http://127.0.0.1:28203"
Executing explicit failover hook; hook output suppressed to avoid leaking secrets.
{"observed_instances_before": 2, "successful_writes": 128, "failed_attempts": 1, "first_recovery_seconds": 1.468}
PASS: failover preserved confirmed data and existing session. Hook scope needs operator evidence.
+4
View File
@@ -0,0 +1,4 @@
python3 tests/resilience.py --mode failover --action-script "scripts/stop-one.sh" --base-url "http://127.0.0.1:28203"
Executing explicit failover hook; hook output suppressed to avoid leaking secrets.
{"observed_instances_before": 2, "successful_writes": 127, "failed_attempts": 1, "first_recovery_seconds": 1.484}
PASS: failover preserved confirmed data and existing session. Hook scope needs operator evidence.
View File
+13
View File
@@ -0,0 +1,13 @@
? backend/cmd/app [no test files]
? backend/db [no test files]
ok backend/internal/adapter/handler 1.040s
? backend/internal/adapter/password [no test files]
? backend/internal/adapter/repository/postgres [no test files]
? backend/internal/adapter/repository/postgres/queries [no test files]
? backend/internal/application/usecase [no test files]
ok backend/internal/config 1.018s
ok backend/internal/domain/model 1.014s
? backend/internal/domain/port [no test files]
? backend/internal/domain/repository [no test files]
? backend/pkg/logger [no test files]
? backend/pkg/server [no test files]
+15
View File
@@ -0,0 +1,15 @@
# Independent runtime review
Scope: approved lab3/lab4 k3s + Pingap migration, scripts/k3s.ts, scripts/k3s-model.ts, new unit tests and native research/concurrent-images/reconciliation call sites. Reviewer: independent agent /root/lab1_review, read-only. Backend and original course contracts were outside the implementation diff.
No confirmed remaining P1/P2 findings in the reviewed scope. Confirmed prior findings were corrected: Pingap shutdown grace, pinned manifest/config identities, scoped kubectl arguments, game guard at the native memory Job, partial-claim ownership and native CRI verification of stopped Pod processes.
Closure review checked withCleanup preserving primary and teardown errors, ready waiting for managed terminating Pods, restart pairing evidence by run_id and rejecting reused original UIDs, and the lab4 hard2048MiB/soft1536MiB image budget. Runtime/model copies in both labs matched. Reviewer ran no live operations or tests; author test output is separate.
Live tests are author evidence, separate from read-only review. Archive validation, teacher acceptance and an awarded grade are not inferred from this review.
Follow-up review checked the lab4 outage test timeout: no assignment/contract/public test requires8seconds for upload dependency failure. The handler budgets20seconds and the student client now waits at most25seconds, still requiring HTTP502/503 and a complete response. Public failover deadlines remain unchanged. Both acceptance helpers annotate their current operation and preserve the original error as cause. No blocker found; reviewer performed no live test.
Final measurement/report review checked all16 samples in research/run-R4F28Q, rolling/replacement evidence, plots and ChargeMessage SQL. Means, ranges, errors, memory and PostgreSQL observations agree with REPORT.md. Both two-API p95 results are below both four-API results at equal total budget; mean reduction41.04%. The negative pool experiment and overlapping throughput ranges are reported explicitly. Rolling2725success/0errors replaced both original UIDs. No material blocker found. A minor wording issue was corrected: scaling.svg displays ranges; pool.svg displays means only. No remote operations or test reruns were performed by the reviewer.
The earlier JSON-aggregate parse failure was captured as RED. The runner now emits jsonb::text and preserves failureStage before cleanup; the complete native study is its successful boundary check.
+2
View File
@@ -0,0 +1,2 @@
Running as unit: run-p1580581-i1556111.scope; invocation ID: fe2791c13cde49c083165d2cbfdecc25
PASS lab3: 409 HTTP assertions, registration race, rollback, pagination, authentication, concurrent idempotency and replica sharing; fixture cleanup completed
+4
View File
@@ -0,0 +1,4 @@
.venv/bin/python scripts/check_contract.py
PASS: offline skeleton structure, local refs and Python syntax; application NOT tested.
.venv/bin/python scripts/validate_openapi.py
PASS: full OpenAPI 3.1 and JSON Schema validation; application NOT tested.
+4
View File
@@ -0,0 +1,4 @@
python3 tests/resilience.py --mode failover --action-script "scripts/stop-one.sh" --base-url "http://127.0.0.1:28203"
Executing explicit failover hook; hook output suppressed to avoid leaking secrets.
{"observed_instances_before": 2, "successful_writes": 79, "failed_attempts": 34, "first_recovery_seconds": 1.491}
PASS: failover preserved confirmed data and existing session. Hook scope needs operator evidence.
+4
View File
@@ -0,0 +1,4 @@
python3 tests/resilience.py --mode failover --action-script "scripts/stop-one.sh" --base-url "http://127.0.0.1:28203"
Executing explicit failover hook; hook output suppressed to avoid leaking secrets.
{"observed_instances_before": 2, "successful_writes": 89, "failed_attempts": 36, "first_recovery_seconds": 1.649}
PASS: failover preserved confirmed data and existing session. Hook scope needs operator evidence.
+5
View File
@@ -0,0 +1,5 @@
Running as unit: run-p1577904-i1587070.scope; invocation ID: a976c46b972045998b6eeb2aff8218cb
python3 tests/resilience.py --mode failover --action-script "scripts/stop-one.sh" --base-url "http://127.0.0.1:28203"
Executing explicit failover hook; hook output suppressed to avoid leaking secrets.
{"observed_instances_before": 2, "successful_writes": 132, "failed_attempts": 1, "first_recovery_seconds": 1.478}
PASS: failover preserved confirmed data and existing session. Hook scope needs operator evidence.
+3
View File
@@ -0,0 +1,3 @@
python3 tests/resilience.py --mode persistence --action-script "scripts/restart.sh" --base-url "http://127.0.0.1:28203"
Executing explicit persistence hook; hook output suppressed to avoid leaking secrets.
PASS: persistence preserved confirmed data and existing session. Hook scope needs operator evidence.
+1
View File
@@ -0,0 +1 @@
{"stage":"stand_destroy","primary":"JSON Parse error: Unexpected EOF","cleanup_errors":[]}
@@ -0,0 +1,17 @@
{
"lab": 3,
"workload": "closed-loop POST messages; no automatic retries",
"requested_duration_seconds": 5.0,
"elapsed_seconds": 5.143,
"concurrency": 16,
"successful_requests": 604,
"failed_requests": 0,
"error_ratio": 0.0,
"successful_rps": 117.433,
"successful_latency_ms": {
"p50": 133.477,
"p95": 175.258,
"p99": 200.33
},
"note": "Latency percentiles cover successes only. Timeouts/errors are counted separately; closed-loop has coordinated omission and client overhead."
}
@@ -0,0 +1,17 @@
{
"lab": 3,
"workload": "closed-loop POST messages; no automatic retries",
"requested_duration_seconds": 5.0,
"elapsed_seconds": 5.168,
"concurrency": 16,
"successful_requests": 603,
"failed_requests": 0,
"error_ratio": 0.0,
"successful_rps": 116.672,
"successful_latency_ms": {
"p50": 133.488,
"p95": 175.326,
"p99": 208.589
},
"note": "Latency percentiles cover successes only. Timeouts/errors are counted separately; closed-loop has coordinated omission and client overhead."
}
@@ -0,0 +1,17 @@
{
"lab": 3,
"workload": "closed-loop POST messages; no automatic retries",
"requested_duration_seconds": 5.0,
"elapsed_seconds": 5.161,
"concurrency": 16,
"successful_requests": 602,
"failed_requests": 0,
"error_ratio": 0.0,
"successful_rps": 116.648,
"successful_latency_ms": {
"p50": 133.599,
"p95": 267.099,
"p99": 342.13
},
"note": "Latency percentiles cover successes only. Timeouts/errors are counted separately; closed-loop has coordinated omission and client overhead."
}
@@ -0,0 +1,17 @@
{
"lab": 3,
"workload": "closed-loop POST messages; no automatic retries",
"requested_duration_seconds": 5.0,
"elapsed_seconds": 5.145,
"concurrency": 16,
"successful_requests": 588,
"failed_requests": 0,
"error_ratio": 0.0,
"successful_rps": 114.289,
"successful_latency_ms": {
"p50": 133.497,
"p95": 283.707,
"p99": 385.774
},
"note": "Latency percentiles cover successes only. Timeouts/errors are counted separately; closed-loop has coordinated omission and client overhead."
}
@@ -0,0 +1,17 @@
{
"lab": 3,
"workload": "closed-loop POST messages; no automatic retries",
"requested_duration_seconds": 5.0,
"elapsed_seconds": 5.148,
"concurrency": 16,
"successful_requests": 398,
"failed_requests": 0,
"error_ratio": 0.0,
"successful_rps": 77.308,
"successful_latency_ms": {
"p50": 141.704,
"p95": 592.047,
"p99": 1542.862
},
"note": "Latency percentiles cover successes only. Timeouts/errors are counted separately; closed-loop has coordinated omission and client overhead."
}
@@ -0,0 +1,17 @@
{
"lab": 3,
"workload": "closed-loop POST messages; no automatic retries",
"requested_duration_seconds": 5.0,
"elapsed_seconds": 5.15,
"concurrency": 16,
"successful_requests": 612,
"failed_requests": 0,
"error_ratio": 0.0,
"successful_rps": 118.843,
"successful_latency_ms": {
"p50": 100.356,
"p95": 342.111,
"p99": 509.063
},
"note": "Latency percentiles cover successes only. Timeouts/errors are counted separately; closed-loop has coordinated omission and client overhead."
}
@@ -0,0 +1,17 @@
{
"lab": 3,
"workload": "closed-loop POST messages; no automatic retries",
"requested_duration_seconds": 5.0,
"elapsed_seconds": 5.14,
"concurrency": 16,
"successful_requests": 609,
"failed_requests": 0,
"error_ratio": 0.0,
"successful_rps": 118.487,
"successful_latency_ms": {
"p50": 125.236,
"p95": 166.837,
"p99": 191.916
},
"note": "Latency percentiles cover successes only. Timeouts/errors are counted separately; closed-loop has coordinated omission and client overhead."
}
@@ -0,0 +1,17 @@
{
"lab": 3,
"workload": "closed-loop POST messages; no automatic retries",
"requested_duration_seconds": 5.0,
"elapsed_seconds": 5.141,
"concurrency": 16,
"successful_requests": 592,
"failed_requests": 0,
"error_ratio": 0.0,
"successful_rps": 115.144,
"successful_latency_ms": {
"p50": 133.487,
"p95": 175.153,
"p99": 209.005
},
"note": "Latency percentiles cover successes only. Timeouts/errors are counted separately; closed-loop has coordinated omission and client overhead."
}
@@ -0,0 +1,17 @@
{
"lab": 3,
"workload": "closed-loop POST messages; no automatic retries",
"requested_duration_seconds": 5.0,
"elapsed_seconds": 5.141,
"concurrency": 16,
"successful_requests": 602,
"failed_requests": 0,
"error_ratio": 0.0,
"successful_rps": 117.087,
"successful_latency_ms": {
"p50": 133.446,
"p95": 242.025,
"p99": 300.401
},
"note": "Latency percentiles cover successes only. Timeouts/errors are counted separately; closed-loop has coordinated omission and client overhead."
}
@@ -0,0 +1,17 @@
{
"lab": 3,
"workload": "closed-loop POST messages; no automatic retries",
"requested_duration_seconds": 5.0,
"elapsed_seconds": 5.206,
"concurrency": 16,
"successful_requests": 483,
"failed_requests": 0,
"error_ratio": 0.0,
"successful_rps": 92.784,
"successful_latency_ms": {
"p50": 150.206,
"p95": 416.852,
"p99": 758.495
},
"note": "Latency percentiles cover successes only. Timeouts/errors are counted separately; closed-loop has coordinated omission and client overhead."
}
@@ -0,0 +1,17 @@
{
"lab": 3,
"workload": "closed-loop POST messages; no automatic retries",
"requested_duration_seconds": 5.0,
"elapsed_seconds": 5.149,
"concurrency": 16,
"successful_requests": 587,
"failed_requests": 0,
"error_ratio": 0.0,
"successful_rps": 113.996,
"successful_latency_ms": {
"p50": 108.526,
"p95": 341.859,
"p99": 509.083
},
"note": "Latency percentiles cover successes only. Timeouts/errors are counted separately; closed-loop has coordinated omission and client overhead."
}
@@ -0,0 +1,17 @@
{
"lab": 3,
"workload": "closed-loop POST messages; no automatic retries",
"requested_duration_seconds": 5.0,
"elapsed_seconds": 5.151,
"concurrency": 16,
"successful_requests": 609,
"failed_requests": 0,
"error_ratio": 0.0,
"successful_rps": 118.235,
"successful_latency_ms": {
"p50": 108.462,
"p95": 333.75,
"p99": 458.974
},
"note": "Latency percentiles cover successes only. Timeouts/errors are counted separately; closed-loop has coordinated omission and client overhead."
}
@@ -0,0 +1,30 @@
[
{
"field": "CPU(s):",
"data": "16"
},
{
"field": "On-line CPU(s) list:",
"data": "0-15"
},
{
"field": "Model name:",
"data": "AMD Ryzen 7 5700X 8-Core Processor"
},
{
"field": "Thread(s) per core:",
"data": "2"
},
{
"field": "Core(s) per socket:",
"data": "8"
},
{
"field": "CPU(s) scaling MHz:",
"data": "82%"
},
{
"field": "NUMA node0 CPU(s):",
"data": "0-15"
}
]
@@ -0,0 +1,17 @@
{
"lab": 3,
"workload": "closed-loop POST messages; no automatic retries",
"requested_duration_seconds": 5.0,
"elapsed_seconds": 5.139,
"concurrency": 16,
"successful_requests": 598,
"failed_requests": 0,
"error_ratio": 0.0,
"successful_rps": 116.366,
"successful_latency_ms": {
"p50": 133.437,
"p95": 166.377,
"p99": 216.771
},
"note": "Latency percentiles cover successes only. Timeouts/errors are counted separately; closed-loop has coordinated omission and client overhead."
}
@@ -0,0 +1,17 @@
{
"lab": 3,
"workload": "closed-loop POST messages; no automatic retries",
"requested_duration_seconds": 5.0,
"elapsed_seconds": 5.138,
"concurrency": 16,
"successful_requests": 565,
"failed_requests": 0,
"error_ratio": 0.0,
"successful_rps": 109.975,
"successful_latency_ms": {
"p50": 133.462,
"p95": 208.454,
"p99": 341.772
},
"note": "Latency percentiles cover successes only. Timeouts/errors are counted separately; closed-loop has coordinated omission and client overhead."
}
@@ -0,0 +1,17 @@
{
"lab": 3,
"workload": "closed-loop POST messages; no automatic retries",
"requested_duration_seconds": 5.0,
"elapsed_seconds": 5.141,
"concurrency": 16,
"successful_requests": 609,
"failed_requests": 0,
"error_ratio": 0.0,
"successful_rps": 118.461,
"successful_latency_ms": {
"p50": 125.254,
"p95": 166.879,
"p99": 191.926
},
"note": "Latency percentiles cover successes only. Timeouts/errors are counted separately; closed-loop has coordinated omission and client overhead."
}
@@ -0,0 +1,17 @@
{
"lab": 3,
"workload": "closed-loop POST messages; no automatic retries",
"requested_duration_seconds": 5.0,
"elapsed_seconds": 5.149,
"concurrency": 16,
"successful_requests": 596,
"failed_requests": 0,
"error_ratio": 0.0,
"successful_rps": 115.747,
"successful_latency_ms": {
"p50": 133.393,
"p95": 183.591,
"p99": 258.514
},
"note": "Latency percentiles cover successes only. Timeouts/errors are counted separately; closed-loop has coordinated omission and client overhead."
}
+361
View File
@@ -0,0 +1,361 @@
<?xml version="1.0" encoding="utf-8" standalone="no"?>
<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN"
"http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
<svg xmlns:xlink="http://www.w3.org/1999/xlink" width="576pt" height="252pt" viewBox="0 0 576 252" xmlns="http://www.w3.org/2000/svg" version="1.1">
<metadata>
<rdf:RDF xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:cc="http://creativecommons.org/ns#" xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#">
<cc:Work>
<dc:type rdf:resource="http://purl.org/dc/dcmitype/StillImage"/>
<dc:date>2026-11-12T20:29:03.601037</dc:date>
<dc:format>image/svg+xml</dc:format>
<dc:creator>
<cc:Agent>
<dc:title>Matplotlib v3.11.2, https://matplotlib.org/</dc:title>
</cc:Agent>
</dc:creator>
</cc:Work>
</rdf:RDF>
</metadata>
<defs>
<style type="text/css">*{stroke-linejoin: round; stroke-linecap: butt}</style>
</defs>
<g id="figure_1">
<g id="patch_1">
<path d="M 0 252
L 576 252
L 576 0
L 0 0
z
" style="fill: #ffffff"/>
</g>
<g id="axes_1">
<g id="patch_2">
<path d="M 43.088521 231.998979
L 285.000151 231.998979
L 285.000151 22.664092
L 43.088521 22.664092
z
" style="fill: #ffffff"/>
</g>
<g id="patch_3">
<path d="M 54.084504 231.998979
L 151.826577 231.998979
L 151.826577 32.63242
L 54.084504 32.63242
z
" clip-path="url(#pc2a2c8751d)" style="fill: #6b7280"/>
</g>
<g id="patch_4">
<path d="M 176.262095 231.998979
L 274.004167 231.998979
L 274.004167 39.329103
L 176.262095 39.329103
z
" clip-path="url(#pc2a2c8751d)" style="fill: #2563eb"/>
</g>
<g id="matplotlib.axis_1">
<g id="xtick_1">
<g id="line2d_1">
<defs>
<path id="ma82d5a25fb" d="M 0 0
L 0 3.5
" style="stroke: #000000; stroke-width: 0.8"/>
</defs>
<g>
<use xlink:href="#ma82d5a25fb" x="102.955541" y="231.998979" style="stroke: #000000; stroke-width: 0.8"/>
</g>
</g>
<g id="text_1">
<text style="font-size: 10px; font-family: 'DejaVu Sans', 'Bitstream Vera Sans', 'Computer Modern Sans Serif', 'Lucida Grande', 'Verdana', 'Geneva', 'Lucid', 'Arial', 'Helvetica', 'Avant Garde', sans-serif; text-anchor: middle" x="102.955541" y="246.597416" transform="rotate(-0 102.955541 246.597416)">pool = 8</text>
</g>
</g>
<g id="xtick_2">
<g id="line2d_2">
<g>
<use xlink:href="#ma82d5a25fb" x="225.133131" y="231.998979" style="stroke: #000000; stroke-width: 0.8"/>
</g>
</g>
<g id="text_2">
<text style="font-size: 10px; font-family: 'DejaVu Sans', 'Bitstream Vera Sans', 'Computer Modern Sans Serif', 'Lucida Grande', 'Verdana', 'Geneva', 'Lucid', 'Arial', 'Helvetica', 'Avant Garde', sans-serif; text-anchor: middle" x="225.133131" y="246.597416" transform="rotate(-0 225.133131 246.597416)">pool = 1</text>
</g>
</g>
</g>
<g id="matplotlib.axis_2">
<g id="ytick_1">
<g id="line2d_3">
<defs>
<path id="m31727d8780" d="M 0 0
L -3.5 0
" style="stroke: #000000; stroke-width: 0.8"/>
</defs>
<g>
<use xlink:href="#m31727d8780" x="43.088521" y="231.998979" style="stroke: #000000; stroke-width: 0.8"/>
</g>
</g>
<g id="text_3">
<text style="font-size: 10px; font-family: 'DejaVu Sans', 'Bitstream Vera Sans', 'Computer Modern Sans Serif', 'Lucida Grande', 'Verdana', 'Geneva', 'Lucid', 'Arial', 'Helvetica', 'Avant Garde', sans-serif; text-anchor: end" x="36.088521" y="235.797807" transform="rotate(-0 36.088521 235.797807)">0</text>
</g>
</g>
<g id="ytick_2">
<g id="line2d_4">
<g>
<use xlink:href="#m31727d8780" x="43.088521" y="197.949491" style="stroke: #000000; stroke-width: 0.8"/>
</g>
</g>
<g id="text_4">
<text style="font-size: 10px; font-family: 'DejaVu Sans', 'Bitstream Vera Sans', 'Computer Modern Sans Serif', 'Lucida Grande', 'Verdana', 'Geneva', 'Lucid', 'Arial', 'Helvetica', 'Avant Garde', sans-serif; text-anchor: end" x="36.088521" y="201.748319" transform="rotate(-0 36.088521 201.748319)">20</text>
</g>
</g>
<g id="ytick_3">
<g id="line2d_5">
<g>
<use xlink:href="#m31727d8780" x="43.088521" y="163.900004" style="stroke: #000000; stroke-width: 0.8"/>
</g>
</g>
<g id="text_5">
<text style="font-size: 10px; font-family: 'DejaVu Sans', 'Bitstream Vera Sans', 'Computer Modern Sans Serif', 'Lucida Grande', 'Verdana', 'Geneva', 'Lucid', 'Arial', 'Helvetica', 'Avant Garde', sans-serif; text-anchor: end" x="36.088521" y="167.698832" transform="rotate(-0 36.088521 167.698832)">40</text>
</g>
</g>
<g id="ytick_4">
<g id="line2d_6">
<g>
<use xlink:href="#m31727d8780" x="43.088521" y="129.850516" style="stroke: #000000; stroke-width: 0.8"/>
</g>
</g>
<g id="text_6">
<text style="font-size: 10px; font-family: 'DejaVu Sans', 'Bitstream Vera Sans', 'Computer Modern Sans Serif', 'Lucida Grande', 'Verdana', 'Geneva', 'Lucid', 'Arial', 'Helvetica', 'Avant Garde', sans-serif; text-anchor: end" x="36.088521" y="133.649344" transform="rotate(-0 36.088521 133.649344)">60</text>
</g>
</g>
<g id="ytick_5">
<g id="line2d_7">
<g>
<use xlink:href="#m31727d8780" x="43.088521" y="95.801029" style="stroke: #000000; stroke-width: 0.8"/>
</g>
</g>
<g id="text_7">
<text style="font-size: 10px; font-family: 'DejaVu Sans', 'Bitstream Vera Sans', 'Computer Modern Sans Serif', 'Lucida Grande', 'Verdana', 'Geneva', 'Lucid', 'Arial', 'Helvetica', 'Avant Garde', sans-serif; text-anchor: end" x="36.088521" y="99.599857" transform="rotate(-0 36.088521 99.599857)">80</text>
</g>
</g>
<g id="ytick_6">
<g id="line2d_8">
<g>
<use xlink:href="#m31727d8780" x="43.088521" y="61.751541" style="stroke: #000000; stroke-width: 0.8"/>
</g>
</g>
<g id="text_8">
<text style="font-size: 10px; font-family: 'DejaVu Sans', 'Bitstream Vera Sans', 'Computer Modern Sans Serif', 'Lucida Grande', 'Verdana', 'Geneva', 'Lucid', 'Arial', 'Helvetica', 'Avant Garde', sans-serif; text-anchor: end" x="36.088521" y="65.550369" transform="rotate(-0 36.088521 65.550369)">100</text>
</g>
</g>
<g id="ytick_7">
<g id="line2d_9">
<g>
<use xlink:href="#m31727d8780" x="43.088521" y="27.702054" style="stroke: #000000; stroke-width: 0.8"/>
</g>
</g>
<g id="text_9">
<text style="font-size: 10px; font-family: 'DejaVu Sans', 'Bitstream Vera Sans', 'Computer Modern Sans Serif', 'Lucida Grande', 'Verdana', 'Geneva', 'Lucid', 'Arial', 'Helvetica', 'Avant Garde', sans-serif; text-anchor: end" x="36.088521" y="31.500882" transform="rotate(-0 36.088521 31.500882)">120</text>
</g>
</g>
<g id="text_10">
<text style="font-size: 10px; font-family: 'DejaVu Sans', 'Bitstream Vera Sans', 'Computer Modern Sans Serif', 'Lucida Grande', 'Verdana', 'Geneva', 'Lucid', 'Arial', 'Helvetica', 'Avant Garde', sans-serif; text-anchor: middle" x="10.598677" y="127.331535" transform="rotate(-90 10.598677 127.331535)">Successful req/s</text>
</g>
</g>
<g id="patch_5">
<path d="M 43.088521 231.998979
L 43.088521 22.664092
" style="fill: none; stroke: #000000; stroke-width: 0.8; stroke-linejoin: miter; stroke-linecap: square"/>
</g>
<g id="patch_6">
<path d="M 285.000151 231.998979
L 285.000151 22.664092
" style="fill: none; stroke: #000000; stroke-width: 0.8; stroke-linejoin: miter; stroke-linecap: square"/>
</g>
<g id="patch_7">
<path d="M 43.088521 231.998979
L 285.000151 231.998979
" style="fill: none; stroke: #000000; stroke-width: 0.8; stroke-linejoin: miter; stroke-linecap: square"/>
</g>
<g id="patch_8">
<path d="M 43.088521 22.664092
L 285.000151 22.664092
" style="fill: none; stroke: #000000; stroke-width: 0.8; stroke-linejoin: miter; stroke-linecap: square"/>
</g>
<g id="text_11">
<text style="font-size: 10px; font-family: 'DejaVu Sans', 'Bitstream Vera Sans', 'Computer Modern Sans Serif', 'Lucida Grande', 'Verdana', 'Geneva', 'Lucid', 'Arial', 'Helvetica', 'Avant Garde', sans-serif; text-anchor: middle" x="102.955541" y="28.63242" transform="rotate(-0 102.955541 28.63242)">117.10</text>
</g>
<g id="text_12">
<text style="font-size: 10px; font-family: 'DejaVu Sans', 'Bitstream Vera Sans', 'Computer Modern Sans Serif', 'Lucida Grande', 'Verdana', 'Geneva', 'Lucid', 'Arial', 'Helvetica', 'Avant Garde', sans-serif; text-anchor: middle" x="225.133131" y="35.329103" transform="rotate(-0 225.133131 35.329103)">113.17</text>
</g>
</g>
<g id="axes_2">
<g id="patch_9">
<path d="M 331.088131 231.998979
L 572.99976 231.998979
L 572.99976 22.664092
L 331.088131 22.664092
z
" style="fill: #ffffff"/>
</g>
<g id="patch_10">
<path d="M 342.084114 231.998979
L 439.826186 231.998979
L 439.826186 45.589642
L 342.084114 45.589642
z
" clip-path="url(#pc17e266073)" style="fill: #6b7280"/>
</g>
<g id="patch_11">
<path d="M 464.261704 231.998979
L 562.003777 231.998979
L 562.003777 32.63242
L 464.261704 32.63242
z
" clip-path="url(#pc17e266073)" style="fill: #2563eb"/>
</g>
<g id="matplotlib.axis_3">
<g id="xtick_3">
<g id="line2d_10">
<g>
<use xlink:href="#ma82d5a25fb" x="390.95515" y="231.998979" style="stroke: #000000; stroke-width: 0.8"/>
</g>
</g>
<g id="text_13">
<text style="font-size: 10px; font-family: 'DejaVu Sans', 'Bitstream Vera Sans', 'Computer Modern Sans Serif', 'Lucida Grande', 'Verdana', 'Geneva', 'Lucid', 'Arial', 'Helvetica', 'Avant Garde', sans-serif; text-anchor: middle" x="390.95515" y="246.597416" transform="rotate(-0 390.95515 246.597416)">pool = 8</text>
</g>
</g>
<g id="xtick_4">
<g id="line2d_11">
<g>
<use xlink:href="#ma82d5a25fb" x="513.132741" y="231.998979" style="stroke: #000000; stroke-width: 0.8"/>
</g>
</g>
<g id="text_14">
<text style="font-size: 10px; font-family: 'DejaVu Sans', 'Bitstream Vera Sans', 'Computer Modern Sans Serif', 'Lucida Grande', 'Verdana', 'Geneva', 'Lucid', 'Arial', 'Helvetica', 'Avant Garde', sans-serif; text-anchor: middle" x="513.132741" y="246.597416" transform="rotate(-0 513.132741 246.597416)">pool = 1</text>
</g>
</g>
</g>
<g id="matplotlib.axis_4">
<g id="ytick_8">
<g id="line2d_12">
<g>
<use xlink:href="#m31727d8780" x="331.088131" y="231.998979" style="stroke: #000000; stroke-width: 0.8"/>
</g>
</g>
<g id="text_15">
<text style="font-size: 10px; font-family: 'DejaVu Sans', 'Bitstream Vera Sans', 'Computer Modern Sans Serif', 'Lucida Grande', 'Verdana', 'Geneva', 'Lucid', 'Arial', 'Helvetica', 'Avant Garde', sans-serif; text-anchor: end" x="324.088131" y="235.797807" transform="rotate(-0 324.088131 235.797807)">0</text>
</g>
</g>
<g id="ytick_9">
<g id="line2d_13">
<g>
<use xlink:href="#m31727d8780" x="331.088131" y="205.404786" style="stroke: #000000; stroke-width: 0.8"/>
</g>
</g>
<g id="text_16">
<text style="font-size: 10px; font-family: 'DejaVu Sans', 'Bitstream Vera Sans', 'Computer Modern Sans Serif', 'Lucida Grande', 'Verdana', 'Geneva', 'Lucid', 'Arial', 'Helvetica', 'Avant Garde', sans-serif; text-anchor: end" x="324.088131" y="209.203614" transform="rotate(-0 324.088131 209.203614)">25</text>
</g>
</g>
<g id="ytick_10">
<g id="line2d_14">
<g>
<use xlink:href="#m31727d8780" x="331.088131" y="178.810593" style="stroke: #000000; stroke-width: 0.8"/>
</g>
</g>
<g id="text_17">
<text style="font-size: 10px; font-family: 'DejaVu Sans', 'Bitstream Vera Sans', 'Computer Modern Sans Serif', 'Lucida Grande', 'Verdana', 'Geneva', 'Lucid', 'Arial', 'Helvetica', 'Avant Garde', sans-serif; text-anchor: end" x="324.088131" y="182.609421" transform="rotate(-0 324.088131 182.609421)">50</text>
</g>
</g>
<g id="ytick_11">
<g id="line2d_15">
<g>
<use xlink:href="#m31727d8780" x="331.088131" y="152.2164" style="stroke: #000000; stroke-width: 0.8"/>
</g>
</g>
<g id="text_18">
<text style="font-size: 10px; font-family: 'DejaVu Sans', 'Bitstream Vera Sans', 'Computer Modern Sans Serif', 'Lucida Grande', 'Verdana', 'Geneva', 'Lucid', 'Arial', 'Helvetica', 'Avant Garde', sans-serif; text-anchor: end" x="324.088131" y="156.015228" transform="rotate(-0 324.088131 156.015228)">75</text>
</g>
</g>
<g id="ytick_12">
<g id="line2d_16">
<g>
<use xlink:href="#m31727d8780" x="331.088131" y="125.622207" style="stroke: #000000; stroke-width: 0.8"/>
</g>
</g>
<g id="text_19">
<text style="font-size: 10px; font-family: 'DejaVu Sans', 'Bitstream Vera Sans', 'Computer Modern Sans Serif', 'Lucida Grande', 'Verdana', 'Geneva', 'Lucid', 'Arial', 'Helvetica', 'Avant Garde', sans-serif; text-anchor: end" x="324.088131" y="129.421035" transform="rotate(-0 324.088131 129.421035)">100</text>
</g>
</g>
<g id="ytick_13">
<g id="line2d_17">
<g>
<use xlink:href="#m31727d8780" x="331.088131" y="99.028014" style="stroke: #000000; stroke-width: 0.8"/>
</g>
</g>
<g id="text_20">
<text style="font-size: 10px; font-family: 'DejaVu Sans', 'Bitstream Vera Sans', 'Computer Modern Sans Serif', 'Lucida Grande', 'Verdana', 'Geneva', 'Lucid', 'Arial', 'Helvetica', 'Avant Garde', sans-serif; text-anchor: end" x="324.088131" y="102.826842" transform="rotate(-0 324.088131 102.826842)">125</text>
</g>
</g>
<g id="ytick_14">
<g id="line2d_18">
<g>
<use xlink:href="#m31727d8780" x="331.088131" y="72.433821" style="stroke: #000000; stroke-width: 0.8"/>
</g>
</g>
<g id="text_21">
<text style="font-size: 10px; font-family: 'DejaVu Sans', 'Bitstream Vera Sans', 'Computer Modern Sans Serif', 'Lucida Grande', 'Verdana', 'Geneva', 'Lucid', 'Arial', 'Helvetica', 'Avant Garde', sans-serif; text-anchor: end" x="324.088131" y="76.232649" transform="rotate(-0 324.088131 76.232649)">150</text>
</g>
</g>
<g id="ytick_15">
<g id="line2d_19">
<g>
<use xlink:href="#m31727d8780" x="331.088131" y="45.839628" style="stroke: #000000; stroke-width: 0.8"/>
</g>
</g>
<g id="text_22">
<text style="font-size: 10px; font-family: 'DejaVu Sans', 'Bitstream Vera Sans', 'Computer Modern Sans Serif', 'Lucida Grande', 'Verdana', 'Geneva', 'Lucid', 'Arial', 'Helvetica', 'Avant Garde', sans-serif; text-anchor: end" x="324.088131" y="49.638456" transform="rotate(-0 324.088131 49.638456)">175</text>
</g>
</g>
<g id="text_23">
<text style="font-size: 10px; font-family: 'DejaVu Sans', 'Bitstream Vera Sans', 'Computer Modern Sans Serif', 'Lucida Grande', 'Verdana', 'Geneva', 'Lucid', 'Arial', 'Helvetica', 'Avant Garde', sans-serif; text-anchor: middle" x="298.598287" y="127.331535" transform="rotate(-90 298.598287 127.331535)">p95, ms</text>
</g>
</g>
<g id="patch_12">
<path d="M 331.088131 231.998979
L 331.088131 22.664092
" style="fill: none; stroke: #000000; stroke-width: 0.8; stroke-linejoin: miter; stroke-linecap: square"/>
</g>
<g id="patch_13">
<path d="M 572.99976 231.998979
L 572.99976 22.664092
" style="fill: none; stroke: #000000; stroke-width: 0.8; stroke-linejoin: miter; stroke-linecap: square"/>
</g>
<g id="patch_14">
<path d="M 331.088131 231.998979
L 572.99976 231.998979
" style="fill: none; stroke: #000000; stroke-width: 0.8; stroke-linejoin: miter; stroke-linecap: square"/>
</g>
<g id="patch_15">
<path d="M 331.088131 22.664092
L 572.99976 22.664092
" style="fill: none; stroke: #000000; stroke-width: 0.8; stroke-linejoin: miter; stroke-linecap: square"/>
</g>
<g id="text_24">
<text style="font-size: 10px; font-family: 'DejaVu Sans', 'Bitstream Vera Sans', 'Computer Modern Sans Serif', 'Lucida Grande', 'Verdana', 'Geneva', 'Lucid', 'Arial', 'Helvetica', 'Avant Garde', sans-serif; text-anchor: middle" x="390.95515" y="41.589642" transform="rotate(-0 390.95515 41.589642)">175.24</text>
</g>
<g id="text_25">
<text style="font-size: 10px; font-family: 'DejaVu Sans', 'Bitstream Vera Sans', 'Computer Modern Sans Serif', 'Lucida Grande', 'Verdana', 'Geneva', 'Lucid', 'Arial', 'Helvetica', 'Avant Garde', sans-serif; text-anchor: middle" x="513.132741" y="28.63242" transform="rotate(-0 513.132741 28.63242)">187.42</text>
</g>
</g>
<g id="text_26">
<text style="font-size: 12px; font-family: 'DejaVu Sans', 'Bitstream Vera Sans', 'Computer Modern Sans Serif', 'Lucida Grande', 'Verdana', 'Geneva', 'Lucid', 'Arial', 'Helvetica', 'Avant Garde', sans-serif; text-anchor: middle" x="288" y="12.118365" transform="rotate(-0 288 12.118365)">One hot sender; same single-replica CPU/RAM budget</text>
</g>
</g>
<defs>
<clipPath id="pc2a2c8751d">
<rect x="43.088521" y="22.664092" width="241.911629" height="209.334887"/>
</clipPath>
<clipPath id="pc17e266073">
<rect x="331.088131" y="22.664092" width="241.911629" height="209.334887"/>
</clipPath>
</defs>
</svg>

After

Width:  |  Height:  |  Size: 17 KiB

@@ -0,0 +1,28 @@
{
"before": [
{
"name": "api-747c44bcb7-f5pd5",
"uid": "e3fe3bc8-e520-4849-8179-b2168d07233a"
},
{
"name": "api-747c44bcb7-tb9tq",
"uid": "08ab5c19-1180-43c8-8993-108b40406e88"
}
],
"after": [
{
"name": "api-6d5996b6c6-5t8wf",
"uid": "abafbfe6-6e5e-4318-8322-8d0ef85ff1ae"
},
{
"name": "api-6d5996b6c6-r72sd",
"uid": "ee081545-2161-4855-b485-ad132dac3570"
}
],
"messages_before": 39,
"messages_after": 2028,
"strategy": {
"maxSurge": 1,
"maxUnavailable": 0
}
}
@@ -0,0 +1,17 @@
{
"lab": 3,
"workload": "closed-loop POST messages; no automatic retries",
"requested_duration_seconds": 30.0,
"elapsed_seconds": 30.073,
"concurrency": 8,
"successful_requests": 2725,
"failed_requests": 0,
"error_ratio": 0.0,
"successful_rps": 90.612,
"successful_latency_ms": {
"p50": 58.545,
"p95": 219.169,
"p99": 566.767
},
"note": "Latency percentiles cover successes only. Timeouts/errors are counted separately; closed-loop has coordinated omission and client overhead."
}

Some files were not shown because too many files have changed in this diff Show More