metadata_presenter 1.5.0 → 1.7.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: aaea9e08a797416b551fd731c80db49d05f02f75f4ac61ecf68c5861d55af9a3
-  data.tar.gz: e3938447849a5197cc3567c55caacdf0eea2e80e1e4eb05b42e175850d9b34cd
+  metadata.gz: 5ac5fd51e02d3200c324282f394e5d8d3b11e0e440592e627290dfd7b6c767ba
+  data.tar.gz: bced641e349533c820815867b08bfca21f7d8c0bbd619ed19615e424edcaa2a6
 SHA512:
-  metadata.gz: 4f9ac675b0c24ca6ea9a1a9556b13a1151d499750e8aa16d3fbfc5981ac2a93cb99acc03939a188886eaf1254930bcdc1634fd44461b4345ec029a0243bd4d73
-  data.tar.gz: bf12bf7eefe0f0376fe67801fa74507d0a8267c08106b8c0198023f09999a093090127d4f6b3e8360d2e570cc90a49a36f4263ed77b63dc2e56587ad605a95fd
+  metadata.gz: d38891660bc18dfe3472b43b84efc4a4752be370ba88decb17aad07aa47d779282214602bd52b10db043ad9aec8cc582e2010828deb8916f4b4b40fe069165d7
+  data.tar.gz: 289b34c930dd5c2322d6c32bb22d761c2d2f973e8ae8be7edd5104d3af2f429055ac5edbe76a56b9e78b63e48da5958e551f3e1b66a444eaa02572a41ee3febf

data/README.md

@@ -83,3 +83,15 @@ service.
 ## Generate documentation
 
 Run `rake doc` and open the doc/index.html
+
+## Flow diagrams
+
+You can generate flow diagrams calling a rake task:
+
+```
+  brew install graphviz
+  SERVICE_METADATA="some-form-metadata" rails metadata:flow
+```
+
+This will generate an image with the flow for that metadata. Open that image
+and profit!

data/app/controllers/metadata_presenter/answers_controller.rb

@@ -28,6 +28,7 @@ module MetadataPresenter
       next_page = NextPage.new(
         service: service,
         session: session,
+        user_data: load_user_data,
         current_page_url: page_url
       ).find
 

data/app/controllers/metadata_presenter/change_answer_controller.rb

@@ -1,7 +1,7 @@
 module MetadataPresenter
   class ChangeAnswerController < EngineController
     def create
-      session[:return_to_check_you_answer] = true
+      session[:return_to_check_your_answer] = true
       redirect_to_page params[:url]
     end
   end

data/app/controllers/metadata_presenter/engine_controller.rb

@@ -6,14 +6,19 @@ module MetadataPresenter
     default_form_builder GOVUKDesignSystemFormBuilder::FormBuilder
 
     def back_link
-      return if @page.blank?
-
-      previous_page = service.previous_page(
+      previous_page = PreviousPage.new(
+        service: service,
+        user_data: load_user_data,
         current_page: @page,
-        referrer: request.referer
-      )&.url
-
-      @back_link ||= File.join(request.script_name, previous_page) if previous_page
+        referrer: request.referrer
+      ).page
+
+      if previous_page
+        @back_link ||= File.join(
+          request.script_name,
+          previous_page.url
+        )
+      end
     end
     helper_method :back_link
 

data/app/models/metadata_presenter/evaluate_conditions.rb

@@ -4,24 +4,32 @@ module MetadataPresenter
     attr_accessor :service, :flow, :user_data
 
     def page
-      results = conditions.map do |condition|
-        condition.criterias.map do |criteria|
+      evaluated_page_uuid = page_uuid || flow.default_next
+
+      service.find_page_by_uuid(evaluated_page_uuid)
+    end
+
+    def page_uuid
+      @results ||= conditions.map do |condition|
+        evaluated_criterias = condition.criterias.map do |criteria|
           criteria.service = service
 
-          next unless Operator.new(
+          Operator.new(
             criteria.operator
-          ).evaluate(criteria.field_label, user_data[criteria.criteria_component.id])
+          ).evaluate(
+            criteria.field_label,
+            user_data[criteria.criteria_component.id]
+          )
+        end
 
