41 lines
5.0 KiB
Markdown
41 lines
5.0 KiB
Markdown
## Why
|
||
|
||
Веб-приложение хаба выросло из перенесённой доски `links.html` и выглядит и ведёт себя как набор страниц, собранных в
|
||
разное время: свои цвета и отступы у каждой страницы, «Обновить из Jira» и тема — только в шапке доски, фильтры списка
|
||
задач — сплошная строка из шести выпадающих списков, двух флажков и поиска. Владелец (21.10.2026, jira-hub#65) хочет,
|
||
чтобы хаб выглядел как родственное приложение AURA (дизайн-система из handoff AURA-xlsx-tool 29.09.2026 и Figma
|
||
«Универсалки», материалы — `~/projects/jira-bridge/design/`), и чтобы интерфейс стал логичнее.
|
||
|
||
Сценарий владельца: раз в спринт — обзор графа связей на доске; в остальное время — поиск и перепроверка задач в
|
||
списке и карточке. Все фильтры нужны, но упакованы должны быть удобнее. Редизайн и UX владелец отдал на усмотрение
|
||
агента; дальше — доработки от результата.
|
||
|
||
## What Changes
|
||
|
||
- **Дизайн-система в приложении:** токены AURA (цвета светлой и тёмной темы, типографика, шаг 4 px, радиусы, высоты
|
||
контролов, фокус) — `web/src/styles/tokens.css`; набор базовых компонентов `web/src/ui/` (кнопки-«таблетки»,
|
||
иконки, сегментный переключатель, переключатель темы, поле, выпадающий список, флажок, бейдж, сообщение, панель,
|
||
окно, меню); все страницы собраны из них. Шрифт — Mulish (свободная замена Proxima Nova, с кириллицей), моноширинный
|
||
— IBM Plex Mono, как был.
|
||
- **Верхняя панель приложения:** название, проект, разделы сегментным переключателем, блок данных Jira (время
|
||
последнего полного обновления, агент на связи / офлайн, «Обновить из Jira» и ход пакета), переключатель темы, меню
|
||
с «Сменить токен». Обновление из Jira и тема доступны с любой страницы.
|
||
- **Обновление из Jira — уровень приложения:** пакет `refresh` ставит и опрашивает оболочка; по завершении
|
||
перечитываются снимки доски, список задач и открытая карточка. Доска сохраняет только своё: источник (хаб / файл),
|
||
«Перечитать», загрузку файла и события снимка.
|
||
- **Доска:** шапка страницы (название, счётчики, источник, «Проблемы», меню), панель управления (спринты, исполнители,
|
||
режимы показа группами), сворачиваемая легенда; редкие действия — в меню. Поведение доски (модель, выборка,
|
||
критический путь, раскладка, ключи `localStorage`) не меняется.
|
||
- **Список задач:** поиск и «Открытые / Все» на виду, остальные фильтры — в раскрывающейся панели «Фильтры (N)»,
|
||
выбранные — снимаемыми плашками; таблица в панели, строка открывает карточку, «сосед» — плашкой у ключа. Адрес и
|
||
запросы к хабу — как были.
|
||
- **Карточка задачи, вход, «Новый проект», «не найдено», ошибки** — в стиле системы, содержание и поведение прежние.
|
||
|
||
## Non-Goals
|
||
|
||
- Ant Design и генерация токенов из `tokens.json` скриптом (`design-system:sync`): токены переносятся вручную.
|
||
- Proxima Nova (платный шрифт) и любые ресурсы вне сборки.
|
||
- Новые функции: правки в Jira из интерфейса (`viewer-edit`), страницы очереди, агента и настроек.
|
||
- Изменения API хаба, MCP, агента; изменения логики доски (golden-тесты не трогаются).
|
||
- Мобильная вёрстка доски сверх нынешней (узкий экран — только без поломок).
|