drawio_dsl 0.8.4 → 0.8.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: eaadefa65f1fcd1e6b91b0fec2a2991b6dbd0b5c81177c2437cd0cf68a1cafe7
-  data.tar.gz: 356f7ccd25ffdd017a1cdd2e73c38981489419b60267bb901c369a5de05bee68
+  metadata.gz: 3326464ea6385663c953bce3506bb21fed82b44a0003a08a75ad7649f1ee5bcb
+  data.tar.gz: a8d0e991fb3f38038b417021d0f16dd42736bc757c9fc92001449650ed9b1fac
 SHA512:
-  metadata.gz: affa37adb5680219cd4198308779a5fca57e687ca4a0c6a8dde2f090513295d369c67c6e0f1e77dec546af066a91bc673e2ff82e6f2a3ca26f4e6b30132904f9
-  data.tar.gz: 3d4053a106945fb96b2e9179a4bd49a4103e1fe8f4505761f1dba184d9906ac8cc7d6ac039dafedb9ce8275643ff6af8a7ea3aee5db452e40024a2aa178a8ab6
+  metadata.gz: 25a5e3322839124a32c317f9835b7216554e29e8f31071056d861b2a2f6eb7f96142c34ec45f14b5c478abfdb5539d5ffc5f50db58c6b811e532480582524bf1
+  data.tar.gz: c318a04c0cad50652fcbcf0d490ed4788cf1e646745df16df587a60f86f157f3e05e3972815f106d4ea02029db03f1eb25974e80b84e727bdc766fb9cf1bc23f

data/.builders/.data/shapes.json

@@ -415,6 +415,15 @@
       "h": 80,
       "style_modifiers": "shape=mxgraph.flowchart.database;strokeWidth=1"
     },
