(() => (
servers.map((s) => ({
id: s.id,
@@ -658,13 +690,14 @@ function RecursiveRoutesContent({ mode, backendUrl }: { mode: string; backendUrl
items={rrRailItems}
selectedId={selectedServerId}
onSelect={id => {
- if (writeLock.current || id === selectedServerId) return
+ if (writeLock.current || sharedBusy || id === selectedServerId) return
readEpoch.current++; gatewayEpoch.current++; historyEpoch.current++
setSelectedServerId(id); setRows([]); setRouteOwner(""); setLiveStale(true); setBusy(null)
setGatewayOptions([]); setGatewayError(null); setOpError(null); setSaveError(null)
setReadAt(null); setWriteAt(null); setSheetOpen(false); setHistoryOpen(false); setRevisions([]); setHistoryError(null)
- setExpandedGroupKey(null)
+ patchUrl({ serverId: id, route: null, table: null })
}}
+ preserveSelection={true}
showAll={false}
showCount={false}
loading={isLive && !liveServerListReady}
@@ -727,6 +760,9 @@ function RecursiveRoutesContent({ mode, backendUrl }: { mode: string; backendUrl
{!hasRouteSnapshot ? "Количество неизвестно" : filteredRows.length !== rows.length ? `${filteredRows.length} из ${rows.length} маршрутов` : `${rows.length} маршрутов`}
+ {sharedBusy && busy !== "apply" && Операция предыдущего контекста ещё выполняется. Изменения заблокированы до ответа API.
}
+ {contextError && {contextError}. Выберите устройство или сбросьте ссылку.
}
+ {expandedGroupKey && !liveStale && !groupedRoutes.some(group => group.key === expandedGroupKey) && Маршрут из ссылки отсутствует в текущем срезе.
}
{(opError || saveError) && (
{opError || saveError}
@@ -776,7 +812,10 @@ function RecursiveRoutesContent({ mode, backendUrl }: { mode: string; backendUrl
emptyTitle={liveStale ? "Маршруты пока неизвестны" : search ? "Нет маршрутов по текущему поиску" : undefined}
groups={groupedRoutes.map((g) => ({ ...g, id: g.key }))}
expandedKey={expandedGroupKey}
- onExpandedChange={setExpandedGroupKey}
+ onExpandedChange={key => {
+ const group = groupedRoutes.find(group => group.key === key)
+ patchUrl({ route: group?.dstAddress ?? null, table: group?.routingTable ?? null })
+ }}
mutationsDisabled={mutationsLocked}
onEdit={openEdit}
onDelete={(g) => {
@@ -813,7 +852,7 @@ function RecursiveRoutesContent({ mode, backendUrl }: { mode: string; backendUrl
itemLabel="маршрутов"
revisions={revisions}
loading={historyLoading}
- restoreDisabled={!can("mm:network:write") || !currentServer?.enabled || busy !== null && !historyRestoring}
+ restoreDisabled={!can("mm:network:write") || !currentServer?.enabled || (busy !== null || sharedBusy) && !historyRestoring}
restoring={historyRestoring}
onRestore={restoreRevision}
/>
diff --git a/docs/ux-ui-progress.md b/docs/ux-ui-progress.md
index 5fb4bdd5..8d54c559 100644
--- a/docs/ux-ui-progress.md
+++ b/docs/ux-ui-progress.md
@@ -26,11 +26,20 @@
| 7 | Серверы и мониторинг: детали, формы, URL-контекст, права | Завершён в границах локальной приёмки 2026-09-23; внешние ограничения ниже |
| 8 | Трафик и статистика | Завершён 2026-09-28 в границах локальной приёмки; ограничения в блоке 8.13 |
| 9 | VPN, Firewall и Filters | Завершён в границах локальной приёмки 2026-09-30; блоки 9.1–9.64, ограничения в 9.64 |
-| 10 | Маршрутизация, диагностика, карта и терминал | В работе: 10.1–10.25; операции/валидация рекурсивных маршрутов, далее URL/source |
+| 10 | Маршрутизация, диагностика, карта и терминал | В работе: 10.1–10.26; URL/source маршрутов, далее observed metadata |
| 11А | Пользователи, контейнеры, сертификаты и резервные копии | Не начат |
| 11Б | Оповещения, сбор данных, интеграции, релизы и настройки | Не начат |
| 12 | Итоговая доступность, адаптивность, производительность и регрессия | Не начат |
+## Блок 10.26 — URL и source/history рекурсивных маршрутов (2026-09-30)
+
+- server/q/route/table сохранены в URL. Default устройство записывается через replace; выбор/раскрытие используют history, поиск replace. Чужие query-поля сохранены. Missing/invalid/repeated/oversized контекст блокирует срез; route требует table. Отсутствующая группа закрывается отдельно.
+- ServerRail preserveSelection исключает автоматический переход с отсутствующего устройства на первый сервер. Предварительная проверка выявила этот fallback; исправление подтверждено.
+- Общий lock живёт над device context и привязан к mode/backend. URL/history не снимает pending запись; завершение перечитывает текущий контекст соответствующего источника. Late read/write старого backend/режима не меняют новый снимок и не показывают старые toast/error.
+- Путь recursive-routes использует mm:network:read, как backend. Readonly/disabled устройства по-прежнему не могут сохранять или восстанавливать.
+- Проверки: 38 разных основных E2E в совокупности (первый прогон 37/38, после исправления missing-device прошли все 11 links), восемь source E2E, два unit, TS/lint и production frontend 34 страницы прошли. Source mock проверки используют фактическую заглушку раздела, без требования отсутствующей mode badge.
+- Далее 10.27: строгие наблюдаемые поля маршрутов/шлюзов; затем layout/keyboard/screens и профильная приёмка. Legacy mapper ещё подставляет distance/default flags, реальный RouterOS/DB/JWT не проверен. Последняя квота: 46% окна, 38% недели использовано. Локальный коммит без push.
+
## Блок 10.25 — backend-валидация рекурсивных операций (2026-09-30)
- PUT требует явные serverId/routes и валидные параметры каждого маршрута; отсутствие routes не превращается в удаление всех managed-маршрутов. Пустой массив остаётся допустимым намеренным действием. Нули distance/scope/targetScope сохраняются.
diff --git a/docs/ux-ui-stage-10.md b/docs/ux-ui-stage-10.md
index 39c86b67..6dba5b74 100644
--- a/docs/ux-ui-stage-10.md
+++ b/docs/ux-ui-stage-10.md
@@ -152,3 +152,7 @@ Strict receipts/serverId, общая блокировка save/delete/restore,
## 10.25. Валидация PUT/restore
Явный список и точный serverId обязательны; повреждённая версия не превращается в empty/default конфигурацию. HTTP injection проверяет отказ до сети; auth/config-sync/build/lint прошли. Intentional empty и canonical snapshot без id совместимы; алгоритм применения прежний. Далее URL/source, observed parser и layout.
+
+## 10.26. URL/history/source
+
+server/q/route/table принадлежат экрану; default replace, выбор/раскрытие history. Missing-device fallback панели запрещён. Source lock сохраняется над device context; late write освобождает lock и запускает чтение текущего среза только соответствующего источника. 38 разных основных + 8 source E2E, 2 unit, TS/lint и production frontend прошли. Далее observed metadata и layout.
diff --git a/lib/auth.ts b/lib/auth.ts
index d6a1b3fe..add91bdb 100644
--- a/lib/auth.ts
+++ b/lib/auth.ts
@@ -241,6 +241,7 @@ export function permissionForPath(pathname: string): string | null {
if (pathname.startsWith("/certificates")) return "mm:certificates:read"
if (
pathname.startsWith("/network") ||
+ pathname.startsWith("/recursive-routes") ||
pathname.startsWith("/ospf") ||
pathname.startsWith("/route-optimizer")
) {
diff --git a/lib/recursive-route-url-state.test.ts b/lib/recursive-route-url-state.test.ts
new file mode 100644
index 00000000..c50635bd
--- /dev/null
+++ b/lib/recursive-route-url-state.test.ts
@@ -0,0 +1,14 @@
+import {test} from "node:test"
+import assert from "node:assert/strict"
+import {readRecursiveUrl,patchRecursiveUrl} from "./recursive-route-url-state"
+import {permissionForPath} from "./auth"
+test("recursive context roundtrip owns only its URL fields",()=>{
+ const params=new URLSearchParams("keep=x&server=2&q=ether&route=10.0.0.0%2F24&table=main")
+ assert.deepEqual(readRecursiveUrl(params),{serverId:"2",q:"ether",route:"10.0.0.0/24",table:"main",error:null})
+ const next=patchRecursiveUrl(params,{serverId:"1",q:null,route:null,table:null})
+ assert.equal(next.get("keep"),"x");assert.equal(next.get("server"),"1");assert.equal(next.has("q"),false)
+ assert.equal(permissionForPath("/recursive-routes"),"mm:network:read")
+})
+test("recursive invalid or ambiguous URL never guesses a device/group",()=>{
+ for(const q of ["server=0","server=srv1","server=1&server=2","route=10.0.0.0/24","table=main","q=a&q=b","q="+"x".repeat(257)]) assert.ok(readRecursiveUrl(new URLSearchParams(q)).error,q)
+})
diff --git a/lib/recursive-route-url-state.ts b/lib/recursive-route-url-state.ts
new file mode 100644
index 00000000..c77f64c3
--- /dev/null
+++ b/lib/recursive-route-url-state.ts
@@ -0,0 +1,22 @@
+export type RecursiveUrlState = { serverId: string | null; q: string; route: string | null; table: string | null; error: string | null }
+export type RecursiveUrlPatch = Partial<{ serverId: string | null; q: string | null; route: string | null; table: string | null }>
+export function readRecursiveUrl(params: URLSearchParams): RecursiveUrlState {
+ const result: RecursiveUrlState = { serverId: null, q: "", route: null, table: null, error: null }
+ for (const [key, limit] of [["server", 64], ["q", 256], ["route", 128], ["table", 256]] as const) {
+ const values = params.getAll(key)
+ if (values.length > 1 || values.some(value => value.length > limit)) return { ...result, error: "Некорректный контекст маршрутов в ссылке" }
+ }
+ const server = params.get("server"), q = params.get("q")?.trim() ?? ""
+ if (server !== null && !/^[1-9]\d*$/.test(server)) return { ...result, error: "Некорректное устройство в ссылке" }
+ const route = params.get("route")?.trim() ?? null, table = params.get("table")?.trim() ?? null
+ if ((route !== null || table !== null) && (!route || !table)) return { ...result, error: "В ссылке маршрута нужны адрес и таблица" }
+ return { serverId: server, q, route, table, error: null }
+}
+export function patchRecursiveUrl(params: URLSearchParams, patch: RecursiveUrlPatch): URLSearchParams {
+ const next = new URLSearchParams(params)
+ for (const [field, value] of Object.entries(patch)) {
+ const key = field === "serverId" ? "server" : field
+ if (value === null || value.trim() === "") next.delete(key); else next.set(key, value.trim())
+ }
+ return next
+}
diff --git a/playwright.config.ts b/playwright.config.ts
index 2345ae78..980a554a 100644
--- a/playwright.config.ts
+++ b/playwright.config.ts
@@ -2,7 +2,7 @@ import { defineConfig } from "@playwright/test"
export default defineConfig({
testDir: "./tests/e2e",
- testIgnore: ["**/ospf-context.spec.ts", "**/bgp-context.spec.ts", "**/firewall-context.spec.ts", "**/filters-context.spec.ts", "**/ipsec-context.spec.ts", "**/gre-context.spec.ts", "**/vxlan-context.spec.ts"],
+ testIgnore: ["**/recursive-routes-context.spec.ts", "**/ospf-context.spec.ts", "**/bgp-context.spec.ts", "**/firewall-context.spec.ts", "**/filters-context.spec.ts", "**/ipsec-context.spec.ts", "**/gre-context.spec.ts", "**/vxlan-context.spec.ts"],
fullyParallel: false,
workers: 1,
retries: 0,
diff --git a/playwright.recursive-routes-context.config.ts b/playwright.recursive-routes-context.config.ts
new file mode 100644
index 00000000..5aeaf059
--- /dev/null
+++ b/playwright.recursive-routes-context.config.ts
@@ -0,0 +1,8 @@
+import { defineConfig } from "@playwright/test"
+import base from "./playwright.config"
+const server=base.webServer
+if(!server||Array.isArray(server))throw new Error("Ожидается один локальный сервер")
+export default defineConfig({
+ ...base, use:{...base.use,baseURL:"http://127.0.0.1:3101"},testIgnore:[],testMatch:"recursive-routes-context.spec.ts",
+ webServer:{...server,command:"node node_modules/next/dist/bin/next dev --hostname 127.0.0.1 --port 3101",url:"http://127.0.0.1:3101",env:{...server.env,NEXT_PUBLIC_BACKEND_URL:"local"}},
+})
diff --git a/tests/e2e/recursive-routes-context.spec.ts b/tests/e2e/recursive-routes-context.spec.ts
new file mode 100644
index 00000000..3cb7303e
--- /dev/null
+++ b/tests/e2e/recursive-routes-context.spec.ts
@@ -0,0 +1,39 @@
+import {test,expect} from "@playwright/test"
+const headers={"access-control-allow-origin":"*","access-control-allow-methods":"GET,PUT,POST,OPTIONS","access-control-allow-headers":"Content-Type,Authorization"}
+const device={id:1,name:"Роутер 1",host:"192.0.2.1",country:"RU",enabled:true,status:null}
+const row=(name:string)=>({id:"one",dstAddress:"10.0.0.0/24",gateway:"192.0.2.1",distance:1,scope:30,targetScope:10,routingTable:"main",checkGateway:"ping",comment:name,disabled:false,country:""})
+for(const change of ["backend","mode"])for(const operation of ["read","write"])for(const fails of [false,true])test("Маршруты: поздний "+operation+" после смены "+change+"/"+fails,async({page})=>{
+ let newReads=0
+ await page.route("**/health",r=>r.fulfill({headers,json:{ok:true}}))
+ await page.route("**/api/**",r=>{
+ const u=new URL(r.request().url()),p=u.pathname;if(p==="/api/recursive-routes"&&u.port==="8101")newReads++
+ return r.fulfill({headers,json:p==="/api/servers"?[device]:p==="/api/auth/config"?{required:false}:p==="/api/recursive-routes"?{serverId:1,routes:[row(u.port==="8101"?"Новый снимок":"Старый снимок")],live:true,stale:false}:p==="/api/recursive-routes/gateways"?{serverId:1,gateways:[]}:{} })
+ })
+ await page.goto("/settings");await page.getByRole("link",{name:/^Рекурсивные маршруты/}).click()
+ await expect(page.locator("tr[data-row-id]")).toContainText("Старый снимок")
+ let started=false,release!:()=>void;const gate=new Promise(resolve=>{release=resolve})
+ await page.route("**/api/recursive-routes*",async r=>{
+ const u=new URL(r.request().url());if(u.port!=="8000"||u.pathname!=="/api/recursive-routes"||r.request().method()!==(operation==="read"?"GET":"PUT"))return r.fallback()
+ started=true;await gate
+ return r.fulfill(fails?{headers,status:503,json:{error:"Старая ошибка маршрутов"}}:{headers,json:operation==="read"?{serverId:1,routes:[],live:true,stale:false}:{ok:true,serverId:1,routes:r.request().postDataJSON().routes,pushedRoutes:r.request().postDataJSON().routes.length}})
+ })
+ if(operation==="read")await page.getByRole("button",{name:"Обновить",exact:true}).click()
+ else{
+ await page.getByRole("button",{name:"Добавить",exact:true}).click()
+ const sheet=page.getByRole("dialog");await sheet.getByPlaceholder("8.8.8.8/32").fill("203.0.113.0/24");await sheet.getByPlaceholder("1.2.3.4%GW-NAME").fill("192.0.2.9")
+ await sheet.getByRole("button",{name:"Добавить",exact:true}).click()
+ }
+ await expect.poll(()=>started).toBe(true);await page.goBack();await expect(page).toHaveURL(/settings/)
+ if(change==="backend"){const input=page.getByPlaceholder("http://localhost:8000");await input.fill("http://localhost:8101");await input.press("Enter")}
+ else await page.getByRole("button",{name:"Моковые",exact:true}).click()
+ await page.getByRole("link",{name:/^Рекурсивные маршруты/}).click()
+ if(change==="backend")await expect(page.locator("tr[data-row-id]")).toContainText("Новый снимок")
+ else await expect(page.getByText("Раздел работает в режиме",{exact:false})).toBeVisible()
+ const before=newReads,response=page.waitForResponse(r=>new URL(r.url()).port==="8000"&&new URL(r.url()).pathname==="/api/recursive-routes"&&r.request().method()===(operation==="read"?"GET":"PUT"))
+ release();await(await response).finished()
+ await page.evaluate(()=>new Promise(resolve=>requestAnimationFrame(()=>requestAnimationFrame(()=>resolve()))))
+ if(change==="backend")await expect(page.locator("tr[data-row-id]")).toContainText("Новый снимок")
+ await expect(page.getByText("Старая ошибка маршрутов",{exact:false})).toHaveCount(0)
+ await expect(page.locator("[data-sonner-toast]").filter({hasText:"Маршруты применены на роутер"})).toHaveCount(0)
+ expect(newReads).toBe(before)
+})
diff --git a/tests/e2e/recursive-routes-links.spec.ts b/tests/e2e/recursive-routes-links.spec.ts
new file mode 100644
index 00000000..28f0e6eb
--- /dev/null
+++ b/tests/e2e/recursive-routes-links.spec.ts
@@ -0,0 +1,59 @@
+import {test,expect,type Page} from "@playwright/test"
+const devices=[1,2].map(id=>({id,name:"Роутер "+id,host:"192.0.2."+id,country:"RU",enabled:true,status:null}))
+const row=(id:number)=>({id:"r"+id,dstAddress:"10.0."+id+".0/24",gateway:"192.0.2."+id,distance:1,scope:30,targetScope:10,routingTable:"main",checkGateway:"ping",comment:"Маршрут "+id,disabled:false,country:"RU"})
+async function setup(page:Page) {
+ await page.route("**/health",r=>r.fulfill({json:{ok:true}}))
+ await page.route("**/api/**",r=>{const u=new URL(r.request().url()),p=u.pathname,id=Number(u.searchParams.get("serverId"));return r.fulfill({json:p==="/api/servers"?devices:p==="/api/auth/config"?{required:false}:p==="/api/recursive-routes"?{serverId:id,routes:[row(id)],live:true,stale:false}:p==="/api/recursive-routes/gateways"?{serverId:id,gateways:[]}:{} })})
+}
+test("Маршруты: устройство, поиск и раскрытие переживают reload/history",async({page})=>{
+ await setup(page);await page.goto("/recursive-routes?server=2&q=10.0.2&route=10.0.2.0%2F24&table=main&keep=x")
+ await expect(page.getByRole("option").filter({hasText:"Роутер 2"})).toHaveAttribute("aria-selected","true")
+ await expect(page.getByRole("textbox",{name:"Поиск маршрутов"})).toHaveValue("10.0.2")
+ await expect(page.getByText("Endpoint 1",{exact:true})).toBeVisible()
+ await page.reload();await expect(page.getByText("Endpoint 1",{exact:true})).toBeVisible()
+ await page.getByRole("button",{name:"Сбросить поиск маршрутов"}).click()
+ await expect(page).not.toHaveURL(/[?&]q=/)
+ await page.getByRole("option").filter({hasText:"Роутер 1"}).click()
+ await expect(page).toHaveURL(/server=1/);await expect(page).toHaveURL(/keep=x/)
+ await expect(page.getByText("Endpoint 1",{exact:true})).toHaveCount(0)
+ await page.goBack();await expect(page.getByText("Endpoint 1",{exact:true})).toBeVisible()
+ await expect(page.locator("tr[data-row-id]")).toContainText("10.0.2.0/24")
+})
+for(const query of ["server=999","server=broken","server=1&server=2","q=a&q=b","route=10.0.1.0/24","table=main","route=a&route=b&table=main"])test("Маршруты: недоступный URL не расширяет срез "+query,async({page})=>{
+ await setup(page);await page.goto("/recursive-routes?"+query+"&keep=x")
+ const error=page.getByRole("alert").filter({hasText:"ссылк"})
+ await expect(error).toBeVisible();await expect(page.locator("tr[data-row-id]")).toHaveCount(0)
+ await expect(page.getByRole("button",{name:"Добавить",exact:true})).toBeDisabled()
+ await error.getByRole("button",{name:"Сбросить контекст маршрутов"}).click()
+ await expect(page).toHaveURL(/keep=x/);await expect(page.locator("tr[data-row-id]")).toHaveCount(1)
+})
+test("Маршруты: отсутствующая группа закрывается без сброса устройства и поиска",async({page})=>{
+ await setup(page);await page.goto("/recursive-routes?server=2&q=10.0&route=10.0.9.0%2F24&table=main&keep=x")
+ await page.getByRole("button",{name:"Закрыть маршрут",exact:true}).click()
+ await expect(page).toHaveURL(/server=2/);await expect(page).toHaveURL(/q=10.0/);await expect(page).not.toHaveURL(/[?&]route=/)
+ await expect(page.locator("tr[data-row-id]")).toContainText("10.0.2.0/24")
+})
+for(const fails of [false,true])test("Маршруты: history сохраняет lock до завершения записи "+fails,async({page})=>{
+ await setup(page);let writes=0,reads=0;let release!:()=>void;const gate=new Promise(resolve=>{release=resolve})
+ await page.route("**/api/recursive-routes?**",r=>{reads++;const id=Number(new URL(r.request().url()).searchParams.get("serverId"));return r.fulfill({json:{serverId:id,routes:[row(id)],live:true,stale:false}})})
+ await page.route("**/api/recursive-routes",async r=>{writes++;await gate;const next=r.request().postDataJSON().routes;return r.fulfill(fails?{status:503,json:{error:"Старая ошибка записи"}}:{json:{ok:true,serverId:1,routes:next,pushedRoutes:next.length}})})
+ await page.goto("/recursive-routes?server=2")
+ await page.getByRole("option").filter({hasText:"Роутер 1"}).click()
+ await expect(page.getByRole("button",{name:"Добавить",exact:true})).toBeEnabled()
+ await page.getByRole("button",{name:"Добавить",exact:true}).click()
+ const sheet=page.getByRole("dialog")
+ await sheet.getByPlaceholder("8.8.8.8/32").fill("203.0.113.0/24");await sheet.getByPlaceholder("1.2.3.4%GW-NAME").fill("192.0.2.9")
+ await sheet.getByRole("button",{name:"Добавить",exact:true}).click();await expect.poll(()=>writes).toBe(1)
+ await page.goBack();await expect(page).toHaveURL(/server=2/)
+ await expect(page.getByRole("button",{name:"Добавить",exact:true})).toBeDisabled()
+ await expect(page.getByRole("status").filter({hasText:"предыдущего контекста"})).toBeVisible()
+ await page.goForward();await expect(page).toHaveURL(/server=1/)
+ await expect(page.locator("tr[data-row-id]")).toHaveCount(1)
+ await expect(page.getByRole("button",{name:"Добавить",exact:true})).toBeDisabled()
+ const before=reads,response=page.waitForResponse(r=>r.request().method()==="PUT")
+ release();await(await response).finished()
+ await expect.poll(()=>reads).toBe(before+1);await expect(page.getByRole("button",{name:"Добавить",exact:true})).toBeEnabled()
+ await expect(page.getByRole("dialog")).toHaveCount(0);await expect(page.getByText("Старая ошибка записи",{exact:false})).toHaveCount(0)
+ await expect(page.locator("[data-sonner-toast]").filter({hasText:"Маршруты применены на роутер"})).toHaveCount(0)
+ expect(writes).toBe(1)
+})