Skip to the content
Krizaka Java
Skip to Content
Krizaka Java

Features

What Krizaka Java ships, partly ships and plans — each shipped line backed by code the build checks.

What a Spring Boot 4 team expects of a building-blocks library, and where Krizaka Java stands — honestly. A line marked shipped names the files that prove it, and the site does not build if one of them is missing from main; a line marked partial or planned links the issue that tracks the rest. The audit behind this page is ADR-001.

Shipped means merged and tested. The building blocks merged since the last release reach the next release: check the version of each artifact on the building blocks map.

15 shipped · 3 partial · 7 planned · the roadmap

CapabilityStatusWhat it is, honestlyProof
StartersshippedOne dependency per capability (web, security, RabbitMQ, observability, app-config, idempotency, persistence, webhooks, ratelimit), defaults at the lowest priority, every bean backs off.pom.xml
Configuration metadatashippedEvery krizaka.* property completed by the IDE with its description and default; the reference is generated from it.configuration-metadata.jsonconfiguration-metadata.jsonconfiguration-metadata.json
Errors as RFC 9457 Problem DetailsshippedStable codes, requestId, 422 with the field errors, a 500 that never leaks its message.ProblemDetailsAdvice.java
Request correlationshippedX-Request-Id accepted or created, sent back, in the MDC of every log line.CorrelationIdFilter.java
Cursor paginationshippedOpaque cursors, a next page proven without COUNT, size capped.Cursor.java
Security baseline and service tokensshippedStateless chain closed by default, local HS256 verification, SERVICE tokens for /internal/v1.SecurityBaseline.javaServiceTokenProvider.java
Transactional outboxshippedEvents committed with the state, relayed with leasing (no broker I/O inside a transaction), purged.OutboxRelay.java
Consumer retry and dead lettersshippedQuorum queue and DLQ in one line, retry with back-off, then dead-lettered with headers.DeadLetterQueueRecoverer.java
Idempotent consumptionshippedOne INSERT claims a message; a failure releases the claim, so nothing is silently dropped.JdbcMessageDedup.java
HTTP Idempotency-KeyshippedAt most once per key, replay with Idempotent-Replayed, 422 on reuse; PostgreSQL store in the action's transaction. Promoted from Sovkora.Idempotency.javaIdempotencyExampleIT.java
Actuator healthshippedoutbox (DOWN after repeated failures), dedup (the claims table answers) and appConfig (the store answers, maintenance listed), each with its switch.OutboxHealthIndicator.javaMessageDedupHealthIndicator.javaAppConfigHealthIndicator.java
Micrometer observations and tracingshippedTimers and spans for the outbox relay and publish, the dedup and the idempotency keys; common tags; OpenTelemetry in the starter.ObservedMessageDedup.javapom.xml
App version compatibilityshipped426 Upgrade Required below the minimum, N-1 contracts with Deprecation and Sunset, an audited admin API.ClientVersionFilter.java
Outbox store, migrations and purgesshippedA PostgreSQL outbox that leases rows; Flyway creates the declared stores' tables at startup in their own history; message claims purged on a schedule.JdbcOutboxStore.javaKrizakaMigrations.javaKrizakaMigrationsIT.java
Signed webhooksshippedSign, send once and verify Standard Webhooks (constant-time check, replay tolerance, secret rotation, 401 Problem Details); the sender makes one attempt — retries are yours, in the outbox or a job.WebhookVerifier.javaWebhookSender.javaWebhooksExampleTest.java
Test supportpartialPostgreSQL and RabbitMQ containers, ArchUnit rules, event contract tests; @ServiceConnection and lazy containers are missing.AbstractContainerIntegrationTest.javaArchitectureRules.javaissue #63
Resilience of the clientspartialThe billing client has tight timeouts; the users client has none yet, and there is no retry or circuit breaker.org.springframework.boot.autoconfigure.AutoConfiguration.importsissue #65
Rate limitingpartialA token bucket per key (client address or your own key and tier), observe then enforce, 429 with Retry-After as Problem Details. State is in memory per instance: a shared store, and the users service's login lockout, are not promoted yet.RateLimiter.javaRateLimitInterceptor.javaRateLimitExampleTest.javaissue #65
Asymmetric tokens (JWKS)plannedIssuer-signed session tokens and per-caller service tokens instead of one shared secret.issue #65
OpenAPIplannedspringdoc integration documenting the Problem Details schema; an openapi.json per service contract.issue #65
Audit trailplannedA reusable audit module, promoted from app-config and the users admin.issue #65
Localized errorsplannedProblem Details detail looked up by code in the caller's language.issue #65
Multi-tenancyplannedTenant resolution, in the MDC and in observations.issue #65
Virtual threadsplannedThe kit's schedulers on virtual threads when the application enables them.issue #65
Native imageplannedRuntimeHints for every auto-configuration and an AOT smoke test in CI.issue #65