From 09a76bc212a9e1d7f5574d3291df5e46ecbec9ec Mon Sep 17 00:00:00 2001
From: brain-marchine <152466993+brain-marchine@users.noreply.github.com>
Date: Sun, 12 Jul 2026 17:34:33 +0800
Subject: [PATCH] docs: document index.ts modularization roadmap

Fixes #13
---
 docs/module-layout.md | 14 ++++++++++++++
 1 file changed, 14 insertions(+)
 create mode 100644 docs/module-layout.md

diff --git a/docs/module-layout.md b/docs/module-layout.md
new file mode 100644
index 0000000..5bcb1f7
--- /dev/null
+++ b/docs/module-layout.md
@@ -0,0 +1,14 @@
+# Module layout roadmap
+
+`src/index.ts` currently hosts routing, middleware, stores, and handlers in
+one file (issue #13). The intended split:
+
+| Module | Responsibility |
+|--------|----------------|
+| `src/routers/` | Express route mounts (`pairs`, `webhooks`, `admin`) |
+| `src/middleware/` | CORS, rate limit, security headers, pause guard |
+| `src/stores.ts` | In-memory registries (already extracted) |
+| `src/validation/` | Shared request validators |
+
+New endpoints should prefer small router modules over growing `index.ts`.
+See `docs/middleware-order.md` and `docs/architecture.md` for current flow.