feat(EMS-4141): broker address lookup - manual entry

[ttbarnes]

Introduction ✏️

This PR updates the broker address lookup functionality to allow a user to enter an address manually, when the broker is based in the UK, and/or the address lookup results are not as a user expects.

Previously, the logic was:

• "If broker is based in the UK => address lookup".
• "If broker is not based in the UK => manual address".

But we now allow a user to enter a manual address if a broker is based in the UK.

Resolution ✔️

E2E

• Update relevant cypress commands to consume and pass a provideBrokerAddressManually flag/param.
• Update cy.assertEnterAddressManuallyLink to consume a expectedText param.
• Create a DRY clickEnterAddressManuallyLink link, cypress command.
• Add test coverage for:
  • Submitting single and multiple contract policy applications with a broker that is based in the UK, with manual address entry.
  • Submitting the "broker manual address" form via "Save and back", when the broker is based in the UK.
  • Changing the "broker address" from "not based in the UK" to "based in the UK" - and then entering the address manually after mutiple address look up results are available.
  • Checking new and wiped values after changing answers through certain flows/scenarios.

API

• Update mapBrokerAddress XLSX mapping function to return a value of FULL_ADDRESS or mapBrokerAddressBasedInTheUk, regardless of IS_BASED_IN_UK.

UI

• Update various task list related functions to consume and pass a brokerFullAddress param.
• Update getBrokerTasks logic.
• Create a new DRY helper function to generate an "enter broker address manually URL" ,generateEnterBrokerAddressManuallyUrl.
• Update BROKER_ADDRESSES and BROKER_CONFIRM_ADDRESS GET controllers to consume generateEnterBrokerAddressManuallyUrl.
• Update broker mapSubmittedData function to to wipe address lookup fields if IS_BASED_IN_UK is true and FULL_ADDRESS is populated.
• Update flattenApplicationData to only return address lookup fields if FULL_ADDRESS is not populated.
• Update the summary list's brokerAddressField mapping function to return a FULL_ADDRESS field/row, if populated.

Miscellaneous ➕

• Fix some typos.
• Minor documentation improvements.