f7cloud_mobile/docs/app-map/deck.md

Карта: Карточки (Deck)

Приложение «Карточки» (/apps/deck/) на forbion.f7cloud.ru. Структура кнопок/меню/переходов снята из кода (метод mail/078): апстрим nextcloud/deck v1.16.4 (src/**/*.vue — точная версия с forbion, канон README) + мобильная тема forbion (design-reference/forbion-theme/css/pages/pages-mobile/_mobile-deck.css, css/pages/app-deck/_app-deck.css). Живой мобильный web (Browser 1, cloude, mail/079) — только для визуальной сверки «как выглядит/порядок»; строго read-only (mail/073): ничего не создаётся/не меняется/не удаляется. Приватность: реальные названия досок/карточек не фиксируются — только структура UI и дерево переходов.

Статус визуальной сверки на живом forbion: выполнена 2026-07-12 (Browser 1, cloude, мобильный вьюпорт через same-origin iframe 390px, read-only — ни одной пишущей операции). Реальные русские подписи forbion внесены ниже; расхождения кода ↔ живой темы помечены сверено:. Пройдены: Обзор, Все доски, доска (Controls+стеки+карточки), сайдбар карточки.

Компоненты-источники (nextcloud/deck v1.16.4)

Навигация: navigation/AppNavigation.vue (+ AppNavigationAddBoard, AppNavigationBoard, AppNavigationBoardCategory, AppNavigationImportBoard, BoardCloneModal, BoardExportModal). Список досок: boards/Boards.vue, boards/BoardItem.vue. Обзор: overview/Overview.vue (+ dashboard/Card.vue, views/DashboardToday|Tomorrow|Upcoming.vue). Доска: board/Board.vue, board/Stack.vue, Controls.vue. Карточка на доске: cards/CardItem.vue, cards/CardMenu.vue, cards/CardMenuEntries.vue, cards/CardBadges.vue, cards/AvatarList.vue, cards/badges/DueDate.vue, cards/badges/CardId.vue. Сайдбар карточки: card/CardSidebar.vue + табы CardSidebarTabDetails (→ TagSelector, AssignmentSelector, DueDateSelector, Description, AttachmentList), CardSidebarTabAttachments, CardSidebarTabComments (+ CommentForm, CommentItem), CardSidebarTabActivity. Сайдбар доски: board/BoardSidebar.vue + SharingTabSidebar, TagsTabSidebar, DeletedTabSidebar, TimelineTabSidebar. Диалоги: CardMoveDialog.vue, CardCreateDialog.vue, BoardSelector.vue, CardSelector.vue. Настройки: DeckAppSettings.vue (+ KeyboardShortcuts.vue).

Вход

Шторка приложений (по «трём полоскам») → «Карточки», или прямой URL /apps/deck/. Оболочку (нижняя панель, шторка, бургер) описывает shell.md (зона лида) — здесь только специфика приложения. На мобильном (узкий вьюпорт) тема (_mobile-deck.css) раскладывает доску колонками по вертикали (.smooth-dnd-container.horizontal { flex-direction: column }), навигацию убирает под бургер/шторку навигации, а сайдбары/модалки/настройки раскрывает на весь экран (modal-container height:100%, modal-header скрыт).

Экран: Навигация приложения (левая шторка — AppNavigation)

На мобильном — за «бургером»/шторкой навигации приложения (не нижняя панель оболочки). Тело (пункты по порядку, сверено: подписи с forbion):

• «Ожидающие выполнения» (Upcoming cards, to="/") → экран «Обзор» (дашборд по срокам). сверено: на forbion пункт назван «Ожидающие выполнения», это и есть лендинг приложения.
• «Все доски» (All boards, to="/board", иконка deck) → список досок.
• Список личных досок (каждая — AppNavigationBoard, см. ниже), сгруппировано по категориям (AppNavigationBoardCategory).
• «Добавить доску» (Add board, иконка +) → инлайн-создание: цветной bullet (палитра-пикер) + поле «Имя доски» (Board name) + кнопки «Отмена правки»/«Сохранить доску». (write — не жму.)
• «Импортировать доску» (Import board, иконка upload) → диалог импорта (файл). (write — не жму.)
• Внизу: «Настройки Deck» (Deck settings, шестерёнка) → модалка настроек.

