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 после
разнесения по каталогам совпадал бы ровно с одним файлом.
This commit is contained in:
+39
-15
@@ -47,25 +47,49 @@
|
||||
persistent path. У мутирующей фазы ровно один владелец — оркестратор:
|
||||
`install.sh` проверяет и передаёт управление, не изменяя ничего сам.
|
||||
Очистка предыдущей установки — отдельная явная операция оператора,
|
||||
см. [14-legacy-cleanup.md](14-legacy-cleanup.md).
|
||||
см. [operations/14-legacy-cleanup.md](operations/14-legacy-cleanup.md).
|
||||
8. Выдача доступа пользователям, Telegram-бот, billing, backend профилей и похожие контуры **не входят** в этот baseline.
|
||||
|
||||
## Состав документов
|
||||
|
||||
1. [01-architecture-baseline.md](01-architecture-baseline.md)
|
||||
2. [02-build-layer-and-package.md](02-build-layer-and-package.md)
|
||||
3. [03-server-hysteria2.md](03-server-hysteria2.md)
|
||||
4. [04-admin-panel.md](04-admin-panel.md)
|
||||
5. [05-client-and-access-scope.md](05-client-and-access-scope.md)
|
||||
6. [06-speed-limits-and-congestion.md](06-speed-limits-and-congestion.md)
|
||||
7. [07-systemd-and-firewall.md](07-systemd-and-firewall.md)
|
||||
8. [08-orchestrator-spec.md](08-orchestrator-spec.md)
|
||||
9. [09-post-install-env.md](09-post-install-env.md)
|
||||
10. [10-access-layer-out-of-scope.md](10-access-layer-out-of-scope.md)
|
||||
11. [11-testing-and-acceptance.md](11-testing-and-acceptance.md)
|
||||
12. [12-operations-and-troubleshooting.md](12-operations-and-troubleshooting.md)
|
||||
13. [13-production-runbook.md](13-production-runbook.md)
|
||||
14. [14-legacy-cleanup.md](14-legacy-cleanup.md)
|
||||
Документы разложены по слою, к которому относятся. Двузначный префикс в имени —
|
||||
стабильный идентификатор документа: под ним на него ссылаются CHANGELOG,
|
||||
релизные гейты и сообщения оркестратора, поэтому при переносе в каталоги он
|
||||
сохранён.
|
||||
|
||||
### Архитектура и рамки
|
||||
|
||||
- [architecture/01-architecture-baseline.md](architecture/01-architecture-baseline.md) — baseline-модель двух слоёв
|
||||
- [architecture/03-server-hysteria2.md](architecture/03-server-hysteria2.md) — серверный транспорт
|
||||
- [architecture/05-client-and-access-scope.md](architecture/05-client-and-access-scope.md) — граница клиента
|
||||
- [architecture/06-speed-limits-and-congestion.md](architecture/06-speed-limits-and-congestion.md) — ограничения скорости
|
||||
- [architecture/10-access-layer-out-of-scope.md](architecture/10-access-layer-out-of-scope.md) — что вне baseline
|
||||
|
||||
### Сборка
|
||||
|
||||
- [build/02-build-layer-and-package.md](build/02-build-layer-and-package.md) — builder layer, состав пакета, требования к сборочной машине
|
||||
|
||||
### Runtime на target
|
||||
|
||||
- [runtime/08-orchestrator-spec.md](runtime/08-orchestrator-spec.md) — спецификация оркестратора
|
||||
- [runtime/07-systemd-and-firewall.md](runtime/07-systemd-and-firewall.md) — systemd и nftables
|
||||
- [runtime/09-post-install-env.md](runtime/09-post-install-env.md) — post-install состояние
|
||||
|
||||
### Панель
|
||||
|
||||
- [admin/04-admin-panel.md](admin/04-admin-panel.md) — HY2XS admin
|
||||
- [admin/15-ui-contracts.md](admin/15-ui-contracts.md) — контракты панели: иконки, структурированные ошибки, необязательные поля, атрибуция
|
||||
|
||||
### Эксплуатация
|
||||
|
||||
- [operations/13-production-runbook.md](operations/13-production-runbook.md) — production runbook
|
||||
- [operations/12-operations-and-troubleshooting.md](operations/12-operations-and-troubleshooting.md) — операции и разбор отказов
|
||||
- [operations/14-legacy-cleanup.md](operations/14-legacy-cleanup.md) — очистка установки предыдущего поколения
|
||||
|
||||
### Проверки
|
||||
|
||||
- [testing/](testing/README.md) — набор проверок по слоям (бывший `11-testing-and-acceptance.md`)
|
||||
- [acceptance/](acceptance/README.md) — отчёты о фактических прогонах приёмки
|
||||
|
||||
История изменений проекта — в [CHANGELOG.md](../CHANGELOG.md).
|
||||
|
||||
|
||||
Reference in New Issue
Block a user