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 после
разнесения по каталогам совпадал бы ровно с одним файлом.
53 lines
2.0 KiB
Vue
53 lines
2.0 KiB
Vue
<template>
|
|
<svg
|
|
aria-hidden="true"
|
|
focusable="false"
|
|
class="svg-icon"
|
|
:style="'width:' + size + ';height:' + size"
|
|
>
|
|
<use :xlink:href="symbolId" />
|
|
</svg>
|
|
</template>
|
|
|
|
<script setup lang="ts">
|
|
import { SYMBOL_PREFIX } from "./symbol";
|
|
|
|
/**
|
|
* Цвет иконке не передаётся — и это контракт, а не упущение.
|
|
*
|
|
* Раньше здесь были проп `color` и `:fill="color"` на `<use>`. Ими никто не
|
|
* пользовался ни разу, а существование такого пропа приглашает чинить
|
|
* сломанный цвет точечно: «вот этой иконке передадим белый». Монохромная
|
|
* иконка обязана получать цвет ровно одним способом — наследованием
|
|
* `currentColor` от компонента и темы; ассет, который так не умеет, чинится в
|
|
* самом ассете и не доезжает до релиза (см. `symbol.ts`).
|
|
*
|
|
* Префикс id тоже больше не проп: он принадлежит спрайту, а не месту вызова, и
|
|
* объявлен рядом с кодом, который этот id создаёт.
|
|
*/
|
|
const props = defineProps({
|
|
iconClass: {
|
|
type: String,
|
|
required: false,
|
|
},
|
|
size: {
|
|
type: String,
|
|
default: "1em",
|
|
},
|
|
});
|
|
|
|
const symbolId = computed(() => `#${SYMBOL_PREFIX}-${props.iconClass}`);
|
|
</script>
|
|
|
|
<style scoped>
|
|
.svg-icon {
|
|
display: inline-block;
|
|
width: 1em;
|
|
height: 1em;
|
|
overflow: hidden;
|
|
vertical-align: -0.15em; /* Так как размер icon равен размеру шрифта, добавляем смещение для визуального выравнивания */
|
|
outline: none;
|
|
fill: currentcolor; /* currentColor наследует текущий цвет элемента или родителя */
|
|
}
|
|
</style>
|