+        if condition.condition_type == 'or' && evaluated_criterias.any?
+          condition.next
+        elsif evaluated_criterias.all?
           condition.next
         end
       end
 
-      page_uuid = results.flatten.uniq.compact
-      if page_uuid.present?
-        service.find_page_by_uuid(page_uuid.first)
-      else
-        service.find_page_by_uuid(flow.default_next)
-      end
+      @results.flatten.compact.first
     end
 
     delegate :conditions, to: :flow

data/app/models/metadata_presenter/flow.rb

@@ -13,5 +13,9 @@ module MetadataPresenter
         Condition.new(condition_metadata)
       end
     end
+
+    def group_by_page
+      conditions.group_by(&:next)
+    end
   end
 end

data/app/models/metadata_presenter/next_page.rb

@@ -1,10 +1,10 @@
 module MetadataPresenter
   class NextPage
     include ActiveModel::Model
-    attr_accessor :service, :session, :current_page_url
+    attr_accessor :service, :session, :user_data, :current_page_url
 
     def find
-      return check_answers_page if return_to_check_you_answer?
+      return check_answers_page if return_to_check_your_answer?
 
       if conditions?
         evaluate_conditions
@@ -18,12 +18,12 @@ module MetadataPresenter
     private
 
     def check_answers_page
-      session[:return_to_check_you_answer] = nil
+      session[:return_to_check_your_answer] = nil
       service.pages.find { |page| page.type == 'page.checkanswers' }
     end
 
-    def return_to_check_you_answer?
-      session[:return_to_check_you_answer].present?
+    def return_to_check_your_answer?
+      session[:return_to_check_your_answer].present?
     end
 
     def conditions?
@@ -36,7 +36,7 @@ module MetadataPresenter
       EvaluateConditions.new(
         service: service,
         flow: next_flow,
-        user_data: session[:user_data]
+        user_data: user_data
       ).page
     end
 

data/app/models/metadata_presenter/page.rb

@@ -62,6 +62,10 @@ module MetadataPresenter
       components.select(&:upload?)
     end
 
+    def standalone?
+      type == 'page.standalone'
+    end
+
     private
 
     def to_components(node_components, collection:)

data/app/models/metadata_presenter/page_answers.rb

@@ -2,6 +2,7 @@ module MetadataPresenter
   class PageAnswers
     include ActiveModel::Model
     include ActiveModel::Validations
+    include ActionView::Helpers
     attr_reader :page, :answers, :uploaded_files
 
     def initialize(page, answers)
@@ -30,7 +31,7 @@ module MetadataPresenter
       elsif component && component.type == 'checkboxes'
         answers[method_name.to_s].to_a
       else
-        answers[method_name.to_s]
+        sanitize(answers[method_name.to_s])
       end
     end
 
@@ -40,10 +41,10 @@ module MetadataPresenter
       return {} unless file_details
 
       if file_details.is_a?(Hash) || file_details.is_a?(ActionController::Parameters)
-        file_details
+        file_details.merge('original_filename' => sanitize(file_details['original_filename']))
       else
         {
-          'original_filename' => file_details.original_filename,
+          'original_filename' => sanitize(file_details.original_filename),
           'content_type' => file_details.content_type,
           'tempfile' => file_details.tempfile.path.to_s
         }
@@ -62,7 +63,7 @@ module MetadataPresenter
         GOVUKDesignSystemFormBuilder::Elements::Date::SEGMENTS[:month],
         GOVUKDesignSystemFormBuilder::Elements::Date::SEGMENTS[:year]
       ].map do |segment|
-        answers["#{component_id}(#{segment})"]
+        sanitize(answers["#{component_id}(#{segment})"])
       end
     end
   end

data/app/models/metadata_presenter/previous_page.rb

