ЛР 3 — БВТ2304 — ivanstorozhev — на 4

Две реплики API за HAProxy делят PostgreSQL и сессии, поэтому остановка одной не рвёт чтение и запись. Idempotency-Key не даёт повторной отправке создать второе сообщение.

Автор / группа: ivanstorozhev, БВТ2304
Целевая оценка (3/4/5): 4
Трек 5, если заявлен: не заявлен

Что реализовано и что перенесено: из lab2 перенесён Spring Boot API. PostgreSQL хранит пользователей, чаты, участников, сообщения, сессии и ключи идемпотентности. Redis только кэширует разбор Bearer и обходится при отказе. Пароли — Argon2id. Миграции Liquibase запускает одноразовый сервис migrate, реплики API схему сами не накатывают. Добавлены HAProxy без sticky session, две реплики, X-Instance-Id, обязательный Idempotency-Key, scripts/stop-one.sh, scripts/restart.sh и scripts/rolling-update.sh. Время в ответах пишется с шестью знаками дробной секунды, чтобы его принимал Python 3.9.

Команды запуска из чистого clone:
cp .env.example .env
docker compose --env-file .env config --quiet
docker compose --env-file .env up -d --build
curl -fsS http://127.0.0.1:8080/health/ready
make test
make test-persistence ACTION_SCRIPT=scripts/restart.sh
make test-failover ACTION_SCRIPT=scripts/stop-one.sh
docker compose --env-file .env start api

Результаты проверок и ссылка на REPORT.md: подробности и числа в REPORT.md
make check — PASS: offline skeleton structure, local refs and Python syntax.
make test — PASS: lab3 public API scenario (Python 3.9.6).
make test-persistence ACTION_SCRIPT=scripts/restart.sh — PASS: persistence preserved confirmed data and existing session.
make test-failover ACTION_SCRIPT=scripts/stop-one.sh — PASS: две реплики до отказа, восстановление записи за 1.16 с, 114 успешных записей и 2 ошибки перехода.
mvn -q test в backend/ — 13 тестов без ошибок, включая повтор ключа, 409 на другое тело и 8 параллельных запросов с одним ключом. После фикса формата времени заново прогнан ApiIntegrationTest и публичный make test.

Ограничения / известные ошибки: трек 5 не делался. Один Docker-хост, единственные PostgreSQL, Redis и HAProxy остаются точками отказа. Если Redis жив, а удаление ключа при logout не прошло, кэш может жить до своего TTL. История сообщений не кэшируется. Миграция идёт один раз до старта реплик; совместимость новой схемы со старым бинарём под нагрузкой не проверялась. Пока HAProxy не снял backend, часть запросов на останавливаемую реплику завершается ошибкой соединения; повтор с тем же Idempotency-Key безопасен только для отправки сообщения.

