Skip to content

minkinad/focusboard

FocusBoard

CI Deploy GitHub Pages React TypeScript Vite

FocusBoard — это локальный frontend-only продукт для поддержки принятия решений. Он помогает превратить расплывчатый вопрос в понятную структуру: краткую сводку, набор вариантов, компромиссы, риски, рекомендацию и финальное решение.

Проект задуман как спокойный, объяснимый и правдоподобный инструмент, а не как очередной "умный" интерфейс, который внезапно всё перестраивает за пользователя.

Что это за продукт

FocusBoard решает простую, но частую проблему: сложные решения редко начинаются с ясной формулировки. Обычно у пользователя есть:

  • слишком много контекста
  • несколько конкурирующих направлений
  • неочевидные критерии выбора
  • ощущение перегруза уже на старте

Обычные заметки не помогают удержать структуру, а многие "AI-first" интерфейсы либо слишком шумные, либо ведут себя непрозрачно. FocusBoard идёт в другую сторону:

  • держит интерфейс стабильным
  • помогает пользователю увидеть ход мысли
  • предлагает маленькие и обратимые подсказки
  • не пытается автоматизировать само решение

Цель продукта не в том, чтобы решить за человека. Цель в том, чтобы сделать его собственное решение более ясным, аргументированным и уверенным.

Продуктовая рамка

Для кого

FocusBoard хорошо подходит для сценариев, где нужно не просто записать мысли, а аккуратно пройти путь от вопроса к выбору:

  • продуктовые и стратегические решения
  • сравнение нескольких направлений развития
  • карьерные и профессиональные выборы
  • UX-ревью и оценка редизайна
  • разбор длинных AI-ответов перед финальной формулировкой

Основная ценность

Продукт даёт пользователю три вещи:

  1. Структуру: вопрос превращается в набор понятных секций и опорных артефактов.
  2. Спокойствие: интерфейс не дёргается и не ломает контекст в критичный момент.
  3. Объяснимость: любые адаптивные подсказки прозрачны и обратимы.

Позиционирование

FocusBoard можно описать как explainable decision-support workspace:

  • не менеджер задач
  • не чат
  • не дашборд ради дашборда
  • не opaque AI-автоматизация

Это рабочее пространство для вдумчивого решения, где адаптация помогает, но не перехватывает контроль.

Как устроен пользовательский опыт

1. Старт сессии

Пользователь начинает с брифа:

  • название решения
  • главный вопрос
  • приоритеты
  • ограничения
  • желаемый формат результата

Для быстрого старта есть несколько seeded-шаблонов с правдоподобными сценариями:

  • продуктовая стратегия
  • карьерное решение
  • UX-ревью
  • сравнение вариантов
  • открытое исследование

2. Основная рабочая область

Рабочее пространство разбито на три зоны:

  • слева — бриф и контекст
  • по центру — анализ: сводка, инсайты, варианты, компромиссы, риски, рекомендация, заметки
  • справа — панель решения, шорт-лист, обоснование и следующий шаг

Интерфейс намеренно остаётся предсказуемым. Пользователь всегда понимает:

  • где находится
  • на каком этапе находится решение
  • какой следующий осмысленный шаг

3. Лёгкая адаптация

FocusBoard не использует ML-модель, бэкенд или скрытую магию. Вместо этого продукт отслеживает несколько лёгких сигналов поведения:

  • всплески скролла
  • время внимания к секциям
  • повторные открытия блоков
  • действия сравнения
  • редактирование заметок
  • смену настроек макета

На основе этих сигналов система предлагает детерминированные подсказки:

  • закрепить инсайты
  • включить компактную плотность
  • открыть режим сравнения
  • свернуть второстепенные детали
  • подсветить критерии
  • зафиксировать компоновку
  • поднять рекомендацию выше
  • собрать итог по решению

Ключевой принцип: поведение влияет на рекомендации, а не на хаотическое автоперестроение интерфейса.

4. Финальное резюме

Когда решение собрано, пользователь переходит в итоговое представление, где видит:

  • краткий итог
  • финальное решение
  • обоснование
  • следующий шаг
  • историю подсказок
  • сохранённые предпочтения рабочего пространства
  • замеченные поведенческие паттерны

Это делает проект похожим не просто на UI-эксперимент, а на продукт с законченным пользовательским циклом.

Продуктовые принципы

  • Стабильность прежде всего. Интерфейс не должен неожиданно отнимать контроль.
  • Подсказки, а не сюрпризы. Адаптация предлагает действия, а не ломает раскладку.
  • Объяснимость. Каждая рекомендация должна быть понятна человеку без "чёрного ящика".
  • Обратимость. Пользователь может отменить применение подсказки.
  • Низкая когнитивная нагрузка. Система снимает сложность, а не добавляет её.
  • Достоверность. И UX, и тексты, и логика должны ощущаться как правдоподобный продукт.

Что важно с точки зрения реализации

Приложение построено на:

  • React
  • TypeScript
  • Vite
  • Tailwind CSS
  • Zustand
  • Framer Motion
  • Lucide Icons
  • Vitest

Структура кода организована по продуктовым срезам:

src/
  app/
    providers/
    store/
  entities/
    behavior/
    session/
    suggestion/
  features/
    decision-panel/
    preferences/
    session-start/
    suggestions/
    summary/
    workspace/
  shared/
    config/
    hooks/
    lib/
    types/
    ui/
  pages/

Ключевые технические решения:

  • typed domain-модели для сессии, артефактов решения, поведения и подсказок
  • локальное сохранение состояния через Zustand persist
  • детерминированный rules engine для адаптивных рекомендаций
  • undo-логика для применённых подсказок
  • seed-контент вместо пустых заглушек, чтобы продукт ощущался живым

Почему проект интересен

FocusBoard показывает не только "красивый интерфейс". Он демонстрирует связку из нескольких важных вещей:

  • продуктовое мышление и позиционирование
  • информационную архитектуру для сложных сценариев
  • объяснимый adaptive UI без хаоса
  • аккуратное моделирование состояния и поведения
  • локальный и автономный пользовательский опыт
  • кодовую структуру, которую удобно читать и развивать

Это делает проект хорошим кейсом на пересечении product thinking, UX systems и frontend architecture.

Локальная разработка

Установка зависимостей:

npm install

Запуск dev-сервера:

npm run dev

Сборка production-версии:

npm run build

Тесты:

npm test

CI:

  • workflow CI запускается на push в main/master и на каждый pull_request
  • pipeline проверяет npm ci, npm test и npm run build

Что можно развить дальше

  • более глубокое редактирование инсайтов, рисков и tradeoffs
  • настройка весов критериев решения
  • быстрые клавиатурные команды для опытных пользователей
  • разные product presets под типы решений

Статус проекта

Сейчас FocusBoard — это цельный frontend-only прототип с ясной продуктовой логикой, локальным состоянием, объяснимыми подсказками и завершённым пользовательским потоком от старта до финального резюме.

About

Explainable decision-support workspace for turning messy questions into structured, confident decisions.

Resources

License

Code of conduct

Contributing

Stars

Watchers

Forks

Contributors

Languages