# Каталог ролей и шаблонов

Статус: `approved`

## Назначение
Экран управления профилями встроенных и пользовательских ролей, их шаблонами промптов, MCP-правами, политиками аккаунтов, использованием в flow и историей версий.

## Главные сущности
- профиль роли
- `work` template
- `revise` template
- MCP policy
- account policy
- использование роли в flow

## Основные блоки
- список ролей
- карточка профиля выбранной роли
- вкладки шаблонов, MCP, политик и использования
- блок зависимостей по flow и репозиториям
- блок публикации новой версии профиля роли и шаблонов в БД
- блок связи с установочной fixture-конфигурацией

## Семантика вкладок
- `Профиль` — назначение, runtime и общая policy роли;
- `Шаблоны` — `work` и `revise`, тексты, diff, версии и проверки;
- `Инструменты (MCP)` — допустимые инструменты и ограничения;
- `Аккаунты` — provider account policy;
- `Использование` — flows, проекты, этапы и последние запуски роли;
- `История версий` — изменения профиля и шаблонов.

## Ключевые действия
- создать пользовательскую роль
- открыть и изменить шаблон
- изменить MCP-права
- изменить политику аккаунта
- посмотреть, где роль используется
- сохранить черновик
- проверить совместимость
- опубликовать новую версию роли

## Источники данных
- платформа: role catalog, prompt template versions, account policies, MCP policies, usage projections, audit log
- репозиторий платформы: только установочные fixture-файлы для bootstrap встроенных ролей и шаблонов

## Что намеренно не показывается
- смешивание профиля роли с настройкой конкретного этапа flow
- репозиторий как runtime-источник истины для активных шаблонов роли
- значения секретов и токенов аккаунтов

## Макеты
- [Основной макет](screen.png) — вкладка `Профиль`, базовый экран каталога ролей.
- [Вкладка `Шаблоны`](tab-templates.png) — вырезка центрального блока вкладки: `work`/`revise`, версии, diff, проверки и публикация новой версии.
- [Вкладка `Инструменты (MCP)`](tab-mcp-tools.png) — вырезка центрального блока вкладки: доступные MCP-инструменты, ограничения, Human gate и аудит опасных операций.
- [Вкладка `Аккаунты`](tab-accounts.png) — вырезка центрального блока вкладки: provider accounts, правила выбора аккаунта, Human gate и проверка доступа.
- [Вкладка `Использование`](tab-usage.png) — вырезка центрального блока вкладки: flows, проекты, этапы, последние запуски и необходимость обновления привязок.
- [Вкладка `История версий`](tab-version-history.png) — вырезка центрального блока вкладки: история изменений роли и шаблонов по версиям, сравнение и откат.

## Открытые вопросы
- нет
