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 после
разнесения по каталогам совпадал бы ровно с одним файлом.
109 lines
4.2 KiB
Go
109 lines
4.2 KiB
Go
package vo
|
|
|
|
import (
|
|
"net/http"
|
|
|
|
"github.com/gin-gonic/gin"
|
|
"hy2xs-admin/model/constant"
|
|
)
|
|
|
|
// FieldError — одна причина отказа.
|
|
//
|
|
// `Field` заполняется, когда причина относится к конкретному полю формы, и
|
|
// пуст для отказов уровня операции. `Params` несёт числа правила (границы
|
|
// длины, допустимые значения), чтобы панель могла составить точную фразу, не
|
|
// заводя у себя вторую копию этих чисел.
|
|
type FieldError struct {
|
|
Code string `json:"code"`
|
|
Field string `json:"field,omitempty"`
|
|
Message string `json:"message"`
|
|
Params map[string]string `json:"params,omitempty"`
|
|
}
|
|
|
|
type result struct {
|
|
Code int `json:"code"`
|
|
Type string `json:"type"`
|
|
Message string `json:"message"`
|
|
Errors []FieldError `json:"errors,omitempty"`
|
|
Data interface{} `json:"data"`
|
|
}
|
|
|
|
const (
|
|
TypeSuccess = "ok"
|
|
TypeError = "no"
|
|
)
|
|
|
|
func Success(data interface{}, c *gin.Context) {
|
|
c.JSON(http.StatusOK, result{
|
|
Code: constant.CodeSuccess,
|
|
Type: TypeSuccess,
|
|
Data: data,
|
|
})
|
|
}
|
|
|
|
// FailWith — единственное место, где формируется ответ об ошибке.
|
|
//
|
|
// Код передаётся аргументом. Раньше он ВЫВОДИЛСЯ здесь сравнением текста
|
|
// сообщения с тремя известными строками:
|
|
//
|
|
// if constant.UnauthorizedError == message { code = ... }
|
|
//
|
|
// Это тот же антипаттерн, который запрещён панели, только на сервере: смысл
|
|
// ответа определялся совпадением литерала. Следствие было не теоретическим —
|
|
// истёкший токен возвращал `token expired`, под условия не подходил и уезжал
|
|
// как обычная системная ошибка с кодом 50000. Панель показывала оператору
|
|
// голый тост и не понимала, что сессия кончилась: ветка входа заново не
|
|
// срабатывала никогда.
|
|
func FailWith(code int, message string, fieldErrors []FieldError, c *gin.Context) {
|
|
c.JSON(http.StatusOK, result{
|
|
Code: code,
|
|
Type: TypeError,
|
|
Message: message,
|
|
Errors: fieldErrors,
|
|
Data: nil,
|
|
})
|
|
}
|
|
|
|
// Fail — отказ уровня операции: правила соблюдены, выполнить нельзя.
|
|
func Fail(message string, c *gin.Context) {
|
|
FailWith(constant.CodeSysError, message, nil, c)
|
|
}
|
|
|
|
// FailDomain — тот же отказ, но с машиночитаемым кодом причины.
|
|
func FailDomain(code string, message string, c *gin.Context) {
|
|
FailWith(constant.CodeSysError, message, []FieldError{{
|
|
Code: code,
|
|
Message: message,
|
|
}}, c)
|
|
}
|
|
|
|
// FailField — отказ уровня операции, привязанный к полю формы.
|
|
func FailField(code string, field string, message string, c *gin.Context) {
|
|
FailWith(constant.CodeSysError, message, []FieldError{{
|
|
Code: code,
|
|
Field: field,
|
|
Message: message,
|
|
}}, c)
|
|
}
|
|
|
|
// FailValidation — вход не прошёл проверку правил.
|
|
func FailValidation(message string, fieldErrors []FieldError, c *gin.Context) {
|
|
FailWith(constant.CodeInvalidError, message, fieldErrors, c)
|
|
}
|
|
|
|
// FailUnauthorized — вход требуется или сессия больше не действует.
|
|
//
|
|
// Причина передаётся кодом: панель по-разному ведёт себя, когда токена нет
|
|
// вовсе и когда он только что истёк под руками у оператора.
|
|
func FailUnauthorized(code string, message string, c *gin.Context) {
|
|
FailWith(constant.CodeUnauthorizedError, message, []FieldError{{
|
|
Code: code,
|
|
Message: message,
|
|
}}, c)
|
|
}
|
|
|
|
// FailForbidden — вход выполнен, но прав недостаточно.
|
|
func FailForbidden(message string, c *gin.Context) {
|
|
FailWith(constant.CodeForbiddenError, message, nil, c)
|
|
}
|