SPEC.md

Актуально на: 2026-02-13

1. Цели

• Основная цель: Дать рабочее пространство для бизнес-плана, которое подстраивается под опыт пользователя и ведет к готовому плану.
• Второстепенные цели: Снизить время до первого полноценного плана, сделать AI-структурирование доверенным, сохранить контроль для профи.
• Пространство должно перестраиваться для профи и новичка, иметь возможность переключиться на полный вид заполнения всех схем и таблиц и/или оставлять минимум, который может быть заполнен прямо сейчас или был заполнен ранее.
• Метрики успеха: Доля заполненных базовых элементов проекта до возможности провести полноценные расчёты, показатели эффективности проекта, доля соблюдаемых величин (рекомендуемых значений).

2. Пользователи и режимы

• Персоны: Основатель без опыта планирования; опытный стратег/аналитик; продакт-менеджер, валидирующий идею, проверяющий инспектор, руководитель. рассматривающий альтернативные реализации проекта.
• Режимы (например, новичок/профи): Новичок (AI задает вопросы, структура раскрывается); Профи (полная структура, прямое редактирование), проверяющий (смотрит по отметкам, на которые система акцентировала внимание), руководитель (выставляет альтернативные значения, чтобы получить максимальную эффективность).
• Уровни доступа: Один пользователь на старте; позже роли просмотр/редактирование/инспекция/комментатор.

3. Основные сценарии

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

4. Экраны и структура

• Основные вкладки (по центру шапки): «Хаб проекта», «AI помощник», «Ключевые моменты», «Бизнес‑модель», «Бизнес план», «Презентация проекта».
• Навигация/IA: левый сайдбар удален; компактная верхняя панель со статусом и режимом (sticky), вкладки по центру шапки.
• Настройки оформления: кнопка‑шестеренка рядом со статусом открывает модальное окно с темой, фоном и акцентом; тема по умолчанию «Real Estate (глубокий)». Добавлены отступы по краям (проценты), раздельно слева/справа, min=1, max=20, default=8. Отступы не влияют на шапку.
• Подсветка при наведении (в настройках): Вкл — “тяжёлая” подсветка (фон/бордер через state там, где нужно); Выкл — облегчённый режим (без JS‑ховера, только CSS: смена цвета текста/иконок; для залитых акцентных кнопок допускается лёгкое затемнение).
• Важно: рабочая область всегда доходит до низа экрана; чат и ключевые моменты прокручиваются внутри блока.
• Чат: список сообщений имеет нижний отступ, чтобы композер не перекрывал последний блок.
• Бизнес‑модель: табличное заполнение по структуре PE; бургер‑ссылка на «Структура Бизнес‑плана» слева от заголовка в каждом разделе.
• Структура Бизнес-плана (PE) с пометками минимального БП:
  • Проект: Заголовок [МИНИМУМ], Список продуктов [МИНИМУМ], Настройка расчета [МИНИМУМ], остальное опционально.
  • Окружение: Налоги [МИНИМУМ]; Учетная ставка — не обязательна.
  • Инвестиционный план: Календарный план [МИНИМУМ]; Список активов [МИНИМУМ, опционально].
  • Операционный план: План сбыта [МИНИМУМ], План производства [МИНИМУМ], Материалы и комплектующие [МИНИМУМ], План по персоналу [МИНИМУМ], Общие издержки [МИНИМУМ].
  • Финансирование: Акционерный капитал [МИНИМУМ], Займы [МИНИМУМ], Инвестиции [МИНИМУМ].
  • Результаты: Кэш‑фло [МИНИМУМ].
  • Анализ проекта: Эффективность инвестиций [МИНИМУМ]; Финансовые показатели — не обязательны.
  • В UI пометки [МИНИМУМ] отображаются зелёной звёздочкой ★ с легендой в панели структуры.
  • Панель «Структура Бизнес-плана» раскрывается поверх формы внутри бизнес‑модели, с затемнением и блокировкой прокрутки формы.
  • Раздел «Настройка расчета» добавлен как обязательный минимум (бизнес‑модель).
