Questionnaires

LicenseStablePHPIssuesMerge Requests

Description

Questionnaires provides questionnaire definitions, question banks, answer dictionaries, and questionnaire takes for Laravel Enso.

The package exposes CRUD APIs for answers and questions, execution endpoints for questionnaire takes, and form/table builders for all major questionnaire entities.

It is intended for internal survey, audit, onboarding, or rule-driven question flows where answers may be typed, predefined, conditional, and persisted in multiple stages.

Installation

Install the package:

composer require laravel-enso/questionnaires

Run the package migrations:

php artisan migrate

Optional publishes:

php artisan vendor:publish --tag=questionnaires-config
php artisan vendor:publish --tag=questionnaires-assets

Features

  • Question, answer, and questionnaire-take APIs with table init, table data, and Excel export flows.
  • Shared questionnaire options endpoint for dependent selects.
  • Support for typed answers through the AnswerTypes enum.
  • Range answer endpoint for generating predefined numeric intervals.
  • Persist flow for questionnaire takes separate from take creation.

Usage

Main route groups:

  • qres.answers.*
  • qres.questions.*
  • qres.qreTakes.*
  • qres.options

Supported typed answer families:

  • numeric
  • boolean
  • date
  • freetext
  • predefined

The question form captures questionnaire membership, display order, required flag, allows-multiple flag, and the question body. Questionnaire takes are created first, then persisted through the dedicated persist endpoint.

API

HTTP routes

  • GET api/qres/options
  • GET api/qres/answers/create
  • POST api/qres/answers
  • GET api/qres/answers/{answer}/edit
  • PATCH api/qres/answers/{answer}
  • DELETE api/qres/answers/{answer}
  • GET api/qres/answers/initTable
  • GET api/qres/answers/tableData
  • GET api/qres/answers/exportExcel
  • GET api/qres/answers/options
  • GET api/qres/questions/create
  • POST api/qres/questions
  • GET api/qres/questions/{question}/edit
  • PATCH api/qres/questions/{question}
  • DELETE api/qres/questions/{question}
  • GET api/qres/questions/initTable
  • GET api/qres/questions/tableData
  • GET api/qres/questions/exportExcel
  • GET api/qres/questions/options
  • POST api/qres/questions/{question}/rangeAnswer
  • POST api/qres/qreTakes
  • POST api/qres/qreTakes/{qreTake}/persist
  • GET api/qres/qreTakes/initTable
  • GET api/qres/qreTakes/tableData
  • GET api/qres/qreTakes/exportExcel

Depends On

Required Enso packages:

Companion frontend package:

Edit this page on GitHub
Last Updated: 4/20/2026, 6:08:26 PM