RubyGems - task-manager - Versions diffs - 0.1.1 - Mend

task-manager 0.1.1

Files changed (69) hide show

data/app/models/task_manager/task.rb ADDED Viewed

@@ -0,0 +1,81 @@
+# -*- encoding: utf-8 -*-
+module TaskManager
+  class Task < ActiveRecord::Base
+    extend Enumerize
+    has_one :assignable, as: :target
+    has_many :callables, as: :target
+    enumerize :task_type, in: [:daily, :weekly, :monthly, :quarterly, :yearly]
+    enumerize :status, in: [:new, :in_process, :expired, :finished]
+    serialize :data, ActiveRecord::Coders::Hstore
+    default_value_for :status, :new
+    attr_accessible :data, :deadline, :name, :reminding_at, :status, :task_type, :finished_at
+    validates_presence_of :name, :task_type, :status, :assignable, :deadline
+    def assignee
+      assignable.assignee
+    end
+    def callbacks
+      callables.collect(&:callback)
+    end
+    def remindable?
+      return false if reminding_at.nil?
+      (status == :new || status == :in_process) &&
+        (deadline - reminding_at) / 60 >= 2 * 24 * 60 * 60
+    end
+    def next_reminding_at
+      if remindable?
+        seconds = (deadline - reminding_at) / 60
+        reminding_at.since(seconds)
+      end
+    end
+    # 提醒任务执行者，任务即将到期，并且修改任务下次提醒时间。
+    # 如果`next_reminding_at`返回`nil`，则表示该任务不再需要提醒。
+    def remind
+      Task.transaction do
+        assignee.remind_of_expiring_task(self) if assignee.respond_to?(:remind_of_expiring_task)
+        update_attributes!(reminding_at: next_reminding_at)
+      end
+    end
+    def expire
+      Task.transaction do
+        callbacks.each do |c|
+          c.call(self) if c.respond_to?(:call)
+        end
+        update_attributes!(status: :expired)
+      end
+    end
+    def finish
+      update_attributes(finished_at: Time.now, status: :finished)
+    end
+    class << self
+      def active
+        where("status = ? OR status = ?", :new, :in_process)
+      end
+      def just_expired
+        active.where("deadline <= ?", Time.now)
+      end
+      def remindable
+        active.where("reminding_at <= ?", Time.now)
+      end
+    end
+  end
+end

data/app/serializers/task_manager/plan_serializer.rb ADDED Viewed

@@ -0,0 +1,8 @@
+module TaskManager
+  class PlanSerializer < ActiveModel::Serializer
+    attributes :id, :name, :plan_type, :data, :enabled_at,
+      :begin_to_remind, :autocompletable, :created_at, :updated_at
+    has_many :assignees
+  end
+end

data/app/serializers/task_manager/task_serializer.rb ADDED Viewed

@@ -0,0 +1,8 @@
+module TaskManager
+  class TaskSerializer < ActiveModel::Serializer
+    attributes :id, :name, :task_type, :data, :status,
+      :deadline, :created_at, :updated_at
+    has_one :assignee
+  end
+end

data/app/views/layouts/task-manager/application.html.erb ADDED Viewed

@@ -0,0 +1,14 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <title>TaskManager</title>
+  <%= stylesheet_link_tag    "task-manager/application", :media => "all" %>
+  <%= javascript_include_tag "task-manager/application" %>
+  <%= csrf_meta_tags %>
+</head>
+<body>
+<%= yield %>
+</body>
+</html>

data/config/routes.rb ADDED Viewed

@@ -0,0 +1,8 @@
+TaskManager::Engine.routes.draw do
+  namespace :api, defaults: { format: 'json' } do
+    scope module: :v1, constraints: TaskManager::ApiConstraints.new(version: 1, default: true) do
+      resources :plans, only: [:index, :create, :update, :destroy]
+      resources :tasks, only: [:index, :destroy]
+    end
+  end
+end

data/db/migrate/20121102054723_setup_hstore.rb ADDED Viewed

@@ -0,0 +1,9 @@
+class SetupHstore < ActiveRecord::Migration
+  def self.up
+    execute "CREATE EXTENSION IF NOT EXISTS hstore"
+  end
+  def self.down
+    execute "DROP EXTENSION IF EXISTS hstore"
+  end
+end

