baarkerlounger
/
submit-social-housing-lettings-and-sales-data
mirror of https://github.com/communitiesuk/submit-social-housing-lettings-and-sales-data.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity
Submit social housing lettings and sales data (CORE)
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
1875 Commits
218 Branches
260 Tags
83 MiB
 
 
 
 
Branch: CLDC-869-add-validations-for-initial-equity-for-shared-ownership
Branches Tags
${ item.name }
Create tag ${ searchTerm }
Create branch ${ searchTerm }
from 'CLDC-869-add-validations-for-initial-equity-for-shared-ownership'
${ noResults }
submit-social-housing-letti.../docs/form/runner.md

1.8 KiB
Raw Permalink Blame History

parent nav_order
Generating forms 2

Form runner

The Form runner is composed of:

Ruby classes:

  • A singleton form handler that instantiates an instances of each form definition (config file we have) combined with the setup section that is common to all forms. This is created at rails boot time. (app/models/form_handler.rb)
  • A Form class that is the entry point for parsing a form definition and handles most of the associated logic (app/models/form.rb)
  • Section, Subsection, Page and Question classes (app/models/form/)
  • Setup subsection specific instances (subclasses) of Section, Subsection, Pages and Questions (app/form/setup/)

ERB templates:

  • The page view which is the main view for each form page (app/views/form/page.html.erb)
  • Partials for each question type (radio, checkbox, select, text, numeric, date) (app/views/form/)
  • Partials for specific question guidance (app/views/form/guidance)
  • The check answers page which is the view for the answer summary page of each section (app/views/form/check_answers.html.erb)

Routes for each form page are generated by looping over each Page instance in each Form instance held by the form handler and defining a GET path. The corresponding controller method is also auto-generated with meta-programming via the same looping in app/controllers/form_controller.rb

All form pages submit to the same controller method (app/controllers/form_controller.rb#submit_form) which validates and persists the data, and then redirects to the next form page that identifies as routed_to given the current lettings log state.

Form models and definition

For information about the form model and related models (section, subsection, page, question) and how these relate to each other see form definition.