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 после
разнесения по каталогам совпадал бы ровно с одним файлом.
89 lines
3.3 KiB
Bash
Executable File
89 lines
3.3 KiB
Bash
Executable File
#!/usr/bin/env bash
|
|
set -euo pipefail
|
|
|
|
ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
|
|
BUILD_DIR="$ROOT_DIR/tools/build"
|
|
|
|
# shellcheck source=tools/build/lib/common.sh
|
|
. "$BUILD_DIR/lib/common.sh"
|
|
# versions.sh подключается до deps.sh: deps.sh больше не носит собственных
|
|
# значений по умолчанию и берёт весь toolchain-контракт отсюда.
|
|
# shellcheck source=tools/build/lib/versions.sh
|
|
. "$BUILD_DIR/lib/versions.sh"
|
|
load_versions_contract
|
|
# shellcheck source=tools/build/lib/deps.sh
|
|
. "$BUILD_DIR/lib/deps.sh"
|
|
# shellcheck source=tools/build/lib/verify.sh
|
|
. "$BUILD_DIR/lib/verify.sh"
|
|
# shellcheck source=tools/build/lib/hysteria.sh
|
|
. "$BUILD_DIR/lib/hysteria.sh"
|
|
# shellcheck source=tools/build/lib/acceptance.sh
|
|
. "$BUILD_DIR/lib/acceptance.sh"
|
|
# shellcheck source=tools/build/lib/security.sh
|
|
. "$BUILD_DIR/lib/security.sh"
|
|
# shellcheck source=tools/build/lib/package.sh
|
|
. "$BUILD_DIR/lib/package.sh"
|
|
|
|
main() {
|
|
cd "$ROOT_DIR"
|
|
|
|
require_build_host_platform
|
|
require_repo_layout
|
|
verify_source_tree_policy
|
|
ensure_build_dependencies
|
|
ensure_toolchain
|
|
|
|
# Версия пакета приходит из versions.env: собственного значения по
|
|
# умолчанию у сборки больше нет.
|
|
PACKAGE_VERSION="${PACKAGE_VERSION:-$HY2XS_VERSION}"
|
|
BUILD_ID="${BUILD_ID:-$(date -u +%Y%m%dT%H%M%SZ)}"
|
|
|
|
verify_versions_contract
|
|
|
|
log_step "Checking orchestrator contracts"
|
|
run_orchestrator_tests
|
|
|
|
# Контракты панели проверяются рано: они не требуют ни собранного bundle, ни
|
|
# установленных зависимостей, и падать на них после резолва Hysteria и сборки
|
|
# артефактов означало бы платить минутами за ошибку, видимую сразу.
|
|
log_step "Checking HY2XS admin frontend contracts"
|
|
run_frontend_tests
|
|
|
|
log_step "Resolving upstream Hysteria and running compatibility gate"
|
|
resolve_and_verify_hysteria
|
|
|
|
log_step "Preparing package stage"
|
|
prepare_stage "$PACKAGE_VERSION" "$BUILD_ID"
|
|
|
|
log_step "Building install-only orchestrator"
|
|
build_orchestrator
|
|
|
|
log_step "Bundling HY2XS admin"
|
|
bundle_ui
|
|
|
|
# Тесты админки идут после bundle_ui: `go:embed all:dist` требует уже
|
|
# собранных frontend-ассетов, которых нет в git.
|
|
log_step "Checking HY2XS admin contracts"
|
|
run_admin_tests
|
|
|
|
# Проверка уязвимостей идёт после bundle_ui по двум причинам: govulncheck
|
|
# анализирует пакеты, а `go:embed all:dist` не собирается без ассетов; pnpm
|
|
# audit требует установленных зависимостей frontend, которые кладёт
|
|
# `pnpm install --frozen-lockfile` внутри bundle_ui.
|
|
log_step "Checking dependency vulnerabilities"
|
|
run_dependency_security_gate
|
|
|
|
log_step "Writing metadata"
|
|
write_metadata "$PACKAGE_VERSION" "$BUILD_ID"
|
|
|
|
log_step "Creating final archive"
|
|
create_archive "$PACKAGE_VERSION"
|
|
|
|
log_step "Verifying final archive"
|
|
verify_archive "$PACKAGE_VERSION"
|
|
|
|
log_info "Built dist/hy2xs-install-${PACKAGE_VERSION}.tar.gz"
|
|
}
|
|
|
|
main "$@"
|