Ventilator Form

Express app to collect volunteers contact details. It uses the GOV frontend components to create a single page form. The page is vaildated on the server and stored in postgress database.

The form consists of three sets of questions as separate nunjucks includes, with options created from data in constants.js.

The app routes are the main form, a privacy page and the confirmation page. There are some additional demo pages, including a sinpe contacts page to allow the app to be deployed quickly to capture raw json.

The main file to process the data and a convert it into SQL is createFormData.js (the other two examples are included for demo purposes). This takes in raw json from the form and re-formats it into the various SQL strings. This data is then used in save_to_companies_db.js to generate the SQL query and passes teh data the database.

express

Sample express form highlighting how to create a boilerplate form using the govUk frontend toolkit based on passport details.

Key endpoints

Get /full-form

The endpoint showing the view for the form

Post /full-form

The endpoint handling submission of the form

Key points

This route begins by checking for any validation errors

Key files

routes/index.js

This is the file handling the main routes.

The validation of entries takes place here (approximately lines 16 - 70).

lib/save_to_db.js

This is the file processing the JSON data from the form. It calls the createMacroData function to process the JSON response into valid entries that we can use to build the sql query.

It then generates the sql query and then sends the query to the database.

lib/createMacroData.js

This file receives the JSON response from the form and converts the json into the valid columns it needs to make it usable.

This function can then be reused to convert the json to the columsn for any entries that do not have the columns yet.

lib/utils.js

This file provides helper functions to allow us to handle errors more easily.

views/full-form.html

This file renders the view for the form using the gov toolkit and displays errors as needed

macroDatabase.sql

This is the sql query to create the backend sql database for us to use with the necessary columns.