Class: Decision

Inherits:
PersistentDocument show all
Defined in:
lib/almirah/doc_types/decision.rb

Direct Known Subclasses

RiskRecord

Instance Attribute Summary collapse

Attributes inherited from PersistentDocument

#controlled_items, #frontmatter, #headings, #items, #up_link_docs

Attributes inherited from BaseDocument

#dom, #headings, #id, #output_rel_path, #title

Instance Method Summary collapse

Methods inherited from BaseDocument

#decisions_link, #home_link, #index_link, #needs_chartjs?, #rel_to, #risks_link, #save_html_to_file

Constructor Details

#initialize(file_path) ⇒ Decision

Returns a new instance of Decision.



14
15
16
17
18
19
20
21
22
23
24
25
 
# File 'lib/almirah/doc_types/decision.rb', line 14

def initialize(file_path)
  super
  @path = file_path
  stem = File.basename(file_path, File.extname(file_path))
  assign_id_parts(stem)
  @current_status = nil
  @start_date = nil
  @target_date = nil
  @target_release_version = nil
  @wrong_links_hash = {}
  @owners = []
end

Instance Attribute Details

#current_status ⇒ Object

Returns the value of attribute current_status.



10
11
12
 
# File 'lib/almirah/doc_types/decision.rb', line 10

def current_status
  @current_status
end

#html_rel_path ⇒ Object

Returns the value of attribute html_rel_path.



10
11
12
 
# File 'lib/almirah/doc_types/decision.rb', line 10

def html_rel_path
  @html_rel_path
end

#owners ⇒ Object

Returns the value of attribute owners.



10
11
12
 
# File 'lib/almirah/doc_types/decision.rb', line 10

def owners
  @owners
end

#path ⇒ Object

Returns the value of attribute path.



10
11
12
 
# File 'lib/almirah/doc_types/decision.rb', line 10

def path
  @path
end

#record_type ⇒ Object

Returns the value of attribute record_type.



10
11
12
 
# File 'lib/almirah/doc_types/decision.rb', line 10

def record_type
  @record_type
end

#root_prefix ⇒ Object

Returns the value of attribute root_prefix.



10
11
12
 
# File 'lib/almirah/doc_types/decision.rb', line 10

def root_prefix
  @root_prefix
end

#sequence_number ⇒ Object

Returns the value of attribute sequence_number.



10
11
12
 
# File 'lib/almirah/doc_types/decision.rb', line 10

def sequence_number
  @sequence_number
end

#specifications_path ⇒ Object

Returns the value of attribute specifications_path.



10
11
12
 
# File 'lib/almirah/doc_types/decision.rb', line 10

def specifications_path
  @specifications_path
end

#start_date ⇒ Object

Returns the value of attribute start_date.



10
11
12
 
# File 'lib/almirah/doc_types/decision.rb', line 10

def start_date
  @start_date
end

#target_date ⇒ Object

Returns the value of attribute target_date.



10
11
12
 
# File 'lib/almirah/doc_types/decision.rb', line 10

def target_date
  @target_date
end

#target_release_version ⇒ Object

Returns the value of attribute target_release_version.



10
11
12
 
# File 'lib/almirah/doc_types/decision.rb', line 10

def target_release_version
  @target_release_version
end

#wrong_links_hash ⇒ Object

Returns the value of attribute wrong_links_hash.



10
11
12
 
# File 'lib/almirah/doc_types/decision.rb', line 10

def wrong_links_hash
  @wrong_links_hash
end

Instance Method Details

#effective_status_on(date) ⇒ Object 



87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
 
# File 'lib/almirah/doc_types/decision.rb', line 87

def effective_status_on(date)
  table = find_section_table('Status')
  return nil if table.nil?

  date_idx = column_index(table, 'Date')
  status_idx = column_index(table, 'Status')
  return nil if date_idx.nil? || status_idx.nil?

  best_idx = nil
  best_date = nil
  table.rows.each_with_index do |row, i|
    parsed = parse_dd_mm_yyyy(row[date_idx])
    next if parsed.nil? || parsed > date

    if best_date.nil? || parsed > best_date || (parsed == best_date && i > best_idx)
      best_date = parsed
      best_idx = i
    end
  end
  return nil if best_idx.nil?

  status = table.rows[best_idx][status_idx].to_s.strip
  status.empty? ? nil : status
end

#extract_current_status ⇒ Object 



42
43
44
45
46
47
48
49
 
# File 'lib/almirah/doc_types/decision.rb', line 42

def extract_current_status
  status_table = find_section_table('Status')
  return if status_table.nil?

  status_table.is_decision_status_table = true
  marker_rows = status_table.rows.select { |row| row[0].to_s.strip == '*' }
  @current_status = marker_rows.length == 1 ? marker_rows[0][-1].to_s.strip : nil
end

#extract_owners ⇒ Object

The distinct, first-seen-ordered list of non-empty Owner cells in the Scope table. Empty when there is no Scope table, no Owner column, or no owner values. The Owner column is located by header text, not position.



73
74
75
76
77
78
79
80
81
82
83
84
85
 
# File 'lib/almirah/doc_types/decision.rb', line 73

def extract_owners
  @owners = []
  table = find_section_table('Scope')
  return if table.nil?

  owner_idx = column_index(table, 'Owner')
  return if owner_idx.nil?

  table.cells.each do |row|
    owner = row[owner_idx].to_s.strip
    @owners << owner unless owner.empty? || @owners.include?(owner)
  end
end

#extract_start_date ⇒ Object 



51
52
53
54
 
# File 'lib/almirah/doc_types/decision.rb', line 51

def extract_start_date
  dates = collect_dates('Status', 'Date') + collect_dates('Scope', 'Start Date')
  @start_date = dates.min
end

#extract_target_date ⇒ Object 



56
57
58
59
 
# File 'lib/almirah/doc_types/decision.rb', line 56

def extract_target_date
  dates = collect_dates('Status', 'Date') + collect_dates('Scope', 'Target Date')
  @target_date = dates.max
end

#extract_target_release_version ⇒ Object 



61
62
63
64
65
66
67
68
 
# File 'lib/almirah/doc_types/decision.rb', line 61

def extract_target_release_version
  @target_release_version = lookup_cell(
    section_name: 'Software Versions',
    key_column: 'Software Version Category',
    value_column: 'Software Version ID',
    key: 'Target Release Version'
  )
end

#to_console ⇒ Object 



27
28
29
 
# File 'lib/almirah/doc_types/decision.rb', line 27

def to_console
  puts "\e[36mDecision: #{@id}\e[0m"
end

#to_html(nav_pane, output_file_path) ⇒ Object 



31
32
33
34
35
36
37
38
39
40
 
# File 'lib/almirah/doc_types/decision.rb', line 31

def to_html(nav_pane, output_file_path)
  html_rows = []
  html_rows.append('')

  @items.each do |item|
    html_rows.append item.to_html
  end

  save_html_to_file(html_rows, nav_pane, output_file_path)
end