Form Manager is a simple system (backend/frontend) to receive web form POST submissions.
Login is performed using OpenID connect. There is no internal user account management.
When a form is added, it will be given a unique ID. Form submission can then be done using POST to /api/v1/form/<identifier>/incoming. The full url for submissions is also available: /api/v1/form/<identifier>/url.
Features:
- Send the form submission to an email address
- Recaptcha validation (v2 confirmed to work)
- Redirection to wanted page after submission
Created using:
- Database: MongoDB
- Backend: Python (Flask)
- Frontend: Vue (Quasar)
The backend can be found in the form_manager folder, while the frontend is found in frontend.
All configuration options are listed in form_manager/conf.py. Modify that file to change the configuration.
A complete development environment can be activated locally by running:
docker-compose --profile dev up
It will set up a database, a mail catcher, and one instance each of the backend and frontend, reachable at http://localhost:5050. The backend and frontend instance will use your local code, adapting to your changes.
If FLASK_ENV is set to development (done by default if you run the above command), you can log in by using the endpoint http://localhost:5050/api/v1/development/login/[email protected], where [email protected] may be exchanged to any email you want to log in as.
The easiest way to use development environment is to paste the url to the login endpoint in a web browser, and then open http://localhost:5050 to use the system.
The tests can be run using the command:
docker-compose --profile testing up --exit-code-from test
Form manager require a MongoDB instance, as well an instance of the frontend and backend. See the docker-compose.yml file.
Backend and frontend container images are available from Packages in the Github repository.