@@ -0,0 +1,38 @@
+module MetadataPresenter
+  class PreviousPage
+    include ActiveModel::Model
+    attr_accessor :service, :user_data, :current_page, :referrer
+
+    def page
+      # what happens when a user enters in the middle of the flow
+      return if no_current_or_referrer_pages? || service.no_back_link?(current_page)
+
+      if flow.present?
+        return referrer_page if return_to_referrer?
+
+        TraversedPages.new(service, user_data, current_page).last
+      else
+        service.previous_page(current_page: current_page, referrer: referrer)
+      end
+    end
+
+    def flow
+      service.metadata['flow']
+    end
+
+    private
+
+    def referrer_page
+      @referrer_page ||= service.find_page_by_url(URI(referrer).path)
+    end
+
+    def return_to_referrer?
+      current_page.standalone? ||
+        (referrer_page && referrer_page.standalone?)
+    end
+
+    def no_current_or_referrer_pages?
+      current_page.blank? || referrer.nil?
+    end
+  end
+end

data/app/models/metadata_presenter/service.rb

@@ -39,6 +39,8 @@ class MetadataPresenter::Service < MetadataPresenter::Metadata
   end
 
   def previous_page(current_page:, referrer:)
+    return if current_page.nil? || referrer.nil?
+
     unless no_back_link?(current_page)
       flow_page(current_page) || referrer_page(referrer)
     end
@@ -54,16 +56,16 @@ class MetadataPresenter::Service < MetadataPresenter::Metadata
     MetadataPresenter::Meta.new(configuration['meta'])
   end
 
+  def no_back_link?(current_page)
+    current_page == start_page || current_page == confirmation_page
+  end
+
   private
 
   def all_pages
     @all_pages ||= pages + standalone_pages
   end
 
-  def no_back_link?(current_page)
-    current_page == start_page || current_page == confirmation_page
-  end
-
   def flow_page(current_page)
     page_index = pages.index(current_page)
     pages[page_index - 1] if page_index.present?

data/app/models/metadata_presenter/traversed_pages.rb

@@ -0,0 +1,40 @@
+module MetadataPresenter
+  class TraversedPages
+    attr_reader :service, :user_data, :current_page
+
+    def initialize(service, user_data, current_page)
+      @service = service
+      @user_data = user_data
+      @pages = [service.start_page]
+      @current_page = current_page
+    end
+
+    delegate :last, to: :all
+
+    def all
+      page_uuid = service.start_page.uuid
+
+      service.metadata['flow'].size.times do
+        break if page_uuid == current_page.uuid
+
+        flow_object = service.flow(page_uuid)
+
+        if flow_object.branch?
+          page = EvaluateConditions.new(
+            service: service,
+            flow: flow_object,
+            user_data: user_data
+          ).page
+          page_uuid = page.uuid
+        else
+          page_uuid = flow_object.default_next
+          page = service.find_page_by_uuid(page_uuid)
+        end
+
+        @pages.push(page) if page && page.uuid != current_page.uuid
+      end
+
+      @pages
+    end
+  end
+end

data/fixtures/branching.json

