~/About~/Systems~/Foundry~/Blueprint~/Journal~/Projects
Book a Call

The Journal

Essays on architectural decisions, engineering trade-offs, and the thinking behind the systems.

Showing 29 entries

Technical essays compared by failure mode, constraints, code evidence, and system context.

+89 more tags inside entries

From the Inventory Allocation Simulator system

A planner approved a transfer after the warehouse data changed. The only honest answer was to freeze the run inputs before solving.

juliaoptimizationsimulation
Code SampleFailureConstraintSurprise

May 28, 2026

5 min read

Open entry

From the Compliance Document Substrate system

The docs CLI proved that a document type can be reachable while still bypassing the service that owns its legal behavior.

api-designclidispatch
Code SampleFailureConstraint

May 11, 2026

3 min read

Open entry

From the Compliance Document Substrate system

Entity snapshots turned legal identity from template text into durable document state, including the dormant Nigerian Ltd constraint.

entity-scopecompliancesnapshots
Code SampleFailureConstraint

May 11, 2026

3 min read

Open entry

From the Compliance Document Substrate system

The invoice send path refuses to invent a valid-looking document when XML, PDF/A, or signing checks fail.

factur-xxrechnungpdf-a
Code SampleFailure

May 11, 2026

3 min read

Open entry

From the Compliance Document Substrate system

Each finalized document enters a per-entity chain so later verification can prove order, content, and tamper evidence.

hash-chainauditpostgres
Code Sample

May 11, 2026

2 min read

Open entry

From the Compliance Document Substrate system

Document numbers are reserved before finalization, reclaimed after failure, and isolated by entity, type, and year.

numberingpostgresconcurrency
Code SampleFailure

May 11, 2026

2 min read

Open entry

From the Dispute Resolution Workbench system

A 0.70 correlation score can still attach the wrong exception to the wrong case. I made confidence create a decision, not mutate the dispute.

clojurecorrelationfinance-operations
Code SampleFailureConstraintSurprise

May 6, 2026

8 min read

Open entry

From the SLA Penalty Settlement Engine system

A penalty row without its mirror is worse than a missing accrual. The ledger had to reject half-truths before SQL ever saw them.

fsharpledger-designdomain-modeling
Code SampleFailureConstraintSurprise

May 5, 2026

8 min read

Open entry

From the Event-Driven Notification Hub system

Per-tenant rate limit silently capped every tenant at the default 200/minute. The rate check ran before auth populated the tenant on the request.

fastifyrate-limitingmulti-tenant
Code SampleFailureConstraintSurprise

Apr 26, 2026

8 min read

Open entry

From the Contract Lifecycle Engine system

False-positive AI obligations create phantom compliance records worse than missed real ones. Every extraction lands in Pending until a human confirms it.

state-machineevent-sourcingai-extraction
Code SampleFailureConstraint

Apr 18, 2026

8 min read

Open entry

From the Invoice Reconciliation Engine system

Vendors copy-paste PO numbers differently, omit sales orders, or pad format noise. A single exact match catches 60%. A five-strategy cascade catches 98%.

kotlinmatching-algorithmsfuzzy-matching
Code SampleFailureConstraintSurprise

Apr 16, 2026

10 min read

Open entry

From the Sensor Telemetry Engine system

A downstream HTTP timeout inside synchronous anomaly evaluation stalled the NATS consumer. 3,000 messages piled up before fire-and-forget tasks fixed it.

rustanomaly-detectionasync
Code SampleFailureConstraintScaling Limit

Apr 15, 2026

8 min read

Open entry

DAGs don't branch natively. Encoding branches in graph structure produced path explosion. Mutable skip sets at runtime kept the topological sort flat.

dag-orchestrationstate-machinesconditional-branching
Code SampleFailureConstraintSurprise

Apr 13, 2026

8 min read

Open entry

From the Transaction Reconciliation Engine system

Bank settlement dates differ from charge dates on 23% of transactions, and 4% by two days. Exact-match reconciliation flags all of them as discrepancies.

Goreconciliationscoring-algorithms
Code SampleFailureConstraintScaling Limit

Mar 21, 2026

5 min read

Open entry

From the Solar Pricing Engine system

Fuzzy matching on the last 15% of solar SKUs paired STP8.0 with STP10.0. Running the pipeline twice beat every fuzzy threshold I tuned.

sku-matchingdata-processingpython
Code SampleFailureConstraintSurprise

Mar 3, 2026

7 min read

Open entry

Get Notified

New system breakdown? You'll know first.