Документация
Полное руководство по работе с Mini Maximum
Содержание
1. Что это
Mini Maximum — это no-code конструктор для создания мини-приложений внутри мессенджера MAX. Вы собираете проект из визуальных экранов, настраиваете сценарии поведения, подключаете данные и AI — всё в одной системе без необходимости писать код.
Ключевые факты:
- Без кода — весь интерфейс и логика собираются в визуальном конструкторе
- Контроль версий — как в Git: история изменений, откаты, ветвление проектов
- Безопасные симуляции — тестирование изменений перед публикацией без рисков
- AI с контролем — автоматизация действий только с вашим подтверждением
- Интеграции — возможность подключения внешних сервисов и кастомных решений
2. Быстрый старт
- Зарегистрируйтесь в Mini Maximum и создайте новый проект
- Опишите идею вашего проекта — система предложит базовую структуру
- Добавьте экраны: главная, каталог, профиль — используйте готовые шаблоны или создайте с нуля
- Настройте сценарии: опишите логику переходов между экранами и взаимодействия с пользователем
- Подключите данные: создайте коллекции для хранения информации (товары, пользователи, заказы)
- Запустите симуляцию: протестируйте весь flow приложения в безопасной среде
- Исправьте ошибки, если они есть, и запустите повторную симуляцию
- Опубликуйте проект — ваше приложение становится доступным пользователям MAX
3. Термины и определения
Проект
Полное мини-приложение со всеми экранами, сценариями, данными и настройками. Один проект = одно приложение в MAX.
Экраны
Визуальные страницы вашего приложения. Каждый экран содержит элементы интерфейса: кнопки, текст, изображения, формы.
Сценарии
Логика поведения приложения: что происходит при нажатии кнопки, как обрабатываются формы, условия переходов между экранами.
Данные (коллекции)
Структурированное хранилище информации: товары, пользователи, заказы. Работает как таблица базы данных.
Версии
Снимки состояния проекта в определённый момент времени. Позволяют откатиться к любой предыдущей версии.
Симуляции
Безопасный режим проверки изменений перед публикацией. Вы видите, как работает приложение, но пользователи этого не видят.
Публикация
Развертывание проекта для реальных пользователей MAX. После публикации приложение становится доступным.
4. Версии и откаты
Система версий работает как Git — каждое изменение фиксируется и может быть отменено.
История изменений
Каждое сохранение создаёт новую версию. Вы видите: кто, когда и что изменил.
Откат за секунды
Нашли баг после обновления? Вернитесь к предыдущей версии в один клик без потери данных.
Ветвление проектов
Создавайте параллельные версии для тестирования новых функций без влияния на основную ветку.
Сравнение версий
Просматривайте изменения между версиями: что добавилось, что удалилось, что изменилось.
5. Симуляции
Режим безопасного тестирования перед публикацией изменений.
Чеклист перед публикацией:
- Запустите симуляцию перед каждой публикацией
- Проверьте все основные сценарии: регистрация, оформление заказа, навигация
- Проверьте экраны на всех девайсах (мобильный/десктоп)
- Убедитесь, что формы работают корректно и отправляют данные
- Протестируйте граничные случаи: пустые поля, неверные форматы данных
- Проверьте интеграции с внешними сервисами (если подключены)
- Убедитесь, что AI-действия срабатывают правильно и требуют подтверждения
- Исправьте найденные ошибки и запустите симуляцию заново
6. AI и ручная проверка
✓ Что делает AI
- Предлагает структуру проекта на основе вашего описания
- Генерирует базовые экраны и сценарии для типовых задач
- Автоматически заполняет данные для демонстрации
- Предлагает оптимизации и улучшения интерфейса
- Помогает с интеграциями: подсказывает API и настройки
✗ Что AI НЕ делает
- Не публикует изменения без вашего подтверждения
- Не удаляет данные без явного разрешения
- Не изменяет критичные настройки безопасности автоматически
- Не отправляет запросы к платным API без подтверждения
- Не принимает финальные решения — только предлагает варианты
⚠️ Где требуется ручное подтверждение
- Публикация изменений в продакшен
- Удаление коллекций данных или экранов
- Изменение платёжных настроек и интеграций
- Массовые операции с данными пользователей
- Изменение прав доступа и безопасности
- Отправка уведомлений пользователям приложения
7. Частые ошибки и решения
❌ Экран не отображается после публикации
✓ Решение: Проверьте, что экран добавлен в навигацию и имеет правильный URL. Убедитесь, что нет условий скрытия.
❌ Форма не отправляет данные
✓ Решение: Проверьте привязку полей к коллекции данных. Убедитесь, что все обязательные поля заполнены и сценарий отправки настроен.
❌ Сценарий не срабатывает
✓ Решение: Проверьте условия срабатывания. Убедитесь, что триггер (кнопка/событие) правильно связан со сценарием.
❌ Данные не сохраняются
✓ Решение: Проверьте права доступа к коллекции. Убедитесь, что структура данных соответствует схеме коллекции.
❌ Интеграция не работает
✓ Решение: Проверьте API-ключи и URL эндпоинтов. Убедитесь, что внешний сервис доступен и правильно настроен.
❌ Симуляция зависает
✓ Решение: Проверьте сценарии на бесконечные циклы. Упростите логику и попробуйте симуляцию отдельных частей.
8. Поддержка и контакты
Если вы не нашли ответ в документации, свяжитесь с нами:
Канал поддержки в MAX
Быстрые ответы на вопросы от команды и сообщества
Email поддержка
Детальные консультации и помощь с интеграциями
Сборка под ключ
Полная разработка и запуск приложения нашей командой
