22 lines
1.4 KiB
Markdown
22 lines
1.4 KiB
Markdown
|
# ADR Index — web
|
|||
|
|
|
|||
|
|
Module-level architecture decisions for `code.nochebuena.dev/einherjar/web`.
|
|||
|
|
|
|||
|
|
For framework-wide decisions see the
|
|||
|
|
[Einherjar docs repository](https://code.nochebuena.dev/einherjar/docs).
|
|||
|
|
|
|||
|
|
No module-level ADRs for v1.0.0 — all design decisions were consistent with
|
|||
|
|
existing framework principles (ADR-001 through ADR-003 from `core`, framework
|
|||
|
|
ADRs 001–004 from `docs`). No contested choices required a record.
|
|||
|
|
|
|||
|
|
Decisions worth noting (not ADR-worthy individually):
|
|||
|
|
|
|||
|
|
| Decision | Outcome | Rationale |
|
|||
|
|
|---|---|---|
|
|||
|
|
| `RateLimiterStore` as interface (not concrete) | Interface only; `InMemoryRateLimiterStore` as default | Allows `cache-valkey` to satisfy it via duck typing without cross-module import |
|
|||
|
|
| Fail-open rate limiting | Request allowed on store error | Availability preferred over hard enforcement during infrastructure degradation |
|
|||
|
|
| `last_seen` excluded | Not in v1.0.0 | Application-domain concern; not transport-level middleware |
|
|||
|
|
| UUID v7 for request IDs | v7 with v4 fallback | Time-ordered IDs sort chronologically in logs; fallback ensures generation never fails |
|
|||
|
|
| `observability.Checkable` not redefined | Imported from contracts | Starters implement contracts directly; no web import needed by db/cache starters |
|
|||
|
|
| Background goroutine for in-memory eviction | `time.Ticker` goroutine | Avoids `worker` module dependency; in-memory store is self-contained |
|