Документация
Сгенерировано из
docs/matrices/fm/auth.yaml.
| FM | Элемент | Действие | Поведение | Роли (доступ) | Статус |
|---|---|---|---|---|---|
| FM-184 | Кнопка «?» в топ-баре | Открыть раздел | Переход на view=tutorial → TutorialPage.svelte | guest, employee, spaceman, supervisor, org_admin, site_admin | done |
| FM-185 | Переключатель роли (pills) | Клик на пилюлю (Обзор/Гость/Сотрудник/…) | Фильтрует статью по выбранной роли, read-only | guest, employee, spaceman, supervisor, org_admin, site_admin | done |
| FM-186 | Статья (markdown) | Просмотр | Рендер .md из docs/tutorial/ с TOC-сайдбаром слева, read-only | guest, employee, spaceman, supervisor, org_admin, site_admin | done |
| FM-187 | Баннер «Агент-дисклеймер» | Закрыть баннер | Скрыть предупреждение про AI-агентов, сессионное состояние | guest, employee, spaceman, supervisor, org_admin, site_admin | done |
Обзор экрана
«Документация» — встроенный в продукт раздел справки. Открывается кнопкой «?» в верхней панели (FM-184) и показывает статьи-руководства из docs/tutorial/.
Основной сценарий. Пользователь открывает раздел, слева видит оглавление (TOC), в центре — статью. Сверху ряд «пилюль»-переключателей по ролям (Обзор / Гость / Сотрудник / …); клик по пилюле (FM-185) перестраивает статью под выбранную роль — показывает то, что этой роли действительно доступно. Контент только для чтения. Отдельный баннер-предупреждение можно закрыть, его состояние держится в рамках сессии (FM-187).
Связь с методами API. Сам раздел статичен — он рендерит markdown-файлы и не дёргает методы домена «Аутентификация». Это справка для человека, тогда как машиночитаемая точка входа для агентов лежит отдельно: служебные адреса /llms.txt (краткая карта Agent API) и /docs/agents (подробный путеводитель) отдаются сервером в обход авторизации — с них агент начинает знакомство с системой. Доступ агента к API строится на Bearer-токене из профиля (Создать токен), а не на формах входа этого раздела.
Таблица выше перечисляет элементы экрана и роли, которым они доступны.