docs: recommend web-split before domain-admin and inbound-relay

Document the preferred implementation order in the roadmap and linked plans.

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
mixeme
2026-08-09 13:17:54 +03:00
parent 012802d83d
commit 870012514a
4 changed files with 36 additions and 11 deletions
+14 -1
View File
@@ -22,11 +22,24 @@ static), ~25 `.go` / ~4000 строк Go, в одной плоскости ле
разбиение потянуло бы за собой экспорт того, что сейчас пакетно-приватно, — то
есть расширение внутреннего API ради косметики.
Смысл появляется, когда пакет начнёт расти: **inbound-relay** и **domain-admin**
Смысл появляется, когда пакет начнёт расти: **domain-admin** и **inbound-relay**
добавляют в него код — роль приносит авторизацию в каждый хендлер, входящий
релей — отдельные страницы и хендлеры входящих доменов. Рефакторинг дешевле
делать перед этим ростом, чем после.
## Рекомендуемый порядок
**web-split → domain-admin → inbound-relay** (см. [roadmap](../roadmap.md)).
1. **web-split** — заложить структуру пакета (в т.ч. место под `web/auth`), пока
нет сквозных правок от роли и новых inbound-хендлеров.
2. **domain-admin** — авторизация в каждом хендлере опирается на уже выбранную
схему пакета.
3. **inbound-relay** — новый вертикальный срез; проще добавить в уже разрезанный
пакет, чем рефакторить вместе с двумя предыдущими фичами.
Порядок рекомендация, не блокер.
## Готово, когда
Решение принято осознанно в момент старта работ — либо пакет разрезан по