docs(app-map): notes.md — визуальная сверка на forbion (Browser 1, read-only)

Подтверждено живьём: welcome-пустое, новая заметка/поиск/образец, навигация категорий,
меню настроек (Мобильные приложения). Ненаблюдаемое read-only (нет заметок у cloude) —
меню/редактор/конфликт помечены код-only. mail/079.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
b-mob-notes
2026-07-12 22:32:15 +00:00
parent 2cb7a9a470
commit 03460dceaf
+30 -14
View File
@@ -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).