Источники и использование ИИ: контракт contracts/openapi.json и contracts/README.md; Spring Boot 4.1.1, Spring Data JPA, spring-security-crypto, Spring Data Redis, Liquibase, Actuator, MapStruct 1.6.3, OpenAPI Generator 7.17.0, Bouncy Castle, PostgreSQL 16.10, Redis 7.4.6, HAProxy 3.2.6, Testcontainers. Реализация собрана в Cursor.

Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами.
Контракт и публичные тесты не ослаблены.
make check и make test выполнены; приложен реальный вывод.
Сценарии отказов своего уровня воспроизведены.
Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens.
README задания сохранён, REPORT.md содержит инструкцию именно моего решения.
This commit is contained in:
ivanstorozhev
2026-10-29 20:00:59 +03:00
parent 0ab3a341aa
commit b9a899d510
84 changed files with 3645 additions and 14 deletions
@@ -0,0 +1,281 @@
package ru.mtuci.messenger;
import org.junit.jupiter.api.BeforeEach;
import org.junit.jupiter.api.Test;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.context.SpringBootTest;
import org.springframework.boot.test.web.server.LocalServerPort;
import org.springframework.data.redis.core.StringRedisTemplate;
import org.springframework.test.context.DynamicPropertyRegistry;
import org.springframework.test.context.DynamicPropertySource;
import ru.mtuci.messenger.repository.ChatRepository;
import ru.mtuci.messenger.service.UserService;
import ru.mtuci.messenger.support.ApiClient;
import ru.mtuci.messenger.support.LabContainers;
import tools.jackson.databind.JsonNode;
import tools.jackson.databind.json.JsonMapper;
import java.util.Base64;
import java.util.List;
import java.util.Map;
import java.util.UUID;
import java.util.concurrent.CountDownLatch;
import java.util.concurrent.ExecutorService;
import java.util.concurrent.Executors;
import java.util.concurrent.Future;
import static org.junit.jupiter.api.Assertions.assertEquals;
import static org.junit.jupiter.api.Assertions.assertFalse;
import static org.junit.jupiter.api.Assertions.assertNotEquals;
import static org.junit.jupiter.api.Assertions.assertTrue;
@SpringBootTest(webEnvironment = SpringBootTest.WebEnvironment.RANDOM_PORT)
class ApiIntegrationTest {
@LocalServerPort
int port;
@Autowired
JsonMapper jsonMapper;
@Autowired
ChatRepository chatRepository;
@Autowired
StringRedisTemplate redis;
private ApiClient api;
@DynamicPropertySource
static void containers(DynamicPropertyRegistry registry) {
LabContainers.register(registry);
}
@BeforeEach
void client() {
api = new ApiClient(port, jsonMapper);
}
@Test
void healthAndActuatorReportProcessAndDatabase() {
ApiClient.Result live = api.get("/health/live", null);
assertEquals(200, live.status());
assertEquals("ok", live.body().get("status").asString());
assertFalse(live.requestId().isBlank());
ApiClient.Result ready = api.get("/health/ready", null);
assertEquals(200, ready.status());
assertEquals("ok", ready.body().get("status").asString());
ApiClient.Result actuator = api.get("/actuator/health/readiness", null);
assertEquals(200, actuator.status());
assertEquals("UP", actuator.body().get("status").asString());
}
@Test
void registrationConflictValidationAndRace() throws Exception {
String username = name("reg");
ApiClient.Result created = api.post("/api/v1/users", api.user(username, "Алиса", "Example-only-not-a-real-secret-123"));
assertEquals(201, created.status());
assertEquals(username, created.body().get("username").asString());
assertTrue(created.body().get("created_at").asString().endsWith("Z"));
assertFalse(created.raw().contains("password"));
assertEquals(created.requestId(), created.requestId());
ApiClient.Result conflict = api.post("/api/v1/users", api.user(username, "Алиса", "Example-only-not-a-real-secret-123"));
assertEquals(409, conflict.status());
assertEquals("conflict", conflict.body().get("error").get("code").asString());
assertEquals(conflict.requestId(), conflict.body().get("error").get("request_id").asString());
ApiClient.Result blank = api.post("/api/v1/users", api.user(name("blank"), " ", "Example-only-not-a-real-secret-123"));
assertEquals(400, blank.status());
ApiClient.Result extra = api.post("/api/v1/users", Map.of("username", name("extra"), "display_name", "Имя", "password", "Example-only-not-a-real-secret-123", "role", "admin"));
assertEquals(400, extra.status());
String raced = name("race");
CountDownLatch latch = new CountDownLatch(1);
try (ExecutorService pool = Executors.newFixedThreadPool(2)) {
List<Future<Integer>> results = List.of(
pool.submit(() -> once(latch, raced)),
pool.submit(() -> once(latch, raced))
);
latch.countDown();
int createdCount = 0;
int conflictCount = 0;
for (Future<Integer> result : results) {
int status = result.get();
if (status == 201) {
createdCount++;
} else if (status == 409) {
conflictCount++;
}
}
assertEquals(1, createdCount);
assertEquals(1, conflictCount);
}
}
@Test
void sessionLoginLogoutAndIgnoredUserHeader() {
String username = name("sess");
String password = "Example-only-not-a-real-secret-123";
JsonNode user = api.post("/api/v1/users", api.user(username, "Алиса", password)).body();
JsonNode other = api.post("/api/v1/users", api.user(name("oth"), "Боб", password)).body();
String basic = Base64.getEncoder().encodeToString((username + ":" + password).getBytes());
ApiClient.Result bad = api.postBasic("/api/v1/auth/sessions", Base64.getEncoder().encodeToString((username + ":wrong-password-xx").getBytes()));
assertEquals(401, bad.status());
assertTrue(bad.authenticate().toLowerCase().startsWith("basic"));
ApiClient.Result session = api.postBasic("/api/v1/auth/sessions", basic);
assertEquals(201, session.status());
assertEquals("Bearer", session.body().get("token_type").asString());
assertTrue(session.body().get("token").asString().length() >= 32);
assertNotEquals(user.get("id").asString(), session.body().get("token").asString());
assertEquals(user.get("id").asString(), session.body().get("user").get("id").asString());
String token = session.body().get("token").asString();
ApiClient.Result basicOnApi = api.postBasic("/api/v1/users/me", basic);
assertEquals(401, basicOnApi.status());
assertTrue(basicOnApi.authenticate().toLowerCase().startsWith("bearer"));
ApiClient.Result headerOnly = api.get("/api/v1/users/me", null, Map.of("X-User-Id", user.get("id").asString()));
assertEquals(401, headerOnly.status());
ApiClient.Result me = api.get("/api/v1/users/me", token, Map.of("X-User-Id", other.get("id").asString()));
assertEquals(200, me.status());
assertEquals(user.get("id").asString(), me.body().get("id").asString());
assertTrue(Boolean.TRUE.equals(redis.hasKey("session:" + UserService.tokenHash(token))));
ApiClient.Result logout = api.delete("/api/v1/auth/sessions/current", token);
assertEquals(204, logout.status());
assertTrue(logout.raw().isBlank());
assertFalse(Boolean.TRUE.equals(redis.hasKey("session:" + UserService.tokenHash(token))));
assertEquals(401, api.get("/api/v1/users/me", token).status());
assertEquals(401, api.delete("/api/v1/auth/sessions/current", token).status());
}
@Test
void chatsAreAtomicAndHiddenFromOutsiders() {
String password = "Example-only-not-a-real-secret-123";
JsonNode alice = register(name("alice"), "Алиса", password);
JsonNode bob = register(name("bob"), "Боб", password);
String aliceToken = login(alice.get("username").asString(), password);
String bobToken = login(bob.get("username").asString(), password);
String eveToken = login(register(name("eve"), "Ева", password).get("username").asString(), password);
String title = "rollback-" + UUID.randomUUID();
ApiClient.Result unknown = api.post("/api/v1/chats", aliceToken, Map.of(
"title", title,
"member_ids", List.of(alice.get("id").asString(), UUID.randomUUID().toString())
));
assertEquals(400, unknown.status());
assertEquals(0, chatRepository.countByTitle(title));
ApiClient.Result duplicates = api.post("/api/v1/chats", aliceToken, Map.of(
"title", "dup-" + UUID.randomUUID(),
"member_ids", List.of(alice.get("id").asString(), alice.get("id").asString())
));
assertEquals(400, duplicates.status());
ApiClient.Result withoutSelf = api.post("/api/v1/chats", aliceToken, Map.of(
"title", "self-" + UUID.randomUUID(),
"member_ids", List.of(bob.get("id").asString())
));
assertEquals(400, withoutSelf.status());
ApiClient.Result created = api.post("/api/v1/chats", aliceToken, Map.of(
"title", "Контрактный тест",
"member_ids", List.of(alice.get("id").asString(), bob.get("id").asString())
));
assertEquals(201, created.status());
String chatId = created.body().get("id").asString();
assertEquals(404, api.get("/api/v1/chats/" + chatId, eveToken).status());
JsonNode bobList = api.get("/api/v1/chats?limit=100", bobToken).body();
assertTrue(containsId(bobList.get("items"), chatId));
JsonNode eveList = api.get("/api/v1/chats?limit=100", eveToken).body();
assertFalse(containsId(eveList.get("items"), chatId));
ApiClient.Result second = api.post("/api/v1/chats", aliceToken, Map.of(
"title", "Второй",
"member_ids", List.of(alice.get("id").asString())
));
assertEquals(201, second.status());
JsonNode page = api.get("/api/v1/chats?limit=1", aliceToken).body();
assertEquals(1, page.get("items").size());
assertFalse(page.get("next_cursor").isNull());
JsonNode next = api.get("/api/v1/chats?limit=1&cursor=" + page.get("next_cursor").asString(), aliceToken).body();
assertEquals(1, next.get("items").size());
assertNotEquals(page.get("items").get(0).get("id").asString(), next.get("items").get(0).get("id").asString());
}
@Test
void messageHistoryUsesKeysetCursor() {
String password = "Example-only-not-a-real-secret-123";
JsonNode alice = register(name("ma"), "Алиса", password);
JsonNode bob = register(name("mb"), "Боб", password);
String aliceToken = login(alice.get("username").asString(), password);
String bobToken = login(bob.get("username").asString(), password);
String eveToken = login(register(name("me"), "Ева", password).get("username").asString(), password);
String chatId = api.post("/api/v1/chats", aliceToken, Map.of(
"title", "История",
"member_ids", List.of(alice.get("id").asString(), bob.get("id").asString())
)).body().get("id").asString();
String otherChat = api.post("/api/v1/chats", aliceToken, Map.of(
"title", "Другой",
"member_ids", List.of(alice.get("id").asString())
)).body().get("id").asString();
ApiClient.Result first = sendMessage(aliceToken, chatId, "Привет, мир");
ApiClient.Result second = sendMessage(bobToken, chatId, "Сообщение Боба");
assertEquals(201, first.status());
assertTrue(first.body().get("created_at").asString().matches("\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}\\.\\d{6}Z"));
assertFalse(first.instanceId().isBlank());
assertEquals(first.instanceId(), api.get("/api/v1/users/me", aliceToken).instanceId());
assertEquals(alice.get("id").asString(), first.body().get("sender_id").asString());
assertEquals(201, second.status());
assertEquals(400, sendMessage(aliceToken, chatId, "").status());
assertEquals(400, sendMessage(aliceToken, chatId, " ").status());
assertEquals(404, sendMessage(eveToken, chatId, "чужое").status());
assertEquals(400, api.get("/api/v1/chats/" + chatId + "/messages?limit=0", aliceToken).status());
JsonNode page = api.get("/api/v1/chats/" + chatId + "/messages?limit=1", bobToken).body();
assertEquals(1, page.get("items").size());
assertEquals(first.body().get("id").asString(), page.get("items").get(0).get("id").asString());
String cursor = page.get("next_cursor").asString();
JsonNode rest = api.get("/api/v1/chats/" + chatId + "/messages?limit=1&cursor=" + cursor, aliceToken).body();
assertEquals(second.body().get("id").asString(), rest.get("items").get(0).get("id").asString());
assertTrue(rest.get("next_cursor").isNull());
assertEquals(400, api.get("/api/v1/chats/" + otherChat + "/messages?cursor=" + cursor, aliceToken).status());
}
private int once(CountDownLatch latch, String username) throws Exception {
latch.await();
return api.post("/api/v1/users", api.user(username, "Гонка", "Example-only-not-a-real-secret-123")).status();
}
private JsonNode register(String username, String displayName, String password) {
ApiClient.Result result = api.post("/api/v1/users", api.user(username, displayName, password));
assertEquals(201, result.status());
return result.body();
}
private String login(String username, String password) {
String basic = Base64.getEncoder().encodeToString((username + ":" + password).getBytes());
ApiClient.Result session = api.postBasic("/api/v1/auth/sessions", basic);
assertEquals(201, session.status());
return session.body().get("token").asString();
}
private static boolean containsId(JsonNode items, String id) {
for (JsonNode item : items) {
if (id.equals(item.get("id").asString())) {
return true;
}
}
return false;
}
private ApiClient.Result sendMessage(String token, String chatId, String text) {
return api.post("/api/v1/chats/" + chatId + "/messages", token, Map.of("text", text),
Map.of("Idempotency-Key", UUID.randomUUID().toString()));
}
private static String name(String prefix) {
return (prefix + UUID.randomUUID().toString().replace("-", "")).substring(0, 20);
}
}