# Manager API

Источник маршрутов: `internal/modules/manager/http/module.go`.

## Public

1. `POST /tenant/vk/callback/{path_token}/{tenant_id}/{group_id}`  
   Callback endpoint для tenant/group.
2. `OPTIONS /tenant/vk/callback/{path_token}/{tenant_id}/{group_id}`  
   CORS/preflight.

## Private (`/manager/*`)

### Me

1. `GET /manager/me/profile` — профиль менеджера (`account_type`, `account_code`).
2. `GET /manager/me/settings` — пользовательские настройки.
3. `PUT /manager/me/settings` — обновление пользовательских настроек.

### Chats / Workspace

1. `GET /manager/chats` — список доступных чатов.
2. `GET /manager/chats/workspace/{chat_uid}` — агрегированный workspace чата.
3. `POST /manager/chats/workspace/{chat_uid}/events` — создать event rule.
4. `POST /manager/chats/workspace/{chat_uid}/timers` — создать timer.
5. `GET /manager/chats/workspace/{chat_uid}/actions` — список audit-действий.
6. `GET /manager/chats/workspace/{chat_uid}/stats` — статистика чата.

### Chat addons

1. `GET /manager/chats/{peer_id}/addons` — список аддонов чата.
2. `POST /manager/chats/{peer_id}/addons` — создать аддон в чате.
3. `PATCH /manager/chats/{peer_id}/addons/{name}` — изменить аддон.
4. `DELETE /manager/chats/{peer_id}/addons/{name}` — удалить аддон.
5. `POST /manager/chats/{peer_id}/addons/install` — установить аддон из каталога.

### Chat settings

1. `GET /manager/chats/{peer_id}/settings` — получить базовые настройки.
2. `PUT /manager/chats/{peer_id}/settings` — обновить базовые настройки.

### Groups / Callback

1. `GET /manager/groups` — группы пользователя.
2. `POST /manager/groups/connect` — подключить группу.
3. `GET /manager/groups/{group_id}/settings` — настройки группы.
4. `PUT /manager/groups/{group_id}/settings` — обновить настройки группы.
5. `POST /manager/groups/{group_id}/token` — сохранить token.
6. `POST /manager/groups/{group_id}/callback/rotate-secret` — ротация секрета.
7. `GET /manager/groups/{group_id}/callback/verify` — верификация callback.
8. `GET /manager/groups/{group_id}/callback/events` — лог callback событий.
9. `POST /manager/groups/{group_id}/callback/ping` — тест callback.
10. `GET /manager/groups/{group_id}/status` — статус callback-конфигурации.

### Addons catalog

1. `GET /manager/addons/catalog` — публичный каталог approved аддонов.
2. `GET /manager/addons/catalog/categories` — список стандартизированных категорий.
3. `GET /manager/addons/catalog/{addon_id}/versions` — история версий каталожного аддона.
4. `POST /manager/addons/catalog` — создать draft в каталоге.
5. `GET /manager/addons/catalog/mine` — мои каталогные аддоны.
6. `POST /manager/addons/catalog/{addon_id}/submit` — отправить на модерацию.
7. `GET /manager/addons/moderation/pending` — pending для модерации.
8. `POST /manager/addons/moderation/{addon_id}/decision` — решение модерации.

## Каталог аддонов: важные поля

1. `title`, `slug`, `addon_name`
2. `category` (стандартизированная)
3. `image_url`
4. `usage_example`
5. `gallery` (массив URL)
6. `description`
7. `code`

## Доступы

1. Модерация каталога (`pending`, `decision`) ограничена глобальным уровнем аккаунта `account_type >= moderator`.
2. Дополнительно поддерживается legacy-список moderator VK IDs.