Skip to content

docs: add architecture decision records#33

Merged
tkahng merged 1 commit into
mainfrom
feat/adrs
May 30, 2026
Merged

docs: add architecture decision records#33
tkahng merged 1 commit into
mainfrom
feat/adrs

Conversation

@tkahng

@tkahng tkahng commented May 30, 2026

Copy link
Copy Markdown
Owner

Summary

  • Adds docs/adr/ directory with 6 Architecture Decision Records documenting non-obvious design choices in the Garden platform
  • Covers: JWT stateless auth, Spring transactional event listeners, webhook outbox pattern, Flyway schema migrations, Stripe Checkout + Tax, and the B2B quote workflow

ADRs included

# Decision
0001 JWT over server-side sessions
0002 Spring domain events for post-commit side effects (@TransactionalEventListener)
0003 Outbox table + scheduled poller for outbound webhooks
0004 Flyway for schema evolution
0005 Stripe Checkout + Stripe Tax
0006 B2B quote → review → PDF → accept → order flow

Each ADR follows the lightweight Nygard format: context, decision, consequences (positive and negative).

Test plan

  • Read through each ADR for accuracy against the codebase
  • Verify links in docs/adr/README.md resolve correctly

Six ADRs documenting key design choices: JWT auth, transactional event
listeners, webhook outbox pattern, Flyway migrations, Stripe Checkout/Tax,
and B2B quote workflow.
@tkahng tkahng enabled auto-merge (squash) May 30, 2026 06:46
@tkahng tkahng merged commit ee744bd into main May 30, 2026
3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant