Fonctionnalités
Ce que Krizaka Java livre, livre en partie et prévoit — chaque ligne livrée adossée à du code que le build vérifie.
Ce qu'une équipe Spring Boot 4 attend d'une bibliothèque de briques, et où en est Krizaka Java — honnêtement. Une ligne
livrée nomme les fichiers qui la prouvent, et le site ne se construit pas si l'un d'eux manque sur main ; une ligne
partielle ou prévue renvoie à l'issue qui suit le reste. L'audit derrière cette page est
l'ADR-001.
Livré veut dire fusionné et testé. Les briques fusionnées depuis la dernière release arrivent avec la prochaine release : vérifie la version de chaque artefact sur la carte des briques.
15 livré · 3 partiel · 7 prévu · la feuille de route
| Capacité | Statut | Ce que c'est, honnêtement | Preuve |
|---|---|---|---|
| Starters | livré | Une dépendance par capacité (web, sécurité, RabbitMQ, observabilité, app-config, idempotence, persistance), des défauts à la plus basse priorité, chaque bean s'efface. | pom.xml |
| Métadonnées de configuration | livré | Chaque propriété krizaka.* complétée par l'IDE avec sa description et son défaut ; la référence en est générée. | configuration-metadata.jsonconfiguration-metadata.jsonconfiguration-metadata.json |
| Erreurs en Problem Details (RFC 9457) | livré | Codes stables, requestId, 422 avec les erreurs par champ, un 500 qui ne laisse jamais fuir son message. | ProblemDetailsAdvice.java |
| Corrélation des requêtes | livré | X-Request-Id accepté ou créé, renvoyé, dans le MDC de chaque ligne de log. | CorrelationIdFilter.java |
| Pagination par curseur | livré | Curseurs opaques, page suivante prouvée sans COUNT, taille plafonnée. | Cursor.java |
| Socle de sécurité et jetons de service | livré | Chaîne sans état fermée par défaut, vérification HS256 locale, jetons SERVICE pour /internal/v1. | SecurityBaseline.javaServiceTokenProvider.java |
| Outbox transactionnelle | livré | Événements validés avec l'état, relayés par bail (aucune E/S broker dans une transaction), purgés. | OutboxRelay.java |
| Reprise et lettres mortes | livré | File quorum et DLQ en une ligne, reprise avec back-off, puis lettre morte avec ses en-têtes. | DeadLetterQueueRecoverer.java |
| Consommation idempotente | livré | Un INSERT réserve un message ; un échec libère la réservation, rien n'est perdu en silence. | JdbcMessageDedup.java |
| Idempotency-Key HTTP | livré | Au plus une fois par clé, rejeu avec Idempotent-Replayed, 422 en cas de réutilisation ; stockage PostgreSQL dans la transaction de l'action. Promu depuis Sovkora. | Idempotency.javaIdempotencyExampleIT.java |
| Santé Actuator | livré | outbox (DOWN après des échecs répétés), dedup (la table des réservations répond) et appConfig (le stockage répond, maintenances listées), chacun avec son interrupteur. | OutboxHealthIndicator.javaMessageDedupHealthIndicator.javaAppConfigHealthIndicator.java |
| Observations Micrometer et traces | livré | Timers et spans pour le relais et la publication de l'outbox, la déduplication et les clés d'idempotence ; tags communs ; OpenTelemetry dans le starter. | ObservedMessageDedup.javapom.xml |
| Compatibilité des versions d'app | livré | 426 Upgrade Required sous le minimum, contrats N-1 avec Deprecation et Sunset, une API d'administration auditée. | ClientVersionFilter.java |
| Stockage d'outbox, migrations et purges | livré | Une outbox PostgreSQL qui loue ses lignes ; Flyway crée au démarrage les tables des stockages déclarés, dans leur propre historique ; réservations de messages purgées à intervalle. | JdbcOutboxStore.javaKrizakaMigrations.javaKrizakaMigrationsIT.java |
| Webhooks signés | livré | Signer, envoyer une fois et vérifier des Standard Webhooks (comparaison en temps constant, tolérance au rejeu, rotation des secrets, 401 Problem Details) ; l'envoi est une tentative — les reprises sont à vous, dans l'outbox ou un job. | WebhookVerifier.javaWebhookSender.javaWebhooksExampleTest.java |
| Outils de test | partiel | Conteneurs PostgreSQL et RabbitMQ, règles ArchUnit, tests de contrat d'événements ; @ServiceConnection et conteneurs paresseux manquent. | AbstractContainerIntegrationTest.javaArchitectureRules.javaissue #63 |
| Résilience des clients | partiel | Le client billing a des délais serrés ; le client users n'en a pas encore, et il n'y a ni reprise ni disjoncteur. | org.springframework.boot.autoconfigure.AutoConfiguration.importsissue #65 |
| Limitation de débit | partiel | Un seau à jetons par clé (adresse du client, ou votre clé et son palier), observe puis enforce, 429 avec Retry-After en Problem Details. L'état est en mémoire, par instance : un stockage partagé, et le verrouillage de connexion du service users, ne sont pas encore promus. | RateLimiter.javaRateLimitInterceptor.javaRateLimitExampleTest.javaissue #65 |
| Jetons asymétriques (JWKS) | prévu | Jetons de session signés par l'émetteur et jetons de service par appelant, au lieu d'un secret partagé. | issue #65 |
| OpenAPI | prévu | Intégration springdoc qui documente le schéma Problem Details ; un openapi.json par contrat de service. | issue #65 |
| Piste d'audit | prévu | Un module d'audit réutilisable, promu depuis app-config et l'administration users. | issue #65 |
| Erreurs localisées | prévu | Le détail des Problem Details cherché par code dans la langue de l'appelant. | issue #65 |
| Multi-locataire | prévu | Résolution du locataire, dans le MDC et dans les observations. | issue #65 |
| Threads virtuels | prévu | Les ordonnanceurs du kit sur threads virtuels quand l'application les active. | issue #65 |
| Image native | prévu | RuntimeHints pour chaque auto-configuration et un test AOT en CI. | issue #65 |