Deprecated — use the layer plugins. AI Unified Process for the Vaadin/jOOQ stack - migrations, implementation, tests
94%
Does it follow best practices?
Impact
97%
1.10xAverage score across 15 eval scenarios
Passed
No findings from the security scan
The source file UC001ManagePersonsServiceTest.java, wrapped in Markdown so that every skill host installs it.
Use the content of the code block below; a copy written to disk takes the name UC001ManagePersonsServiceTest.java.
package com.example.app.person;
import com.example.app.usecase.UseCase;
import com.vaadin.hilla.exception.EndpointException;
import org.jooq.DSLContext;
import org.junit.jupiter.api.AfterEach;
import org.junit.jupiter.api.Test;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.context.SpringBootTest;
import java.util.ArrayList;
import java.util.List;
import static com.example.app.jooq.Tables.PERSON;
import static org.assertj.core.api.Assertions.assertThat;
import static org.assertj.core.api.Assertions.assertThatThrownBy;
/**
* Backend tests for UC-001 "Manage Persons".
*
* Template for /hilla-test backend suites:
* - Class name UC<id><PascalCaseUseCaseName>ServiceTest
* - The @BrowserCallable service is called directly as a Spring bean — no HTTP layer
* - Every test method carries @UseCase for spec traceability
* - Seed data comes from Flyway test migrations (src/test/resources/db/migration);
* @AfterEach removes only rows the tests created
* - No Mockito, no @Transactional
*/
@SpringBootTest
class UC001ManagePersonsServiceTest {
@Autowired
private PersonService personService;
@Autowired
private DSLContext ctx;
private final List<Long> createdIds = new ArrayList<>();
@AfterEach
void removeTestCreatedData() {
if (!createdIds.isEmpty()) {
ctx.deleteFrom(PERSON).where(PERSON.ID.in(createdIds)).execute();
createdIds.clear();
}
}
@Test
@UseCase(id = "UC-001")
void lists_persons_from_seed_data() {
List<PersonDto> persons = personService.list();
// alice and bob are seeded by V001__test_data.sql
assertThat(persons)
.extracting(PersonDto::email)
.contains("alice@example.com", "bob@example.com");
}
@Test
@UseCase(id = "UC-001")
void saves_a_new_person_and_returns_it_with_an_id() {
PersonDto saved = personService.save(
new PersonDto(null, "Carol", "Miller", "carol@example.com"));
createdIds.add(saved.id());
assertThat(saved.id()).isNotNull();
assertThat(personService.list())
.extracting(PersonDto::email)
.contains("carol@example.com");
}
@Test
@UseCase(id = "UC-001", scenario = "A1: Email Already Exists", businessRules = {"BR-002"})
void save_rejects_duplicate_email() {
// alice@example.com already exists in the seed data
assertThatThrownBy(() -> personService.save(
new PersonDto(null, "Alice", "Clone", "alice@example.com")))
.isInstanceOf(EndpointException.class)
.hasMessageContaining("already registered");
}
}