Repository navigation

Name		Name	Last commit message	Last commit date
parent directory ..
0001-record-architecture-decisions.md		0001-record-architecture-decisions.md
0002-no-service-registry.md		0002-no-service-registry.md
0003-jwt-rs256-jwks.md		0003-jwt-rs256-jwks.md
0004-transactional-outbox-polling.md		0004-transactional-outbox-polling.md
0005-idempotent-consumer.md		0005-idempotent-consumer.md
0006-sales-saga-orchestration.md		0006-sales-saga-orchestration.md
0007-domain-service-jwt-jwks.md		0007-domain-service-jwt-jwks.md
0008-authoritative-inventory-reservation-reconciliation.md		0008-authoritative-inventory-reservation-reconciliation.md
0009-persisted-assistant-boundary.md		0009-persisted-assistant-boundary.md
0010-observability-stack.md		0010-observability-stack.md
0011-monorepo-strategy.md		0011-monorepo-strategy.md
0012-database-per-service.md		0012-database-per-service.md
0013-kafka-event-communication.md		0013-kafka-event-communication.md
0014-api-gateway-and-same-origin-edge.md		0014-api-gateway-and-same-origin-edge.md
0015-authenticated-mqtt-iot-ingestion.md		0015-authenticated-mqtt-iot-ingestion.md
README.md		README.md
template.md		template.md

README.md

Architecture decision records

Accepted decisions are append-only. Supersede an ADR with a new record rather than rewriting history.

Decision index

ADR	Decision	Status	Date
0001	Record architecture decisions	Accepted	2026-07-16
0002	No service registry	Accepted	2026-07-16
0003	RS256 access tokens with JWKS	Accepted	2026-07-16
0004	Transactional outbox with polling publishers	Accepted	2026-07-16
0005	Idempotent consumers with processed-event ledgers	Accepted	2026-07-16
0006	Sales inventory saga orchestration	Accepted	2026-07-16
0007	Domain services validate JWT via Identity JWKS	Accepted	2026-07-16
0008	Authoritative Inventory reservation reconciliation	Accepted	2026-07-20
0009	Persisted assistant and same-origin web boundary	Accepted	2026-07-22
0010	OpenTelemetry observability stack	Accepted	2026-07-22
0011	Maven and pnpm monorepo	Accepted	2026-07-23
0012	Database per service	Accepted	2026-07-23
0013	Kafka for domain event communication	Accepted	2026-07-23
0014	API gateway and same-origin browser edge	Accepted	2026-07-23
0015	Authenticated MQTT for IoT ingestion	Accepted	2026-07-23

Lifecycle

Copy the template.
Use the next four-digit number and a descriptive kebab-case name.
Include context, decision, consequences, alternatives, trade-offs, and evidence links.
Mark the record Accepted only after implementation and verification agree.