pearl-honest

byБогдан Каюмов

А видио создать можешь ?

No preview

Comments (0)

No comments yet. Be the first!

System Requirements

System Requirements Document for Видио

1. Introduction

Видио — это личное приложение ИИ-ассистента для владельца ПК. Ассистент полностью слышит пользователя, видит экран его компьютера, помогает в работе и действует на ПК через свой собственный курсор и свою собственную клавиатуру, не перехватывая мышь и клавиатуру пользователя. Приложение полностью бесплатное, включая умную ИИ-модель; модель не устанавливается на ПК, а работает через локальный или аналогичный внешний запуск, чтобы не нагружать компьютер. Ассистент может самостоятельно учиться, когда пользователь даёт на это разрешение, может управлять человечком в игре и выполнять там действия, а также имеет гибкие настройки, где пользователь может многое включить, выключить, настроить и посмотреть.

Аудитория — один владелец ПК (Богдан Каюмов), который хочет необычного, прикольного и многофункционального помощника, а не корпоративный инструмент. Тон продукта — оптимистичная игра, а не техническая сдержанность.

Page 1 of 21

2. System Overview

Видио поставляется как веб-приложение с общим бэкендом FastAPI, базой данных MariaDB для данных приложения, фронтендом на React и шлюзом LiteLLM для вызовов моделей (с отдельной базой PostgreSQL для LiteLLM). Ассистент работает как фоновая автоматизация: он слушает пользователя, видит экран, действует своим курсором и своей клавиатурой, учится при выданном разрешении и управляет человечком в игре.

Активные люди-акторы: Владелец ПК (пользователь ассистента) — единственная персона. Внешние и системные акторы: внешний запуск ИИ-модели (через LiteLLM), процесс фоновой автоматизации ассистента, игровой процесс, экран и аудиоустройства ПК.

Текущая поставка включает публичную главную страницу, страницу входа, рабочую страницу ассистента, страницу игры, страницу обучения и страницу настроек. Защищённые страницы (Ассистент, Игра, Обучение, Настройки) требуют входа; Главная и Вход доступны без входа.

Removed from scope

  • Ничего не удалено: все требования исходного потока сохранены.
Page 2 of 21

2a. Product Interpretation and Delivery Boundary

Видио — это персональный агент, который живёт рядом с рабочим столом пользователя и действует от своего имени. Ключевая граница продукта: ассистент не управляет курсором и клавиатурой пользователя. Он ведёт свой курсор (с розовым следом и лаймовым кольцом) и свою клавиатуру, поэтому пользователь и ассистент могут работать одновременно, не мешая друг другу.

ИИ-модель не устанавливается на ПК. Она запускается через локальный или аналогичный внешний запуск (через шлюз LiteLLM), чтобы нагрузка на компьютер не шла. Приложение полностью бесплатное, включая модель.

Идентичность принадлежит приложению: пользователь создаёт учётную запись на странице входа и подтверждает вход, чтобы вернуться к своим настройкам, разрешениям и истории обучения. Публичная Главная объясняет продукт и ведёт ко входу. Всё, что требует личного состояния (разговоры с ассистентом, разрешения на обучение, настройки, игровые команды), находится за входом.

Фоновая автоматизация — принятая часть поставки: ассистент слушает, видит экран и действует, пока пользователь работает. Обучение происходит только при явно выданном разрешении и может быть отозвано.

2b. Source Content Inventory

Не применимо: директивы-источника с content_source нет.

2c. Page Content and Component Coverage

Page 3 of 21