сверено: в мобильной навигации forbion пунктов «Архивные доски» (/board/archived) и «Доски, доступные вам» (/board/shared) НЕ видно — в коде они есть (AppNavigation), но на узком вьюпорте тема их не выводит (или показывает только при непустом списке). Для нативного клиента это скорее плюс: паритет по видимой мобильной навигации не требует этих двух видов.

Меню доски (⋯ на пункте доски — AppNavigationBoard NcActions)

Порядок пунктов из кода:

• «Сведения о доске» (Board details, icon-info) → открывает сайдбар доски (см. ниже).
• «Редактировать доску» (Edit board, icon-rename; если canManage и не архивная) → инлайн-правка названия/цвета.
• «Клонировать доску» (Clone board; если canCreate) → модалка BoardCloneModal.
• «Разархивировать доску» / «Архивировать доску» (Unarchive/Archive board) — тумблер.
• «Экспортировать доску» (Export board, icon-download) → модалка BoardExportModal.
• «Вкл./выкл. напоминания о сроках» → подменю «Напоминания о сроках» (Due date reminders): «Все карточки» (All cards) / «Назначенные карточки» (Assigned cards) / «Выкл.» (Off). (все write — не выполняю.)

Экран: Все доски (список — Boards.vue)

Тело: таблица-список досок. Тема (_app-deck.css, _mobile-deck.css) делает каждую строку карточкой (border, radius 8px). Колонки-заголовки (board-list-header-row):

• «Имя доски» (Board name) — bullet цвета доски + название (тап по строке → открыть доску).
• «Участники» (Members) — аватары ACL (AvatarList; если >5 — «+N» иконкой more).
• Поле фильтра списка navFilter (быстрый поиск по названию доски) — визуал(?) (положение на мобильной вёрстке). Пустое состояние: стандартный NcEmptyContent (тема подставляет deck-иконку).

Экран: Доска (Board.vue + Controls.vue)

Шапка (Controls) — сверено: на мобильном forbion в шапке доски 4 контрола (иконками):

• «Добавить список» (Add list) — инлайн-поле «Имя списка» (List name) + подтверждение. (write — не жму.)
• «Применить фильтр» (иконка-воронка; активная = primary). Раскрывает поповер фильтров:
  • «Фильтр по метке» (Filter by tag) — чекбоксы по меткам доски.
  • «Фильтр по назначенному» (Filter by assigned user) — «Без назначения» (Unassigned) + список пользователей доски.
  • «Фильтр по статусу» (Filter by status) — «Открытые и выполненные» / «Открытые» / «Выполненные».
• «Режимы просмотра» (View modes, иконка-сетка) — сверено: поповер с переключателями: «Показывать архивные карточки», «Выбор компактного или обычного режима просмотра», «Показывать обложки карточек». (в карте кода этого блока не было — добавлено по сверке.)
• «Открыть подробности» (Open details, ⋯) → сайдбар доски (Общий доступ/Метки/Удалённые/Активность).
• «Добавить карточку» (Add card) в коде тоже есть в Controls — на мобильном быстрый ввод идёт из шапки колонки (см. Stack). (write — не жму.) Тело: колонки-списки (Stack) по вертикали (мобильная тема), в каждой — карточки. Состояния: «Загрузка доски» (Loading board) / «Доска не найдена» (Board not found) / пусто «Нет доступных списков» (No lists available) + «Создать новый список, чтобы добавлять карточки» + поле «Имя списка».

Колонка-список (Stack.vue)

Шапка колонки:

• Заголовок списка — тап (canManage) → инлайн-правка «Изменить заголовок списка» (Edit list title).
• Меню колонки (⋯, NcActions): «Архивировать все карточки» (Archive all cards) / «Разархивировать все карточки» (Unarchive all cards) → подтверждение («Архивировать все карточки в этом списке» + Архивировать/Отмена); «Удалить список» (Delete list). (все write — не выполняю.)
• «Добавить карточку» (Add card) → инлайн-поле «Имя карточки» (Card name). (write — не жму.) Тело: карточки (CardItem), drag-n-drop переносом между колонками (мышью/тачем).