• Проект → Заголовок: валюта выбирается из списка (RUB/USD/EUR/CNY/JPY) или «Другая валюта» (поля Название/Сокращение).
• Проект → Список продуктов: таблица с валютой; модальные окна Добавить/Редактировать; удаление с подтверждением.
• Инвестиционный план → Календарный план:
  • Таблица: уровни, вложенность до 10, сворачивание групп, добавление/редактирование/удаление, перемещение вверх/вниз, изменение ширины столбцов.
  • Диаграмма Ганта: фиксированная левая часть; колонки слева занимают «контент + 10%», остальное пространство — под полосы; масштаб (75–250%) и горизонтальная прокрутка; действия (вверх/вниз/редактировать/удалить). Настройки «Стили уровней» доступны только здесь.
  • Оплаты: «в начале», «в конце», «по графику»; график с датами и суммой/процентом, проверка дат в пределах этапа; быстрый просмотр/модалка графика оплат.
  • «Распределение»: периоды день/неделя/декада/месяц/квартал/год; общая сумма показана сверху; масштаб и стили уровней не отображаются.
  • «Матрица»: по вертикали этапы, по горизонтали периоды; суммы на пересечении + итоги по строкам/столбцам; первый столбец фиксирован при горизонтальной прокрутке, «Итого» выделен жирным; вертикальные линии отключены.
  • Названия этапа: короткое (обязательное) + полное (опционально). Если полное задано — показывается иконка, при наведении — подсказка с полным названием, по клику — модалка.
  • Все модальные окна/оверлеи закрываются по Esc.

5. Данные и сущности

• Сущность 1 (поля): Проект (id, name, mode, status, progress, createdAt).
• Сущность 2 (поля): Раздел (id, projectId, title, type, status).
• Связи: Проект имеет много Разделов; Раздел имеет много Строк таблицы; Заметки AI привязаны к Разделам.

6. UI/UX требования

• Визуальное направление: Спокойный редакционный стиль, теплый фон, четкая иерархия, AI‑блоки визуально отделены.
• Переиспользуемые компоненты: Карточки, переключатель режимов, список шагов, чат‑пузырьки, статусы, единый стиль теней/фонов у вкладок и статусных чипов.
• Состояния (loading/empty/error): Скелетоны для таблиц, пустые состояния с подсказками, ошибки с повтором.
• Доступность: Видимый фокус, контрастные статусы, ARIA для переключателей.

7. Контент и тексты

• Тональность: Уверенно, поддерживающе, кратко.
• Ключевые лейблы: Новичок, Профи, AI помощник, Ключевые моменты, Бизнес‑модель, Бизнес план, Презентация проекта, Вопрос от AI, Ответить.
• Локализация: Русский как основной, английский позже, китайский позже, индийский позже.

8. Ограничения

• Технологии: Next.js + React + Tailwind + Django(python) для back-а.
• Производительность: Быстрая первая загрузка, без тяжелых графиков на первом экране.
• Устройства: Desktop first, адаптация под мобильные.

9. Открытые вопросы

• В1: Переключение режимов не удаляет данные. Новичок -> Профи раскрывает всю структуру. Профи -> Новичок оставляет видимость, но продвинутые разделы становятся неактивными с подсказкой и переводом в guided-поток.
• В2: AI ссылается на встроенный список источников и помечает оценки. Пользователь может добавить свой источник (URL/файл/заметка), при отсутствии источника AI просит подтвердить.

10. История изменений

• YYYY-MM-DD: Создан
• TBD: Заполнен первый черновик (assistant)
• 2026-01-20: Обновлены экраны, навигация и настройки оформления
• 2026-01-20: Добавлен чат-композер, режим “Ключевые моменты” и фиксированная высота рабочего пространства
• 2026-01-26: Композер переработан (сворачивание, ручной режим, фиксированная панель поверх чата, компактная строка статуса)
• 2026-01-27: Уточнена структура минимального БП и её отображение (легенда ★).
• 2026-01-27: Бургер-кнопка «Структура Бизнес-плана» перенесена слева от заголовков разделов; заголовки выровнены по координатам.
• 2026-01-27: Панель «Структура Бизнес-плана» встроена внутрь классического режима, с затемнением и блокировкой прокрутки формы.
• 2026-01-27: [МИНИМУМ] заменен на зелёную звёздочку ★ и обновлена легенда.
• 2026-01-29: «Классический режим» переименован в «Бизнес‑модель», добавлены вкладки «Бизнес план» и «Презентация проекта».
• 2026-01-29: Удалена левая навигационная панель; вкладки перенесены в шапку, оформление унифицировано.
• 2026-01-29: Календарный план: таблица/Гант/распределение/матрица, иконки действий, масштабирование и горизонтальная прокрутка.
• 2026-01-29: Календарный план: короткое/полное название этапа, подсказки и модалки, просмотр графика оплат; закрытие оверлеев по Esc.
• 2026-01-29: Матрица распределения: исправлены стили последних столбцов; вертикальные линии отключены.
• 2026-02-13: Добавлена настройка «Главная вкладка», стабилизирована сортировка разделов (без «прыжков»), оптимизирован автосейв под нагрузку (см. CHANGELOG.md/PERFORMANCE.md).