decidim-time_tracker 0.3

data/app/models/decidim/time_tracker/task.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+module Decidim
+  module TimeTracker
+    # The data store for a Task in the Decidim::TimeTracker component.
+    class Task < ApplicationRecord
+      include Decidim::Traceable
+      include Decidim::Loggable
+
+      self.table_name = :decidim_time_tracker_tasks
+
+      belongs_to :time_tracker,
+                 class_name: "Decidim::TimeTracker::TimeTracker"
+
+      has_many :activities,
+               class_name: "Decidim::TimeTracker::Activity",
+               dependent: :destroy
+
+      delegate :questionnaire, to: :time_tracker
+      delegate :component, to: :time_tracker
+
+      def starts_at
+        activities.order(start_date: :asc).first&.start_date
+      end
+
+      def ends_at
+        activities.order(end_date: :desc).first&.end_date
+      end
+
+      def assignations_count(filter: :accepted)
+        assignations = Assignation.where(activity: activities).send(filter)
+        assignations.count
+      end
+
+      def user_is_assignation?(user, filter: :accepted)
+        Assignation.where(user: user, activity: activities).send(filter).any?
+      end
+
+      def self.log_presenter_class_for(_log)
+        Decidim::TimeTracker::AdminLog::TaskPresenter
+      end
+    end
+  end
+end

data/app/models/decidim/time_tracker/time_event.rb

@@ -0,0 +1,62 @@
+# frozen_string_literal: true
+
+module Decidim
+  module TimeTracker
+    # The data store for a time entry in the Decidim::TimeTracker component.
+    class TimeEvent < ApplicationRecord
+      self.table_name = :decidim_time_tracker_time_events
+
+      belongs_to :assignation,
+                 class_name: "Decidim::TimeTracker::Assignation"
+
+      belongs_to :activity,
+                 class_name: "Decidim::TimeTracker::Activity"
+
+      belongs_to :user,
+                 foreign_key: "decidim_user_id",
+                 class_name: "Decidim::User"
+
+      # note that with the default order reversed
+      # the "last" element needs to be found with .first
+      default_scope { order(start: :desc) }
+      scope :started_between, ->(start_date, end_date) { where("start >= ? AND start <= ?", start_date.to_i, end_date.to_i) }
+
+      # rubocop:disable Rails/FindBy
+      def self.last_for(user)
+        if user.is_a?(Assignation)
+          where(assignation: user).first
+        else
+          where(user: user).first
+        end
+      end
+      # rubocop:enable Rails/FindBy
+
+      # number of seconds since the counting started
+      # zero if activity is stopped
+      def seconds_elapsed
+        return 0 if stopped?
+        return 0 if start.blank?
+
+        @seconds_elapsed ||= Time.current.to_i - start.to_i
+      end
+
+      def stopped?
+        stop.to_i >= start
+      end
+
+      def start_time
+        Time.zone.at start
+      end
+
+      def stop_time
+        Time.zone.at stop
+      end
+
+      def stop!
+        self.stop = Time.current.to_i
+        self.total_seconds = stop - start
+        save!
+      end
+    end
+  end
+end

data/app/models/decidim/time_tracker/time_tracker.rb

@@ -0,0 +1,46 @@
+# frozen_string_literal: true
+
+module Decidim
+  module TimeTracker
+    class TimeTracker < ApplicationRecord
+      include Decidim::HasComponent
+      include Decidim::Forms::HasQuestionnaire
+      include Decidim::Traceable
+      include Decidim::Loggable
+
+      self.table_name = :decidim_time_trackers
+
+      component_manifest_name "time_tracker"
+
+      has_many :tasks,
+               class_name: "Decidim::TimeTracker::Task",
+               dependent: :destroy
+
+      has_many :activities,
+               class_name: "Decidim::TimeTracker::Activity",
+               through: :tasks
+
+      has_many :assignations,
+               class_name: "Decidim::TimeTracker::Assignation",
+               through: :activities
+
+      has_one :assignee_data,
+              class_name: "Decidim::TimeTracker::AssigneeData"
+
+      has_one :assignee_questionnaire,
+              source: :questionnaire,
+              through: :assignee_data,
+              class_name: "Decidim::Forms::Questionnaire"
+
+      def has_questions?
+        questionnaire.questions.any?
+      end
+
+      def has_assignee_questions?
+        assignee_data.questionnaire.questions.any?
+      end
+
+      alias activity_questionnaire questionnaire
+    end
+  end
+end

