Test Evidence: Targeted Project Lombok boilerplate

Test type: Unit
Requirement IDs: ARC-002, ARC-005, ARC-006, TST-001
Scenario IDs: AC-TST-001
Test class/method: com.lab.labtimesheet.feature.project.repository.ProjectLombokBoilerplateTest#eligibleConstructorsUseTargetedLombokWithoutChangingDomainApis
Implementation commit: pending

Protected behavior

Project Spring components use targeted required-argument constructor generation only when their constructors assign required final dependencies. Project JPA entities use only protected no-arg constructor generation. Records remain records, and entity identity, lazy associations, explicit domain accessors, aggregate constructors, and mutation methods do not gain broad generated APIs.

Test method

The source-contract test inspects only feature.project production sources. It requires @RequiredArgsConstructor on the three injection-only components, removes the stateless advice's handwritten no-arg constructor, and requires protected @NoArgsConstructor on the three JPA entities. It also rejects broad entity Lombok annotations, confirms representative explicit domain APIs remain, and verifies every Project immutable DTO/value type remains a Java record.

Hand-derived expected result

Seven handwritten constructors are mechanical and eligible for removal: three dependency-assignment constructors, one empty advice constructor, and three empty protected JPA constructors. The three entity domain constructors, all aggregate mutation methods, defensive-copy accessors, derived membership/leadership accessors, validation constructors, exception constructors, and all thirteen records must remain explicit or remain records because they carry behavior or preserve the existing API shape.

RED

Command

export JAVA_HOME=/opt/homebrew/opt/openjdk@25
export PATH="/opt/homebrew/opt/node@24/bin:$JAVA_HOME/bin:$PATH"
./mvnw -Dtest=ProjectLombokBoilerplateTest test

Observed result

[INFO] Running com.lab.labtimesheet.feature.project.repository.ProjectLombokBoilerplateTest
[ERROR] Tests run: 1, Failures: 1, Errors: 0, Skipped: 0
ProjectLombokBoilerplateTest.eligibleConstructorsUseTargetedLombokWithoutChangingDomainApis
expected ProjectController.java to contain import lombok.RequiredArgsConstructor; and
@RequiredArgsConstructor, but neither was present and the handwritten assignment-only constructor
remained.
[INFO] BUILD FAILURE

GREEN

Command

export JAVA_HOME=/opt/homebrew/opt/openjdk@25
export PATH="/opt/homebrew/opt/node@24/bin:$JAVA_HOME/bin:$PATH"
./mvnw -Dtest=ProjectLombokBoilerplateTest test

Observed result

[INFO] Running com.lab.labtimesheet.feature.project.repository.ProjectLombokBoilerplateTest
[INFO] Tests run: 1, Failures: 0, Errors: 0, Skipped: 0
[INFO] BUILD SUCCESS

Affected suite

Command and result

export JAVA_HOME=/opt/homebrew/opt/openjdk@25
export PATH="/opt/homebrew/opt/node@24/bin:$JAVA_HOME/bin:$PATH"
./mvnw -DskipTests compile
[INFO] BUILD SUCCESS

./mvnw -Dtest=ProjectLombokBoilerplateTest,ProjectEntityTest,ProjectPersistenceStructureTest,ProjectTaskMutationContextTest test
[INFO] Tests run: 9, Failures: 0, Errors: 0, Skipped: 0
[INFO] BUILD SUCCESS

./mvnw -Dtest=ProjectControllerTest test
[INFO] Tests run: 16, Failures: 0, Errors: 0, Skipped: 0
[INFO] BUILD SUCCESS

export DOCKER_HOST=unix:///Users/sechmachine/.orbstack/run/docker.sock
./mvnw -Dtest=ProjectServiceIntegrationTest test
[INFO] Tests run: 7, Failures: 0, Errors: 0, Skipped: 0
[INFO] BUILD SUCCESS

./mvnw -Dtest='Project*Test' test
[INFO] Tests run: 45, Failures: 0, Errors: 0, Skipped: 0
[INFO] BUILD SUCCESS

./mvnw -DskipTests -Dmaven.javadoc.failOnWarnings=true -Ddoclint=all \
  -Dsubpackages=com.lab.labtimesheet.feature.project javadoc:javadoc
[INFO] BUILD SUCCESS

git diff --check
(no output; exit 0)

External-test boundaries

The source audit does not by itself prove Lombok annotation processing, Spring constructor injection, Hibernate materialization, PostgreSQL mappings, Thymeleaf behavior, Project authorization, locking, or aggregate lifecycle rules. Those boundaries are covered by the compile, scoped Javadoc/doclint, Project unit/web, and PostgreSQL 18.4 integration gates above. The first sandboxed unit-suite attempt could not attach Mockito's Byte Buddy agent; the unchanged command passed after approved execution outside that sandbox. Browser E2E behavior remains outside this unit milestone.

4.5 KiB Raw Blame History