Files

T

tasks: очередь расставлена от базы к деталям

- порядок беклога и роадмапа назначен слоями: проверки, которым можно
  верить → долги входа → владелец записи и контракт API → конвейер под
  тестами → приложение и возможности поверх; у каждого движения записана
  причина;
- заведены восемь задач под пункты «Завершения», которых не закрывала ни
  одна запись, — цель any-audio-source была без задач вовсе;
- у четырёх задач сняты критерии, требовавшие того, что делает задача ниже
  по очереди; исправлены ссылки на несуществующий repo/sqlite и на
  отменённую разведку об очереди.

2026-08-12 20:48:53 +03:00

4.8 KiB

Raw Blame History

✨ Собрать каркас приложения и раздать его из бинарника

Тип: feature
Категория: Очередь — Каркас приложения: экранов нет и собирать их нечем, а на экране стоят настройки, удаление, уровни текста и статистика.
Зачем: Экранов нет и собирать их нечем: ни сборки фронтенда, ни раздачи статики в проекте не существует.
Теги: goal:web-access

Ни одной строки «Завершения» цели каркас не закрывает: он готовит четыре экранные — 1, 2, 3 и 4, — но сам по себе пользователю ничего не даёт. Видимое от него одно: приложение открывается и достаёт данные с живого сервера, а не отдаёт пустую страницу.

Фреймворк выбран 2026-08-11 — Vue 3 с роутером пятой версии и сборкой Vite (ADR); правила кода приложения лежат в conventions/web-ui.md.

Затрагивает

новый каталог фронтенда: исходники, зависимости, конфигурация сборки;
роут, отдающий index.html на неизвестный путь вне /api/: адреса маршрутов обычные, а не после решётки;
Taskfile.yml — шаг сборки статики и его место в task gate и task image;
Dockerfile — сборка статики внутри образа, чтобы выкладка не зависела от машины разработчика;
раздача статики из бинарника через go:embed и роут под неё;
.gitignore — каталог зависимостей и собранная статика;
docs/conventions/web-ui.md — переписывается под выбранный фреймворк;
docs/architecture.md — новый компонент и новая внешняя зависимость сборки.

Критерии приёмки

Статика собирается одной командой и вшивается в бинарник: запущенный бинарник отдаёт приложение без каталога рядом. Оракул — сборка, запуск бинарника из пустого каталога, запрос корня возвращает разметку приложения.
Образ собирается на чистой машине без предустановленного окружения фронтенда. Оракул — task image без локально установленных зависимостей фронтенда.
Приложение показывает, кто вошёл, и обращается к API живого сервера. Оракул — тест либо ручная проверка на запущенном сервере с сессией.
Шаг сборки статики входит в task gate и краснеет при ошибке сборки. Оракул — намеренно сломанный исходник роняет task gate.
Обновление страницы на любом маршруте приложения открывает тот же экран, а адрес внутри /api/ в приложение не проваливается. Оракул — тест на два запроса: неизвестный путь вне /api/ отдаёт разметку, неизвестный путь внутри /api/ отдаёт ошибку контракта.

Рамки

Экранов, кроме заглушки с именем вошедшего, не делаем — это upload-and-status-screen и records-list-screen. Установку на телефон не делаем — это installable-pwa. Готовый набор компонентов не берём: он не выбран, а способен удвоить собранный файл.

Шаг сборки входит в гейт и в образ решением ADR 2026-08-11 — заново это решение не принимается. Во что слой Node обходится образу по времени и по весу, не замерялось: замер делает эта задача.

4.8 KiB Raw Blame History

✨ Собрать каркас приложения и раздать его из бинарника

Затрагивает

Критерии приёмки

Рамки

4.8 KiB

Raw Blame History