docs(app-map): notifications P1 ЗАКРЫТ (лента a30627a + unregister cc7ad71/255c962 + retry a6bda89), Ff 45.5→63.6%; Fd на Roborazzi

This commit is contained in:
b-mob-notify
2026-07-13 10:22:13 +00:00
parent 255c962d8f
commit eed7723230
2 changed files with 40 additions and 32 deletions
+39 -31
View File
@@ -1,6 +1,9 @@
# Diff: Уведомления (Notifications) — итерация 1 (2026-07-13)
Ff_app: **45.5%** (done 10 / open 12, n-a 1) · Fd_app: **0.0%** (ждёт девайс-сверки) · автор `b-mob-notify`
Ff_app: **63.6%** (done 14 / open 8, n-a 1) · Fd_app: **0.0%** (Roborazzi-сверка в работе) · автор `b-mob-notify`
> **Итерация 1b (2026-07-13):** P1-лента закрыта лидом (`a30627a`) + P1-push unregister закрыт
> (клиент `cc7ad71` + вызов в logout `255c962`). Ff 45.5% → 63.6%.
> Сверка веб (`nextcloud/notifications 5.0.0-dev.0` + тема forbion, mail/078) ↔ **натив
> (реализован в app-shell)**. Лента УЖЕ работает: `NotificationsSheet` (`app/AppSheets.kt`) +
@@ -9,11 +12,10 @@ Ff_app: **45.5%** (done 10 / open 12, n-a 1) · Fd_app: **0.0%** (ждёт де
> Карта-источник: [`notifications.md`](notifications.md) (из кода + живая сверка forbion,
> Browser 1/`cloude`, read-only; лента `cloude` = 3 уведомления `firstrunwizard`).
>
> **NB зона:** лента живёт в `app/AppSheets.kt` (app-shell, зона лида). Два P1-расхождения
> (Скрыть-все, action-кнопки) требуют правок в app/ → **прошу лида завести `feature/notifications`
> и перенести `NotificationsSheet`** (предложено в mail/107), тогда закрываю автономно.
>
> **Приоритеты предлагаю (P1→P3); финальная приоритизация — за лидом.**
> **NB зона:** лента в `app/AppSheets.kt` + `core/*` (зона лида) — P1-функционал он закрыл сам
> (mail/113). Моё: core/push (retry+unregister — done) и **Fd (Roborazzi-строка уведомления в
> `core/designsystem/src/test` + веб-эталон 360 CSS-px)** — по разрешению лида (mail/112б).
> `feature/notifications` — после приёмочного гейта (mail/112б).
Метки: `[Ф|Д]` (функционал/дизайн) · `[open|done|n-a]`.
@@ -26,14 +28,14 @@ Ff_app: **45.5%** (done 10 / open 12, n-a 1) · Fd_app: **0.0%** (ждёт де
- [Ф][n-a] иконка-триггер + раскрытие ленты — шелл (лид). Индикатор непрочитанных (точка
`showDot` / warning `hasThrottledPushNotifications`) — если понадобится, отдельным пингом лиду.
## Экран 2. Лента (дропдаун/шит) — Ff 57.1% · Fd 0%
**Ф (8, done 4, open 3, n-a 1):**
## Экран 2. Лента (дропдаун/шит) — Ff 71.4% · Fd 0%
**Ф (8, done 5, open 2, n-a 1):**
- [Ф][done] загрузка списка (`NotificationsRepository.load`, OCS API v2, `limit=50`)
- [Ф][done] пустое состояние «Нет уведомлений» (иконка `nof-not-icon.svg` + текст) — `items.isEmpty()`
- [Ф][done] состояние загрузки (спиннер `CircularProgressIndicator`)
- [Ф][done] состояние ошибки (текст `error`)
- [Ф][open] **«Скрыть все уведомления»** (dismiss-all`DELETE …/api/v2/notifications`) — НЕТ
в нативе; на forbion кнопка видна ВСЕГДА (даже при пустой ленте, см. карту) — **P1**
- [Ф][done] **«Скрыть все уведомления»** (`dismissAll()``DELETE …/api/v2/notifications`) —
лид `a30627a` (заголовок ленты + кнопка + оптимистичное скрытие)
- [Ф][open] баннер fairUsePolicy при throttled push («Push notifications might be unreliable») — P3
- [Ф][open] авто-обновление ленты: сейчас только push-триггер (`refreshRequest`), ETag/поллинга
(`lastETag`/notify_push) НЕТ — P2
@@ -44,16 +46,16 @@ Ff_app: **45.5%** (done 10 / open 12, n-a 1) · Fd_app: **0.0%** (ждёт де
[Д][open] пустое состояние (вид иконки/текста) · [Д][open] состояние загрузки/ошибки ·
[Д][open] анимация inbox-zero (галочка+конфетти при переходе >0→0) — P3
## Экран 3. Элемент уведомления (`F7NotificationRow` ↔ `NotificationItem`) — Ff 50.0% · Fd 0%
**Ф (12, done 6, open 6):**
## Экран 3. Элемент уведомления (`F7NotificationRow` ↔ `NotificationItem`) — Ff 58.3% · Fd 0%
**Ф (12, done 7, open 5):**
- [Ф][done] относительное время (`formatNotificationRelativeTime`) — совпадает с forbion («N минут назад»)
- [Ф][done] кнопка «Скрыть» (× → `dismissNotification``DELETE …/notifications/{id}`)
- [Ф][done] иконка app (`resolveNotificationIcon` + `AsyncImage` с auth-хедером)
- [Ф][done] subject (плоский текст)
- [Ф][done] message (плоский текст, если есть)
- [Ф][done] переход по тапу (`onNotificationClick``openAppLink(notification.link)`)
- [Ф][open] **action-кнопки уведомления** (`notification.actions[]``ActionButton`) — НЕТ в
нативе; ломает сценарии с действиями (Talk-приглашение «Присоединиться/Отклонить», и т.п.) — **P1**
- [Ф][done] **action-кнопки уведомления** (`actions[]``F7NotificationActionUi`, FlowRow) —
лид `a30627a` (primary=заливка, прочие=контур); закрывает Talk-приглашения и т.п.
- [Ф][open] `subjectRich` (`NcRichText` + User/File-параметры) — только плоский subject — P2
- [Ф][open] `messageRich` (rich + autolink) — только плоский message — P2
- [Ф][open] `externalLink` (вариант «↗», target=_blank + primary-кнопка «Contact…») — не отличается
@@ -65,32 +67,38 @@ Ff_app: **45.5%** (done 10 / open 12, n-a 1) · Fd_app: **0.0%** (ждёт де
[Д][open] вёрстка по теме (карточный стиль `_mobile-common.css` + токены) · [Д][open] иконки/аватар ·
[Д][open] типографика subject(SemiBold)/message/время
## Экран 4. Кнопка действия (`ActionButton`) — Ff 0.0% · Fd 0% — ОТСУТСТВУЕТ В НАТИВЕ
Модель `action{label,link,type,primary}`; в нативной `F7Notification` поля `actions` вообще НЕТ
(`NotificationsRepository` их не парсит).
**Ф (3, open 3):**
- [Ф][open] primary/secondary по типу (`WEB`/`primary` → primary; GET/POST/DELETE → secondary) — P1
- [Ф][open] выполнение действия (`method:action.type url:action.link`) + удаление из ленты — P1
- [Ф][open] WEB-действие как прямая ссылка (`href`) — P1
## Экран 4. Кнопка действия (`F7NotificationActionUi` ↔ `ActionButton`) — Ff 66.7% · Fd 0%
Реализовано лидом (`a30627a`): парсинг `actions[]` (`parseActions`, type→uppercase, default GET,
primary), рендер `F7NotificationActionUi`, выполнение `executeAction`.
**Ф (3, done 2, open 1):**
- [Ф][done] primary/контур по флагу `primary` (`F7NotificationActionUi.primary`) — рендер FlowRow.
(нюанс упстрима: там `isWebLink||primary`→primary; в нативе только флаг `primary` — визуально
сойдётся, разберём в Fd, не Ф-дыра)
- [Ф][done] выполнение действия (`executeAction`: POST/PUT/DELETE, иначе GET, по абсолютному
`action.link` + `OCS-APIRequest`) + оптимистичное скрытие уведомления после
- [Ф][open] **WEB-действие как прямая ссылка/открытие в браузере**`executeAction` для типа
`WEB` уходит в `else→GET` (упстрим: WEB = открыть `link` в браузере, а не HTTP-GET). Пограничный
случай, но семантика иная — P3. (сообщу лиду, если встретится WEB-action живьём)
---
## Вне карты-экрана: core/push (моя зона, отдельный бэклог)
Не входит в Ff ленты (нет веб-экрана-аналога), но моя зона и уже зафиксировано в представлении
(mail/070). Держу как отдельный трек:
- [Ф][~done] **unregister при logout**контракт f7push подтверждён (mail/110: `DELETE
…/devices/{deviceId}`, идемпотентно). **Клиент готов:** `F7PushRegistrar.unregisterBlocking`
(коммит `cc7ad71`, compile+detekt green). Осталась 1 строка вызова в `MainViewModel.logout()`
(app/, зона лида) — патч отправлен лиду (mail/112). Как впаяет — [done] (P1-push).
- [Ф][done] **unregister при logout**ЗАКРЫТО. Контракт f7push (mail/110). Клиент
`F7PushRegistrar.unregisterBlocking` (`cc7ad71`, compile+detekt green) + вызов в
`MainViewModel.logout()` best-effort на IO рядом с ревокацией (лид `255c962`, mail/112а). P1-push.
- [Ф][done] retry/бэкофф в `F7PushRegistrar.registerBlocking` (3 попытки, бэкофф 1с/3с, повтор
на 0/5xx/408/429, стоп на 2xx/4xx) — коммит `a6bda89`, compile+detekt green (P2-push)
- [Ф][n-a] серверные хвосты FCM (чистка 403 SenderId mismatch, старые `f7cloud-apk`) — ячейка A,
через integrator-b (mail/064) — вне натива
## Сводка
- **Ff = 45.5%** (done 10 / open 12; n-a 3 не в счёте: web-permission-empty, триггер-шелл, серверный FCM).
- **P1 (гейт-приоритет):** «Скрыть все» + action-кнопки (+парсинг `actions` в repo) + unregister-push.
- **P2:** rich subject/message, авто-обновление ETag, retry регистрации.
- **P3:** fairUsePolicy, external-«↗», сворачивание message, `notification--new`, inbox-zero.
- **Fd=0%** до девайс-сверки (вёрстка по теме forbion; лента у `cloude` наполняется — mail/107,
как засеют `occ notification:generate`, сверю rich/action/список живьём).
- **Ff = 63.6%** (done 14 / open 8; n-a 3 не в счёте: web-permission-empty, триггер-шелл, серверный FCM).
- **P1 — ЗАКРЫТ:** «Скрыть все» + action-кнопки + парсинг `actions` (лид `a30627a`);
unregister-push (клиент `cc7ad71` + вызов `255c962`); retry регистрации (`a6bda89`).
- **P2 (осталось):** rich subject/message, авто-обновление ETag.
- **P3 (осталось):** fairUsePolicy-баннер, external-«↗», WEB-action как ссылка, сворачивание
message, `notification--new`, inbox-zero.
- **Fd=0% → в работе автономно:** Roborazzi-скрин `F7NotificationRow` в `core/designsystem/src/test`
(w360dp) + веб-эталон 360 CSS-px (пустое состояние, без данных `cloude`) — по mail/111/112б.