founder
c0a43ae915
Девятый проход, по итогам приёмки 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 после
разнесения по каталогам совпадал бы ровно с одним файлом.
72 lines
4.3 KiB
Go
72 lines
4.3 KiB
Go
package constant
|
|
|
|
const (
|
|
SysError string = "system error"
|
|
UnauthorizedError string = "unauthorized"
|
|
ForbiddenError string = "permission denied"
|
|
InvalidError string = "invalid"
|
|
|
|
IllegalTokenError string = "authentication failed"
|
|
TokenExpiredError string = "token expired"
|
|
|
|
WrongPassword string = "wrong password"
|
|
ConfigNotExist string = "config not exist"
|
|
)
|
|
|
|
// Коды структурированных ошибок.
|
|
//
|
|
// Зачем они есть. Раньше единственным машиночитаемым признаком ошибки был
|
|
// числовой `code` ответа, а всё остальное жило в человеческом тексте: слой vo
|
|
// выбирал HTTP-семантику СРАВНЕНИЕМ строки сообщения, а панель показывала
|
|
// оператору голое «invalid» на любую ошибку любого поля формы. Оба места
|
|
// разбирали прозу — то есть договор между сервером и панелью держался на
|
|
// совпадении литералов, которое ничто не проверяло.
|
|
//
|
|
// Теперь у ошибки есть код и — там, где ошибка относится к полю, — имя поля.
|
|
// Панель выбирает по коду свою локализованную строку и не разбирает текст;
|
|
// `message` остаётся человекочитаемым ответом для клиента без UI и запасным
|
|
// вариантом для кода, которого панель ещё не знает.
|
|
//
|
|
// Коды — часть публичного контракта API: их значения не меняются вместе с
|
|
// формулировками сообщений.
|
|
const (
|
|
// ErrCodeBodyInvalid — тело запроса не разобралось: не JSON, не тот тип
|
|
// поля, сломанная query-строка. Это отказ ДО проверки правил.
|
|
ErrCodeBodyInvalid string = "body_invalid"
|
|
// ErrCodeValidationFailed — общий код ответа, у которого есть errors[].
|
|
ErrCodeValidationFailed string = "validation_failed"
|
|
|
|
// Коды правил. Совпадают с именами тегов валидатора: одно правило — один
|
|
// код, и никакого второго словаря соответствий.
|
|
ErrCodeRequired string = "required"
|
|
// Границы числа и границы длины строки различаются кодом, хотя тег
|
|
// валидатора у них один. Оператору это разные фразы: «не меньше 1
|
|
// устройства» и «не короче 6 символов», — и панель обязана уметь их
|
|
// различить, не заводя у себя таблицу «какое поле какого рода».
|
|
ErrCodeMin string = "min"
|
|
ErrCodeMax string = "max"
|
|
ErrCodeMinLength string = "min_length"
|
|
ErrCodeMaxLength string = "max_length"
|
|
ErrCodeLen string = "len"
|
|
ErrCodeOneOf string = "oneof"
|
|
ErrCodeGreaterThan string = "gt"
|
|
ErrCodePeerName string = "peer_name"
|
|
ErrCodeCredentialStr string = "credential_format"
|
|
ErrCodeRuleUnknown string = "rule_violated"
|
|
|
|
// Доменные коды: правило соблюдено, но операция всё равно невозможна.
|
|
ErrCodePeerNameTaken string = "peer_name_taken"
|
|
ErrCodePeerNameReserved string = "peer_name_reserved"
|
|
ErrCodePeerBootstrapLocked string = "peer_bootstrap_identity_locked"
|
|
ErrCodeInvalidCredentials string = "invalid_credentials"
|
|
ErrCodeImportFileExtension string = "import_file_extension"
|
|
|
|
// Коды состояния сессии. Панель различает «войдите» и «сессия кончилась»:
|
|
// во втором случае оператор находится на рабочей странице, и молча
|
|
// выбрасывать его на форму входа без объяснения нельзя.
|
|
ErrCodeUnauthorized string = "unauthorized"
|
|
ErrCodeSessionExpired string = "session_expired"
|
|
ErrCodeTokenInvalid string = "token_invalid"
|
|
ErrCodeAccountDisabled string = "account_disabled"
|
|
)
|