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 после
разнесения по каталогам совпадал бы ровно с одним файлом.
65 lines
3.0 KiB
Go
65 lines
3.0 KiB
Go
package service
|
|
|
|
import (
|
|
"fmt"
|
|
|
|
"hy2xs-admin/model/constant"
|
|
)
|
|
|
|
// Доменные отказы пиров несут КОД, а не только текст.
|
|
//
|
|
// Раньше причина отказа существовала исключительно в виде человеческой фразы:
|
|
// `fmt.Errorf("name %s already exists", …)`. Слой контроллеров отдавал её
|
|
// панели как есть, панель показывала её тостом, и всё, что могло бы захотеть
|
|
// отреагировать на причину — подсветить нужное поле формы, перевести фразу на
|
|
// язык оператора, — было вынуждено сравнивать текст. Такое сравнение молча
|
|
// ломается при первой же правке формулировки.
|
|
//
|
|
// Код и имя поля объявляются здесь, рядом с местом, которое отказ порождает.
|
|
|
|
// PeerError — отказ операции над пиром с машиночитаемой причиной.
|
|
type PeerError struct {
|
|
// Code — причина из constant.ErrCode*.
|
|
Code string
|
|
// Field — поле формы, к которому относится отказ; пусто, если отказ
|
|
// относится к операции целиком.
|
|
Field string
|
|
// Message — человекочитаемое объяснение для клиента без UI.
|
|
Message string
|
|
}
|
|
|
|
func (e *PeerError) Error() string { return e.Message }
|
|
|
|
// ErrPeerNameRequired — имя пира не передано.
|
|
//
|
|
// Правило `required` в DTO ловит это раньше, но CreatePeer вызывается и из
|
|
// тестов, и потенциально из будущих внутренних путей, поэтому проверка
|
|
// остаётся, а не превращается в предположение.
|
|
var ErrPeerNameRequired = &PeerError{
|
|
Code: constant.ErrCodeRequired,
|
|
Field: "name",
|
|
Message: "имя пира обязательно",
|
|
}
|
|
|
|
// ErrPeerNameReserved — имя принадлежит пиру установщика.
|
|
//
|
|
// Имя зарезервировано и когда сам пир уже удалён: иначе обычный пир занял бы
|
|
// его и оказался под защитой, предназначенной не ему.
|
|
var ErrPeerNameReserved = &PeerError{
|
|
Code: constant.ErrCodePeerNameReserved,
|
|
Field: "name",
|
|
Message: fmt.Sprintf(
|
|
"имя %q зарезервировано за пиром установщика",
|
|
ReservedBootstrapPeerName,
|
|
),
|
|
}
|
|
|
|
// PeerNameTakenError — имя уже занято другим пиром.
|
|
func PeerNameTakenError(name string) *PeerError {
|
|
return &PeerError{
|
|
Code: constant.ErrCodePeerNameTaken,
|
|
Field: "name",
|
|
Message: fmt.Sprintf("пир с именем %q уже существует", name),
|
|
}
|
|
}
|