Skip to content

Latest commit

 

History

History
127 lines (81 loc) · 6.27 KB

README.en-us.md

File metadata and controls

127 lines (81 loc) · 6.27 KB
Raw

SurveyKing

English | 简体中文

preview-surveyking

BMI calculator survey

Background

Based on Ali's open source formily form solution self-developed survey editor, using the latest front-end and back-end technology (React+SpringBoot+AntDesignUI) to build a complete survey system.

SurveyKing is one of the known open source survey systems that has the most powerful functions, the simplest installation, and the best comprehensive experience.

Simple, Easy to use, and Professional are the continuous development concepts of SurveyKing. Large and medium-sized enterprises and even individuals can use SurveyKing to quickly build their own online survey system.

🚀 Quickly build a questionnaire system in 1 minute

  1. First install Java runtime environment (if the machine already has a Java environment, you can ignore it)
  2. Download Volume King Installation Package
  3. Double-click to run
  4. Open the browser to visit http://localhost:1991, enter the account password: admin/surveyking

Features

  • 🥇 Support a variety of question types, such as fill-blank, selection, dropdown, cascade, matrix, pagination, signature, question-group, etc.
  • 🎉 Computable, divided into logical calculation, value calculation, text replacement calculation, required calculation, click to experience
  • 🦋 Questions and options support fast rich text editing
  • 🥊 Responsive layout, all pages have a good operating experience on PC and mobile
  • 🥂 Various survey settings, such as support for temporary storage, survey modification, password setting, etc.
  • 🎇 Data, support survey data adding, editing, marking, exporting, previewing and downloading attachments
  • 🎨 Reports, support real-time statistical analysis of problems and display the output in the form of graphs (bar graphs, column graphs, fan graphs) and tables
  • 🚀 Simple installation and deployment (The fastest deployment in 1 minute), supports nginx deployment and one-click startup
  • 🎁 The backend supports a variety of databases (embedded h2), which can support all relational databases with jdbc driver, and mongodb will be supported in the future.
  • 🐯 Safe, reliable, stable and high-performance back-end API service
  • 🙆 Support complete RBAC permission control (cn.surveyking.server.workflow will be introduced later)
  • 🌈 Support internationalization (under improvement) -...

Install

Install via distribution

Currently adapted to h2 database and mysql database

Click Download surveyking-h2 version to the local

Click Download surveyking-mysql version to the local

Use source code to compile and install

The h2 version of the installation package is built by default.

# Download source code
git clone https://github.com/javahuang/SurveyKing.git

# Start building
gradle clean :api:build -P pro -x test

# start operation
java -jar api/build/libs/surveyking-v0.1.0.jar

Quick start with docker

When you start the SurveyKing mirroring, you can specify the SurveyKing mount parameters and save the log files and built-in database to your local. (There are still some problems with the docker version, to be resolved)

docker run -p 1991:1991 surveyking/surveyking
# Mount data file
docker run -p 1991:1991 -v /surveyking:/surveyking surveyking/surveyking

Usage

Since this system is built in Java, it needs to rely on the Java runtime environment, which can be downloaded via Java download for all operating systems to pre-install the java environment.

Follow the instructions below to configure different databases. If the front-end needs to be deployed with nginx, refer to using nginx to deploy the front-end.

Windows and mac support double-click to run, or open a command line window to execute the following commands

java -jar surveyking-v0.1.0.jar

Open the browser and visit http://localhost:1991. After the system is started for the first time, the admin user, account/password (admin/surveyking) will be created automatically, and the password can be changed through the user management interface after logging in to the system.

h2 startup method

Without any configuration, the database startup script will be created automatically. If you need to change the port number, refer to the defined port of mysql startup mode.

mysql startup mode

  1. First create the mysql database, and then execute the initialization script, download script.
  2. Then create a new application.properties file under the current directory.
server.port=1991 # Port number (optional, default 1991)
spring.datasource.url=jdbc:mysql://<ip>:<port>/<dbname> # Database connection address, replace with your mysql database address
spring.datasource.username=username # Database account (required)
spring.datasource.password=password # database password (required)

Deploy the front-end with nginx

Download static resource files under this directory and deploy directly to nginx.

Then configure the proxy to proxy to the back-end api service.

Online experience

Demo address: https://surveyking.cn

Click Try it, no need to register and log in (-_-||, the server bandwidth is only 1M, maybe the first load is slightly slower)

Contact the author

The back-end code is completely open source, and the front-end code will have an open source plan after it is stabilized. If you find it helpful, you can click the star in the upper right corner.

If you encounter any problems or suggestions, Please send me an issue.

LICENSE

SurveyKing is open source software licensed as MIT.