Маркетплейс объявлений — кейс B (Highload)

Кейс: объявления, модерация, поиск, оплата продвижения, подписки (см. docs/).

Задание 3 (PoC)

Требования к репозиторию и нагрузочному циклу: ДЗ 3: PoC + оптимизация, материалы курса: Highload · ВШПИ × МТС 2026.

1. Как запустить

Из корня репозитория (нужны Docker и Docker Compose v2):

docker compose up -d --build

Дождаться зелёных healthcheck’ов (первый старт PostgreSQL может занять ~30–60 с):

docker compose ps

Сервисы и порты на хосте:

Сервис	Порт	Healthcheck
ads-service	8081	GET http://localhost:8081/health
billing-service	8082	GET http://localhost:8082/health
postgres	(только сеть Docker)	pg_isready внутри контейнера
minio	9000 (API), 9001 (console)	bucket marketplace-media

Пересоздать БД с нуля (если менялась схема): docker compose down -v && docker compose up -d --build.

2. Как проверить (curl, happy path из ДЗ 2)

Создать объявление (статус moderation_pending):

curl -sS -X POST http://localhost:8081/api/v1/ads \
  -H 'Content-Type: application/json' \
  -d '{"title":"Велосипед Pro","description":"Отличный велосипед для города и леса, почти новый.","category":"transport","region":"moscow","price":19900}' | jq .

Загрузить фото (до 8 шт., jpeg/png/webp, макс. 5 МБ; файлы в MinIO, метаданные в Postgres):

curl -sS -X POST "http://localhost:8081/api/v1/ads/${AD_ID}/photos" \
  -F "file=@./photo.jpg;type=image/jpeg" | jq .

Опубликовать (имитация успешной модерации → published):

export AD_ID='<uuid из ответа create>'
curl -sS -X POST "http://localhost:8081/api/v1/ads/${AD_ID}/publish" | jq .

Ожидается 200, status: published.

Получить карточку:

curl -sS "http://localhost:8081/api/v1/ads/${AD_ID}" | jq .

Ожидается 200.

Купить продвижение (billing проверяет объявление по HTTP в ads, пишет в БД):

curl -sS -X POST "http://localhost:8082/api/v1/ads/${AD_ID}/promotions" | jq .

Ожидается 201 и поля id, adId, status, createdAt.

Проверка health:

curl -sS http://localhost:8081/health && echo
curl -sS http://localhost:8082/health && echo

Ожидается 200 и {"status":"ok"} (включая успешный Ping к PostgreSQL).

3. Как запустить нагрузочный тест

На ноутбуке (не на VM приложения), при установленном k6:

export BASE_URL=http://<IP_VM>:8081
export BILLING_URL=http://<IP_VM>:8082
k6 run loadtest/smoke.js

Метрики: сводка k6 в консоли; на VM — docker stats, htop, iostat (см. ДЗ 3). Полный цикл baseline и iter 1–3 — в docs/optimization-log.md.

4. Паттерны (≥4: проектирование + устойчивость)

Паттерн	Зачем	Где в коде
Ports & Adapters (чистая архитектура)	Домен не зависит от БД/HTTP; тестируемость	services/*/internal/domain/ports, application/usecases, infrastructure/adapters
CQRS (упрощённо)	Запись объявлений в PostgreSQL; межсервисная проверка опубликованного объявления — read через HTTP в ads	Write: services/ads-service/.../postgres/ads_repository.go; read-side check: services/billing-service/.../http/ads_catalog_adapter.go
Rate limiting	Защита create от burst (429 при перегрузе)	services/ads-service/internal/presentation/http/middleware.go
Timeouts	Ограничение висящих исходящих вызовов	services/billing-service/internal/di/providers.go (http.Client.Timeout)
Retry with exponential backoff	Временные 5xx / сетевые сбои при вызове ads	services/billing-service/internal/infrastructure/adapters/http/ads_catalog_adapter.go (getWithRetry)
Circuit breaker	Не долбить упавший ads при каскадном сбое	services/billing-service/.../ads_catalog_adapter.go (gobreaker)
Healthcheck + DB ping	Readiness: сервис не «зелёный», пока БД недоступна	services/*/internal/presentation/http/handlers.go (GET /health), docker-compose.yml

5. Итерации оптимизации

Профиль трафика: read-heavy (~80% GET / ~15% write / ~5% promotion). VM: 2 vCPU, 8 GB RAM, 72 GB HDD.

Метрика	NFR (ДЗ1)	Iter 0	Iter 1	Iter 2
Latency p99 read	< 500 мс	46 мс	~46 мс	~120 мс
Latency p99 write	< 1000 мс	46 мс	timeout (ошибки)	~180 мс
Max RPS (read)	≥ 100	> 400	1200	1200 ✓
Max RPS (write)	≥ 10	> 120	~225 (с ошибками)	225 ✓
Error rate	< 1%	0.00%	2.83% ✗	0.00% ✓
CPU / RAM	70–90% CPU	< 20% / ~11%	CPU ads-svc ~100% (лимит)	~50% / ~12%
Bottleneck	—	не найден	CPU ads-svc + conn pool	устранён
Что сделали	—	—	↑ нагрузку до 1500 RPS	CPU ×2, pool ×2.5, rate-limit ×4
NFR достигнут?	—	Да, все	Нет (write path)	Да, все ✓

Git-теги: iter-0 (baseline) → iter-1 (bottleneck) → iter-2 (оптимизация).

Подробный анализ RED/USE метрик, bottleneck и diff по каждой итерации: docs/optimization-log.md.

---

Структура репозитория (ДЗ 3)

├── docker-compose.yml
├── deployments/postgres/init.sql
├── services/
│   ├── ads-service/
│   └── billing-service/
├── loadtest/
│   └── smoke.js
├── docs/
│   ├── optimization-log.md
│   └── ...
└── README.md

Локальная разработка

make test
make wire
./scripts/verify-poc.sh