Class: Card::Act

Inherits:
Cardio::Record show all
Defined in:
mod/history/lib/card/act.rb,
mod/history/lib/card/act/act_renderer.rb,
mod/history/lib/card/act/act_renderer/board_act_renderer.rb,
mod/history/lib/card/act/act_renderer/absolute_act_renderer.rb,
mod/history/lib/card/act/act_renderer/relative_act_renderer.rb

Overview

An “act” is a group of recorded actions on cards. Together, acts, actions, and changes comprise a comprehensive card history tracking system.

For example, if a given web form submissions updates the contents of three cards, then the submission will result in the recording of three actions, each of which is tied to one act.

Each act records:

  • the actor_id (an id associated with the account responsible)
  • the card_id of the act’s primary card
  • acted_at, a timestamp of the action
  • the ip_address of the actor where applicable.

Defined Under Namespace

Classes: ActRenderer

Class Method Summary collapse

Instance Method Summary collapse

Class Method Details

.all_viewable(action_where = nil) ⇒ ActiveRecord Relation

all acts with actions that current user has permission to view

Returns:

  • (ActiveRecord Relation) 


54
55
56
57
58
 
# File 'mod/history/lib/card/act.rb', line 54

def all_viewable action_where=nil
  relation = joins(ar_actions: :ar_card)
  relation = relation.where(action_where) if action_where
  relation.where(Query::CardQuery.viewable_sql).where.not(card_id: nil).distinct
end

.all_with_actions_on(card_ids, with_drafts = false) ⇒ Array of Acts

all acts with actions on a given list of cards

Parameters:

  • card_ids (Array of Integers)
  • with_drafts (true, false) (defaults to: false) —

    (only shows drafts of current user)

Returns:

  • (Array of Acts) 


46
47
48
49
50
 
# File 'mod/history/lib/card/act.rb', line 46

def all_with_actions_on card_ids, with_drafts=false
  sql = "card_actions.card_id IN (:card_ids) AND (draft is not true"
  sql << (with_drafts ? " OR actor_id = :user_id)" : ")")
  all_viewable([sql, { card_ids: card_ids, user_id: Card::Auth.current_id }])
end

.cache ⇒ Object 



60
61
62
 
# File 'mod/history/lib/card/act.rb', line 60

def cache
  Card::Cache[Card::Act]
end

.delete_actionless ⇒ Object

remove all acts that have no action. (janitorial)



34
35
36
37
38
39
40
 
# File 'mod/history/lib/card/act.rb', line 34

def delete_actionless
  joins(
    "LEFT JOIN card_actions ON card_acts.id = card_act_id"
  ).where(
    "card_actions.id is null"
  ).delete_all
end

.delete_cardless ⇒ Object

remove all acts that have no card. (janitorial)

CAREFUL - could still have actions even if act card is gone…



28
29
30
31
 
# File 'mod/history/lib/card/act.rb', line 28

def delete_cardless
  left_join = "LEFT JOIN cards ON card_acts.card_id = cards.id"
  joins(left_join).where("cards.id IS NULL").delete_all
end

.timestamp_attributes_for_create ⇒ Object

used by rails time_ago timestamp is set by rails on create



66
67
68
 
# File 'mod/history/lib/card/act.rb', line 66

def timestamp_attributes_for_create
  super << "acted_at"
end

Instance Method Details

#action_on(card_id) ⇒ Card::Action

act’s action on the card in question

Parameters:

  • card_id (Integer)

Returns:



97
98
99
100
101
 
# File 'mod/history/lib/card/act.rb', line 97

def action_on card_id
  actions.find do |action|
    action.card_id == card_id && !action.draft
  end
end

#actions(cached = true) ⇒ Array

list of all actions that are part of the act

Returns:

  • (Array) 


88
89
90
91
92
 
# File 'mod/history/lib/card/act.rb', line 88

def actions cached=true
  return ar_actions unless cached

  self.class.cache.fetch("#{id}-actions") { ar_actions.find_all.to_a }
end

#actions_affecting(card) ⇒ Array of Actions

act’s actions on either the card itself or another card that includes it

Parameters:

Returns:

  • (Array of Actions) 


122
123
124
125
126
127
 
# File 'mod/history/lib/card/act.rb', line 122

def actions_affecting card
  actions.select do |action|
    (card.id == action.card_id) ||
      card.history_card_ids.include?(action.card_id)
  end
end

#actor ⇒ Object 



71
72
73
 
# File 'mod/history/lib/card/act.rb', line 71

def actor
  Card.fetch actor_id
end

#card ⇒ Card

the act’s primary card

Returns:



82
83
84
 
# File 'mod/history/lib/card/act.rb', line 82

def card
  Card.fetch card_id, look_in_trash: true
end

#card_id ⇒ Object

sometimes Object#card_id interferes with default ActiveRecord attribute def



76
77
78
 
# File 'mod/history/lib/card/act.rb', line 76

def card_id
  _read_attribute "card_id"
end

#draft? ⇒ Boolean

Returns:

  • (Boolean) 


109
110
111
 
# File 'mod/history/lib/card/act.rb', line 109

def draft?
  main_action&.draft
end

#elapsed_time ⇒ String

time (in words) since act took place

Returns:

  • (String) 


115
116
117
 
# File 'mod/history/lib/card/act.rb', line 115

def elapsed_time
  DateTime.new(acted_at).distance_of_time_in_words_to_now
end

#main_action ⇒ Card::Action

act’s action on primary card if it exists. otherwise act’s first action

Returns:



105
106
107
 
# File 'mod/history/lib/card/act.rb', line 105

def main_action
  action_on(card_id) || actions.first
end