data/db/migrate/20121102055137_create_task_manager_plans.rb ADDED Viewed

@@ -0,0 +1,16 @@
+class CreateTaskManagerPlans < ActiveRecord::Migration
+  def change
+    create_table :task_manager_plans do |t|
+      t.string :name
+      t.hstore :data
+      t.boolean :autocompletable
+      t.string :plan_type
+      t.integer :begin_to_remind
+      t.timestamp :enabled_at
+      t.timestamp :last_task_created_at
+      t.timestamps
+    end
+  end
+end

data/db/migrate/20121102142657_create_task_manager_assignables.rb ADDED Viewed

@@ -0,0 +1,13 @@
+class CreateTaskManagerAssignables < ActiveRecord::Migration
+  def change
+    create_table :task_manager_assignables do |t|
+      t.belongs_to :target, polymorphic: true
+      t.belongs_to :assignee, polymorphic: true
+      t.timestamps
+    end
+    add_index :task_manager_assignables, [:assignee_id, :assignee_type]
+    add_index :task_manager_assignables, [:target_id, :target_type]
+  end
+end

data/db/migrate/20121102150720_create_task_manager_callables.rb ADDED Viewed

@@ -0,0 +1,13 @@
+class CreateTaskManagerCallables < ActiveRecord::Migration
+  def change
+    create_table :task_manager_callables do |t|
+      t.belongs_to :callback, polymorphic: true
+      t.belongs_to :target, polymorphic: true
+      t.timestamps
+    end
+    add_index :task_manager_callables, [:callback_id, :callback_type]
+    add_index :task_manager_callables, [:target_id, :target_type]
+  end
+end

data/db/migrate/20121105170602_create_task_manager_tasks.rb ADDED Viewed

@@ -0,0 +1,18 @@
+class CreateTaskManagerTasks < ActiveRecord::Migration
+  def change
+    create_table :task_manager_tasks do |t|
+      t.string :name
+      t.string :task_type
+      t.string :status
+      t.hstore :data
+      t.timestamp :deadline
+      t.timestamp :reminding_at
+      t.timestamp :finished_at
+      t.timestamps
+    end
+  end
+end

data/lib/task-manager.rb ADDED Viewed

@@ -0,0 +1,37 @@
+# -*- encoding: utf-8 -*-
+require "enumerize"
+require "default_value_for"
+require "active_model_serializers"
+require "task-manager/api_constraints"
+require "task-manager/engine"
+require "task-manager/deadline_calculator"
+require "task-manager/deadline_validator"
+module TaskManager
+  # 创建计划任务
+  #
+  # 首先，获取所有需要生成计划任务的计划，参见{TaskManager::Plan.active}。
+  # 然后调用{TaskManager::Plan#generate_tasks}生成计划任务。
+  def self.generate_tasks
+    Plan.active.collect(&:generate_tasks).flatten
+  end
+  # 找到刚刚过期的计划任务，然后调用{TaskManager::Task#expire}。
+  def self.expire_tasks
+    tasks = Task.just_expired
+    tasks.each(&:expire)
+    tasks
+  end
+  # 通知任务执行者，任务即将到期。参见{TaskManager::Task#remind}
+  def self.remind_assignees_of_expiring_tasks
+    tasks = Task.remindable
+    tasks.each(&:remind)
+    tasks
+  end
+end

data/lib/task-manager/api_constraints.rb ADDED Viewed

@@ -0,0 +1,12 @@
+module TaskManager
+  class ApiConstraints
+    def initialize(options)
+      @version = options[:version]
+      @default = options[:default]
+    end
+    def matches?(req)
+      @default || req.headers['Accept'].include?("application/vnd.menglifang.com.cn; version=#{@version}")
+    end
+  end
+end

data/lib/task-manager/deadline_calculator.rb ADDED Viewed

@@ -0,0 +1,22 @@
+module TaskManager
+  module DeadlineCalculator
+    def calculate_deadline(type, opts)
+      type = convert_type(type)
+      opts.symbolize_keys!
+      beginning = Time.now.send("beginning_of_#{type}")
+      beginning.
+        months_since(opts[:deadline_month].to_i).
+        since(opts[:deadline_day].to_i * 24 * 60 * 60).
+        since(opts[:deadline_hour].to_i * 60 * 60).
+        since(opts[:deadline_minute].to_i * 60)
+    end
+    private
+    def convert_type(type)
+      return :day if type.to_sym == :daily
+      type.to_s.gsub(/ly/, '').to_sym
+    end
+  end
+end

