This talk shows how we can implement a custom customer service flow based on the SmartAnswers module from the GOV.UK project.

1. @codescrum
Application Example based on
Gov.uk public code
This talk shows how we can implement a
custom customer service flow based on the
SmartAnswers module from the GOV.UK
project.
Jairo Diaz
@codescrum

2. @codescrum
Requirement
● Implement a pension advice tool:
Start
Question
1
Question
2
Oucome
1
Question
4
Oucome
2
Oucome
3
Oucome
4

3. @codescrum
GOV.UK
● https://www.gov.uk/which-finance-is-right-for-your-business/

4. @codescrum
Can we reuse?
1. Spike: Install and implement a simple flow
2. Review code
3. Reuse code

5. @codescrum
Step 1. Test Simple Flow
● Github project: alphagov / smart-answers-stack
● Check Readme.md

6. @codescrum
Dependencies for Smart-answers
Smart-anwers
(5001)
Static
(5000)
GovUk_Content_API
(5002)
MongoDb
(27017)
Local URL:
http://smartanswers.dev.gov.uk/which-finance-is-right-for-your-business

7. @codescrum
Smart-answers DSL (flow.rb)
multiple_choice :have_you_got_a_letter? do
option :yes => :what_does_your_letter_say?
option :no => :workplace_pension_good_idea
end
multiple_choice :what_does_your_letter_say? {...}
outcome :workplace_pension_good_idea
outcome :no_outcome

8. @codescrum
Smart-answers Text (flow.yml)
en:
test-flow:
flow:
have_you_got_a_letter?:
title: Have you received a letter ...
options:
"yes": "Yes"
"no": "No"
workplace_pension_good_idea:
body: “the advice is here”

9. @codescrum
Step 2. Review Code
CodeClimate Metrics:
Duplication / Complex Method / Complex Class

10. @codescrum
Test Coverage

11. @codescrum
Rails App
SmartAnswers
Controller
SmartAnswers
Presenter
Show.html.erb
Look up translations
Controls UI elements
Find Flow
Control user interaction
Controls Display for a
multiple choice question with “options”
MultipleChoice
QuestionPresenter
Renders UI

12. @codescrum
Library Interface
SmartAnswers
Presenter
FlowRegistry
MultipleChoiceMultipleChoice
QuestionPresenter
Method instance
Method find
Flow
Method name
Method process
Method node
Method path
SmartAnswers
Controller
Method name
Method process
Method node
Method path
Method name
Method options
Method to_response

13. @codescrum
Library Implementation
State
Node
Question::Base
SmartAnswers
Presenter
FlowRegistry
MultipleChoiceMultipleChoice
QuestionPresenter
Flow
SmartAnswers
Controller

14. @codescrum
Step 3. Reuse Code
FlowStatePresenter
QuestionPresenter
Flows
Controller
SmartAnswers
Presenter
MultipleChoice
QuestionPresenter
SmartAnswers
Controller
FlowRegistry
MultipleChoice
Flow

15. @codescrum
Additional elements
● Custom Javascript application
● Localisation for an additional language
● Cucumber / RSpec testbed
● Google Analytics configuration
● Deployment
● Service monitoring

16. @codescrum
Workplace pension advice tool
https://www.moneyadviceservice.org.uk/en/tools/workplace-pension-advice-tool

17. @codescrum
The new budget tool
https://www.moneyadviceservice.org.uk/en/tools/the-budget-and-you

18. @codescrum
Other Interesting Projects
● Smart-answers-builder
file://localhost/Users/User/Github/smart-answer-builder/index.html
● Performance management apps (backdrop)
https://www.gov.uk/performance/dashboard
● CMS: whitehall / publisher / frontend
● Puppet modules

19. @codescrum
Thank you & Questions