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:
@@ -109,7 +109,71 @@ export default {
|
||||
invalid: "Некорректное значение",
|
||||
switchLanguageSuccess: "Язык переключён",
|
||||
logoutConfirm: "Выйти из системы?",
|
||||
sessionExpired: "Текущая сессия истекла, войдите снова",
|
||||
sessionExpired: "Сессия истекла. Войдите снова, чтобы продолжить.",
|
||||
signInRequired: "Требуется вход в панель.",
|
||||
signIn: "Войти",
|
||||
systemError: "Системная ошибка",
|
||||
networkError: "Сервер не отвечает. Проверьте соединение с панелью.",
|
||||
},
|
||||
// Причины отказа API.
|
||||
//
|
||||
// Ключи строятся из КОДА ответа, а не из его текста: панель не разбирает
|
||||
// человеческие сообщения сервера. Числа правил приходят в параметрах, поэтому
|
||||
// второй копии границ длины здесь нет — она неизбежно разошлась бы с
|
||||
// серверной.
|
||||
error: {
|
||||
field: {
|
||||
name: "Имя пира",
|
||||
secret: "Секрет",
|
||||
remark: "Комментарий",
|
||||
quotaBytes: "Квота",
|
||||
expiresAt: "Срок действия",
|
||||
maxDevices: "Лимит устройств",
|
||||
disabled: "Состояние",
|
||||
bannedUntil: "Блокировка до",
|
||||
file: "Файл",
|
||||
id: "Идентификатор",
|
||||
username: "Логин",
|
||||
pass: "Пароль",
|
||||
oldPassword: "Старый пароль",
|
||||
newPassword: "Новый пароль",
|
||||
key: "Ключ настройки",
|
||||
value: "Значение настройки",
|
||||
numLine: "Число строк",
|
||||
pageNum: "Номер страницы",
|
||||
pageSize: "Размер страницы",
|
||||
},
|
||||
code: {
|
||||
required: "«{field}»: поле обязательно",
|
||||
min: "«{field}»: значение не может быть меньше {min}",
|
||||
max: "«{field}»: значение не может быть больше {max}",
|
||||
min_length: "«{field}»: не короче {min} символов",
|
||||
max_length: "«{field}»: не длиннее {max} символов",
|
||||
len: "«{field}»: длина должна быть ровно {len}",
|
||||
oneof: "«{field}»: допустимые значения — {values}",
|
||||
gt: "«{field}»: значение должно быть больше {gt}",
|
||||
peer_name:
|
||||
"«{field}»: от {min} до {max} символов из набора {charset}. Пробелы, кириллица и знаки / : ; . недопустимы",
|
||||
credential_format: "«{field}»: недопустимые символы",
|
||||
rule_violated: "«{field}»: значение не подходит",
|
||||
validation_failed: "Проверка данных не пройдена",
|
||||
body_invalid: "Запрос не разобран: проверьте формат и типы полей",
|
||||
peer_name_taken: "Пир с таким именем уже существует",
|
||||
peer_name_reserved: "Это имя зарезервировано за пиром установщика",
|
||||
peer_bootstrap_identity_locked:
|
||||
"Имя и секрет пира установщика продублированы в файле на сервере и не меняются через панель. Ненужный bootstrap-пир следует удалить целиком.",
|
||||
invalid_credentials: "Неверный логин или пароль",
|
||||
import_file_extension: "Импорт принимает только файлы .json",
|
||||
unauthorized: "Требуется вход в панель",
|
||||
session_expired: "Сессия истекла",
|
||||
token_invalid: "Сессия недействительна",
|
||||
account_disabled: "Учётная запись отключена",
|
||||
},
|
||||
},
|
||||
sidebar: {
|
||||
// {brand} подставляется ссылкой, поэтому фраза обязана остаться одной
|
||||
// строкой с одним подстановочным местом.
|
||||
developedBy: "Разработано во {brand}",
|
||||
},
|
||||
info: {
|
||||
expireTime: "г-М-д Ч:м:с",
|
||||
@@ -124,12 +188,12 @@ export default {
|
||||
remark: "Комментарий",
|
||||
secret: "Секрет",
|
||||
form: {
|
||||
namePlaceholder: "например, ivan-laptop",
|
||||
namePlaceholder: "client-01",
|
||||
nameHint:
|
||||
"Короткий идентификатор пира. Используйте латиницу, цифры и дефис — имя попадает в автогенерируемый секрет и показывается клиенту как название профиля.",
|
||||
remarkPlaceholder: "например, Ноутбук Ивана, отдел продаж",
|
||||
"Идентификатор пира: от 6 до 32 символов, латиница, цифры и дефис. Имя попадает в автогенерируемый секрет и показывается клиенту как название профиля.",
|
||||
remarkPlaceholder: "ноутбук",
|
||||
remarkHint: "Необязательная пометка для оператора. Клиент её не видит.",
|
||||
secretPlaceholder: "оставьте пустым — сгенерируем автоматически",
|
||||
secretPlaceholder: "оставьте пустым — сгенерируем",
|
||||
secretHint:
|
||||
"Пароль подключения клиента. Если оставить поле пустым, секрет будет сгенерирован автоматически. При ручном вводе: от 6 до 128 символов.",
|
||||
quotaHint: "Лимит трафика в байтах. Укажите -1 для безлимита.",
|
||||
|
||||
Reference in New Issue
Block a user