@@ -169,7 +169,7 @@
     "618b7537-b42b-4551-ae7d-053afa4d9ca9": {
       "_type": "branch",
       "next": {
-        "default": "e337070b-f636-49a3-a65c-f506675265f0",
+        "default": "dc7454f9-4186-48d7-b055-684d57bbcdc7",
         "conditions": [
           {
             "condition_type": "if",
@@ -201,10 +201,146 @@
     "bc666714-c0a2-4674-afe5-faff2e20d847": {
       "_type": "page",
       "next": {
-        "default": "e337070b-f636-49a3-a65c-f506675265f0"
+        "default": "dc7454f9-4186-48d7-b055-684d57bbcdc7"
       }
     },
     "e2887f44-5e8d-4dc0-b1de-496ab6039430": {
+      "_type": "page",
+      "next": {
+        "default": "dc7454f9-4186-48d7-b055-684d57bbcdc7"
+      }
+    },
+    "dc7454f9-4186-48d7-b055-684d57bbcdc7": {
+      "_type": "page",
+      "next": {
+        "default": "84a347fc-8d4b-486a-9996-6a86fa9544c5"
+      }
+    },
+    "84a347fc-8d4b-486a-9996-6a86fa9544c5": {
+      "_type": "branch",
+      "next": {
+        "default": "48357db5-7c06-4e85-94b1-5e1c9d8f39eb",
+        "conditions": [
+          {
+            "condition_type": "or",
+            "next": "2cc66e51-2c14-4023-86bf-ded49887cdb2",
+            "criterias": [
+              {
+                "operator": "is",
+                "page": "dc7454f9-4186-48d7-b055-684d57bbcdc7",
+                "component": "5ca01e56-94de-4c33-b5fc-74697e5b95cc",
+                "field": "bd14bf31-427e-4267-9926-a18c167fe604"
+              },
+              {
+                "operator": "is",
+                "page": "dc7454f9-4186-48d7-b055-684d57bbcdc7",
+                "component": "5ca01e56-94de-4c33-b5fc-74697e5b95cc",
+                "field": "eb720ef7-bcaf-4c73-8972-6fc80dca6245"
+              }
+            ]
+          },
+          {
+            "condition_type": "and",
+            "next": "f6c51f88-7be8-4cb7-bbfc-6c905727a051",
+            "criterias": [
+              {
+                "operator": "is",
+                "page": "68fbb180-9a2a-48f6-9da6-545e28b8d35a",
+                "component": "ac41be35-914e-4b22-8683-f5477716b7d4",
+                "field": "c5571937-9388-4411-b5fa-34ddf9bc4ca0"
+              },
+              {
+                "operator": "is",
+                "page": "dc7454f9-4186-48d7-b055-684d57bbcdc7",
+                "component": "5ca01e56-94de-4c33-b5fc-74697e5b95cc",
+                "field": "0c4192eb-1441-4f10-b00a-0f03b756269e"
+              }
+            ]
+          }
+        ]
+      }
+    },
+    "2cc66e51-2c14-4023-86bf-ded49887cdb2": {
+      "_type": "page",
+      "next": {
+        "default": "48357db5-7c06-4e85-94b1-5e1c9d8f39eb"
+      }
+    },
+    "f6c51f88-7be8-4cb7-bbfc-6c905727a051": {
+      "_type": "page",
+      "next": {
+        "default": "48357db5-7c06-4e85-94b1-5e1c9d8f39eb"
+      }
+    },
+    "48357db5-7c06-4e85-94b1-5e1c9d8f39eb": {
+      "_type": "page",
+      "next": {
+        "default": "1079b5b8-abd0-4bf6-aaac-1f01e69e3b39"
+      }
+    },
+    "1079b5b8-abd0-4bf6-aaac-1f01e69e3b39": {
+      "_type": "branch",
+      "next": {
+        "default": "941137d7-a1da-43fd-994a-98a4f9ea6d46",
+        "conditions": [
+          {
+            "condition_type": "and",
+            "next": "56e80942-d0a4-405a-85cd-bd1b100013d6",
+            "criterias": [
+              {
+                "operator": "is",
+                "page": "48357db5-7c06-4e85-94b1-5e1c9d8f39eb",
+                "component": "3a430712-a75f-4412-836d-4ec7b2cb1ac9",
+                "field": "30258b55-ec04-4278-86b7-8382cbd34bea"
+              },
+              {
+                "operator": "is",
+                "page": "48357db5-7c06-4e85-94b1-5e1c9d8f39eb",
+                "component": "3a430712-a75f-4412-836d-4ec7b2cb1ac9",
+                "field": "9339d86e-b53c-42c0-ab6e-1ab3e2340873"
+              },
+              {
+                "operator": "is",
+                "page": "48357db5-7c06-4e85-94b1-5e1c9d8f39eb",
+                "component": "3a430712-a75f-4412-836d-4ec7b2cb1ac9",
+                "field": "5d650e5d-57ac-42a1-9348-c1b93248753a"
+              }
+            ]
+          },
+          {
+            "condition_type": "or",
+            "next": "6324cca4-7770-4765-89b9-1cdc41f49c8b",
+            "criterias": [
+              {
+                "operator": "is",
+                "page": "48357db5-7c06-4e85-94b1-5e1c9d8f39eb",
+                "component": "3a430712-a75f-4412-836d-4ec7b2cb1ac9",
+                "field": "6b82b4e4-6dfd-4b3c-b6ed-2d71be0980bf"
+              },
+              {
+                "operator": "is",
+                "page": "48357db5-7c06-4e85-94b1-5e1c9d8f39eb",
+                "component": "3a430712-a75f-4412-836d-4ec7b2cb1ac9",
+                "field": "8c2c6161-7309-4e4f-9f3c-9fa629bcb459"
+              }
+            ]
+          }
+        ]
+      }
+    },
+    "941137d7-a1da-43fd-994a-98a4f9ea6d46": {
+      "_type": "page",
+      "next": {
+        "default": "e337070b-f636-49a3-a65c-f506675265f0"
+      }
+    },
+    "56e80942-d0a4-405a-85cd-bd1b100013d6": {
+      "_type": "page",
+      "next": {
+        "default": "e337070b-f636-49a3-a65c-f506675265f0"
+      }
+    },
+    "6324cca4-7770-4765-89b9-1cdc41f49c8b": {
       "_type": "page",
       "next": {
         "default": "e337070b-f636-49a3-a65c-f506675265f0"
@@ -420,6 +556,7 @@
       "url": "favourite-fruit",
       "_type": "page.singlequestion",
       "_uuid": "0b297048-aa4d-49b6-ac74-18e069118185",
+      "heading": "",
       "components": [
         {
           "_id": "favourite-fruit_radios_1",
@@ -463,6 +600,7 @@
       "url": "apple-juice",
       "_type": "page.singlequestion",
       "_uuid": "d4342dfd-0d09-4a91-a0ea-d7fd67e706cc",
+      "heading": "",
       "components": [
         {
           "_id": "apple-juice_radios_1",
@@ -499,6 +637,7 @@
       "url": "orange-juice",
       "_type": "page.singlequestion",
       "_uuid": "91e9f7c6-2f75-4b7d-9eb5-0cf352f7be66",
+      "heading": "",
       "components": [
         {
           "_id": "orange-juice_radios_1",
@@ -535,6 +674,7 @@
       "url": "favourite-band",
       "_type": "page.singlequestion",
       "_uuid": "05c3306c-0a39-42d2-9e0f-93fd49248f4e",
+      "heading": "",
       "components": [
         {
           "_id": "favourite-band_radios_1",
@@ -571,6 +711,7 @@
       "url": "music-app",
       "_type": "page.singlequestion",
       "_uuid": "8002df6e-29ab-4cdf-b520-1d7bb931a28f",
+      "heading": "",
       "components": [
         {
           "_id": "music-app_radios_1",
@@ -607,6 +748,7 @@
       "url": "best-formbuilder",
       "_type": "page.singlequestion",
       "_uuid": "ef2cafe3-37e2-4533-9b0c-09a970cd38d4",
+      "heading": "",
       "components": [
         {
           "_id": "best-formbuilder_radios_1",
@@ -773,6 +915,230 @@
       ],
       "section_heading": ""
     },
+    {
+      "_id": "page.marvel-series",
+      "url": "marvel-series",
+      "_type": "page.singlequestion",
+      "_uuid": "dc7454f9-4186-48d7-b055-684d57bbcdc7",
+      "heading": "",
+      "components": [
+        {
+          "_id": "marvel-series_radios_1",
+          "hint": "",
+          "name": "marvel-series_radios_1",
+          "_type": "radios",
+          "_uuid": "5ca01e56-94de-4c33-b5fc-74697e5b95cc",
+          "items": [
+            {
+              "_id": "marvel-series_radios_1_item_1",
+              "hint": "",
+              "_type": "radio",
+              "_uuid": "0c4192eb-1441-4f10-b00a-0f03b756269e",
+              "label": "WandaVision"
+            },
+            {
+              "_id": "marvel-series_radios_1_item_2",
+              "hint": "",
+              "_type": "radio",
+              "_uuid": "bd14bf31-427e-4267-9926-a18c167fe604",
+              "label": "The Falcon and the Winter Soldier"
+            },
+            {
+              "_id": "marvel-series_radios_1_item_2",
+              "hint": "",
+              "_type": "radio",
+              "_uuid": "eb720ef7-bcaf-4c73-8972-6fc80dca6245",
+              "label": "Loki"
+            },
+            {
+              "_id": "marvel-series_radios_1_item_3",
+              "hint": "",
+              "_type": "radio",
+              "_uuid": "d762e328-18dc-4861-bca8-d104609b8299",
+              "label": "Hawkeye"
+            }
+          ],
+          "errors": {},
+          "legend": "What is the best marvel series?",
+          "validation": {
+            "required": true
+          }
+        }
+      ]
+    },
+    {
+      "_id": "page.marvel-quotes",
+      "url": "marvel-quotes",
+      "body": "Marvel quotes",
+      "lede": "",
+      "_type": "page.content",
+      "_uuid": "2cc66e51-2c14-4023-86bf-ded49887cdb2",
+      "heading": "Loki",
+      "components": [
+        {
+          "_id": "marvel-quotes_content_1",
+          "name": "marvel-quotes_content_1",
+          "_type": "content",
+          "_uuid": "5cede2fa-5001-4d6a-965c-30addc3c4496",
+          "content": "I am Loki of Asgard, and I am burdened with glorious purpose."
+        },
+        {
+          "_id": "marvel-quotes_content_2",
+          "name": "marvel-quotes_content_2",
+          "_type": "content",
+          "_uuid": "816b6afd-4649-455a-b10d-62cb5acb4584",
+          "content": "So Who Are You Fighting Now ... Gandalf?"
+        }
+      ],
+      "section_heading": ""
+    },
+    {
+      "_id": "page.other-quotes",
+      "url": "other-quotes",
+      "body": "Other quotes",
+      "lede": "",
+      "_type": "page.content",
+      "_uuid": "f6c51f88-7be8-4cb7-bbfc-6c905727a051",
+      "heading": "Other quotes",
+      "components": [
+        {
+          "_id": "other-quotes_content_1",
+          "name": "other-quotes_content_1",
+          "_type": "content",
+          "_uuid": "2535a867-deab-457b-91aa-c006e3c73d63",
+          "content": "- How we doing? - Same as always... - That bad, huh?"
+        },
+        {
+          "_id": "other-quotes_content_2",
+          "name": "other-quotes_content_2",
+          "_type": "content",
+          "_uuid": "816b6afd-4649-455a-b10d-62cb5acb4584",
+          "content": "Are you using your night vision, Vision?"
+        }
+      ],
+      "section_heading": ""
+    },
+    {
+      "_id": "page.best-arnold-quote",
+      "url": "best-arnold-quote",
+      "body": "Body section",
+      "lede": "",
+      "_type": "page.singlequestion",
+      "_uuid": "48357db5-7c06-4e85-94b1-5e1c9d8f39eb",
+      "heading": "Question",
+      "components": [
+        {
+          "_id": "best-arnold-quote_checkboxes_1",
+          "hint": "",
+          "name": "best-arnold-quote_checkboxes_1",
+          "_type": "checkboxes",
+          "_uuid": "3a430712-a75f-4412-836d-4ec7b2cb1ac9",
+          "items": [
+            {
+              "_id": "best-arnold-quote_checkboxes_1_item_1",
+              "hint": "",
+              "name": "best-arnold-quote_checkboxes_1",
+              "_type": "checkbox",
+              "_uuid": "30258b55-ec04-4278-86b7-8382cbd34bea",
+              "label": "You are not you. You are me"
+            },
+            {
+              "_id": "best-arnold-quote_checkboxes_1_item_2",
+              "hint": "",
+              "name": "best-arnold-quote_checkboxes_1",
+              "_type": "checkbox",
+              "_uuid": "9339d86e-b53c-42c0-ab6e-1ab3e2340873",
+              "label": "Get to the chopper"
+            },
+            {
+              "_id": "best-arnold-quote_checkboxes_1_item_3",
+              "hint": "",
+              "name": "best-arnold-quote_checkboxes_1",
+              "_type": "checkbox",
+              "_uuid": "5d650e5d-57ac-42a1-9348-c1b93248753a",
+              "label": "You have been terminated"
+            },
+            {
+              "_id": "best-arnold-quote_checkboxes_1_item_4",
+              "hint": "",
+              "name": "best-arnold-quote_checkboxes_1",
+              "_type": "checkbox",
+              "_uuid": "6b82b4e4-6dfd-4b3c-b6ed-2d71be0980bf",
+              "label": "I am GROOT"
+            },
+            {
+              "_id": "best-arnold-quote_checkboxes_1_item_5",
+              "hint": "",
+              "name": "best-arnold-quote_checkboxes_1",
+              "_type": "checkbox",
+              "_uuid": "8c2c6161-7309-4e4f-9f3c-9fa629bcb459",
+              "label": "Dance Off, Bro."
+            }
+          ],
+          "legend": "Select all Arnold Schwarzenegger quotes",
+          "validation": {
+            "required": true
+          }
+        }
+      ]
+    },
+    {
+      "_id": "page.arnold-right-answers",
+      "url": "arnold-right-answers",
+      "body": "You are right! Now, talk to the hand!",
+      "lede": "",
+      "_type": "page.content",
+      "_uuid": "56e80942-d0a4-405a-85cd-bd1b100013d6",
+      "heading": "You are right",
+      "components": [
+        {
+          "_id": "arnold-right-answers_content_1",
+          "name": "arnold-right-answers_content_1",
+          "_type": "content",
+          "_uuid": "9a7948f1-9e9a-4273-b52e-e2917c79f37c",
+          "content": "You are right! Now, talk to the hand!"
+        }
+      ],
+      "section_heading": ""
+    },
+    {
+      "_id": "page.arnold-wrong-answers",
+      "url": "arnold-wrong-answers",
+      "body": "You are wrong! These are from the Guardians of the Galaxy!",
+      "lede": "",
+      "_type": "page.content",
+      "_uuid": "6324cca4-7770-4765-89b9-1cdc41f49c8b",
+      "heading": "You are wrong",
+      "components": [
+        {
+          "_id": "arnold-wrong-answers_content_1",
+          "name": "arnold-wrong-answers_content_1",
+          "_type": "content",
+          "_uuid": "3bd3ca1d-fed7-43b0-ab90-b4425b634203",
+          "content": "You need to master the ability of standing so incredibly still, that you become invisible to the eye."
+        }
+      ],
+      "section_heading": ""
+    },
+    {
+      "_id": "page.arnold-incomplete-answers",
+      "url": "arnold-incomplete-answers",
+      "body": "You are wrong! The answers are incomplete.",
+      "lede": "",
+      "_type": "page.content",
+      "_uuid": "941137d7-a1da-43fd-994a-98a4f9ea6d46",
+      "heading": "You are wrong",
+      "components": [
+        {
+          "_id": "arnold-incomplete-answers_content_1",
+          "name": "arnold-incomplete-answers_content_1",
+          "_type": "content",
+          "_uuid": "16252a29-8e00-4247-b47f-3e94c863a540",
+          "content": "The answers are incomplete. You need to remember Arnold saying 'I will be back'. So go back to answer correctly."
+        }
+      ],
+      "section_heading": ""
+    },
     {
       "_id": "page.check-answers",
       "url": "check-answers",
@@ -820,7 +1186,7 @@
   "created_by": "099d5bf5-5f7b-444c-86ee-9e189cc1a369",
   "service_id": "488edccd-8411-4ffb-a38b-6a96c6ac28d6",
   "version_id": "27dc30c9-f7b8-4dec-973a-bd153f6797df",
-  "service_name": "Version Fixture",
+  "service_name": "Branching Fixture",
   "configuration": {
     "meta": {
       "_id": "config.meta",

data/lib/metadata_presenter/version.rb

@@ -1,3 +1,3 @@
 module MetadataPresenter
-  VERSION = '1.5.0'.freeze
+  VERSION = '1.7.2'.freeze
 end

data/lib/tasks/metadata_presenter_tasks.rake

@@ -5,48 +5,85 @@ namespace :metadata do
 
   desc 'Represent the flow objects in human readable form'
   task flow: :environment do
-    service = MetadataPresenter::Service.new(metadata_fixture('branching'))
-
-    start_page = service.start_page
-    flow = service.flow(start_page.uuid)
-    first_page = service.find_page_by_uuid(flow.default_next)
-
-    humanized_flow = {}
-
-    humanized_flow[start_page.url] = {
-      next: first_page.url
-    }
-
-    service.metadata['flow'].each do |id, _metadata|
-      flow = service.flow(id)
-
-      if flow.branch?
-        page = service.find_page_by_uuid(flow.default_next)
-        humanized_flow[page.url] = {
-          conditions: flow.conditions.map do |condition|
-            {
-              condition_type: condition.condition_type,
-              criterias: condition.criterias.map do |criteria|
-                criteria.service = service
-                {
-                  operator: criteria.operator,
-                  page: criteria.criteria_page.url,
-                  component: criteria.criteria_component.humanised_title,
-                  field: criteria.field_label
-                }
-              end
-            }
+    require 'ruby-graphviz'
+    metadata = ENV['SERVICE_METADATA'] || metadata_fixture('branching')
+    service = MetadataPresenter::Service.new(metadata)
+
+    graph = MetadataPresenter::Graph.new(service)
+
+    graph.draw.generate_image
+    puts "Generated file #{graph.filename}"
+    system("open #{graph.filename}")
+  end
+end
+
+module MetadataPresenter
+  class Graph
+    attr_reader :service, :filename, :nodes
+
+    delegate :metadata, :start_page, :find_page_by_uuid, :service_slug, to: :service
+
+    def initialize(service)
+      @service = service
+      @graphviz = GraphViz.new(:G, type: :digraph)
+      @filename = Rails.root.join('tmp', "#{service_slug}.png")
+      @nodes = {}
+    end
+
+    def draw
+      draw_nodes
+      draw_edges
+
+      self
+    end
+
+    def generate_image
+      @graphviz.output(png: filename)
+    end
+
+    private
+
+    def draw_nodes
+      flow.each do |id, _value|
+        flow_object = service.flow(id)
+
+        if flow_object.branch?
+          full_description = flow_object.conditions.map.each_with_index do |condition, _index|
+            condition.criterias.map { |criteria|
+              criteria.service = service
+
+              "#{criteria.criteria_component.humanised_title} #{criteria.operator} #{criteria.field_label}"
+            }.join(" #{condition.condition_type} ")
+          end
+          nodes[id] = @graphviz.add_nodes(full_description.flatten.join(' / '))
+        else
+          current_page = find_page_by_uuid(id)
+          nodes[id] = @graphviz.add_nodes(current_page.url)
+        end
+      end
+    end
+
+    def draw_edges
+      flow.each do |id, _value|
+        flow_object = service.flow(id)
+        current_node = nodes[id]
+        node_next = nodes[flow_object.default_next]
+
+        if flow_object.branch?
+          @graphviz.add_edges(current_node, node_next, label: 'Conditions are not met', labelfontsize: 8) if node_next
+
+          flow_object.group_by_page.each do |page_uuid, _conditions|
+            conditions_node = nodes[page_uuid]
+            @graphviz.add_edges(current_node, conditions_node, label: 'Conditions are met', labelfontsize: 8) if conditions_node
           end
-        }
-      else
-        page = service.find_page_by_uuid(id)
-        next_page = service.find_page_by_uuid(flow.default_next)
-        if next_page
-          humanized_flow[page.url] = { next: next_page.url }
+        elsif node_next
+          @graphviz.add_edges(current_node, node_next)
         end
       end
     end
 
-    pp humanized_flow
+    def flow
+      metadata['flow']
+    end
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: metadata_presenter
 version: !ruby/object:Gem::Version
-  version: 1.5.0
+  version: 1.7.2
 platform: ruby
 authors:
 - MoJ Online
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-06-29 00:00:00.000000000 Z
+date: 2021-07-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: govuk_design_system_formbuilder
@@ -128,6 +128,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: ruby-graphviz
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: rspec-rails
   requirement: !ruby/object:Gem::Requirement
@@ -277,7 +291,9 @@ files:
 - app/models/metadata_presenter/offline_upload_adapter.rb
 - app/models/metadata_presenter/page.rb
 - app/models/metadata_presenter/page_answers.rb
+- app/models/metadata_presenter/previous_page.rb
 - app/models/metadata_presenter/service.rb
+- app/models/metadata_presenter/traversed_pages.rb
 - app/models/metadata_presenter/uploaded_file.rb
 - app/operators/metadata_presenter/base_operator.rb
 - app/operators/metadata_presenter/is_answered_operator.rb