From 03460dceaff5ed7b5549371a9133caf461e96579 Mon Sep 17 00:00:00 2001 From: b-mob-notes Date: Sun, 12 Jul 2026 22:32:15 +0000 Subject: [PATCH] =?UTF-8?q?docs(app-map):=20notes.md=20=E2=80=94=20=D0=B2?= =?UTF-8?q?=D0=B8=D0=B7=D1=83=D0=B0=D0=BB=D1=8C=D0=BD=D0=B0=D1=8F=20=D1=81?= =?UTF-8?q?=D0=B2=D0=B5=D1=80=D0=BA=D0=B0=20=D0=BD=D0=B0=20forbion=20(Brow?= =?UTF-8?q?ser=201,=20read-only)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Подтверждено живьём: welcome-пустое, новая заметка/поиск/образец, навигация категорий, меню настроек (Мобильные приложения). Ненаблюдаемое read-only (нет заметок у cloude) — меню/редактор/конфликт помечены код-only. mail/079. Co-Authored-By: Claude Fable 5 --- docs/app-map/notes.md | 44 +++++++++++++++++++++++++++++-------------- 1 file changed, 30 insertions(+), 14 deletions(-) diff --git a/docs/app-map/notes.md b/docs/app-map/notes.md index d5381ab..1d0ba32 100644 --- a/docs/app-map/notes.md +++ b/docs/app-map/notes.md @@ -9,10 +9,18 @@ создаётся/не меняется/не удаляется. Приватность: реальные заголовки/тексты заметок не фиксируются — только структура UI и дерево переходов. -> Статус визуальной сверки на живом forbion: **ожидает** — автопереход Chrome на forbion в -> моей сессии блокирует защитный классификатор (переход инициирован из письма, не владельцем). -> Дерево ниже построено из кода и валидно; отметки `визуал(?)` = требуют финального взгляда -> на экран. +> Статус визуальной сверки на живом forbion (Browser 1 `c9284989`, `cloude`, mail/079, +> техника same-origin iframe 390px): **выполнена частично, 2026-07-12.** Мобильная вёрстка +> подтверждена (`header__mobile`, `header__mobile-bottom`). **Подтверждено на живом сервере:** +> пустое состояние Welcome (тексты 1:1 с кодом), кнопка «Новая заметка», поле поиска, «Создайте +> образец заметки с помощью Markdown», навигация «Все заметки» (со счётчиком) / капшен +> «Категории» / «Новая категория», «Меню настроек» (модалка открывается, секция «Мобильные +> приложения» — Android / iPhone and iPad). **НЕ наблюдаемо read-only:** список строк-заметок, +> меню заметки (⋮), редактор (rich/plain/preview), диалог конфликта, детальные секции настроек +> «Общее» — у `cloude` заметок НЕТ, а создание/открытие = запись (запрещено mail/073). Эти узлы +> остаются из кода (v5.0.0) — помечены `код-only` ниже. NB: при первом входе поверх приложения +> всплывает глобальный онбординг-попап «Добро пожаловать в F7cloud!» (не notes-специфичный, не +> закрывал — dismiss может писать флаг на сервер). ## Компоненты-источники (nextcloud/notes v5.0.0) `App.vue` (шелл: навигация категорий + настройки) · `NotesView.vue` (список + поиск + «Новая @@ -29,7 +37,7 @@ выбор заметки открывает **редактор** поверх (`NcAppContent` show-details), возврат — «назад». ## Экран: Список заметок (главный) -**Шапка списка (`content-list__search`):** +**Шапка списка (`content-list__search`) — ✔ кнопка и поле подтверждены на forbion:** - Кнопка «**Новая заметка**» (primary, иконка +) → создаёт заметку и открывает редактор (write — на forbion НЕ нажимаю). - Поле «**Искать заметки**» (`Search for notes`) → фильтрация списка по заголовку по мере @@ -45,16 +53,19 @@ - Индикатор «расшарена» (значок ShareVariant, если у заметки есть шаринг). - Кнопка «**действия**» (⋮, меню строки) → см. «Меню заметки». -**Пустое состояние (нет заметок / `Welcome.vue`):** заголовок «Заметки» + «Start writing a -note by clicking on “New note”» + кнопка «**Новая заметка**»; подсказки: «Пишите мысли без -отвлечений», «Используйте Markdown», кнопка «**Создать образец заметки с Markdown**» -(`CreateSampleButton` — write, не нажимаю), «Организуйте заметки по категориям». +**Пустое состояние (нет заметок / `Welcome.vue`) — ✔ подтверждено на forbion (`cloude`, +route `/apps/notes/welcome`):** заголовок «Заметки» + «Начните писать заметку, нажав «Новая +заметка».» + кнопка «**Новая заметка**»; подсказки: «Записывайте свои мысли, ни на что не +отвлекаясь.», «Поддержка языка разметки Markdown для оформления текста;», кнопка «**Создайте +образец заметки с помощью Markdown**» (`CreateSampleButton` — write, не нажимаю), «Поддержка +категорий;». **Состояние загрузки:** «Загрузка …» (`Loading …`). **Пустой поиск в категории:** кнопка «**Найти во всех категориях**» (сбрасывает выбранную категорию). -## Меню заметки (⋮ в строке — `NoteItem` #actions) -Порядок пунктов из кода: +## Меню заметки (⋮ в строке — `NoteItem` #actions) — `код-only` +(У `cloude` заметок нет → строку и её меню на forbion read-only не наблюдал; из кода v5.0.0.) +Порядок пунктов: - «**Добавить в избранное**» / «**Удалить из избранного**» (тумблер, звезда) → `PUT /favorite`. - «**Поделиться**» (Share) → открывает сайдбар шаринга (`NoteShareSidebar`, стандартный NC-шэринг). *(состав панели — общий NC sharing; детально не раскрывал — визуал(?))* @@ -65,7 +76,8 @@ note by clicking on “New note”» + кнопка «**Новая заметк - «**Удалить заметку**» (если не read-only) → удаление (`DELETE`) с возможностью отмены (`POST /notes/undo`). (write — не выполняю на forbion.) -## Экран: Редактор заметки +## Экран: Редактор заметки — `код-only` +(Открытие/создание заметки = запись → на forbion read-only не наблюдал; из кода v5.0.0.) Открывается тапом по заметке или «Новая заметка». Режим определяется настройкой Display (rich / plain / preview, см. Настройки). @@ -92,7 +104,7 @@ note by clicking on “New note”» + кнопка «**Новая заметк **Ошибка сохранения:** пункт «**Сохранение не удалось. Нажмите, чтобы повторить.**» (`onManualSave`) — ручной повтор `PUT`. -## Диалог: Конфликт версий (`ConflictSolution`) +## Диалог: Конфликт версий (`ConflictSolution`) — `код-only` Возникает, если заметка изменена в другой сессии (сервер вернул конфликт на `If-Match`): - Текст: «Заметка была изменена в другой сессии. Выберите, какую версию сохранить.» - Кнопка «**Использовать версию с сервера**». @@ -102,6 +114,8 @@ note by clicking on “New note”» + кнопка «**Новая заметк ## Навигация: Категории (левая шторка — `App.vue` + `CategoriesList`) На мобильном — за «бургером»/шторкой навигации приложения (не нижняя панель оболочки). +✔ На forbion подтверждены: «Все заметки» (со счётчиком `0`), капшен «Категории», «Новая +категория», кнопка «Меню настроек». Список конкретных категорий пуст (у `cloude` нет заметок). - «**Новая категория**» (`NcAppNavigationNew`, иконка папка+) → создание категории (drag-n-drop заметки на неё тоже вешает категорию). (write — не выполняю.) - «**Все заметки**» + счётчик (bubble) → сброс фильтра категории, весь список. @@ -116,7 +130,9 @@ note by clicking on “New note”» + кнопка «**Новая заметк ## Модалка: Настройки заметок (`AppSettings`) На мобильном тема раскрывает её на весь экран (`_mobile-notes.css`: modal-container height -100%, скрыт заголовок modal-header). Секции: +100%, скрыт заголовок modal-header). ✔ На forbion открыл модалку read-only и подтвердил секцию +«**Мобильные приложения**» (подписи «Android», «iPhone and iPad» = `HelpMobile.vue`). Секции +«Общее»/«Комбинации клавиш» детально не раскрывал (`код-only`, из v5.0.0). Секции: - **Общее** (`General`): - «**Отображение**» (Display): «Форматированный текст» (rich) / «Простой текст» (plain) / «Просмотр» (preview).