Карточка на доске (CardItem + CardBadges)

• Тап по карточке → сайдбар/деталь карточки.
• Заголовок (тап при canEdit / клавиша E → инлайн-правка «Edit card title»).
• Бейджи (CardBadges): срок (DueDate — цвет по просрочке, «выполнено»→галочка), счётчик «чек-пунктов» (Todo items), счётчик «комментариев» (N comments, M unread), аватары назначенных (AvatarList), ID карточки (если включён бейдж ID в настройках).
• Меню карточки (⋯ / long-press, CardMenuEntries): «Сведения о карточке» (Card details) → сайдбар; «Изменить заголовок» (Edit title); «Назначить мне» / «Снять назначение с меня» (Assign to me / Unassign myself); «Отметить выполненной» / «Отметить невыполненной» (Mark as done / not done); «Переместить/копировать карточку» (Move/copy card) → диалог; «Архивировать» / «Разархивировать карточку» (Archive/Unarchive card); «Удалить карточку» (Delete card) — с тостом «Карточка удалена» + «Отменить» (undo). (все write — не выполняю.)
• Клавиши на карточке: E правка заголовка, S назначить себя, archive/done по хоткею (см. настройки).

Экран: Обзор / Предстоящие карточки (Overview.vue)

Дашборд карточек по срокам (to="/", заголовок экрана «Ожидающие выполнения» + кнопка «+»), колонки-секции (мобильная тема ставит их в столбец). сверено: реальные подписи forbion: «Просроченные», «Сегодня», «Завтра», «Ближайшие 7 дней», «Позже», «Без назначенной даты». Каждая секция — список dashboard/Card.vue (карточки с меткой, иконкой описания и ⋯). Состояние загрузки: «Загрузка отфильтрованного вида».

Сайдбар карточки (CardSidebar — на мобильном во весь экран)

Шапка: заголовок карточки (редактируемый), меню (⋯): «Открыть в боковом виде» (Open in sidebar view) / «Открыть в большом виде» (Open in bigger view). Подпись «Изменено … ⸱ Создано …». Табы (по порядку) — сверено: на forbion таб Details назван «Свойства», далее «Вложения», «Комментарии», «Активность»:

• Свойства (Details) — CardSidebarTabDetails, порядок секций (сверено на живой карточке: метка → назначение → срок → описание):
  1. «Назначить метку карточке…» (TagSelector) — комбобокс «Выбрать или создать метку…», можно «Создать новую метку».
  2. «Назначить пользователю/группе/команде» (AssignmentSelector) — «Выбрать пользователя…».
  3. «Назначить срок карточке…» (DueDateSelector) — «Установить срок» / «Добавить срок»; быстрые опции: «Позже сегодня», «Завтра», «В эти выходные», «На след. неделе»; «Выбрать дату» (Choose a date) → пикер; «Убрать срок» (Remove due date); «Отметить выполненной» (Mark as done); при наличии — «Срок: …»/«Не выполнено»; «Архивировать карточку».
  4. (если включены проекты) блок связанных проектов (NcCollectionList).
  5. «Описание» (Description) — «Редактировать описание» / «Просмотр описания», «Справка по форматированию», «Добавить вложение», плейсхолдер «Напишите описание …»; статусы «(Не сохранено)»/«(Сохранение…)».
• Вложения (Attachments) — CardSidebarTabAttachments (+ AttachmentList): «Загрузить новые файлы» (Upload new files), «Поделиться из Файлов» (Share from Files); по элементу: «Показать в Файлах», «Скачать» (Download), «Удалить вложение», «Восстановить вложение»; drop-зона «Перетащите файлы для загрузки»; «Эта доска только для чтения».
• Комментарии (Comments) — CardSidebarTabComments (+ CommentForm): поле ввода + «Сохранить»; пусто «Пока нет комментариев. Начните обсуждение!».
• Активность (Activity) — CardSidebarTabActivity (если включён Activity-апп). (все действия табов — write, на forbion не выполняю.)

