diff --git a/docs/images/cabinet-ui/README.md b/docs/images/cabinet-ui/README.md new file mode 100644 index 0000000..8785fb2 --- /dev/null +++ b/docs/images/cabinet-ui/README.md @@ -0,0 +1,10 @@ +# Иллюстрации к разделу «Как пользоваться» + +Сейчас здесь **SVG-схемы** — их видно в Git и в просмотрщике Markdown. +Чтобы подставить **скриншоты** с экрана мини-приложения: + +1. Сделайте 2–3 скриншота (список, низ с «Сохранить», блок «Показ / назначения»). +2. Сохраните в эту папку, например: `spisok.png`, `chernovik.png`, `pokaz.png`. +3. В файле `docs/СПРИНТЫ_МОБИЛЬНЫЙ_ДИЗАЙН.md` замените в картинках `placeholder-*.svg` на ваши имена `*.png` (или оставьте SVG). + +Имена в Markdown сейчас: `placeholder-spisok.svg`, `placeholder-chernovik.svg`, `placeholder-pokaz.svg`. diff --git a/docs/images/cabinet-ui/placeholder-chernovik.svg b/docs/images/cabinet-ui/placeholder-chernovik.svg new file mode 100644 index 0000000..caba0a1 --- /dev/null +++ b/docs/images/cabinet-ui/placeholder-chernovik.svg @@ -0,0 +1,9 @@ + + + =87C  !>E@0=8BL G5@=>28: + A>E@0=O5B 2AQ, GB> =0?8A0;8 2 2>?@>A0E + + !>E@0=8BL G5@=>28: + +  A?8A:C + diff --git a/docs/images/cabinet-ui/placeholder-pokaz.svg b/docs/images/cabinet-ui/placeholder-pokaz.svg new file mode 100644 index 0000000..1fc7833 --- /dev/null +++ b/docs/images/cabinet-ui/placeholder-pokaz.svg @@ -0,0 +1,8 @@ + + + >:07 2 :0B0;>35 + 848<>ABL  2 >1I5< A?8A:5 8;8 A:@KB + >B@C4=8:8 (5A;8 2:;NG5=>) + 07=0G5=85 = 2K40BL B5AB 2 @01>BC, =5 ?CB09B5 A A>E@0=8BL + K1@0BL 2A5E = B>;L:> 2 B5:CI5< >BD8;LB@>20==>< A?8A:5 + diff --git a/docs/images/cabinet-ui/placeholder-spisok.svg b/docs/images/cabinet-ui/placeholder-spisok.svg new file mode 100644 index 0000000..e5ad514 --- /dev/null +++ b/docs/images/cabinet-ui/placeholder-spisok.svg @@ -0,0 +1,7 @@ + + + !?8A>: B5AB>2 + :0@B>G:0 =06<8B5 =0 =0720=85 8;8 @>9B8 + + + diff --git a/docs/СПРИНТЫ_МОБИЛЬНЫЙ_ДИЗАЙН.md b/docs/СПРИНТЫ_МОБИЛЬНЫЙ_ДИЗАЙН.md index 68c4d8f..da957b2 100644 --- a/docs/СПРИНТЫ_МОБИЛЬНЫЙ_ДИЗАЙН.md +++ b/docs/СПРИНТЫ_МОБИЛЬНЫЙ_ДИЗАЙН.md @@ -31,6 +31,106 @@ --- -## Спринт 3 — дизайн-токены (по желанию) +## Спринт 3 — структура «карточки теста», копи, доводка списка и кабинета -- [ ] Единая шкала: `--control-height`, `--control-padding-x`, `--button-gap` — рефакторинг всех `inline-actions` и форм +**Цель:** человекочитаемые названия и группировка разделов; согласованные подсказки и тап-зоны; доводка списка тестов, истории, назначения и редактора по замечаниям. + +### Страница теста (`TestDetail`) + +- [x] **3.1** `AccSection`: подзаголовок под заголовком (`subtitle` + стили `cabinet-disclosure__summary-*`) +- [x] **3.2** У «тела» аккордеона — верхний внутренний отступ: `.cabinet-disclosure__body` (контент не «прилипает» к header) +- [x] **3.3** Переименования: «О тесте», «Вопросы» (вместо мета/содержания); подзаголовки-описания по смыслу +- [x] **3.4** **Импорт** встроен в «Вопросы»: подсекция «Документ в вопросы»; отдельного аккордеона «Импорт из файла» нет +- [x] **3.5** **История**: одна секция, подпункты «Версии» + «Прохождения»; пустое/ошибочное состояние у прогонов +- [x] **3.6** Ошибка загрузки прогонов: не в герое страницы, а внутри «Прохождения» +- [x] **3.7** **Показ в каталоге:** подсекция «Видимость» + (при `assignmentUi`) «Кому выдать»; кнопка видимости **не** на всю ширину (`.publication-visibility__actions`) +- [x] **3.8** Панель ИИ-генерации: `.test-detail-ai-panel` (фон/рамка в духе кабинета, без «лишней» карточки) +- [x] **3.9** Вопрос: блоки `.question-editor-block` + первый вопрос без лишнего верхнего бордера (`.question-editor-block--first`) +- [x] **3.10** Варианты: удаление — **иконка** «закрыть» + `aria-label` (вместо текста «убрать») +- [x] **3.11** Одна панель `.question-editor__footer`: «+ вариант» и «Удалить вопрос»; «+ вопрос» вынесен в `.test-detail-add-question` над блоком импорта +- [x] **3.12** **Назначение:** кнопка **«Выбрать всех (N)»** по текущему отфильтрованному списку; подсказки в подсекциях +- [x] **3.13** Стили подсекций: `.test-detail-subsection`, `.test-detail-subsection__title`, `.test-detail-hint` +- [x] **3.14** Импорт: на мобилке **полная ширина** кнопки «Выбрать файл» (`.import-file-row--block`); ровнее отступы у превью +- [x] **3.15** Классы списка версий: на узком экране у `.version-card-list__main` `flex-grow: 0` в column — **без пустой «вытянутой» карточки v1** + +### Список тестов и шапка + +- [x] **3.16** **Список:** на `≤640px` карточка в **колонку** (заголовок на ширину экрана, **«Пройти»** снизу на **всю ширину**; без пустой полосы) +- [x] **3.17** `hover` у строк списка — только при `@media (hover: hover) and (pointer: fine)`; лёгкий **`:active`** на ссылке (тач-фидбек) +- [x] **3.18** **Шапка** `cabinet-header__inner`: учёт **safe-area** сверху и по бокам +- [x] **3.19** **Назначение (кабинет):** у `.assign-list` — выше область прокрутки на мобилке; у строк — линия раздела чуть заметнее; **центр чекбокса** + **line-clamp** у мета; `accent-color` у чекбокса +- [x] **3.20** Ритм **аккордеонов** на `test-detail-page` — чуть больше `margin` между `cabinet-brick`; **нижний отступ** у страницы под **фикс-футер** увеличен +- [x] **3.21** **Поле поиска** в назначении: более «строчный» вид (min/max `height` + `padding` у `.assign-toolbar__search`) + +**Файлы:** `frontend/src/styles/cabinet-theme.css`, `frontend/src/pages/TestDetail.jsx`, `frontend/src/pages/TestsList.jsx` (только косвенно через стили, разметка списка ранее). + +--- + +## Спринт 4 — памятка для врачей/заведующих (без IT-сленга) + +**Цель:** в этом же файле в конце — краткая инструкция, как пользоваться кабинетом тестов; иллюстрации к разделу; никакой отдельной «саги» про дизайн-токены. + +- [x] **4.1** Блок «Как пользоваться» простым языком, по смыслу блоков интерфейса +- [x] **4.2** Папка `docs/images/cabinet-ui/`: схемы-заглушки (SVG); при необходимости **замените** их своими **скриншотами** с тем же именем файла или поправьте пути внизу документа +- [x] **4.3** Отдельный спринт про design tokens **убран** — при желании вынесите в issue/другой документ + +**Файлы:** `docs/СПРИНТЫ_МОБИЛЬНЫЙ_ДИЗАЙН.md` (блок внизу), `docs/images/cabinet-ui/*`. + +--- + +## Как пользоваться: коротко и по делу + +*Если картинки не открываются — проверьте, что рядом с этим файлом лежат файлы в `images/cabinet-ui/`. Схемы можно заменить на настоящие скриншоты из мини-приложения (PNG) — с теми же названиями.* + +### 1. Список тестов + +Тут — все доступные вам тесты. **Название** (или область слева) ведёт в **редактирование**, кнопка **«Пройти»** — **сдать** тест, если вы в роли сотрудника, а не автора. Не путайте: редактировать могут не все. + +![Схема: список](images/cabinet-ui/placeholder-spisok.svg) + +--- + +### 2. О тесте + +Название, **описание** для коллег, **порог зачёта** (процент). Это «паспорт» теста: заполните так, чтобы было понятно, **что проверяете** и с какой планкой «зачёт/незачёт». + +--- + +### 3. Вопросы + +Здесь вы **пишете сами** вопросы и **варианты ответов**. Кружок/квадратик слева от варианта — **отметьте верные**. Один верный = как контрольный; несколько = можно включить **«Несколько верных ответов»**. + +- **+ вопрос** / **+ вариант** — добавить. +- **Крестик** у варианта — убрать лишний ответ. +- **Документ в вопросы** — подгрузить **файл** (PDF, Word, текст) и по подсказкам вставить в черновик; **не** обязателен, если вы всё ввели руками. +- **ИИ** (если есть) — **помощь**, а не готовый клинический протокол: всё равно **прочитайте и исправьте** перед публикацией. + +--- + +### 4. Сохранить + +Кнопка **«Сохранить черновик»** (часто закреплена **внизу экрана** на телефоне) — **обязательно**, если не хотите потерять правки. **«К списку»** — выйти без паники: если **уже нажимали «Сохранить»** до этого, черновик сохранён. + +![Схема: кнопки внизу](images/cabinet-ui/placeholder-chernovik.svg) + +--- + +### 5. История + +- **Версии** — когда менялся тест. Актуальная помечена. Редко нужно **«Сделать активной»** другую версию — обычно по согласованию с IT/методистом. +- **Прохождения** — **кто уже сдавал**; «Разбор» — посмотреть **ответы** (если вам открыт доступ). Для **обычного заведения теста** смотрите **редко**; для **разбора ситуации** — полезно. + +--- + +### 6. Показ в каталоге + +- **Видимость** — **показать** тест **всех** в списке или **скрыть** (тест **не** удаляется, просто **не мешается** в ленте). Скрытие **не** отменяет уже выданные ссылки, если кто-то ими **поделился**. +- **Кому выдать** (если раздел есть) — **кому** из сотрудников **назначить** тест. Сначала **поиск/фильтр**, **галочки**, при необходимости **«Выбрать всех»** по **текущему** списку, затем **«Назначить выбранных»**. Это **про людей**, не про текст вопросов. + +![Схема: видимость и назначение](images/cabinet-ui/placeholder-pokaz.svg) + +--- + +### В одном предложении + +**Написали вопросы → нажали «Сохранить» → при необходимости показали в списке / кому-то выдали.** Всё остальное — по ситуации.