docs(specs): archive stock card polish
This commit is contained in:
@@ -0,0 +1,109 @@
|
||||
## Context
|
||||
|
||||
Страница Portfolio уже подготавливает presentation-model позиций во ViewModel и
|
||||
рендерит чистые view-компоненты. Акции и облигации выводятся одним широким
|
||||
вариантом Position Card: в нём есть логотип, идентификатор, стоимость,
|
||||
доходность, средняя цена и доля. Текущие требования задают состав метрик,
|
||||
одноколоночность, логотип и цветовую семантику дохода, но не закрепляют
|
||||
внутреннюю визуальную иерархию карточки.
|
||||
|
||||
Изменение остаётся в presentation layer: состав Portfolio, ViewModel-данные,
|
||||
маршруты и интерактивные действия не меняются. У страницы нет действия для
|
||||
Position Card, поэтому клавиатурный focus-стиль должен быть только следствием
|
||||
имеющегося focusable-элемента, а не превращать карточку в контрол.
|
||||
|
||||
## Goals / Non-Goals
|
||||
|
||||
**Goals:**
|
||||
|
||||
- Сделать стоимость и доходность акции визуально первичными, а идентификатор и
|
||||
служебные метрики — спокойным вторым уровнем без конкурирующих акцентов.
|
||||
- Сохранить цветовую семантику доходности без отдельного badge, фона или
|
||||
декоративной иконки.
|
||||
- Сохранить читаемость одноколоночной карточки на узком и широком экранах.
|
||||
|
||||
**Non-Goals:**
|
||||
|
||||
- Изменение состава, вычисления или форматирования данных Portfolio.
|
||||
- Изменение карточек облигаций и других типов позиций, порядка секций,
|
||||
навигации, кликабельности или API.
|
||||
- Добавление новых UI-библиотек, токенов, изображений либо интерактивных
|
||||
состояний без существующего контролa.
|
||||
|
||||
## Decisions
|
||||
|
||||
### D1 — Визуальный вариант передаётся для секции акций
|
||||
|
||||
Position Section передаёт в существующую карточку presentation-only вариант для
|
||||
`STOCK`. Это позволяет сделать акцию выразительнее и оставить карточки
|
||||
облигаций в поставленном виде без копирования разметки или расхождения метрик.
|
||||
Альтернатива — отдельная Stock Card — отклонена: она дублирует уже общий
|
||||
контент карточки и повышает риск расхождения при будущих изменениях метрик.
|
||||
|
||||
### D2 — Две главные зоны и одна тихая мета-строка
|
||||
|
||||
Главная строка имеет только две зоны: слева логотип, название и одна
|
||||
объединённая строка количества с ISIN; справа — текущая стоимость и доходность
|
||||
простым цветным текстом. Средняя цена и доля переходят в единую приглушённую
|
||||
мета-строку под разделителем. Локальная CSS-сетка обеспечивает устойчивое
|
||||
выравнивание, усечение длинного имени и перенос метаданных без изменения DOM
|
||||
порядка или доступных текстовых значений. Альтернатива — отдельные вложенные
|
||||
карточки/панели — отклонена: лишняя декоративная вложенность ослабляет
|
||||
плотность списка.
|
||||
|
||||
### D3 — Доходность остаётся текстовой метрикой
|
||||
|
||||
Доходность использует только существующие positive/negative theme colors и
|
||||
умеренную насыщенность шрифта; ни фон, ни скруглённый контейнер не создаются.
|
||||
При нулевой доходности цветной treatment не применяется. Альтернатива — новая
|
||||
палитра или иконка направления — отклонена: цвет и знак уже передают нужный
|
||||
сигнал, а дополнительный символ создаёт шум.
|
||||
|
||||
### D4 — Hover и focus не добавляются к некликабельной карточке
|
||||
|
||||
Карточка остаётся неинтерактивной. Допустим только ненавязчивый hover для
|
||||
визуального отклика указателя; focus-стиль не добавляется, потому что Card не
|
||||
участвует в keyboard navigation. Альтернатива — сделать карточку button/link —
|
||||
отклонена как выходящая за границы change навигационная функция.
|
||||
|
||||
## Delivery Map
|
||||
|
||||
| Area | Status | Architectural outcome or N/A reason |
|
||||
| --- | --- | --- |
|
||||
| frontend | `affected` | Position Card получает presentation-only вариант акции и локальные стили группировки, статуса доходности и адаптивной компоновки; существующие page tests уточняют ожидаемую разметку акций. |
|
||||
| backend | `N/A` | Контракт, data fetching и финансовые расчёты Portfolio не меняются. |
|
||||
| specs | `affected` | Change хранит утверждённые Proposal и Design с `skip_specs: true`, поскольку существующие требования уже покрывают состав и семантику карточки. |
|
||||
| docs | `affected` | As-built описание Portfolio кратко фиксирует уточнённую визуальную иерархию карточек акций после поставки. |
|
||||
|
||||
### Contract Gate Decision
|
||||
|
||||
| Gate | Status | Reason |
|
||||
| --- | --- | --- |
|
||||
| runtime-openapi | `N/A` | Ни backend, ни frontend API contract и generated snapshot не меняются. |
|
||||
|
||||
## Risks / Trade-offs
|
||||
|
||||
- Длинное имя инструмента может конкурировать с суммой на узком экране → имя
|
||||
остаётся усечённым, а стоимость занимает приоритетную правую область.
|
||||
- Слишком заметная доходность может перегрузить список → используется только
|
||||
существующий цвет текста без фона, badge или отдельной иконки.
|
||||
- Различие внешнего вида акций и облигаций может восприниматься как
|
||||
несогласованность → оно ограничено явной пользовательской целью и не меняет
|
||||
общий набор метрик, одноколоночность или логотип.
|
||||
|
||||
## Migration Plan
|
||||
|
||||
Поставка ограничена обратимой заменой presentation-разметки и локальных
|
||||
стилей frontend, затем обновлением as-built documentation. Данные, миграции и
|
||||
совместимость между приложениями не затрагиваются.
|
||||
|
||||
### Rollback Contract
|
||||
|
||||
| Field | Decision |
|
||||
| --- | --- |
|
||||
| Status | `N/A` |
|
||||
| Reason | Change не меняет security, данные, миграции, публичный контракт или другое труднообратимое решение; прежний вид возвращается обратимой правкой frontend presentation layer. |
|
||||
| Trigger | N/A |
|
||||
| Actions | N/A |
|
||||
| Data safety | N/A |
|
||||
| Verification | N/A |
|
||||
Reference in New Issue
Block a user