# VMax Hub

VMax — личный хаб с общими модулями: интеграциями и повторяющимися процессами.
Проекты подключаются к нему по HTTP API и не реализуют эти модули у себя заново.

## Как подключить проект

1. Владелец хаба создаёт ключ: `npm run vmax -- client:add <имя> --project <ключ-проекта> --modules plane,telegram`.
   Ключ показывается один раз.
2. В `.env` проекта:
   ```
   VMAX_HUB_URL=https://vmax.koltcov.com
   VMAX_HUB_KEY=vmx_...
   ```
3. В каждом запросе передаётся `Authorization: Bearer <VMAX_HUB_KEY>`.

## Что доступно

- `GET https://vmax.koltcov.com/v1/me` — кто я и какие у меня доступы
- `GET https://vmax.koltcov.com/v1/projects` — реестр проектов (сайт, счётчик Метрики, проект в Plane)
- `GET https://vmax.koltcov.com/v1/modules` — список модулей и ссылки на их инструкции
- `GET https://vmax.koltcov.com/v1/instructions/<module>` — инструкция модуля в markdown (её стоит давать ИИ-агенту проекта)

Модули:
- `plane` — задачи, страницы, заметки во «входящие», вебхуки событий Plane. Инструкция: `/v1/instructions/plane`
- `telegram` — уведомления владельцу через общего админ-бота, собственные команды и кнопки продукта. Инструкция: `/v1/instructions/telegram`
- `jobs` — мониторинг вакансий менеджера продукта (VK, Авито). Инструкция: `/v1/instructions/jobs`