data/lib/task-manager/deadline_validator.rb ADDED Viewed

@@ -0,0 +1,27 @@
+class DeadlineValidator < ActiveModel::EachValidator
+  def validate_each(record, attribute, value)
+    type = get_type(record)
+    if type.blank?
+      record.errors[:type] << (options[:message] || 'invalid type')
+    else
+      record.errors[attribute] << (options[:message] || "deadline_hour is required") if value.blank? || value[:deadline_hour].blank?
+      record.errors[attribute] << (options[:message] || "deadline_minute is required") if value.blank? || value[:deadline_minute].blank?
+      case type.to_sym
+      when :weekly, :monthly
+        record.errors[attribute] << (options[:message] || "deadline_day is required in a #{type} plan") if value.blank? || value[:deadline_day].blank?
+      when :quarterly, :yearly
+        record.errors[attribute] << (options[:message] || "deadline_month is required in a #{type} plan") if value.blank? || value[:deadline_month].blank?
+        record.errors[attribute] << (options[:message] || "deadline_day is required in a #{type} plan") if value.blank? || value[:deadline_day].blank?
+      else
+        record.errors[attribute] << (options[:message] || "invalid type!") unless type.to_sym == :daily
+      end
+    end
+  end
+  def get_type(record)
+    return record.type if record.respond_to?(:type)
+    record.send("#{record.class.name.demodulize.underscore}_type")
+  end
+end

data/lib/task-manager/engine.rb ADDED Viewed

@@ -0,0 +1,5 @@
+module TaskManager
+  class Engine < ::Rails::Engine
+    isolate_namespace TaskManager
+  end
+end

data/lib/task-manager/version.rb ADDED Viewed

@@ -0,0 +1,3 @@
+module TaskManager
+  VERSION = "0.1.1"
+end

data/lib/tasks/task-manager_tasks.rake ADDED Viewed

@@ -0,0 +1,4 @@
+# desc "Explaining what the task does"
+# task :task-manager do
+#   # Task goes here
+# end

metadata ADDED Viewed