Главная

  • Информация/состояние: публичная страница без входа. Полноэкранная сливовая сцена (#12060F), крупный глянцевый розовый 3D-блоб справа от центра с живым курсором агента (розовый курсор с лаймовым кольцом), огромный заголовок Unbounded в три строки слева, лаймовая CTA-капсула под заголовком, тонкая лаймовая строка статуса агента.
  • Заголовок: «Твой ИИ. Свой курсор. Полная свобода.»
  • Подзаголовок: «Видио слышит тебя, видит экран и работает отдельно от твоей мыши и клавиатуры.»
  • Основное действие: CTA «Открыть Видио» — ведёт на страницу Входа (или в Ассистент, если пользователь уже вошёл).
  • Вспомогательные действия: переход ко Входу; прокрутка к секциям-сценам с описанием возможностей (слух, зрение экрана, свой курсор и клавиатура, обучение по разрешению, игра, настройки, бесплатность и внешний запуск модели).
  • Доменные сущности: нет пользовательских данных; только презентационный контент.
  • Ответственность компонентов: hero-сцена с блобом и курсором агента; строка статуса агента; секции-сцены с блоб-кривыми краями; CTA-капсула.
  • Состояния: загрузка — статичная сцена с блобом и заголовком; пустое — не применимо; успех — переход по CTA; ошибка — если переход не удался, CTA остаётся доступной и показывает сообщение о повторе; восстановление — повторное нажатие CTA.
Page 4 of 21

Вход

  • Информация/состояние: страница без входа, где пользователь создаёт учётную запись и подтверждает вход. Поля: имя/почта, пароль. Показывает, что вход нужен для возврата к настройкам и разрешениям ассистента.
  • Основные действия: создать учётную запись; войти; после успеха — переход в Ассистент.
  • Вспомогательные действия: переключение между созданием учётной записи и входом; возврат на Главную.
  • Доменные сущности: учётная запись пользователя (идентификатор, учётные данные), сессия.
  • Ответственность компонентов: форма учётных данных; переключатель режима; сообщения об ошибках; индикатор загрузки.
  • Состояния: загрузка — блокировка кнопки с индикатором; пустое — пустые поля с подсказками; успех — переход в Ассистент; ошибка — неверные данные или занятое имя, сообщение и сохранение введённого; восстановление — исправление и повторная отправка.
Page 5 of 21

Ассистент

  • Информация/состояние: защищённая страница (вход). Показывает живое состояние ассистента (лаймовая строка статуса), что он слышит пользователя, что он видит экран ПК, и что он действует своим курсором и своей клавиатурой. Отображает историю разговора и действий.
  • Основные действия: говорить с ассистентом (голосовой ввод); дать команду, которую ассистент выполняет на ПК своим курсором и клавиатурой; наблюдать, как ассистент видит экран и помогает.
  • Вспомогательные действия: остановить действие ассистента; посмотреть, что ассистент видит на экране; перейти к Настройкам, Обучению, Игре.
  • Доменные сущности: сессия разговора, реплики, команды, действия ассистента, снимки экрана (для зрения).
  • Ответственность компонентов: панель состояния агента; голосовой ввод; лента разговора; панель действий; индикатор собственного курсора/клавиатуры.
  • Состояния: загрузка — скелетон ленты и статус «слушаю»; пустое — приглашение сказать первую команду; успех — действие выполнено, статус и запись в ленте; ошибка — ассистент не расслышал или действие не удалось, сообщение и предложение повторить; восстановление — повтор команды или ручной ввод.
Page 6 of 21

Игра

  • Информация/состояние: защищённая страница (вход). Показывает, что ассистент управляет человечком в игре и выполняет там действия.
  • Основные действия: дать команду ассистенту управлять человечком в игре; запустить/остановить игровое управление.
  • Вспомогательные действия: посмотреть журнал игровых действий; вернуться в Ассистент.
  • Доменные сущности: игровая сессия, команды, действия человечка, журнал.
  • Ответственность компонентов: панель игрового управления; журнал действий; индикатор состояния.
  • Состояния: загрузка — статус подключения к игре; пустое — приглашение дать первую игровую команду; успех — действие выполнено, запись в журнале; ошибка — игра недоступна или команда не выполнена, сообщение и повтор; восстановление — повторная команда или остановка.
Page 7 of 21

Обучение

  • Информация/состояние: защищённая страница (вход). Показывает, учится ли ассистент сам, и позволяет дать или отозвать разрешение на самостоятельное обучение.
  • Основные действия: дать разрешение на обучение; отозвать разрешение; посмотреть, чему ассистент научился.
  • Вспомогательные действия: перейти к Настройкам.
  • Доменные сущности: разрешение на обучение (состояние, время), записи об обучении.
  • Ответственность компонентов: капсула-переключатель разрешения; лента обучения; статус.
  • Состояния: загрузка — статус разрешения; пустое — «обучение ещё не начиналось»; успех — разрешение выдано/отозвано, статус обновлён; ошибка — не удалось сохранить разрешение, сообщение и повтор; восстановление — повторное переключение.
Page 8 of 21

Настройки

  • Информация/состояние: защищённая страница (вход). Гибкие настройки: пользователь может многое включить, выключить, настроить и посмотреть. Каждая строка — широкая глянцевая капсула с лаймовым переключателем справа.
  • Основные действия: включать/выключать функции (слух, зрение экрана, собственный курсор, собственная клавиатура, обучение, игровое управление); настраивать параметры; просматривать текущие параметры ассистента.
  • Вспомогательные действия: сброс к значениям по умолчанию; возврат в Ассистент.
  • Доменные сущности: настройки пользователя (флаги, параметры), параметры ассистента.
  • Ответственность компонентов: строки-капсулы с переключателями; поля параметров; панель просмотра; кнопка сброса.
  • Состояния: загрузка — скелетон строк; пустое — не применимо (настройки всегда есть); успех — изменение сохранено, переключатель обновлён; ошибка — не удалось сохранить, сообщение и откат; восстановление — повторное изменение.
Page 9 of 21

3. Functional Requirements

FR-1. Управление ПК. As a Владелец ПК, I should дать ассистенту задачу, чтобы он управлял ПК полностью и помогал мне. Provenance: explicit. Триггер: голосовая или текстовая команда на странице Ассистент. Результат: ассистент выполняет действие на ПК и показывает наблюдаемый результат в ленте. Отказ/восстановление: если действие не удалось, показывается сообщение и предложение повторить. Продолжение: пользователь даёт следующую команду.

FR-2. Слух. As a Владелец ПК, I should говорить с ассистентом, чтобы он полностью слышал меня. Provenance: explicit. Триггер: голосовой ввод. Результат: распознанная реплика появляется в ленте, статус показывает «слушаю». Отказ: не расслышал — сообщение и повтор. Продолжение: разговор продолжается.

FR-3. Зрение экрана. As a Владелец ПК, I should чтобы ассистент видел мой экран ПК, чтобы он понимал контекст и помогал. Provenance: explicit. Триггер: включённое зрение экрана. Результат: ассистент учитывает экран в своих ответах и действиях; пользователь может посмотреть, что ассистент видит. Отказ: нет доступа к экрану — сообщение. Продолжение: помощь продолжается.

FR-4. Помощь. As a Владелец ПК, I should получать помощь от ассистента, чтобы решать задачи. Provenance: explicit. Результат: ответ или выполненное действие, видимое в ленте.

FR-5. Свой курсор. As a Владелец ПК, I should чтобы ассистент использовал свой отдельный курсор и не управлял моим, чтобы мы не мешали друг другу. Provenance: explicit (жёсткое ограничение). Результат: действия ассистента видны через его собственный курсор; курсор пользователя не двигается ассистентом.

Page 10 of 21

FR-6. Своя клавиатура. As a Владелец ПК, I should чтобы ассистент использовал свою клавиатуру и не управлял моей, чтобы мой ввод оставался моим. Provenance: explicit (жёсткое ограничение). Результат: ввод ассистента отделён от ввода пользователя.

FR-7. Необычный и прикольный вид. As a Владелец ПК, I should видеть необычный, прикольный и многофункциональный интерфейс. Provenance: explicit. Результат: интерфейс следует визуальному направлению (сливовый фон, розовые глянцевые блоки, лаймовые состояния, Unbounded/Quicksand).

FR-8. Полностью бесплатно. As a Владелец ПК, I should пользоваться приложением и умной ИИ-моделью полностью бесплатно. Provenance: explicit (жёсткое ограничение). Результат: нет платных шагов или оплаты в любом потоке.

FR-9. Внешний запуск модели. As a Владелец ПК, I should чтобы ИИ-модель не стояла на ПК, а работала через локальный или аналогичный внешний запуск, чтобы не нагружать ПК. Provenance: explicit (жёсткое ограничение). Результат: вызовы модели идут через внешний запуск (LiteLLM); на ПК модель не устанавливается.

FR-10. Самостоятельное обучение по разрешению. As a Владелец ПК, I should давать разрешение на самостоятельное обучение ассистента и отзывать его. Provenance: explicit (жёсткое ограничение: обучение только при разрешении). Триггер: переключатель на странице Обучение. Результат: статус разрешения и лента обучения обновляются. Отказ: не удалось сохранить — сообщение и повтор. Продолжение: обучение идёт только при выданном разрешении.

FR-11. Управление человечком в игре. As a Владелец ПК, I should чтобы ассистент управлял человечком в игре и выполнял там действия. Provenance: explicit. Триггер: игровая команда на странице Игра. Результат: действие человечка выполнено, запись в журнале. Отказ: игра недоступна — сообщение и повтор. Продолжение: следующая команда.

Page 11 of 21

FR-12. Гибкие настройки. As a Владелец ПК, I should включать, выключать, настраивать и просматривать множество параметров. Provenance: explicit. Триггер: изменение строки-капсулы. Результат: изменение сохранено и отражено. Отказ: не удалось сохранить — сообщение и откат. Продолжение: дальнейшая настройка.

FR-13. Создание учётной записи. As a Владелец ПК, I should создать учётную запись на странице Входа, чтобы вернуться к своим настройкам и разрешениям. Provenance: required_inference. Результат: учётная запись создана, вход выполнен, переход в Ассистент. Отказ: занятое имя или слабые данные — сообщение. Продолжение: работа в Ассистенте.

FR-14. Подтверждение входа. As a Владелец ПК, I should подтвердить вход, чтобы получить доступ к защищённым страницам. Provenance: required_inference. Результат: сессия установлена; защищённые страницы доступны. Отказ: неверные данные — сообщение. Продолжение: возврат к прерванной работе.

FR-15. Внешний запуск без установки. As a Владелец ПК, I should пользоваться внешним запуском модели без установки на ПК. Provenance: required_inference. Результат: модель доступна через шлюз; на ПК ничего не устанавливается.

4. User Personas

Page 12 of 21

Владелец ПК (пользователь ассистента)

  • Контекст продукта: Богдан Каюмов, владелец ПК в США, хочет личного ИИ-ассистента, который слышит его, видит экран ПК и помогает, действуя своим курсором и своей клавиатурой. Он ценит необычный, прикольный и многофункциональный инструмент и полностью бесплатное использование.
  • Главная цель: получить помощника, который управляет ПК полностью, не мешая его собственной мыши и клавиатуре, и не нагружает компьютер.
  • Отличительные обязанности: говорит с ассистентом и даёт команды; разрешает или запрещает самостоятельное обучение; даёт игровые команды и наблюдает за человечком; включает, выключает, настраивает и просматривает параметры; создаёт учётную запись и подтверждает вход, чтобы вернуться к своим настройкам и разрешениям.
  • Входы и решения: голосовые и текстовые команды; решение о разрешении на обучение; выбор параметров в настройках; игровые команды.
  • Взаимодействие с другими участниками: с ассистентом (фоновая автоматизация), с внешним запуском ИИ-модели (через LiteLLM), с игровым процессом.
  • Наблюдаемый успех: ассистент слышит, видит экран, помогает и действует своим курсором и клавиатурой; обучение идёт только при разрешении; человечек в игре управляется; настройки сохранены; всё бесплатно и без нагрузки на ПК.

5. Core User Flows

Page 13 of 21

Поток 1. Первый визит и создание учётной записи

  1. Пользователь открывает Главную без входа. Видит сливовую сцену, заголовок «Твой ИИ. Свой курсор. Полная свобода.», подзаголовок и CTA «Открыть Видио».
  2. Пользователь нажимает CTA и попадает на Вход.
  3. На Входе пользователь выбирает создание учётной записи, вводит имя/почту и пароль и отправляет форму.
  4. При успехе учётная запись создана и вход выполнен; пользователь попадает в Ассистент. При ошибке (занятое имя, слабые данные) показывается сообщение, введённое сохраняется, пользователь исправляет и повторяет.
  5. Продолжение: пользователь работает в Ассистенте.

Поток 2. Возвращение и подтверждение входа

  1. Пользователь открывает Вход и вводит учётные данные.
  2. При успехе сессия установлена, защищённые страницы доступны; пользователь возвращается к своим настройкам и разрешениям.
  3. При ошибке — сообщение и повтор.

Поток 3. Разговор с ассистентом и помощь

  1. Пользователь на странице Ассистент говорит команду; статус показывает «слушаю».
  2. Ассистент распознаёт реплику, видит экран ПК и отвечает или выполняет действие своим курсором и своей клавиатурой.
  3. Результат появляется в ленте; пользователь может посмотреть, что ассистент видит на экране.
  4. При неудаче — сообщение и предложение повторить; пользователь повторяет или вводит вручную.
  5. Продолжение: следующая команда.
Page 14 of 21

Поток 4. Управление ПК своим курсором и клавиатурой

  1. Пользователь даёт задачу на Ассистенте.
  2. Ассистент выполняет её на ПК через свой курсор и свою клавиатуру; курсор и клавиатура пользователя не затрагиваются.
  3. Пользователь наблюдает результат в ленте и продолжает работу параллельно.

Поток 5. Разрешение на самостоятельное обучение

  1. Пользователь открывает Обучение.
  2. Пользователь включает разрешение на самостоятельное обучение.
  3. Статус обновляется, обучение начинается; записи появляются в ленте обучения.
  4. Пользователь может отозвать разрешение; обучение прекращается.
  5. При ошибке сохранения — сообщение и повтор.

Поток 6. Управление человечком в игре

  1. Пользователь открывает Игру.
  2. Пользователь даёт команду ассистенту управлять человечком.
  3. Ассистент выполняет действие в игре; запись появляется в журнале.
  4. Пользователь может остановить игровое управление.
  5. При недоступности игры — сообщение и повтор.
Page 15 of 21

Поток 7. Гибкая настройка

  1. Пользователь открывает Настройки.
  2. Пользователь включает/выключает функции и настраивает параметры в строках-капсулах.
  3. Изменения сохраняются и отражаются; пользователь просматривает текущие параметры.
  4. При ошибке сохранения — сообщение и откат; пользователь повторяет.
Page 16 of 21

6. Visuals Colors and Theme

Направление: чувственный поп-минимализм, муза — Karim Rashid. Заголовок направления: «Sensual pop minimalism for a free personal AI assistant».

Токены (тёмный режим):

  • Фон: #12060F (глубокий сливовый, ~70% страницы).
  • Поверхность: #FF4FB0 (жевательная розовая, крупные глянцевые блоки и кнопки).
  • Текст: #FFF6FB (мягкий белый).
  • Основной: #FF4FB0.
  • Акцент: #C6FF3D (лайм — только живые состояния агента).
  • Приглушённый: #B98AA8.

Типографика: заголовки — Unbounded, тяжёлый вес, плотный трекинг, смешанный регистр; мелкие метки — Quicksand bold, капсом; тело — Quicksand. Модульная шкала 1.5: 128/88/56/32/20/16; мобильный заголовок 44px → десктоп 128px через clamp().

Форма: капсулы, блобы и глянцевые скруглённые блоки; радиусы от 24px до полной пилюли; жёсткие края только у следа курсора агента.

Раскладка: одна полноэкранная цветная сцена на секцию; асимметричный текст слева, глянцевый 3D-блоб справа; строки настроек — широкие капсулы с переключателем справа.

Изображения: глянцевые 3D-блобы, розовый курсор агента с лаймовым кольцом, мягкие градиентные рендеры; без стоковых фото людей.

Читаемость: заголовки, вордмарки, метки, числа, текст карточек и элементы управления остаются целиком внутри вьюпорта и контейнера на 375px, 768px и 1280px, переносясь или масштабируясь; декор может обрезаться, но не перекрывает читаемый текст и элементы управления.

Page 17 of 21

7. Signature Design Concept

Публичный вход — полноэкранная сливовая сцена (#12060F). Справа от центра — большой глянцевый розовый 3D-блоб, внутри которого живёт курсор агента: розовый курсор с лаймовым кольцом, который скользит по собственной петле, оставляя розовый след. Слева — огромный заголовок Unbounded в три строки («Твой ИИ. / Свой курсор. / Полная свобода.») от 44px до 128px. Под заголовком — лаймовая CTA-капсула «Открыть Видио». Тонкая лаймовая строка статуса агента читает состояние по словам. Края секций — мягкие блоб-кривые, никогда не прямые. Концепт перекомпоновывает только принятый контент и элементы управления.

8. Interaction Model & Motion Direction

Interaction Model: Animated Motion Tempo: expressive Hero Dimensionality: layered_2d

Landing Hero Motion Brief

  • Фокусный субъект: глянцевый розовый 3D-блоб с курсором агента (розовый курсор, лаймовое кольцо, розовый след).
  • Тезис вход→преобразование→результат: пользователь видит, как курсор агента скользит по своей петле над блобом (вход) → блоб жидко морфится, а строка статуса меняется по словам (преобразование) → CTA «Открыть Видио» ведёт ко Входу (результат).
  • Словарь движения: жидкие морфы блоба, мягкий отскок при нажатии кнопки, скольжение курсора агента по собственной траектории с розовым следом.
  • Скомпонованный первый кадр: сливовая сцена, блоб справа от центра, трёхстрочный заголовок слева, лаймовая CTA под ним, лаймовая строка статуса.
  • Состояние при reduced motion: морф останавливается, формы статичны, курсор агента неподвижен, весь текст и CTA остаются читаемыми и доступными.
Page 18 of 21

9. Non-Functional Requirements

  • Бесплатность: приложение и умная ИИ-модель полностью бесплатны; нет платных шагов. Provenance: explicit.
  • Разгрузка ПК: ИИ-модель не устанавливается на ПК и работает через локальный или аналогичный внешний запуск (LiteLLM), чтобы нагрузка на ПК не шла. Provenance: explicit.
  • Разделение ввода: ассистент не управляет курсором и клавиатурой пользователя; он использует свои. Provenance: explicit.
  • Обучение только по разрешению: самостоятельное обучение возможно только при выданном пользователем разрешении и прекращается при отзыве. Provenance: explicit.
  • Доступность: защищённые страницы требуют входа; Главная и Вход доступны без входа. Provenance: required_inference.
  • Читаемость: текст и элементы управления остаются целиком внутри вьюпорта и контейнера на 375px, 768px и 1280px. Provenance: explicit (design constraints).
  • Доступность движения: при prefers-reduced-motion предоставляется рабочая статичная компоновка. Provenance: explicit (design constraints).

10. Tech Stack

  • Frontend: React.
  • Backend: общий процесс FastAPI для API приложения и доменных модулей.
  • Хранилище приложения: MariaDB для данных приложения (учётные записи, настройки, разрешения, история).
  • Шлюз моделей: LiteLLM для вызовов провайдеров моделей из бэкенда.
  • База шлюза: PostgreSQL для LiteLLM, отдельно от хранилища приложения.
  • Развёртывание: docker-compose с сервисами backend, database (MariaDB), frontend, litellm, postgres.
Page 19 of 21

11. Assumptions and Constraints

  • A-1. Единственная активная персона — Владелец ПК; других людей-акторов нет. Provenance: planning scope.
  • A-2. Идентичность принадлежит приложению: учётная запись создаётся на странице Входа; защищённые страницы требуют входа. Provenance: required_inference.
  • A-3. Внешний запуск модели реализуется через LiteLLM; на ПК модель не устанавливается. Provenance: explicit + scaffold.
  • A-4. Фоновая автоматизация (слух, зрение экрана, действия) — принятая часть поставки. Provenance: planning scope.
  • A-5. Игровое управление относится к человечку в игре; конкретная игра не задана источником. Provenance: explicit (без указания игры).
  • A-6. Визуальные токены и шрифты заданы направлением; иных брендовых ограничений нет. Provenance: creative direction.
Page 20 of 21

12. Glossary

  • Видио — название приложения личного ИИ-ассистента.
  • Ассистент — ИИ-агент, который слышит пользователя, видит экран, помогает и действует на ПК.
  • Свой курсор — отдельный курсор ассистента (розовый с лаймовым кольцом), не курсор пользователя.
  • Своя клавиатура — отдельный ввод ассистента, не клавиатура пользователя.
  • Внешний запуск — работа ИИ-модели вне ПК через локальный или аналогичный запуск (LiteLLM).
  • Разрешение на обучение — явное согласие пользователя на самостоятельное обучение ассистента.
  • Человечек — управляемый персонаж в игре.
  • LiteLLM — шлюз вызовов моделей.
  • MariaDB — хранилище данных приложения.
  • PostgreSQL — база данных шлюза LiteLLM.
Page 21 of 21

No completed page designs yet.

Completed design pages will appear here when they are ready to preview.

Rendering diagram...

No completed page designs yet.

Completed design pages will appear here when they are ready to preview.

Rendering diagram...