Сайдбар доски (BoardSidebar — во весь экран на мобильном)

Табы: «Общий доступ» (Sharing) — SharingTabSidebar: «Поделиться доской с пользователем, группой или командой …», права по ACL (Can edit / Can share / Can manage / Owner), «Передать доску» (Transfer) с подтверждением, «Удалить» доступ; «Метки» (Tags) — TagsTabSidebar: список меток, «Добавить новую метку», по метке — «Редактировать»/«Удалить»; «Удалённые элементы» (Deleted items) — DeletedTabSidebar: «Удалённые списки» / «Удалённые карточки» (восстановление); «Активность» (Activity). (все write — не выполняю.)

Диалог: Переместить/копировать карточку (CardMoveDialog)

• «Выбрать доску» (Select a board) — комбобокс.
• «Выбрать список» (Select a list; «Нет доступных списков», если пусто).
• Кнопки «Переместить карточку» (Move card) / «Копировать карточку» (Copy card).

Модалка: Настройки Deck (DeckAppSettings — во весь экран на мобильном)

• Общее (General): «Использовать увеличенный вид карточки» (Use bigger card view).
• Внешний вид (Appearance): «Показывать бейдж ID карточки» (Show card ID badge), «Показывать доски в календаре/задачах» (Show boards in calendar/tasks).
• Настройки администратора (Admin settings, если админ): «Ограничить создание досок группами».
• Комбинации клавиш (KeyboardShortcuts): действия доски (Scroll sideways, навигация стрелками, Escape закрыть карточку, Ctrl+F поиск, F фильтры, X сброс фильтров, ? справка) и карточки (Enter/Space открыть, E правка заголовка, S назначить себя). В теме forbion секция клавиш может быть скрыта на мобильном — визуал(?).

Расхождения с нативным клиентом (feature/deck) — бэклог

Нативный модуль (DeckRepository/DeckScreen/DeckCardSheet/DeckViewModel) сейчас покрывает: список неархивных досок, доску колонками, карточки (метки/срок/исполнители-чтение/done/ счётчик), деталь карточки (правка названия/описания, срок через пикер, done, toggle меток, перенос между колонками, архив, удаление), создание карточки и колонки, учёт PERMISSION_EDIT. Отсутствует против веба (приоритетный бэклог):

• Обзор/Предстоящие карточки — дашборда по срокам (Просрочено/Сегодня/…/Без срока) нет.
• Архивные доски и Доски, доступные вам — отдельных видов нет (архивные доски просто скрыты).
• Фильтры доски — по метке / назначенному / статусу; поиска по доске нет.
• Исполнители — только чтение: нет «Назначить мне/пользователю», снятия (совпадает с долгом №1 плана mail/071, п.2).
• Комментарии и Вложения карточки — нет совсем (вложения явно в зоне, mail/065).
• Меню/CRUD колонки: правка заголовка списка, «Архивировать/Разархивировать все карточки», «Удалить список» — в приложении нет (только создание).
• CRUD досок: создать/править/клонировать/архивировать/экспортировать/импортировать доску — нет; переименования колонок нет.
• Move/copy на другую доску — нативно только перенос между колонками одной доски.
• Метки (Tags) доски — управления (создать/править/удалить) нет; toggle существующих есть.
• Sharing / Deleted items / Activity доски — нет.
• Быстрые опции срока (Позже сегодня/Завтра/Выходные/След. неделя) — в пикере нет.
• Режимы просмотра доски (сверено: шапка forbion): показ архивных карточек, компактный/ обычный режим, обложки карточек — в нативном клиенте нет.
• Напоминания о сроках (notify-due) и бейдж ID / увеличенный вид из настроек — нет.
• Undo при удалении карточки — в вебе есть тост-отмена; в нативном удаление сразу.
• Мелочь UI: счётчики чек-пунктов и комментариев на карточке доски — не показываются.