Акторы и персоны¶
Карта акторов¶
| Актор | Тип | Канал |
|---|---|---|
| Администратор организации | Человек | Web UI (admin), Account, Organization, Device, Billing |
| Руководитель (supervisor) | Человек | Web UI, Organization |
| Сотрудник организации | Человек | Playground, profile, boards |
| Агент станции (edge) | Система | Remarkable sync API, передача файлов |
| ИИ-агент (MCP) | Система | Document MCP, Chat |
| Платёжный провайдер | Внешний | Webhooks Billing |
| Оператор платформы | Человек | Infrastructure, мониторинг |
Персоны¶
Администратор организации¶
Цели: Поднять tenant, контролировать расходы, зарегистрировать железо, назначить планшеты.
| Область | Действия |
|---|---|
| Учётные записи | Пользователи, сброс доступа |
| Org | Tagline, членство |
| Устройства | Станции, devices, assignments |
| Биллинг | План, entitlements |
| Комплаенс | Audit log |
Права: admin / owner; CRUD станций и устройств в org.
Руководитель (supervisor)¶
Цели: Структура команды, подчинённость, обзор админ-действий.
| Область | Действия |
|---|---|
| Иерархия | Supervisor / subordinate |
| Аудит | Чтение UserAuditLog |
Права: Organization hierarchy/audit; не обязательно device admin.
Сотрудник¶
Цели: ИИ, личные файлы, доски, назначенный планшет.
| Область | Действия |
|---|---|
| ИИ | Чат, OCR, изображения в квоте |
| Документы | KittenSafe |
| Планшет | Скриншоты и файлы назначенного device |
| Доски | Совместное редактирование |
Права: JWT в своей org; device — только назначенные.
Оператор станции (технический)¶
Цели: Edge sync; выполнение команд облака на локальном планшете.
| Область | Действия |
|---|---|
| Sync | Poll, acknowledge |
| Файлы | Extract / insert между tablet и cloud |
Не логин-персона — демон на Raspberry Pi / мини-сервере на площадке.
ИИ-агент (MCP)¶
Цели: Автоматизация документов в чате.
| Tool | Назначение |
|---|---|
documents.* |
Папки и файлы |
device.get_latest_screenshot |
Контекст с планшета |
Права: Контекст JWT пользователя из цепочки Chat → Document.
Сводка прав¶
flowchart TB
Admin[Admin_org]
Supervisor[Supervisor]
Member[Member]
Admin -->|полный| Devices[Stations_Devices]
Admin -->|полный| Billing[Billing]
Supervisor -->|иерархия| Hierarchy[Hierarchy]
Member -->|свой| Chat[AI_Chat]
Member -->|назначен| Tablet[Device]
Member -->|collab| Boards[Boards]