86: Add AssetAZ Journal Service with durable PDE event journal and replayable consumers

2026-09-12 14:26:20 +02:00
parent f1dd5ed9b1
commit a5caa4c6b5
32 changed files with 1076 additions and 0 deletions
@@ -0,0 +1,28 @@
+## Why
+
+AssetAZ needs an authoritative durable event history from which services can reconstruct their models and establish causal freshness. Gitea issue #86 defines a deliberately strict first version.
+
+## What Changes
+
+- Add an append-only PDE journal with SHA-256 integrity, durable sequence commitment and fail-closed writes.
+- Add domain events and registry-provided positional event codecs, independent of Java class naming.
+- Add independent virtual-thread subscriptions, replay, exact filtering, progress barriers and isolated degradation.
+- Add reusable bounded PDE primitive encoding and decoding.
+
+## Capabilities
+
+### New Capabilities
+- `assetaz-journal`: Persistence, event schemas, replay and consumer consistency contracts.
+- `pde-encoding`: Minimal bounded PDE primitives and object framing.
+
+### Modified Capabilities
+
+None.
+
+## Impact
+
+New AssetAZ API and reference implementation packages, a reusable PDE library, and explicit codec/process entries in the existing Hub composition root. No new dependencies. The Nenjim artifact journal is separate and unchanged.
+
+## Non-goals
+
+No snapshots, repair, truncation, retries, consumer recovery, unregister, restart support, adaptive limits, pools, generalized serialization, reflection discovery, migration, PDL, signatures, causation IDs or unrelated thread changes.