data/app/models/decidim/time_tracker/tos_acceptance.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module Decidim
+  module TimeTracker
+    # The data store for terms of service acceptance in the Decidim::TimeTracker component.
+    class TosAcceptance < ApplicationRecord
+      self.table_name = :decidim_time_tracker_tos_acceptances
+
+      belongs_to :assignee,
+                 class_name: "Decidim::TimeTracker::Assignee"
+
+      belongs_to :time_tracker,
+                 class_name: "Decidim::TimeTracker::TimeTracker"
+    end
+  end
+end

data/app/permissions/decidim/time_tracker/admin/permissions.rb

@@ -0,0 +1,69 @@
+# frozen_string_literal: true
+
+module Decidim
+  module TimeTracker
+    module Admin
+      class Permissions < Decidim::DefaultPermissions
+        def permissions
+          return permission_action if permission_action.scope != :admin
+
+          allowed_task_action?
+          allowed_questionnaire_action?
+          allowed_activity_action?
+          allowed_assignation_action?
+
+          permission_action
+        end
+
+        def allowed_task_action?
+          return unless permission_action.subject.in? [:task, :tasks]
+
+          case permission_action.action
+          when :index, :create, :update, :destroy
+            permission_action.allow!
+          end
+        end
+
+        def allowed_questionnaire_action?
+          return unless permission_action.subject.in? [:questionnaire, :questionnaire_answers]
+
+          if permission_action.subject == :questionnaire
+            case permission_action.action
+            when :export_answers, :update, :preview
+              permission_action.allow!
+            end
+          elsif permission_action.subject == :questionnaire_answers
+            case permission_action.action
+            when :show, :index, :export_response
+              permission_action.allow!
+            end
+          end
+        end
+
+        def allowed_activity_action?
+          return unless permission_action.subject.in? [:activity, :activities]
+
+          case permission_action.action
+          when :index, :create, :update, :destroy
+            permission_action.allow!
+          end
+        end
+
+        def allowed_assignation_action?
+          return unless permission_action.subject.in? [:assignation, :assignations]
+
+          case permission_action.action
+          when :update
+            permission_action.allow! if assignation.can_change_status?
+          when :index, :create, :destroy
+            permission_action.allow!
+          end
+        end
+
+        def assignation
+          @assignation ||= context.fetch(:assignation, nil)
+        end
+      end
+    end
+  end
+end

data/app/permissions/decidim/time_tracker/permissions.rb

@@ -0,0 +1,69 @@
+# frozen_string_literal: true
+
+module Decidim
+  module TimeTracker
+    class Permissions < Decidim::DefaultPermissions
+      def permissions
+        # for the moment, we let public views for milestones
+        allow! if permission_action.subject == :milestone && permission_action.action == :show
+
+        return permission_action unless user
+
+        return Decidim::TimeTracker::Admin::Permissions.new(user, permission_action, context).permissions if permission_action.scope == :admin
+
+        case permission_action.subject
+        when :questionnaire
+          allow_answer?
+        when :assignation
+          allow_assignation?
+        when :milestone
+          allow_milestone?
+        else
+          allow!
+        end
+
+        permission_action
+      end
+
+      def allow_answer?
+        return unless permission_action.action == :answer
+
+        allow! if current_component&.published?
+      end
+
+      def allow_assignation?
+        return allow! unless activity
+
+        if permission_action.action == :create
+          return if activity.has_assignation? user
+
+          return unless activity.status.in? [:open, :not_started]
+
+          allow!
+        end
+      end
+
+      def allow_milestone?
+        return unless activity
+
+        if permission_action.action == :create
+          return unless activity.assignation_accepted? user
+
+          return if activity.status.in? [:inactive]
+
+          allow!
+        end
+      end
+
+      private
+
+      def activity
+        @activity ||= context.fetch(:activity, nil)
+      end
+
+      def current_component
+        @current_component ||= context.fetch(:current_component, nil)
+      end
+    end
+  end
+end

