From bcef30eb520f93f1a8b5861d82fa8052cd81b930 Mon Sep 17 00:00:00 2001
From: Claudio Ortolina <cloud8421@gmail.com>
Date: Tue, 17 Mar 2026 11:55:36 +0000
Subject: [PATCH] Document production oban plugins

---
 docs/architecture.md | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/docs/architecture.md b/docs/architecture.md
index b0b4ac05..9475337b 100644
--- a/docs/architecture.md
+++ b/docs/architecture.md
@@ -168,6 +168,14 @@ stubbed via `Req.Test` (configured in `config/test.exs`).
 | `wikipedia` | 1 | Wikipedia calls |
 | `last_fm` | 1 | Last.fm calls (rate-limited at Req layer via `Req.RateLimiter`) |
 
+### Plugins (prod)
+
+| Plugin | Config | Purpose |
+|--------|--------|---------|
+| `Oban.Plugins.Pruner` | `max_age: 43200` (12h) | Prune completed/cancelled/discarded jobs older than 12 hours |
+| `Oban.Plugins.Reindexer` | `schedule: "@weekly"` | Weekly reindex of Oban tables for query performance |
+| `Oban.Plugins.Cron` | `timezone: "Europe/London"` | Scheduled recurring workers (see Cron Workers table) |
+
 ### On-Demand Workers
 
 | Worker | Queue | Trigger |