Build, BOM & test kit

The problem it removes

Parent POMs drift — and a Spring BOM silently overrides the Boot version you chose.

What it does

Decisions and trade-offs

1. 01

   We chose

   A BOM that carries only com.krizaka artifacts; the parent has no dependencyManagement of its own.

   We refused

   Importing spring-boot-dependencies in our BOM.

   Because

   Importing krizaka-bom must never pin a version you chose. Your Spring Boot BOM stays yours; ours sits beside it.

   What it costs you

   You import Spring Boot's BOM (or parent) yourself.

2. 02

   We chose

   Architecture rules as tests (CodeRules, SourceRules, ConfigBindingRules: layering, constructor injection, private state, no Environment injection…).

   We refused

   A review checklist.

   Because

   A rule that runs on every build is the only kind still true six months later.

   What it costs you

   Rules are opinionated: take the ones that fit, call them from your own test.

3. 03

   We chose

   japicmp in the release profile: a binary break in a minor fails the release; publication on Central confirmed by hand.

   We refused

   SemVer by good intentions, and automatic publication.

   Because

   A release on Central can never be deleted: a break shipped is a break forever.

   What it costs you

   A deliberate break is declared in the repository for that release.

In code

// krizaka-test-support: the producer proves its event matches the JSON Schema its -api publishes
// (events/evt.notification.requested.v1.json, draft 2020-12). A consumer checks its own copy
// against the same file with assertReadable — no shared DTO jar between services.
class NotificationRequestContractTest extends EventContractTest {

  @Test
  void anEmailRequestConforms() {
    assertConforms(NotificationRouting.NOTIFICATION_REQUESTED, 1,
        new NotificationRequest(Channel.EMAIL, "ada@example.com", "welcome", "fr-FR",
            Map.of("name", "Ada")));
  }
}

Adopt it

<dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>com.krizaka</groupId>
      <artifactId>krizaka-bom</artifactId>
      <version>0.2.0</version>
      <type>pom</type>
      <scope>import</scope>
    </dependency>
  </dependencies>
</dependencyManagement>

<dependency>
  <groupId>com.krizaka</groupId>
  <artifactId>krizaka-test-support</artifactId>
  <scope>test</scope>
</dependency>