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
| Capability | Status | What it is, honestly | Proof |
|---|---|---|---|
| Starters | shipped | One 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 metadata | shipped | Every 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 Details | shipped | Stable codes, requestId, 422 with the field errors, a 500 that never leaks its message. | ProblemDetailsAdvice.java |
| Request correlation | shipped | X-Request-Id accepted or created, sent back, in the MDC of every log line. | CorrelationIdFilter.java |
| Cursor pagination | shipped | Opaque cursors, a next page proven without COUNT, size capped. | Cursor.java |
| Security baseline and service tokens | shipped | Stateless chain closed by default, local HS256 verification, SERVICE tokens for /internal/v1. | SecurityBaseline.javaServiceTokenProvider.java |
| Transactional outbox | shipped | Events committed with the state, relayed with leasing (no broker I/O inside a transaction), purged. | OutboxRelay.java |
| Consumer retry and dead letters | shipped | Quorum queue and DLQ in one line, retry with back-off, then dead-lettered with headers. | DeadLetterQueueRecoverer.java |
| Idempotent consumption | shipped | One INSERT claims a message; a failure releases the claim, so nothing is silently dropped. | JdbcMessageDedup.java |
| HTTP Idempotency-Key | shipped | At 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 health | shipped | outbox (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 tracing | shipped | Timers 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 compatibility | shipped | 426 Upgrade Required below the minimum, N-1 contracts with Deprecation and Sunset, an audited admin API. | ClientVersionFilter.java |
| Outbox store, migrations and purges | shipped | A 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 webhooks | shipped | Sign, 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 support | partial | PostgreSQL and RabbitMQ containers, ArchUnit rules, event contract tests; @ServiceConnection and lazy containers are missing. | AbstractContainerIntegrationTest.javaArchitectureRules.javaissue #63 |
| Resilience of the clients | partial | The 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 limiting | partial | A 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) | planned | Issuer-signed session tokens and per-caller service tokens instead of one shared secret. | issue #65 |
| OpenAPI | planned | springdoc integration documenting the Problem Details schema; an openapi.json per service contract. | issue #65 |
| Audit trail | planned | A reusable audit module, promoted from app-config and the users admin. | issue #65 |
| Localized errors | planned | Problem Details detail looked up by code in the caller's language. | issue #65 |
| Multi-tenancy | planned | Tenant resolution, in the MDC and in observations. | issue #65 |
| Virtual threads | planned | The kit's schedulers on virtual threads when the application enables them. | issue #65 |
| Native image | planned | RuntimeHints for every auto-configuration and an AOT smoke test in CI. | issue #65 |