# Руководство пользователя VoIdeaAI

## Начало работы

1. **Регистрация** — создайте аккаунт с email и паролем
2. **Вход** — войдите в систему, используя email/пароль или OAuth (Яндекс, Google, Apple)
3. **Создание идеи** — нажмите «Новая идея» или используйте голосовой ввод
4. **Анализ** — запустите анализ идеи через ролевых агентов

## Голосовой ассистент

- **Голосовой ввод**: нажмите на иконку микрофона и говорите
- **Текстовый ввод**: напишите сообщение в поле ввода
- **Голосовые команды**: настройте быстрые команды в разделе «Команды»

## Управление идеями

На главной странице отображаются все ваши идеи. Доступные действия:
- Просмотр деталей идеи
- Редактирование
- Удаление
- Запуск анализа агентами
- Просмотр истории анализа

## Агенты

13 ролевых агентов анализируют идеи с разных перспектив:
- Маркетолог, Финансист, Юрист, Технический директор, HR и другие
- Каждый агент возвращает структурированный отчёт
- Результаты доступны в виде таблицы и в формате JSON

## PWA (установка на телефон)

VoIdea работает как Progressive Web App:

1. **Android**: откройте сайт в Chrome → «Установить приложение» → иконка на рабочем столе
2. **iOS**: откройте сайт в Safari → «Поделиться» → «На экран «Домой»»
3. После установки работает офлайн (базовая версия)
4. Занимает < 5 MB на устройстве

## Telegram бот

VoIdeaAI имеет Telegram бота для быстрого создания идей:

1. **Найдите бота**: в поиске Telegram найдите `@VoIdeaAIBot`
2. **Привяжите аккаунт**: отправьте команду `/link` и перейдите по ссылке
3. **Создавайте идеи**: `/idea Ваша идея` — идея появится в дашборде
4. **Помощь**: `/help` — список всех команд

Доступные команды:
- `/start` — приветствие
- `/link` — привязать Telegram к аккаунту VoIdea
- `/idea <текст>` — создать новую идею
- `/help` — справка

## Воронка идей (Idea Funnel)

Отслеживайте прогресс идей по воронке:

1. **Сырая (raw)** — только что созданная идея
2. **Подтверждённая (validated)** — идея прошла первичную оценку
3. **Бэклог (backlog)** — запланирована к реализации
4. **В работе (in_progress)** — активная работа
5. **Запущена (launched)** — реализована
6. **Ретроспектива (retrospective)** — анализ результатов

Переключайтесь между **Списком** и **Канбан-доской** на дашборде. Перемещайте идеи по воронке кнопками ← → в карточках канбана или через API.

## Рабочие пространства (Workspaces)

Личное рабочее пространство создаётся автоматически при регистрации. Командные пространства доступны по тарифу:

- **Personal** — 1 на пользователя, всегда бесплатно
- **Team** — создаются владельцем, участники добавляются по email
- Переключайтесь между пространствами через выпадающий список в шапке
- Управляйте участниками в настройках пространства

## Совместная работа (Collaboration)

На странице идеи доступны:

- **Голосование** — 👍/👎 оценивайте идеи
- **Комментарии** — threaded обсуждения с ответами
- **Активность** — лента изменений и действий
- **Уведомления** — колокольчик в шапке, отметки о прочитанном

## Интеграция с календарём

Добавляйте идеи в календарь одним нажатием кнопки «+ Календарь» на странице идеи:

- **Google Calendar** — через OAuth (требуется scope calendar.events)
- **Yandex Календарь** — через OAuth (требуется scope calendar:event.write)
- **Apple Calendar (CalDAV)** — в разработке

Подключите календарь в Настройки → Интеграции → Календарь.

## Настройки

В разделе «Настройки» доступно:
- Профиль (имя, email, аватар)
- Безопасность (смена пароля, OAuth привязка)
- Голос (настройки микрофона, TTS)
- Тема (светлая/тёмная)
- Интеграции (Яндекс.Диск, Календарь)
- Тариф (информация о подписке)