Anketa — краткая документация

Типы вопросов

Общие поля: id, type, title (текст вопроса), description (пояснение), required (обязательность), timer (задержка кнопки «Далее»), правила переходов и видимости.

Прохождение анкеты (test vs боевой режим)

В тестовом режиме (?test=1) анкета работает как предпросмотр: ответы не сохраняются в базе. В боевом режиме (без test=1) создаётся сессия и каждый ответ сохраняется на сервере.

• Открытие/резюм: POST /session/open (по cookie device_id).
• Сохранение ответа: POST /session/answer (после каждого “Далее”).
• Завершение: POST /sessions/<id>/end.

Подробно: /docs/runtime.md

Экспорт данных

Результаты можно выгружать в CSV, XLSX и SPSS. Поддерживается выбор статусов интервью и анонимизация IP/геоданных.

• Одиночный выбор - одно поле; множественный - бинарные столбцы по вариантам.
• Текст - строка; шкала - число; матрица - разбиение по строкам/столбцам.
• Ранжирование и распределение - понятные схемы кодирования, пригодные для анализа.

Подробно: /docs/export.md

Подстановки (piping)

В тексты, заголовки или описания можно подставлять ответы на предыдущие вопросы.

• @@QID — простой ответ.
• @@QID|N — N‑й выбранный вариант; для матрицы — N‑я отмеченная ячейка.
• @@QID|#VAL — текст опции со значением VAL.
• @@QID|#ROW#COL — значение конкретной ячейки в матрице.

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

Медиа (загрузка и библиотека)

Для вопросов info_block и heatmap можно использовать изображения (PNG/JPEG) и видео (минимум MP4, в целом video/*). В анкете рекомендуется хранить относительные пути вида /image/... и /video/....

• Загрузка: POST /__upload (только admin/superadmin).
• Библиотека: GET /media (доступна всем пользователям организации).
• Удаление: DELETE /media (только admin/superadmin).

Подробно: /docs/media_library.md

Logic (routing_rules / visibility_rules)

Раздел “Логика” управляет переходами (routing_rules, поле goto) и видимостью (visibility_rules, поля initial/action) на основе условия if (JSON-выражение).

{
  "id": "rr1",
  "priority": 1,
  "if": { "==": ["$q1", "A"] },
  "goto": "q5"
}

{
  "id": "vr1",
  "priority": 1,
  "initial": "VISIBLE",
  "action": "HIDE",
  "if": { "==": ["$q1", "no"] }
}

Быстрый старт (dev)

Для локальной разработки: backend запускается на 8000, frontend — на 3000. По умолчанию фронтенд ходит в API по пути /api (dev-прокси и прод-прокси настроены одинаково).

Подробно: /docs/quickstart.md

Настройки анкеты

• allow_back - разрешить возврат к предыдущим вопросам.
• allow_repeat — разрешить повторное прохождение.
• allow_resuming — продолжить опрос с того же места на том же устройстве.
• Квоты и таймеры также поддерживаются.

Вопросы и ответы