fix(admin): закрыть обещания панели, которые продукт не выполнял

Девятый проход, по итогам приёмки v1.0.0-rc1 на живом Debian 13. Общая тема:
интерфейс обещал оператору то, что продукт умел, но до чего не доходило
управление.

Секрет пира. Подпись под полем предлагала оставить его пустым, сервер умел его
сгенерировать, и генерация была недостижима: в go-playground/validator тег
omitempty НЕ пропускает правило, если поле объявлено указателем и указатель не
nil — hasValue считает указатель на пустую строку «значением». Правило min=6
применялось к пустой строке и отказывало. Ловушка закрыта общим шагом
нормализации DTO, а не тегом на одном поле: та же ловушка ломала фильтр списка
пиров, где очищенный крестиком el-input отправляет `?name=`. Граница проходит по
каждому полю отдельно — у remark пустая строка означает «убрать пометку», у
disabled ноль означает «включён».

Отказы. Любая ошибка любого поля превращалась в слово `invalid`, а слой vo
определял код ответа СРАВНЕНИЕМ текста сообщения — тот же антипаттерн, который
запрещён панели, только на сервере. Ответ несёт errors[{code, field, message,
params}]; панель выбирает фразу по коду и подставляет причины под поля.

Сессия. Ветка «войдите заново» была недостижима дважды: сервер отвечает HTTP 200
на любой отказ, поэтому обработчик ошибок axios не вызывался, а условие в нём
проверяло code === "A0230" и поле msg, которых в этом API никогда не было.
Истёкший токен вдобавок уезжал с кодом системной ошибки.

Иконки. Контракт currentColor был объявлен в двух местах и не действовал: восемь
ассетов несли литеральный fill="#000000" на <path>, а атрибут представления
перебивает унаследованное CSS-свойство. Под это попадали все семь иконок
бокового меню на фоне #181818.

Имя пира. Два правила на одном поле противоречили друг другу (min=1 против
6-32), а копия набора символов в слое контроллеров несла неэкранированный дефис
и впускала `, - . / : ; <` — через панель проходило имя peer/name, которое
импорт того же пира отклонял. Набор символов ЛОГИНА сознательно не сужен и
закреплён тестом: он приходит из HY2XS_ADMIN_USER и оркестратором не
ограничивается.

Добавлены подпись «Разработано во Flamy» с адресом, принадлежащим приложению, и
контрактные тесты панели как обязательный шаг сборки. Их исполняет Bun, а не
vitest: jsdom не вычисляет currentColor и визуальной корректности не доказал бы,
зато vitest привёл бы в граф pnpm audit сотню транзитивных зависимостей.

docs/ разложена по слоям, 11-testing-and-acceptance.md (117 КБ) разбит на пять
частей, добавлен docs/acceptance/ с отчётом о прогоне rc1 и перечнем дефектов.
Обход документации в приёмке стал рекурсивным: плоский docs/*.md после
разнесения по каталогам совпадал бы ровно с одним файлом.

orchestrator/src/commands/reconfigure.ts

@@ -340,7 +340,7 @@ async function ensureInstallStateForOperation(options: ReconfigureOptions): Prom
   if (!state) {
     throw new Error(
       `install state marker is missing: ${INSTALL_STATE_PATH}. ` +
-        "HY2XS v1 требует чистой установки; см. docs/14-legacy-cleanup.md"
+        "HY2XS v1 требует чистой установки; см. docs/operations/14-legacy-cleanup.md"
     );
   }
 

orchestrator/src/config/env.ts

@@ -178,7 +178,7 @@ function normalizeConfigSchemaVersion(value: string | undefined): number {
       "HY2XS_CONFIG_SCHEMA_VERSION отсутствует в конфигурации.\n" +
         "Похоже на конфигурацию предыдущего поколения (0.x) или на неизвестный формат.\n" +
         `HY2XS v1 понимает только схему ${HY2XS_CONFIG_SCHEMA_VERSION} и не выполняет миграцию на месте.\n` +
-        "Очистите старую установку и установите HY2XS v1 с нуля: см. docs/14-legacy-cleanup.md"
+        "Очистите старую установку и установите HY2XS v1 с нуля: см. docs/operations/14-legacy-cleanup.md"
     );
   }
   const parsed = Number(raw);

orchestrator/src/lib/installState.ts

@@ -110,7 +110,7 @@ export function renderGenerationFailure(
     "Расхождения:",
     detail,
     "",
-    "Требуется чистая переустановка: см. docs/14-legacy-cleanup.md"
+    "Требуется чистая переустановка: см. docs/operations/14-legacy-cleanup.md"
   ].join("\n");
 }
 

orchestrator/src/steps/cleanHost.ts

@@ -200,7 +200,7 @@ export function renderLegacyFailure(found: readonly LegacyMarker[]): string {
     "Найденные маркеры:",
     list,
     "",
-    "Очистите сервер и установите HY2XS заново: см. docs/14-legacy-cleanup.md",
+    "Очистите сервер и установите HY2XS заново: см. docs/operations/14-legacy-cleanup.md",
     "или запустите tools/legacy/purge-v0.sh из репозитория."
   ].join("\n");
 }

orchestrator/test/clean-host.test.ts

@@ -157,6 +157,6 @@ describe("clean-host контракт", () => {
     expect(message).toContain("/etc/hy2xs/hy2xs.env");
     expect(message).toContain("hy2xs-admin.service");
     expect(message).toContain("Ни один файл на сервере не изменён");
-    expect(message).toContain("docs/14-legacy-cleanup.md");
+    expect(message).toContain("docs/operations/14-legacy-cleanup.md");
   });
 });

orchestrator/test/install-state.test.ts

@@ -71,7 +71,7 @@ describe("идентификация поколения установки", ()
     const state = currentState({ release_line: 0 });
     const message = renderGenerationFailure(detectGenerationProblems(state), state);
     expect(message).toContain("release_line");
-    expect(message).toContain("docs/14-legacy-cleanup.md");
+    expect(message).toContain("docs/operations/14-legacy-cleanup.md");
   });
 });