+    {
+      "type": "db_json",
+      "category": "element",
+      "x": 0,
+      "y": 0,
+      "w": 160,
+      "h": 40,
+      "style_modifiers": "shape=mxgraph.flowchart.database;strokeWidth=1"
+    },
     {
       "type": "diamond",
       "category": "element",

data/.builders/.templates/basic/drawio_extensions.rb

@@ -2,7 +2,8 @@
 
 module DrawioDsl
   # :nocov:
-  class DrawIoExtensions
+  # 1000's of extension shapes derived from Extensions.js that can be used via the add_shape method
+  class DrawioExtensions
 
     attr_reader :sections
     attr_reader :current_section

data/.builders/.templates/basic/drawio_shapes.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 module DrawioDsl
-  # DrawioDsl::Shapes is a list of DSL methods (one per shape)
+  # List of DSL methods for each common shape
   # :nocov:
   module DrawioShapes
     def random(**opts)

data/.builders/blueprint/shapes.rb

@@ -125,6 +125,7 @@ m = KManager.model :shapes, namespace: %i[domain] do
     row :cross                , :element, 0, 0,  50,  50, 'verticalLabelPosition=bottom;verticalAlign=top;html=1;shape=mxgraph.basic.x'
     row :envelop              , :element, 0, 0, 160, 100, 'shape=message'
     row :database             , :element, 0, 0, 160,  80, 'shape=mxgraph.flowchart.database;strokeWidth=1'
+    row :db_json              , :element, 0, 0, 160,  40, 'shape=mxgraph.flowchart.database;strokeWidth=1'
     row :diamond              , :element, 0, 0, 100, 100, 'rhombus'
     row :document             , :element, 0, 0, 160, 160, 'shape=mxgraph.basic.document'
     row :ellipse              , :element, 0, 0, 200, 120, 'ellipse'

data/.builders/generators/20-drawio-extensions.rb

@@ -5,7 +5,7 @@ KManager.action :transform_drawio_js do
       .init(k_builder, on_exist: :write, on_action: :execute)
       .diagram(theme: :style_10)
 
-      ext = DrawioDsl::DrawIoExtensions.new
+      ext = DrawioDsl::DrawioExtensions.new
       ext.build_extensions
       puts ext.sections.length
 

data/.builders/generators/domain_diagram.rb

@@ -1,36 +1,469 @@
-KManager.action :domain_diagram do
+KManager.action :domain_model do
   action do
 
     DrawioDsl::Drawio
       .init(k_builder, on_exist: :write, on_action: :execute)
       .diagram(theme: :style_04)
-      .page('Style-Plain', margin_left: 0, margin_top: 0, rounded: 0, background: '#fafafa') do
-        grid_layout(wrap_at: 6)
+      .page('Domain Modal', margin_left: 0, margin_top: 0, rounded: 0, background: '#fafafa') do
+        grid_layout(wrap_at: 6, grid_w: 180, grid_h: 180)
 
-        klass do
+        shape_element = :rectangle2 # hexagon, diamond, ellipse
+        shape_element_w = 75
+        shape_element_h = 50
+        shape_element_theme = :style_03
+
+        # need a blank
+        # square(fill_color: '#fafafa', stroke_color: '#fafafa', font_color: '#333333')
+
+        square(title: 'Configuration', theme: :style_01)
+
+        klass(description: '') do
           format
-            .header('Container', description: 'A container acts a base data object for any data that requires tagging')
+            .header('ShapeDefaults')
+            .field(:type, type: :symbol)
+            .field(:category, type: :symbol)
+            .field(:x, type: :integer)
+            .field(:y, type: :integer)
+            .field(:w, type: :integer)
+            .field(:h, type: :integer)
+            .field(:style_modifiers, type: :string)
         end
-        interface(theme: :style_02) do
+
+        klass(description: '') do
+          format
+            .header('ShapeThemeStyle')
+            .field(:theme, type: :symbol)
+            .field(:fill_color, type: :string)
+            .field(:stroke_color, type: :string)
+            .field(:font_color, type: :string)
+        end
+
+        klass(description: 'Configuration container for the DrawIO DSL') do
+          format
+            .header('Configuration')
+            .field(:base_style, type: :Struct)
+            .field(:shapes, type: 'Hash<Struct>')
+            .field(:themes, type: :Hash)
+            .method('+ <ConfigurationThemes>')
+            .method('+ <ConfigurationShapes>')
+        end
+
+        interface(description: 'Used to attach configuration to KConfig module', theme: :style_02) do
+          format
+            .header('ConfigurationExtension', interface_type: 'MixIn')
+            .field(:drawio, type: :Configuration)
+        end
+
+        interface(description: 'Attach predefined DrawIO shapes to KConfig module', theme: :style_02) do
           format
-            .header('Block Processor', interface_type: 'MixIn', description: 'Provide data load events, dependency and import management')
+            .header('ConfigurationShapes', interface_type: 'MixIn')
+            .method(:add_shapes)
         end
-        square(title: 'Documents', theme: :style_01)
-        interface(theme: :style_02) do
+
+        interface(description: 'Configuration for each theme', theme: :style_02) do
+          format
+            .header('ConfigurationThemes', interface_type: 'MixIn')
+            .method(:add_theme)
+            .method(:add_themes)
+        end
+
+        square(title: 'DOM Builder', theme: :style_01)
+
+        klass(description: 'Build Document object model to represent DrawioDsl output file.') do
+          format
+            .header('DomBuilder')
+            .field(:actions, type: :Array)
+            .field(:last_action, type: :Hash)
+            .field(:focus_node, type: :Anchor)
+            .field(:current_page, type: :Page)
+            .field(:dom)
+            .method(:reset)
+            .method(:queue_action)
+            .method(:set_diagram)
+            .method(:diagram)
+            .method(:add_page)
+            .method(:add_grid_layout)
+            .method(:add_flex_layout)
+            .method(:add_layout)
+            .method(:add_shape)
+            .method('+ <DomBuilderShapes>')
+        end
+
+        interface(description: 'Builder methods for each shape, line and text element to attach to DomBuilder.', theme: :style_02) do
+          format
+            .header('DomBuilderShapes', interface_type: 'MixIn')
+            .method('add_* (for each shape)')
+        end
+
+        square(title: 'DrawIO DSL', theme: :style_01)
+
+        klass(description: 'DSL for draw-io diagrams') do
           format
-            .header('Block Processor', interface_type: 'MixIn', description: 'Provide data load events, dependency and import management')
-            .field(:block, type: :proc)
-            .field(:block_state, type: :symbol)
-            .method(:depend_on)
+            .header('Drawio')
+            .method(:diagram)
+            .method(:page)
+            .method(:save)
+            .method(:osave)
+            .method(:export_svg)
+            .method(:export_png)
         end
+
+        klass(description: 'DSL for draw-io diagrams') do
+          format
+            .header('DrawioPage')
+            .method(:grid_layout)
+            .method(:flex_layout)
+            .method('+ <DrawioShapes>')
+        end
+
+        interface(description: 'List of DSL methods for each common shape', theme: :style_02) do
+          format
+            .header('DrawioShapes', interface_type: 'MixIn')
+            .method(:random)
+            .method('* (for each shape)')
+        end
+
+        square(title: '1000 Extension Shapes', theme: :style_01)
+
+        klass(description: '1000s of extension shapes derived from Extensions.js that can be used via the add_shape method') do
+          format
+            .header('DrawioExtensions')
+            .field(:sections, type: :Array)
+            .field(:current_section, type: :Hash)
+            .method(:section)
+            .method(:shape)
+            .method(:to_h)
+            .method(:build_extensions)
+            .method(:configure_extensions)
+            .method('+ <DrawioExtensionsActive>')
+        end
+
+        interface(description: 'Mark shapes as active or not, based on incomplete style being made inactive', theme: :style_02) do
+          format
+            .header('DrawioExtensionsActive', interface_type: 'MixIn')
+            .method(:apply_active_flags)
+            .method(:check_if_active)
+        end
+
+        klass(description: 'Layout engine is responsible for laying out the elements on the page') do
+          format
+            .header('LayoutEngine')
+            .field(:page, type: :Page)
+            .field(:current_page, type: :Page)
+            .field(:current_layout, type: :Layout)
+            .method(:call)
+            .method(:traverse_node)
+            .method(:process_node)
+        end
+
+        klass(description: 'Build the DrawioDsl XML file that is the basis of any draw-io diagrams.') do
+          format
+            .header('XmlBuilder')
+            .field(:diagram)
+            .method(:build)
+        end
+
+        square(title: 'Formatters', theme: :style_01)
+
+        klass(description: 'HTML builder has methods for common HTML elements that get written sequentially') do
+          format
+            .header('HtmlBuilder')
+            .field(:element_style_defaults, type: :Hash)
+            .method(:default_for)
+            .method(:style_for)
+            .method(:empty?)
+            .method(:exist?)
+            .method(:as_html)
+            .method(:hr)
+            .method(:b)
+            .method(:p)
+            .method(:add_line)
+            .method(:add_placeholder)
+            .method(:group)
+            .method(:build_lines)
+            .method(:lines)
+            .method(:groups)
+        end
+
+        interface(description: 'Create an instance of a HTML formatter on the shape', theme: :style_02) do
+          format
+            .header('Factory', interface_type: 'MixIn')
+            .method(:formatter)
+            .method(:format_instance)
+        end
+
+        klass(description: 'Base for any HTML formatter') do
+          format
+            .header('BaseFormatter')
+            .field(:html, type: :String)
+            .method(:empty?)
+            .method(:as_html)
+        end
+
+        klass(description: 'Format the HTML to display an interface on a class diagram') do
+          format
+            .header('InterfaceFormatter')
+            .method(:header)
+            .method(:field)
+            .method(:method)
+            .method(:as_html)
+        end
+
+        klass(description: 'Format the HTML to display an class on a class diagram') do
+          format
+            .header('KlassFormatter')
+            .method(:header)
+            .method(:field)
+            .method(:method)
+            .method(:as_html)
+        end
+
+        klass(description: 'style_builder') do
+          format
+            .header('StyleBuilder')
+            .field(:defaults, type: :Hash)
+            .field(:custom, type: :Hash)
+            .method(:customize)
+            .method(:style)
+            .method(:style_attribute)
+            .method(:build)
+          end
+
+        square(title: 'Schema', theme: :style_01)
+
+        klass(description: 'Shape is a graphical element, it can be a shape, a text, or a group') do
+          format
+            .header('Shape')
+            .field(:category, type: :Symbol)
+            .field(:theme, type: :Symbol)
+            .field(:title, type: :String)
+            .field(:value, type: :String)
+            .field(:white_space, type: :int)
+            .field(:html, type: :int)
+            .field(:rounded, type: :int)
+            .field(:shadow, type: :int)
+            .field(:glass, type: :int)
+            .field(:sketch, type: :int)
+            .field(:fill_color, type: :String)
+            .field(:stroke_color, type: :String)
+            .field(:font_color, type: :String)
+            .field(:gradient, type: :String)
+            .field(:x, type: :int)
+            .field(:y, type: :int)
+            .field(:w, type: :int)
+            .field(:h, type: :int)
+            .field(:style_modifiers, type: :Hash)
+            .field(:source, type: 'Symbol (id)')
+            .field(:target, type: 'Symbol (id)')
+            .method('> configure_shape')
+            .method(:initialize)
+            .method(:shape_defaults)
+            .method(:apply_defaults)
+            .method(:format)
+            .method(:style)
+            .method(:as_xml)
+            .method(:draw_element)
+            .method(:draw_line)
+            .method(:to_h)            
+          end
+
+        klass(description: 'common_style') do
+          format
+            .header('CommonStyle')
+            .field(:white_space, type: :int)
+            .field(:html, type: :int)
+            .field(:rounded, type: :int)
+            .field(:shadow, type: :int)
+            .field(:glass, type: :int)
+            .field(:sketch, type: :int)
+            .method(:to_h)
+        end
+
+        klass(description: 'default_palette') do
+          format
+            .header('DefaultPalette')
+            .field(:fill_color, type: :String)
+            .field(:stroke_color, type: :String)
+            .field(:font_color, type: :String)
+            .field(:gradient, type: :String)
+            .method(:to_h)
+        end
+
+        klass(description: 'diagram') do
+          format
+            .header('Diagram')
+            .field(:host, type: :String)
+            .field(:theme, type: :String)
+            .field(:style, type: :CommonStyle)
+            .field(:palette, type: :DefaultPalette)
+            .field(:pages, type: :Array)
+            .method(:to_h)
+        end
+        klass(description: 'node') do
+          format
+            .header('Node')
+            .field(:id, type: :String)
+            .field(:page, type: :Page)
+            .field(:parent, type: :Node)
+            .field(:classification, type: :String)
+            .field(:type, type: :String)
+            .field(:nodes, type: :Array)
+            .method(:initialize)
+            .method(:to_h)
+            .method(:root?)
+            .method(:add_node)
+        end
+
+        klass(description: 'node_list') do
+          format
+            .header('NodeList')
+            .field(:nodes, type: :Array)
+            .method(:add)
+            .method(:all)
+            .method(:shapes)
+            .method(:layouts)
+            .method(:length)
+            .method(:empty?)
+            .method(:any?)
+            .method(:first)
+            .method(:as_xml)
+            .method(:to_h)
+        end
+
+        klass(description: 'page') do
+          format
+            .header('Page')
+            .field(:diagram, type: :Diagram)
+            .field(:position_x, type: :int)
+            .field(:position_y, type: :int)
+            .field(:id, type: :String)
+            .field(:active, type: :bool)
+            .field(:name, type: :String)
+            .field(:theme, type: :Symbol)
+            .field(:style, type: :CommonStyle)
+            .field(:palette, type: :DefaultPalette)
+            .field(:margin_left, type: :int)
+            .field(:margin_top, type: :int)
+            .field(:nodes, type: :Array)
+            .field(:grid, type: :String)
+            .field(:grid_size, type: :int)
+            .field(:guides, type: :String)
+            .field(:tooltips, type: :String)
+            .field(:connect, type: :String)
+            .field(:arrows, type: :String)
+            .field(:fold, type: :String)
+            .field(:page_no, type: :String)
+            .field(:page_scale, type: :String)
+            .field(:page_width, type: :String)
+            .field(:page_height, type: :String)
+            .field(:background, type: :String)
+            .field(:page_shadow, type: :String)
+            .field(:math, type: :String)
+            .field(:active?, type: :Boolean)
+            .method(:add_node)
+            .method(:as_xml)
+            .method(:to_h)
+            .method(:settings)
+        end
+
+        square(title: 'Schema/Layouts', theme: :style_01)
+
+        klass(description: 'flex_layout') do
+          format
+            .header('FlexLayout')
+            .field(:direction, type: :String)
+            .field(:wrap_at, type: :int)
+            .field(:gap, type: :int)
+            .field(:perpendicular_max, type: :int)
+            .method(:position_shape)
+            .method(:to_h)
+        end
+
+        klass(description: 'grid_layout') do
+          format
+            .header('GridLayout')
+            .field(:direction, type: :String)
+            .field(:wrap_at, type: :int)
+            .field(:grid_size, type: :int)
+            .field(:grid_w, type: :int)
+            .field(:grid_h, type: :int)
+            .field(:cell_no, type: :int)
+            .field(:h_align, type: :String)
+            .field(:v_align, type: :String)
+            .method(:position_shape)
+            .method(:to_h)
+        end
+
+        klass(description: 'layout') do
+          format
+            .header('Layout')
+            .field(:anchor_x, type: :String)
+            .field(:anchor_y, type: :String)
+            .method(:fire_after_init)
+            .method(:after_init)
+            .method(:to_h)
+        end
+
+
+        square(title: 'Schema/virtual', theme: :style_01)
+        send(shape_element, title: 'anchor'        , w: shape_element_w, h: shape_element_h, theme: shape_element_theme)
+        square(title: 'Schema/shapes', theme: :style_01)
+
+        grid_layout(wrap_at: 12, grid_w: 90, grid_h: 70)
+
+        send(shape_element, title: 'actor'         , w: shape_element_w, h: shape_element_h, theme: shape_element_theme)
+        send(shape_element, title: 'actor2'        , w: shape_element_w, h: shape_element_h, theme: shape_element_theme)
+        send(shape_element, title: 'callout'       , w: shape_element_w, h: shape_element_h, theme: shape_element_theme)
+        send(shape_element, title: 'callout2'      , w: shape_element_w, h: shape_element_h, theme: shape_element_theme)
+        send(shape_element, title: 'callout3'      , w: shape_element_w, h: shape_element_h, theme: shape_element_theme)
+        send(shape_element, title: 'callout4'      , w: shape_element_w, h: shape_element_h, theme: shape_element_theme)
+        send(shape_element, title: 'circle'        , w: shape_element_w, h: shape_element_h, theme: shape_element_theme)
+        send(shape_element, title: 'cloud'         , w: shape_element_w, h: shape_element_h, theme: shape_element_theme)
+        send(shape_element, title: 'container'     , w: shape_element_w, h: shape_element_h, theme: shape_element_theme)
+        send(shape_element, title: 'container2'    , w: shape_element_w, h: shape_element_h, theme: shape_element_theme)
+        send(shape_element, title: 'container3'    , w: shape_element_w, h: shape_element_h, theme: shape_element_theme)
+        send(shape_element, title: 'container4'    , w: shape_element_w, h: shape_element_h, theme: shape_element_theme)
+        send(shape_element, title: 'cross'         , w: shape_element_w, h: shape_element_h, theme: shape_element_theme)
+        send(shape_element, title: 'database'      , w: shape_element_w, h: shape_element_h, theme: shape_element_theme)
+        send(shape_element, title: 'db_json'       , w: shape_element_w, h: shape_element_h, theme: shape_element_theme)
+        send(shape_element, title: 'diamond'       , w: shape_element_w, h: shape_element_h, theme: shape_element_theme)
+        send(shape_element, title: 'document'      , w: shape_element_w, h: shape_element_h, theme: shape_element_theme)
+        send(shape_element, title: 'ellipse'       , w: shape_element_w, h: shape_element_h, theme: shape_element_theme)
+        send(shape_element, title: 'embed_col200'  , w: shape_element_w, h: shape_element_h, theme: shape_element_theme)
+        send(shape_element, title: 'embed_col50'   , w: shape_element_w, h: shape_element_h, theme: shape_element_theme)
+        send(shape_element, title: 'embed_row'     , w: shape_element_w, h: shape_element_h, theme: shape_element_theme)
+        send(shape_element, title: 'envelop'       , w: shape_element_w, h: shape_element_h, theme: shape_element_theme)
+        send(shape_element, title: 'face'          , w: shape_element_w, h: shape_element_h, theme: shape_element_theme)
+        send(shape_element, title: 'h1'            , w: shape_element_w, h: shape_element_h, theme: shape_element_theme)
+        send(shape_element, title: 'h2'            , w: shape_element_w, h: shape_element_h, theme: shape_element_theme)
+        send(shape_element, title: 'h3'            , w: shape_element_w, h: shape_element_h, theme: shape_element_theme)
+        send(shape_element, title: 'h4'            , w: shape_element_w, h: shape_element_h, theme: shape_element_theme)
+        send(shape_element, title: 'h5'            , w: shape_element_w, h: shape_element_h, theme: shape_element_theme)
+        send(shape_element, title: 'h6'            , w: shape_element_w, h: shape_element_h, theme: shape_element_theme)
+        send(shape_element, title: 'hexagon'       , w: shape_element_w, h: shape_element_h, theme: shape_element_theme)
+        send(shape_element, title: 'interface'     , w: shape_element_w, h: shape_element_h, theme: shape_element_theme)
+        send(shape_element, title: 'klass'         , w: shape_element_w, h: shape_element_h, theme: shape_element_theme)
+        send(shape_element, title: 'line'          , w: shape_element_w, h: shape_element_h, theme: shape_element_theme)
+        send(shape_element, title: 'note'          , w: shape_element_w, h: shape_element_h, theme: shape_element_theme)
+        send(shape_element, title: 'p'             , w: shape_element_w, h: shape_element_h, theme: shape_element_theme)
+        send(shape_element, title: 'process'       , w: shape_element_w, h: shape_element_h, theme: shape_element_theme)
+        send(shape_element, title: 'rectangle'     , w: shape_element_w, h: shape_element_h, theme: shape_element_theme)
+        send(shape_element, title: 'rectangle2'    , w: shape_element_w, h: shape_element_h, theme: shape_element_theme)
+        send(shape_element, title: 'shape'         , w: shape_element_w, h: shape_element_h, theme: shape_element_theme)
+        send(shape_element, title: 'square'        , w: shape_element_w, h: shape_element_h, theme: shape_element_theme)
+        send(shape_element, title: 'step'          , w: shape_element_w, h: shape_element_h, theme: shape_element_theme)
+        send(shape_element, title: 'tick'          , w: shape_element_w, h: shape_element_h, theme: shape_element_theme)
+        send(shape_element, title: 'todo'          , w: shape_element_w, h: shape_element_h, theme: shape_element_theme)
+        send(shape_element, title: 'triangle'      , w: shape_element_w, h: shape_element_h, theme: shape_element_theme)
+
       end
       .cd(:docs)
-      .save('domain.drawio')
+      .save('domain_model.drawio')
       .export_svg('domain_model', page: 1)
   end
 end
 
-KManager.opts.app_name                    = 'domain_diagram'
+KManager.opts.app_name                    = 'domain_model'
 KManager.opts.sleep                       = 2
 KManager.opts.reboot_on_kill              = 0
 KManager.opts.reboot_sleep                = 4

data/.builders/generators/parking_app.rb

@@ -0,0 +1,110 @@
+KManager.action :parking_app do
+  action do
+
+    DrawioDsl::Drawio
+      .init(k_builder, on_exist: :write, on_action: :execute)
+      .diagram(theme: :style_04)
+      .page('Domain Modal', margin_left: 0, margin_top: 0, rounded: 0, background: '#fafafa') do
+        grid_layout(wrap_at: 6)
+
+        # Two apps in the market for parking currently do the following:
+        # 
+        # Allow an officer to see if a car is parked legally or not
+        # Officer can book the car and if it is parked illegally
+        # Officer can print out the penalty infringement notice (PIN)
+        # The vehicle operator (driver) can use the app to buy a ticket for a parking space
+        #
+        # System is integrated with State Debt Recovery System
+        #
+        # Two actors involved:
+        # Officer will book illegal cars
+        #  - An officer can be a: Parking cop, Police officer, Ranger or parking station attendant.
+        #  - Examples of parking station attendants include, McDonald'se, Wilsons Car Park, etc. (limited GEO fence)
+        # The vehicle operator will pay the ticket for parking space
+        #
+        # What can be booked? Anything that is a registered vehicle.
+        #   - Truck, Bus, Car, Motorcycle, Trailer, etc.
+        #   - They all have a number plate.
+        # 
+        # Goal is to build a better app
+
+        # What is wrong with the current apps?
+        #
+        # When I book a car, I say it is outside of house #5,  Bondi road.
+
+        # What can be improved?
+        #
+        # AI can be used to detect the vehicle definition.
+
+        actor2(title: 'Officer', description: 'Officer can book illegal cars')
+        actor2(title: 'Vehicle operator', description: 'vehicle operator can buy a ticket for a parking space')
+
+        # square
+
+        # should there be vehicle, the definition.
+        # should there be vehicle, the instance of the definition.
+
+        klass do # table in the database
+          format
+            .header('Vehicle', description: 'Any vehicle with a registration number plate, Truck, Bus, Car, Motorcycle, Trailer')
+            .field(:make)
+            .field(:model)
+            .field(:type) # Bus, Sedan, Station Wagon, 4WD, Motorcycle, Trailer, Caravan, Car+Caravan, Van etc.
+            .field(:registration_number)
+            .field(:heavy_vehicle)
+        end
+
+        klass do
+          format
+            .header('Chalk', description: 'Noting that a vehicle is parked at a specific time and location')
+            .field(:date_time)          # 9am (from chalk)
+            .field(:vehicle)
+            .field(:location_geo_long)  # , value: '-33.8425248')
+            .field(:location_geo_lat)   # , value: '151.2054196')
+        end
+
+        klass do
+          format
+            .header('Pin', description: 'Penalty infringement notice (PIN)')
+            .field(:date_time)
+            .field(:vehicle)
+            .field(:location_address)                 # can AI be used auto suggest to populate this field, and then the officer can alter if needed.
+            .field(:location_geo_long)                #, value: '-33.8425248')
+            .field(:location_geo_lat)                 #, value: '151.2054196')
+            .field(:location_photo)
+            .field(:photos)
+            .field(:offense_chalk_time)               # 9am (from chalk)
+            .field(:offense_offence_limit_time)       # 2 hours - has to be after chalk time (and is based on signage)
+            .field(:offense_pin_time)                 # has to be after offense limit time
+        end
+
+        # square(title: 'Schema/virtual', theme: :style_01)
+        # diamond(title: 'anchor')
+
+        # klass do
+        #   format
+        #     .header('Container', description: 'A container acts a base data object for any data that requires tagging')
+        # end
+        # square(title: 'Documents', theme: :style_01)
+        # interface(theme: :style_02) do
+        #   format
+        #     .header('Block Processor', interface_type: 'MixIn', description: 'Provide data load events, dependency and import management')
+        #     .field(:block, type: :proc)
+        #     .field(:block_state, type: :symbol)
+        #     .method(:depend_on)
+        # end
+      end
+      .cd(:docs)
+      .save('parking_app.drawio')
+      .export_svg('parking_app', page: 1)
+  end
+end
+
+KManager.opts.app_name                    = 'domain_diagram'
+KManager.opts.sleep                       = 2
+KManager.opts.reboot_on_kill              = 0
+KManager.opts.reboot_sleep                = 4
+KManager.opts.exception_style             = :short
+KManager.opts.show.time_taken             = true
+KManager.opts.show.finished               = true
+KManager.opts.show.finished_message       = 'FINISHED :)'