🗺️ EdTech CJM Generator

Генератор Customer Journey Map для образовательных продуктов с интеграцией AI

Автор: Yury Mikhno

---

EdTech CJM Generator (edu_cjm_gen) — локальное веб-приложение для методистов, продакт-менеджеров и авторов EdTech-программ. Загрузите бриф и концепцию проекта, настройте структуру карты — и нейросеть синтезирует материалы, задаст уточняющие вопросы и соберёт интерактивную CJM в HTML, готовую к просмотру и передаче заказчику.

Работает через OpenRouter (Qwen и другие модели) или GigaChat API (Сбер).

---

✨ Ключевые возможности

• 📄 Загрузка документов — бриф, концепция и опционально дополнительные материалы. Форматы: xls, xlsx, doc, docx, txt, md.
• 🧩 Гибкая структура CJM — настраиваемые строки (действия ученика, наставника, артефакты, контакты…) и степень детализации столбцов (по модулям или по каждому занятию).
• 🤖 AI-анализ материалов — синтез документов, резюме программы и до 5 уточняющих вопросов по пробелам в данных.
• 🗺️ Готовая интерактивная карта — HTML-просмотрщик с цветовой кодировкой строк, группировкой столбцов по модулям/этапам, горизонтальной прокруткой и sticky-заголовками.
• 💾 Экспорт — открытие CJM в браузере или скачивание автономного .html файла.
• 🔒 Local-first — документы обрабатываются локально; на LLM уходит только синтезированный текст (не исходные файлы целиком).

_{Демонстрационная карта с упрощённым текстом — не реальный проект.}

---

🚀 Установка и запуск (Windows)

Для работы приложения необходим Python 3.10+.

1. Склонируйте репозиторий или скачайте архив релиза и распакуйте его.
2. Откройте папку проекта.
3. Запустите файл run_windows.bat двойным щелчком.

Скрипт полностью автоматизирован: проверит наличие Python, создаст виртуальное окружение, установит зависимости и откроет приложение в браузере.

Запуск вручную (Windows / macOS / Linux)

python -m venv .venv
# Windows:  .venv\Scripts\activate
# Unix:     source .venv/bin/activate
pip install -r requirements.txt
python run.py

Приложение будет доступно по адресу: http://127.0.0.1:5050

---

⚙️ Настройка AI

Ключи хранятся только в localStorage браузера на вашем компьютере — не на сервере и не в облаке.

OpenRouter (рекомендуется для старта)

1. Зарегистрируйтесь на openrouter.ai.
2. Создайте API-ключ в настройках ключей.
3. В приложении нажмите «Настройки ИИ» → выберите провайдер OpenRouter.
4. Вставьте ключ (sk-or-v1-...) и выберите модель, например:
   • qwen/qwen3.7-plus — быстрая и экономичная;
   • qwen/qwen3-235b-a22b-instruct-2507 — более мощная.
5. Нажмите Сохранить.

GigaChat API (Сбер)

1. Получите Authorization Key в GigaChat Studio (раздел API / ключи).
2. В «Настройки ИИ» выберите GigaChat.
3. Вставьте Authorization Key и выберите модель, например GigaChat-2-Pro.
4. Укажите scope тарифа (GIGACHAT_API_PERS для физлиц или корпоративный — по вашему договору).
5. Тарифы и лимиты: документация GigaChat.

💡 Совет: при ошибках JSON или пустых вопросах попробуйте GigaChat-2-Pro или модель Qwen через OpenRouter.

---

📖 Как пользоваться

Шаг 0 — Настройки ИИ

Нажмите «Настройки ИИ» в шапке → выберите провайдера, введите ключ и модель → Сохранить.

Шаг 1 — Загрузка документов

Файл	Обязательность	Содержание
Бриф проекта	✅ Да	Задачи, стейкхолдеры, целевая аудитория
Концепция проекта	✅ Да	Модули, уроки, MVP, структура программы
Дополнительные детали	➖ Нет	Всё важное, что не вошло в бриф и концепцию

Шаг 2 — Настройки CJM

• Строки CJM — какие ряды будут в таблице (действия ученика/наставника, мотивация, проблемы, артефакты, контакты). Можно добавлять, удалять и переименовывать.
• Столбцы CJM — опишите детализацию: «верхнеуровневая карта по 5 модулям» или «отдельный столбец на каждый из 22 занятий».

Нажмите «Анализировать и задать вопросы».

Шаг 3 — Уточняющие вопросы

ИИ покажет резюме программы и до 5 вопросов по неясным местам. Ответьте на них — так карта получится точнее.

Шаг 4 — Результат

Нажмите «Собрать CJM». Затем:

• Открыть CJM — интерактивный просмотрщик в браузере;
• Скачать HTML — автономный файл для отправки коллегам;
• Новая CJM — начать заново.

Сгенерированные файлы сохраняются локально в папке output/.

---

🔒 Безопасность

• Local-first: сервер работает только на 127.0.0.1; данные проекта не покидают ваш компьютер, кроме текстов, отправляемых в LLM для анализа и генерации.
• Ключи API хранятся в localStorage браузера, не в файлах проекта.
• Сессии — в памяти процесса; после перезапуска сервера незавершённая CJM сбрасывается (сохранённые HTML в output/ остаются).

---

🛠️ Требования

Компонент	Версия
Python	3.10+
Браузер	Chrome, Edge, Firefox (современный)
Интернет	Нужен для вызова LLM API

---

📄 Лицензия

Проект распространяется под лицензией MIT. Подробности — в файле LICENSE.

---

_{edu_cjm_gen © Yury Mikhno, 2026}