**bizneshelper.ru** — веб-проект в сфере бизнес-консалтинга и управленческой экспертизы.

## Назначение проекта

Сайт представляет направления профессиональной помощи бизнесу, публикует экспертные материалы и служит публичной точкой входа для знакомства с подходами, компетенциями и опытом команды.

## Тематика

В публичной части проекта представлены материалы, связанные с:

* управленческим и стратегическим консалтингом;
* развитием продаж и маркетинга;
* производственным и антикризисным управлением;
* бизнес-процессами и организационными изменениями;
* кадровыми, юридическими, внешнеэкономическими и другими прикладными направлениями;
* практическими кейсами и экспертными публикациями.

## Аудитория

Проект ориентирован на владельцев, руководителей и специалистов действующих компаний, которым требуется внешняя экспертиза в вопросах управления, развития и повышения эффективности бизнеса.

## Роль сайта

Сайт одновременно выполняет несколько функций:

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

## Принцип ведения проекта

В карточке проекта и связанных публичных сущностях фиксируется только открытая информация. Внутренние договорённости, финансовые показатели, доступы, персональные данные, сведения о клиентах и другая чувствительная информация не публикуются.

## Связанные сущности

* [bizneshelper.ru — модернизация и миграция на haih-cms](/concepts/bizneshelper-ru-modernizatsiya-i-migratsiya-na-haih-cms) — архитектура и текущая модернизация сайта.
* [Унифицированные данные как основа AI-driven проектов — кейс VietnamGuru и BiznesHelper](/concepts/unifitsirovannye-dannye-kak-osnova-ai-driven-proektov-vietnamguru-i-bizneshelper) — практический кейс о переходе от legacy-схем к универсальной Concept-модели и AI-driven управлению контентом.
* [Рост производительности специалистов требует развития технологической среды бизнеса](https://futurist.expert/concepts/rost-proizvoditelnosti-specialistov-trebuet-razvitiya-tehnologicheskoy-sredy-biznesa) — более общий контекст о том, почему рост возможностей специалистов и AI требует соответствующего развития среды.

Текущие работы ведутся через задачи проекта; отдельные технические инициативы не определяют содержание самого проекта.

bizneshelper.ru — сайт о бизнес-консалтинге, управлении и развитии организаций.

bizneshelper.ru

# Цель

Определить минимально необходимый объём legacy-данных и функциональности, который нужно перенести в новую реализацию. Полный reverse engineering старого Rails-приложения не требуется: оно остаётся резервным источником и эталоном для сверки.

## Что сделать

- Выделить реальные сущности данных, которые присутствуют в БД и используются публичной частью сайта.
- Сопоставить модели, таблицы и поля с типами публичного контента: услуги, статьи, новости, кейсы, сотрудники, страницы и другие фактически используемые сущности.
- Проверить структуру медиа и связи файлов с записями БД.
- Зафиксировать актуальные формы и пользовательские сценарии, которые имеют смысл реализовать заново.
- Отдельно получить список реально индексируемых и значимых публичных URL, не пытаясь сохранять весь исторический набор маршрутов.
- Использовать локально запущенный Ruby-сайт как reference для проверки фактического поведения и содержания.
- Не тратить время на восстановление или документирование неиспользуемой legacy-логики, если она не влияет на перенос данных или публичное поведение.

## Результат

Составлен практический перечень сущностей, данных, медиа и пользовательских сценариев, которые необходимо перенести или реализовать в haih-cms.

## Критерии готовности

- Понятно, какие таблицы и сущности являются источником данных для миграции.
- Выделены публичные типы контента и их поля.
- Понятно, какие файлы и изображения действительно используются.
- Зафиксированы актуальные формы и ключевые сценарии.
- Определена выборка значимых URL для SEO-переезда.
- Не осталось критических неизвестных, блокирующих проектирование новой модели данных и импорт.

Инвентаризировать только те данные, сущности и публичные сценарии legacy-сайта, которые реально нужны для переноса на haih-cms.

Инвентаризация текущего Ruby-сайта

# Цель

Получить рабочую локальную копию исходного Ruby-сайта, чтобы можно было безопасно изучать текущую реализацию, сравнивать поведение до и после миграции и разрабатывать перенос на haih-cms без зависимости от production-среды.

## Что сделать

- Получить исходный код legacy Ruby-проекта из доступного рабочего источника.
- Определить используемую версию Ruby, Bundler и ключевые зависимости проекта.
- Установить необходимые локальные зависимости и добиться успешной установки bundle.
- Определить требования к базе данных, файловому хранилищу и другим локальным сервисам.
- Подготовить локальную конфигурацию приложения без переноса production-секретов в открытые файлы или задачи.
- При необходимости подготовить безопасный локальный набор данных или другой способ воспроизвести основные публичные сценарии сайта.
- Запустить приложение локально и проверить загрузку главной страницы, ключевых разделов, типовых страниц и основных публичных сценариев.
- Зафиксировать особенности запуска, несовместимости старых зависимостей и технические блокеры, которые могут влиять на миграцию.
- Подготовить краткую воспроизводимую инструкцию локального запуска для дальнейшей работы с проектом.

## Результат

Исходный Ruby-сайт запускается локально в воспроизводимом окружении и может использоваться как эталон при миграции на haih-cms.

## Критерии готовности

- Проект устанавливается и стартует локально.
- Определены версии Ruby и основных зависимостей.
- Основные публичные страницы открываются.
- Известны необходимые локальные сервисы и зависимости.
- Есть понятная инструкция повторного запуска.
- Все обнаруженные технические ограничения, способные повлиять на миграцию, зафиксированы.

## Ограничения

Не публиковать пароли, токены, ключи, production-конфигурацию, закрытые дампы баз данных, персональные данные и иные чувствительные сведения. Если для локального запуска нужны такие данные, конкретные значения обсуждаются и передаются только вне открытой карточки задачи.

Локальная копия исходного Ruby-сайта поднята и используется как резервная эталонная среда для сверки при миграции.

Локально развернуть исходный Ruby-сайт

# Контекст

В ядре `react-markdown` и `@mdxeditor/editor` по-разному интерпретируют часть Markdown, особенно whitespace/indentation. Из-за этого корректный после MDXEditor контент с HTML может при SSR-чтении превращаться в code block.

## Что сделать

- Временно добавить локальный Markdown-компонент/normalization layer для BiznesHelper по аналогии с решением, уже использованным на VietnamGuru.
- Исправить сценарии с четырьмя пробелами и табуляцией, не ломая реальные code blocks.
- Не переносить это решение в ядро до завершения отдельной R&D-задачи haih-agent.
- После появления платформенного решения заменить локальный компонент общим.

## Результат

Импортированный и AI-обновляемый Markdown корректно рендерится на BiznesHelper через SSR без ложного превращения HTML/контента в листинг кода.

До переработки Markdown в ядре haih-agent добавить в BiznesHelper локальный renderer, совместимый с фактическим Markdown, который сохраняет MDXEditor.

Задачи

Добавить локальный Markdown compatibility-компонент

Локально развернуть исходный Ruby-сайт

Инвентаризация текущего Ruby-сайта