Commit 2f229dd
committed
docs(stovepipe): align record RFC with the shipped stage and hook framework
The record stage landed in #555 while this doc still read as a proposal,
so the RFC described a design rather than the code. Re-frames it as-built
and corrects the contract details that drifted: ValidationFact carries no
Queue field (the queue is the store binding and the leading PK column),
Get takes (uri, project), the Record payload carries queue_name beside the
request id, degrees are the named DegreeGreen/DegreeBroken constants,
LastGreenRequestID is shipped rather than proposed, and the bookmark's CAS
conflict is absorbed by the retry loop rather than returned. Adds the two
algorithm steps the doc omitted (deserialize, per-queue storage resolution)
and the ordering rationale for advancing the bookmark only after the fact
is durable.
Replaces the inline Hooks design with integration against hook-framework.md,
which supersedes it: a HookEvent published to a per-domain hook topic and
dispatched to a pluggable extension, not a Notify() call out of the stage.
Records where the publish belongs, the event shape, and the decision that
`type` names the scope (validation.repository.recorded) rather than the
outcome, since scope is the axis consumers cannot route on later.
Documents that record_dlq has no consumer even though dead-lettering is
enabled on the subscription, so rejected messages accumulate unread.1 parent cae3240 commit 2f229dd
3 files changed
Lines changed: 170 additions & 97 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
28 | 28 | | |
29 | 29 | | |
30 | 30 | | |
31 | | - | |
| 31 | + | |
32 | 32 | | |
33 | 33 | | |
34 | 34 | | |
| |||
0 commit comments