data/app/presenters/decidim/time_tracker/admin_log/activity_presenter.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+module Decidim
+  module TimeTracker
+    module AdminLog
+      # This class holds the logic to present a `Decidim::TimeTracker::Activity`
+      # for the `AdminLog` log.
+      #
+      # Usage should be automatic and you shouldn't need to call this class
+      # directly, but here's an example:
+      #
+      #    action_log = Decidim::ActionLog.last
+      #    view_helpers # => this comes from the views
+      #    ActivityPresenter.new(action_log, view_helpers).present
+      class ActivityPresenter < Decidim::Log::BasePresenter
+        private
+
+        def diff_fields_mapping
+          {
+            description: :i18n,
+            active: :boolean
+          }
+        end
+
+        def i18n_labels_scope
+          "activemodel.attributes.time_tracker.activity"
+        end
+
+        def action_string
+          case action
+          when "create", "delete", "update"
+            "decidim.time_tracker.admin_log.activity.#{action}"
+          else
+            super
+          end
+        end
+
+        def has_diff?
+          action == "delete" || super
+        end
+      end
+    end
+  end
+end

data/app/presenters/decidim/time_tracker/admin_log/assignation_presenter.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+module Decidim
+  module TimeTracker
+    module AdminLog
+      # This class holds the logic to present a `Decidim::TimeTracker::Assignation`
+      # for the `AdminLog` log.
+      #
+      # Usage should be automatic and you shouldn't need to call this class
+      # directly, but here's an example:
+      #
+      #    action_log = Decidim::ActionLog.last
+      #    view_helpers # => this comes from the views
+      #    AssignationPresenter.new(action_log, view_helpers).present
+      class AssignationPresenter < Decidim::Log::BasePresenter
+        private
+
+        def diff_fields_mapping
+          {
+            status: :string,
+            decidim_user_id: :user,
+            activity_id: "Decidim::TimeTracker::AdminLog::ValueTypes::ActivityPresenter",
+            invited_at: :date,
+            invited_by_user: :user,
+            requested_at: :date
+          }
+        end
+
+        def i18n_labels_scope
+          "activemodel.attributes.time_tracker.assignation"
+        end
+
+        def action_string
+          case action
+          when "create", "delete", "update"
+            "decidim.time_tracker.admin_log.assignation.#{action}"
+          else
+            super
+          end
+        end
+
+        def has_diff?
+          action == "delete" || super
+        end
+      end
+    end
+  end
+end

data/app/presenters/decidim/time_tracker/admin_log/task_presenter.rb

@@ -0,0 +1,46 @@
+# frozen_string_literal: true
+
+module Decidim
+  module TimeTracker
+    module AdminLog
+      # This class holds the logic to present a `Decidim::TimeTracker::Task`
+      # for the `AdminLog` log.
+      #
+      # Usage should be automatic and you shouldn't need to call this class
+      # directly, but here's an example:
+      #
+      #    action_log = Decidim::ActionLog.last
+      #    view_helpers # => this comes from the views
+      #    TaskPresenter.new(action_log, view_helpers).present
+      class TaskPresenter < Decidim::Log::BasePresenter
+        private
+
+        def diff_fields_mapping
+          {
+            name: :i18n,
+            time_tracker_id: "Decidim::TimeTracker::AdminLog::ValueTypes::TimeTrackerPresenter",
+            active: :boolean,
+            updated_at: :date
+          }
+        end
+
+        def i18n_labels_scope
+          "activemodel.attributes.time_tracker.task"
+        end
+
+        def action_string
+          case action
+          when "create", "delete", "update"
+            "decidim.time_tracker.admin_log.task.#{action}"
+          else
+            super
+          end
+        end
+
+        def has_diff?
+          action == "delete" || super
+        end
+      end
+    end
+  end
+end