diff --git a/docs/app-map/files.md b/docs/app-map/files.md new file mode 100644 index 0000000..9b5db6e --- /dev/null +++ b/docs/app-map/files.md @@ -0,0 +1,109 @@ +# Карта: Файлы + +Составлена по мобильной веб-версии forbion.f7cloud.ru (аккаунт `cloude`, iframe ~390px, +строго read-only — mail/073/075). Приватность: реальные ФИО/почты сотрудников, права доступа +и инвентарь бизнес-папок не фиксируются — только структура UI и дерево переходов. + +## Вход +Приложение «Файлы» — стартовое (нижняя панель / шторка приложений «Файлы»). URL `/apps/files/files`. +Оболочку (нижняя панель, шторка, бургер) описывает `shell.md` (зона лида) — здесь только +специфика приложения. + +## Экран: Все файлы (главный / список папки) +**Шапка (сверху вниз):** +- Пилюля «Поиск» (Объединённый поиск) → экран поиска (см. ниже). +- Иконка-сетка справа → «Переключиться на режим просмотра сеткой» (тумблер список⇄сетка). +- Кнопка «Открыть навигацию [n]» → шторка навигации файлов (см. «Навигация файлов»). +- Кнопка «Новый» → меню создания/загрузки (см. «Меню Новый»). +- Хлебные крошки: 🏠 (корень) → сегменты пути; каждый сегмент кликабелен → переход к папке. +- Чипы-фильтры: «Тип файла», «Изменён», «Участники» (в корне — три; внутри папки «Участники» + пропадает, остаются «Тип файла»/«Изменён»). + +**Тело:** +- Блок недавних/предложенных файлов (горизонтальная лента карточек: иконка типа + имя + + «Последнее обновление: …»); тап по карточке → открытие файла. +- Список папок/файлов (строки): чекбокс выделения · иконка типа (звёздочка = избранное) · + имя · инлайн-кнопка «Скачать» (для файлов) · кнопка «Действия» (⋮). + - Тап по строке-папке → открыть папку (крошки наращиваются, URL `?dir=/Путь`). + - Тап по строке-файлу → открыть файл (по типу, см. «Открытие файла»). + - Чекбокс → режим выделения (см. «Режим выделения»). + - «Действия» (⋮) → контекстное меню файла/папки (см. ниже). + +**Пустое состояние (папка без файлов):** иконка + «Здесь нет файлов» + подзаголовок +«Загрузите что-нибудь или синхронизируйте со своими устройствами!». + +## Меню «Новый» (создание/загрузка) +Открывается кнопкой «Новый». Два раздела: +- **Загрузить с устройства:** «Загрузить файлы», «Загрузить папки». +- **Создать новое:** «Новая папка», «Запрос на создание файла», «Новая диаграмма», + «Новая доска», «Новая презентация», «Новая таблица», «Новый документ», + «Новый текстовый файл», «Создать папку шаблонов». +- (read-only: пункты только просмотрены, ничего не создавалось.) + +## Навигация файлов (шторка «Открыть навигацию») +Список представлений + дерево: +- «Все файлы», «Личные файлы», «Недавно изменённые», «Избранные», + «Опубликованные ресурсы», «Командные папки», «Метки», «Внешнее хранилище», + «Дерево папок», «Корзина». +- Внизу — индикатор квоты («Использовано N GB»). +- Каждый пункт → соответствующее представление списка файлов. + +## Фильтры +- **«Тип файла»** → мультивыбор типов: Документы, Таблицы, Презентации, PDFs, Папки, Звук, + Изображения, Видео. +- **«Изменён»** → фильтр по дате изменения (диапазоны). *(не раскрывал детально — (?))* +- **«Участники»** → фильтр по людям, имеющим доступ. *(не раскрывал детально — (?))* + +## Контекстное меню (⋮) — Папка +«Добавить в избранное», «Подробно», «Варианты обмена», «Управление метками», +«Переименовать», «Переместить или копировать», «Установить напоминание» ›, +«Открыть локально», «Скачать», «Архивировать в...» ›, «Удалить папку». + +## Контекстное меню (⋮) — Файл +«Добавить/Удалить из избранных», «Подробно», строка-статус общего доступа (если расшарен), +«Управление метками», «Переименовать», «Переместить или копировать», +«Установить напоминание» ›, «Сохранить как…» › (для офисных — форматы), +«Открыть локально», «Скачать», «Архивировать в...» ›, «Удалить файл». + +## Режим выделения (bulk) +Отметка чекбокса → шапка списка меняется на: «Выбран N» (слева) + кнопка «Действия» (справа). +Меню «Действия» (групповое): «Добавить в избранное», «Управление метками», +«Переместить или копировать», «Скачать», «Архивировать в...» ›, «Удалить папку/файлы». + +## Экран: Подробно (панель сведений о файле) +Открывается пунктом «Подробно» в ⋮. Шапка: имя файла · × закрыть · владелец/аватар · +«<дата изменения> / <размер>». Четыре вкладки-иконки: +- **Общий доступ** (людской значок): подсекции «Внутренние ссылки» (поле «Введите имена или + команды», список получателей с выпадающим правом «Можно редактировать/…», «Другие + пользователи, имеющие доступ», «Внутренняя ссылка / Для тех, у кого уже есть доступ» + + копировать), «Внешние ссылки» (поле e-mail, «Создать общедоступную ссылку» +), + «Дополнительные ссылки». Внизу — ряд быстрых иконок связанных приложений. +- **Версии** — история версий файла. +- **Чат** — комментарии к файлу. +- **События** — активность/лента событий по файлу. +- (read-only: панель только просмотрена; персональные данные получателей не фиксируются.) + +## Открытие файла (по типу) +Тап по файлу открывает вьюер/редактор по типу (наблюдалось частично; часть — (?) по иконкам/ +категориям типов): +- Офисные (Таблицы/Документы/Презентации) → редактор Collabora/Richdocuments в WebView. +- `.md` / текст → редактор текста/markdown. +- Изображения → просмотрщик изображений. +- `.whiteboard` / «доска» → редактор доски (WebView). +- PDF → просмотрщик PDF. *(точный переход для PDF/аудио/видео — (?), не открывал.)* + +## Экран: Поиск +Пилюля «Поиск» → объединённый поиск (Nextcloud unified search) по файлам и приложениям. +*(детальное дерево поиска не раскрывал — (?).)* + +## Расхождения с нативным клиентом (предварительно, к сверке — бэклог b-mob-files) +Проставлю после сверки этого дерева с `feature/files` на устройстве (задача №1 по mail/068). +Кандидаты на проверку: +- `расхождение(?):` меню «Новый» — полнота списка «Создать новое» (диаграмма/доска/презентация/ + таблица/документ/текст/шаблоны/запрос на создание файла) против нативного `FilesCreateMenu`. +- `расхождение(?):` панель «Подробно» — наличие всех 4 вкладок (Общий доступ/Версии/Чат/События) + в нативе. +- `расхождение(?):` фильтры «Тип файла/Изменён/Участники» и их опции. +- `расхождение(?):` групповые операции в режиме выделения. +- `расхождение(?):` внутренние шэры (пользователь/группа) — в нативе сейчас только публичная + ссылка (см. mail/068 план п.3).