@@ -0,0 +1,327 @@
+--- !ruby/object:Gem::Specification
+name: task-manager
+version: !ruby/object:Gem::Version
+  version: 0.1.1
+  prerelease:
+platform: ruby
+authors:
+- Beijing Menglifang Network Science and Technology CO.,Ltd.
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2012-11-26 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rails
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 3.2.8
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 3.2.8
+- !ruby/object:Gem::Dependency
+  name: ransack
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: kaminari
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: activerecord-postgres-hstore
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.4.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.4.1
+- !ruby/object:Gem::Dependency
+  name: enumerize
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.5.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.5.0
+- !ruby/object:Gem::Dependency
+  name: default_value_for
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.0.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.0.1
+- !ruby/object:Gem::Dependency
+  name: active_model_serializers
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.6.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.6.0
+- !ruby/object:Gem::Dependency
+  name: pg
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec-rails
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: factory_girl_rails
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: pry
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: shoulda-matchers
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: fivemat
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: TaskManager can help you to manage your routine tasks effectually.
+email:
+- dev@menglifang.org
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- app/assets/images/task-manager/icons/add.png
+- app/assets/images/task-manager/icons/delete.png
+- app/assets/images/task-manager/icons/edit.png
+- app/assets/javascripts/task-manager/application.js
+- app/assets/javascripts/task-manager/extjs/app/controller/Plans.js
+- app/assets/javascripts/task-manager/extjs/app/controller/Tasks.js
+- app/assets/javascripts/task-manager/extjs/app/helper/application_helper.js
+- app/assets/javascripts/task-manager/extjs/app/model/Assignee.js
+- app/assets/javascripts/task-manager/extjs/app/model/Plan.js
+- app/assets/javascripts/task-manager/extjs/app/model/Task.js
+- app/assets/javascripts/task-manager/extjs/app/store/Assignees.js
+- app/assets/javascripts/task-manager/extjs/app/store/AssigneesTree.js
+- app/assets/javascripts/task-manager/extjs/app/store/Booleans.js
+- app/assets/javascripts/task-manager/extjs/app/store/Days.js
+- app/assets/javascripts/task-manager/extjs/app/store/Hours.js
+- app/assets/javascripts/task-manager/extjs/app/store/Minutes.js
+- app/assets/javascripts/task-manager/extjs/app/store/Months.js
+- app/assets/javascripts/task-manager/extjs/app/store/Plans.js
+- app/assets/javascripts/task-manager/extjs/app/store/QuarterlyMonths.js
+- app/assets/javascripts/task-manager/extjs/app/store/Statuses.js
+- app/assets/javascripts/task-manager/extjs/app/store/Tasks.js
+- app/assets/javascripts/task-manager/extjs/app/store/Types.js
+- app/assets/javascripts/task-manager/extjs/app/store/WeekDays.js
+- app/assets/javascripts/task-manager/extjs/app/view/plan/AssignablesWindow.js
+- app/assets/javascripts/task-manager/extjs/app/view/plan/Edit.js
+- app/assets/javascripts/task-manager/extjs/app/view/plan/EditWindow.js
+- app/assets/javascripts/task-manager/extjs/app/view/plan/Grid.js
+- app/assets/javascripts/task-manager/extjs/app/view/plan/Index.js
+- app/assets/javascripts/task-manager/extjs/app/view/plan/New.js
+- app/assets/javascripts/task-manager/extjs/app/view/plan/Search.js
+- app/assets/javascripts/task-manager/extjs/app/view/plan/SelectAssignables.js
+- app/assets/javascripts/task-manager/extjs/app/view/plan/SelectAssignablesGrid.js
+- app/assets/javascripts/task-manager/extjs/app/view/plan/SelectAssignablesTree.js
+- app/assets/javascripts/task-manager/extjs/app/view/plan/Window.js
+- app/assets/javascripts/task-manager/extjs/app/view/task/Grid.js
+- app/assets/javascripts/task-manager/extjs/app/view/task/Index.js
+- app/assets/javascripts/task-manager/extjs/app/view/task/Search.js
+- app/assets/javascripts/task-manager/extjs/lib/ux/MultiSelectablePagingGrid.js
+- app/assets/javascripts/task-manager/extjs/lib/ux/RowExpander.js
+- app/assets/stylesheets/task-manager/application.css.scss
+- app/assets/stylesheets/task-manager/extjs.css.scss
+- app/controllers/task_manager/api/v1/plans_controller.rb
+- app/controllers/task_manager/api/v1/tasks_controller.rb
+- app/controllers/task_manager/application_controller.rb
+- app/helpers/task_manager/application_helper.rb
+- app/models/task_manager/assignable.rb
+- app/models/task_manager/callable.rb
+- app/models/task_manager/plan.rb
+- app/models/task_manager/task.rb
+- app/serializers/task_manager/plan_serializer.rb
+- app/serializers/task_manager/task_serializer.rb
+- app/views/layouts/task-manager/application.html.erb
+- config/routes.rb
+- db/migrate/20121102054723_setup_hstore.rb
+- db/migrate/20121102055137_create_task_manager_plans.rb
+- db/migrate/20121102142657_create_task_manager_assignables.rb
+- db/migrate/20121102150720_create_task_manager_callables.rb
+- db/migrate/20121105170602_create_task_manager_tasks.rb
+- lib/task-manager/api_constraints.rb
+- lib/task-manager/deadline_calculator.rb
+- lib/task-manager/deadline_validator.rb
+- lib/task-manager/engine.rb
+- lib/task-manager/version.rb
+- lib/task-manager.rb
+- lib/tasks/task-manager_tasks.rake
+- MIT-LICENSE
+- Rakefile
+- README.md
+homepage: https://github.com/menglifang/task-manager
+licenses: []
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+      segments:
+      - 0
+      hash: 3200132327859687953
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+      segments:
+      - 0
+      hash: 3200132327859687953
+requirements: []
+rubyforge_project:
+rubygems_version: 1.8.24
+signing_key:
+specification_version: 3
+summary: With TaskManager, you can manage and trace your routine tasks.
+test_files: []