task-manager 0.1.2 → 0.1.3

data/README.md

@@ -1,4 +1,139 @@
 TaskManager
 -----------
 
-This project rocks and uses MIT-LICENSE.
+[![Build Status](https://secure.travis-ci.org/menglifang/task-manager.png?branch=develop)](http://travis-ci.org/menglifang/task-manager)
+[![Dependency Status](https://gemnasium.com/menglifang/task-manager.png)](https://gemnasium.com/menglifang/task-manager)
+[![Code Climate](https://codeclimate.com/badge.png)](https://codeclimate.com/github/menglifang/task-manager)
+
+TaskManager是一个可挂载的Rails引擎（Mountable Rails
+Engine），因此您可以在Rails应用中通过挂载的方式来使用。另外，TaskManager使用了PostgreSQL的hstore特性，因此TaskManager只能工作在PostgreSQL数据库之上。
+
+屁话：鉴于PostgreSQL的宽松的免费使用政策，以及其越来越出色的性能，强烈建议您使用之。
+
+### 依赖
+
+* PostgreSQL数据库
+
+  ```bash
+  # Ubuntu
+  sudo apt-get install postgresql-contrib
+  ```
+
+### 安装
+
+* 安装Gem包
+
+  在您的Rails应用程序的Gemfile文件中添加：
+
+  ```ruby
+  gem 'task-manager', '~>0.1.3'
+  ```
+
+  然后，运行`bundle install`。
+
+* 创建数据库表
+
+  * 生成数据库迁移文件
+
+  ```bash
+  rake task_manager:install:migrations
+  ```
+
+  * 创建数据库表
+
+  ```bash
+  rake db:migrate
+  ```
+
+### 使用说明
+
+#### 挂载TaskManager API
+
+编辑`config/routes.rb`文件，在其中挂载TaskManager路由。
+
+```ruby
+mount TaskManager::Engine => "/task-manager"
+```
+
+使用`rake
+routes`命令，检查是否正常挂载成功。如果挂载成功，命令行中将会有如下输出：
+
+```
+Routes for TaskManager::Engine:
+api_plans GET    /api/plans(.:format)     task_manager/api/v1/plans#index {:format=>"json"}
+          POST   /api/plans(.:format)     task_manager/api/v1/plans#create {:format=>"json"}
+api_plan  PUT    /api/plans/:id(.:format) task_manager/api/v1/plans#update {:format=>"json"}
+          DELETE /api/plans/:id(.:format) task_manager/api/v1/plans#destroy {:format=>"json"}
+api_tasks GET    /api/tasks(.:format)     task_manager/api/v1/tasks#index {:format=>"json"}
+api_task  DELETE /api/tasks/:id(.:format) task_manager/api/v1/tasks#destroy {:format=>"json"}
+```
+
+详细的接口使用说明请查看[TaskManager
+API文档](http://rdoc.info/github/menglifang/task-manager/master/TaskManager/Api/V1)
+
+#### 界面
+
+##### ExtJS
+
+* 导入资源文件
+
+在`app/assets/javascripts/application.js`文件中添加：
+
+```javascript
+// 代码需要放置在导入ExtJS库之后
+//= require task-manager/extjs
+```
+
+在`app/assets/stylesheets/application.css`文件中添加：
+
+```css
+/*= require task-manager/extjs */
+```
+
+### 开发指南
+
+* 安装依赖包
+
+```bash
+bundle install
+```
+
+* 创建数据库
+
+```bash
+cd path/to/task-manager/spec/dummy
+
+# 说明：需要根据您安装的数据库设置，修改path/to/task-manager/spec/dummy/config/database.yml中的相应配置
+
+# 创建开发数据库
+rake db:create db:migrate db:seed RAILS_ENV=development
+
+# 创建测试数据库
+rake db:create db:migrate db:seed RAILS_ENV=test
+```
+
+* 运行后端测试（Ruby）
+
+```bash
+cd path/to/task-manager
+rake
+```
+
+* 运行前端测试（Javascript)
+
+```bash
+cd path/to/task-manager/spec/dummy
+rails s
+```
+
+然后，打开浏览器访问：[http://localhost:3000/siesta](http://localhost:3000/siesta)。
+待页面打开后，点击打开页面的运行按钮进行前端测试。
+
+* 查看Demo应用
+
+```bash
+cd path/to/task-manager/spec/dummy
+rails s
+```
+
+然后，打开浏览器访问：[http://localhost:3000/extjs](http://localhost:3000/extjs)。

data/Rakefile

@@ -4,24 +4,10 @@ begin
 rescue LoadError
   puts 'You must `gem install bundler` and `bundle install` to run rake tasks'
 end
-begin
-  require 'rdoc/task'
-rescue LoadError
-  require 'rdoc/rdoc'
-  require 'rake/rdoctask'
-  RDoc::Task = Rake::RDocTask
-end
-
-RDoc::Task.new(:rdoc) do |rdoc|
-  rdoc.rdoc_dir = 'rdoc'
-  rdoc.title    = 'TaskManager'
-  rdoc.options << '--line-numbers'
-  rdoc.rdoc_files.include('README.rdoc')
-  rdoc.rdoc_files.include('lib/**/*.rb')
-end
-
-
 
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new(:spec)
+task :default => :spec
 
 Bundler::GemHelper.install_tasks
 

data/app/assets/javascripts/task-manager/{application.js → extjs.js}

@@ -8,17 +8,12 @@
 //
 //= require_self
 //
+//= require ./extjs/app/view/assignee/TreeCombo
 //= require ./extjs/app/view/task/Search
 //= require ./extjs/app/view/task/Grid
 //= require ./extjs/app/view/task/Index
-//= require ./extjs/app/view/plan/SelectAssignablesTree
-//= require ./extjs/app/view/plan/SelectAssignablesGrid
-//= require ./extjs/app/view/plan/SelectAssignables 
-//= require ./extjs/app/view/plan/AssignablesWindow 
-//= require ./extjs/app/view/plan/Edit
-//= require ./extjs/app/view/plan/EditWindow
-//= require ./extjs/app/view/plan/New
-//= require ./extjs/app/view/plan/Window
+//= require ./extjs/app/view/plan/Form
+//= require ./extjs/app/view/plan/FormWindow
 //= require ./extjs/app/view/plan/Search
 //= require ./extjs/app/view/plan/Grid
 //= require ./extjs/app/view/plan/Index
@@ -29,7 +24,6 @@
 Ext.data.StoreManager.register(
 	Ext.create('TM.store.Tasks', { storeId: 'TM.store.Tasks'}),
   Ext.create('TM.store.Assignees', { storeId: 'TM.store.Assignees'}),
-  Ext.create('TM.store.AssigneesTree', { storeId: 'TM.store.AssigneesTree'}),
   Ext.create('TM.store.WeekDays', { storeId: 'TM.store.WeekDays'}),
   Ext.create('TM.store.QuarterlyMonths', { storeId: 'TM.store.QuarterlyMonths'}),
   Ext.create('TM.store.Months', { storeId: 'TM.store.Months'}),

data/app/assets/javascripts/task-manager/extjs/app/controller/Plans.js

@@ -2,9 +2,7 @@ Ext.define('TM.controller.Plans', {
   extend: 'Ext.app.Controller',
 
   views: [
-    'plan.Index',
-    'plan.AssignablesWindow'
-
+    'plan.Index'
   ],
 
   models: [
@@ -16,35 +14,11 @@ Ext.define('TM.controller.Plans', {
     ref: 'searchForm',
     selector: 'plan_search'
   }, {
-    ref: 'planWindow',
-    selector: 'plan_window'
-  }, {
-    ref: 'planNew',
-    selector: 'plan_new'
-  }, {
-    ref: 'planEditWindow',
-    selector: 'plan_editwindow'
-  }, {
-    ref: 'planEdit',
-    selector: 'plan_edit'
-  }, {
-    ref: 'planType',
-    selector: 'plan_new combo[name="plan_type"]'
-  }, {
-    ref: 'assignablesField',
-    selector: 'plan_new textfield[id="assignables"]'
+    ref: 'planFormWindow',
+    selector: 'plan_formwindow'
   }, {
-    ref: 'selectAssignablesTree',
-    selector: 'plan_selectassignablestree'
-  }, {
-    ref: 'editAssignablesField',
-    selector: 'plan_edit textfield[id="editassignables"]'
-  }, {
-    ref: 'selectAssignables',
-    selector: 'plan_selectassignables'
-  }, {
-    ref: 'assignablesWindow',
-    selector: 'plan_assignableswindow'
+    ref: 'planForm',
+    selector: 'plan_form'
   }],
 
   init: function() {
@@ -64,135 +38,17 @@ Ext.define('TM.controller.Plans', {
       'plan_grid button[action="delete"]': {
         click: this.onDeleteClick
       },
-      'plan_new textfield[id="assignables"]': {
-        render: this.onSelectAssignablesRender
-      },
-      'plan_edit textfield[id="editassignables"]': {
-        render: this.onEditSelectAssignablesRender
-      },
-      'plan_new': {
-        afterrender: this.onNewFormAfterRender
-      },
-      'plan_new combo': {
-        change: this.onPlanTypeChange
-      },
-      'plan_edit combo': {
-        change: this.onEditPlanTypeChange
-      },
-      'plan_new button[action="save"]': {
+      'plan_form button[action="save"]': {
         click: this.onSaveClick
       },
-      'plan_new button[action="reset"]': {
-        click: this.onResetClick
-      },
-      'plan_selectassignables button[action="save"]': {
-        click: this.onSelectAssignablesSave
-      },
-      'plan_selectassignables button[action="cancel"]': {
-        click: this.onSelectAssignablesCancel
-      },
-      'plan_edit': {
-        render: this.onEditFormRender
-      },
-      'plan_edit button[action="update"]': {
-        click: this.onUpdateClick
-      },
-      'plan_edit button[action="close"]': {
-        click: this.onCloseClick
-      },
-      'plan_selectassignablestree': {
-        checkchange: this.onAssigneesTreeCheckChange
+      'plan_form button[action="cancel"]': {
+        click: this.onCancelClick
       }
     });
   },
 
-  onAssigneesTreeCheckChange: function(node, checked, opts) {
-    node.set('checked', checked);
-    node.cascadeBy(function(n) {
-      n.set('checked', checked)
-    });
-  },
-
-  onSelectAssignablesRender: function() {
-    Ext.getStore('TM.store.Assignees').reload();
-    Ext.getStore('TM.store.AssigneesTree')
-      .setRootNode(Ext.getStore('TM.store.Assignees').toTreeStore().root);
-
-    this.getAssignablesField().getEl().on('click', this.onSelectAssignables, this, {action: 'create'});
-  },
-
-  onEditSelectAssignablesRender: function() {
-    this.getEditAssignablesField().getEl().on('click', this.onSelectAssignables, this, {action: 'edit'});
-  },
-
-  onSelectAssignables: function(eventName, fn, opts) {
-    Ext.create('TM.view.plan.AssignablesWindow', { 'action': opts.action }).show();
-  },
-
-  onSelectAssignablesCancel: function(btn) {
-    btn.up('plan_assignableswindow').close();
-  },
-
-  onSelectAssignablesSave: function(btn) {
-    var nodes = Ext.getStore('TM.store.AssigneesTree').getRootNode().childNodes;
-    var action = btn.up('plan_assignableswindow').action;
-    var view = action == 'create' ? this.getPlanNew() : this.getPlanEdit();
-    var assigneesField = action == 'create' ? this.getAssignablesField() : this.getEditAssignablesField()
-
-    view.assignees = [];
-    var assignees = view.assignees;
-
-    var results = [];
-    this.generateResult(assignees, results, nodes);
-
-    assigneesField.setValue(results.join(', '));
-    this.getAssignablesWindow().close();
-  },
-
-  generateResult: function(assignees, results, nodes) {
-    var self = this;
-    Ext.Array.forEach(nodes, function(node, index, nodes) {
-      if (node.get('leaf')) {
-        if (node.get('checked')) {
-          results.push(node.get('text'));
-          assignees.push(node);
-        }
-      } else {
-        self.generateResult(assignees, results, node.childNodes);
-      }
-    });
-  },
-
-  onUpdateClick: function(btn) {
-    var self = this;
-    var attrs = this.getPlanEdit().getValues();
-
-    attrs.assignees = this.getPlanEdit().assignees;
-
-    // attrs.enabled_at =  new Date(document.getElementById("enabled_at").value);
-    var date = this.getPlanEdit().getValues().enabled_at;
-    attrs.enabled_at = Ext.Date.parse(date, "Y/m/d", true);
-
-    attrs.autocompletable = (attrs.autocompletable == 'on') ? true : false;
-
-
-    var record = btn.up('plan_edit').getRecord();
-    record.update(attrs, {
-      success: function(record, operation) {
-        Ext.Msg.alert('提示', '计划更新成功!');
-        self.getPlanEditWindow().close();
-      },
-      failure: function() {
-        Ext.Msg.alert('提示', '计划更新失败!')
-      }
-    })
-  },
-
-  onCloseClick: function(btn) {
-    btn.up('plan_editwindow').close();
-  },
-
-  onEditFormRender: function(record) {
+  onAddClick: function() {
+    Ext.create('TM.view.plan.FormWindow', { title: '添加计划' }).show();
   },
 
   onEditClick: function(btn) {
@@ -201,55 +57,17 @@ Ext.define('TM.controller.Plans', {
       Ext.Msg.alert('提示', '请选择要修改的数据');
       return;
     }
-     if(length > 1){
-       Ext.Msg.alert('提示', '修改的数据一次只能选择一条！');
-       return;
-     }
+    if(length > 1){
+      Ext.Msg.alert('提示', '修改的数据一次只能选择一条！');
+      return;
+    }
 
     var record = btn.up('plan_grid').getSelectionModel().getSelection()[0];
 
-    var win = Ext.create('TM.view.plan.EditWindow');
+    var win = Ext.create('TM.view.plan.FormWindow', { title: '修改计划' } );
     win.show();
 
-    win.down('plan_edit').loadRecord(record);
-
-    this.generateEditTree(record.get('assignees'));
-
-    var results = [];
-    this.getPlanEdit().assignees = [];
-    var assignees = this.getPlanEdit().assignees;
-    var nodes = Ext.getStore('TM.store.AssigneesTree').getRootNode().childNodes;
-    this.generateResult(assignees, results, nodes);
-    this.getEditAssignablesField().setValue(results.join(', '));
-  },
-
-  generateEditTree: function(assignees) {
-    var self = this;
-    Ext.getStore('TM.store.Assignees').reload();
-    Ext.getStore('TM.store.AssigneesTree').
-      setRootNode(Ext.getStore('TM.store.Assignees').toTreeStore().root);
-
-    Ext.Array.each(Ext.getStore('TM.store.AssigneesTree').tree.root.childNodes,
-                   function(node, index, nodes) {
-      self.checkNodes(node, assignees);
-    });
-
-  },
-
-  checkNodes: function(node, assignees) {
-    var self = this;
-    if (node.get('leaf')) {
-      Ext.Array.each(assignees, function(assignee, index, assignees) {
-        if (assignee.id == node.get('id')) {
-          self.getPlanEdit().assignees.push(node);
-          node.set('checked', true);
-        }
-      });
-    } else {
-      Ext.Array.each(node.childNodes, function(n, index, nodes) {
-        self.checkNodes(n, assignees)
-      });
-    }
+    this.getPlanForm().loadRecord(record);
   },
 
   onDeleteClick: function(btn) {
@@ -269,32 +87,26 @@ Ext.define('TM.controller.Plans', {
     });
   },
 
-  onResetClick: function(btn) {
-    this.getPlanNew().getForm().reset();
-  },
-
   onSaveClick: function(btn) {
     var self = this;
-    var attrs = this.getPlanNew().getValues();
-
-    attrs.assignees = this.getPlanNew().assignees;
-
-    var date = this.getPlanNew().getValues().enabled_at;
-    attrs.enabled_at = Ext.Date.parse(date, "Y/m/d", true);
-
-    attrs.autocompletable = (attrs.autocompletable == 'on') ? true : false;
+    var attrs = this.getPlanForm().getValues();
+    var record = this.getPlanForm().getRecord() ||
+      Ext.create('TM.model.Plan');
 
-    var Plan = TM.model.Plan;
-    var plan = Plan.create(attrs, {
+    record.set(attrs);
+    record.save({
       success: function() {
-        Ext.Msg.alert('提示', '计划添加成功!');
-        Ext.getStore('TM.store.Plans').insert(0, plan);
-        self.getPlanWindow().close();
+        Ext.Msg.alert('提示', '保存计划成功!');
+        self.getPlanFormWindow().close();
       },
       failure: function() {
-        Ext.Msg.alert('提示', '计划添加失败!')
+        Ext.Msg.alert('提示', '保存计划失败!')
       }
-    })
+    });
+  },
+
+  onCancelClick: function(btn) {
+    this.getPlanFormWindow().close();
   },
 
   onQueryClick: function(btn) {
@@ -306,53 +118,6 @@ Ext.define('TM.controller.Plans', {
     this.getSearchForm().getForm().reset();
   },
 
-  onAddClick: function() {
-    Ext.create('TM.view.plan.Window').show();
-  },
-
-  onNewFormAfterRender: function() {
-    this.getPlanType().setValue('daily');
-  },
-
-  onPlanTypeChange: function(combo, value, oldValue) {
-    if (value == oldValue) return;
-
-    if(value == 'daily') {
-      this.getPlanNew().getComponent('fillField').getComponent('new_begin_to_remind').setDisabled(true);
-      this.getPlanNew().showDailyField();
-    } else {
-      this.getPlanNew().getComponent('fillField').getComponent('new_begin_to_remind').setDisabled(false);
-      if(value == 'yearly') {
-        this.getPlanNew().showYearlyField();
-      } else if(value == 'quarterly') {
-        this.getPlanNew().showQuarterlyField();
-      } else if(value == 'monthly') {
-        this.getPlanNew().showMonthlyField();
-      } else if(value == 'weekly') {
-        this.getPlanNew().showWeeklyField();
-      }
-    }
-  },
-
-  onEditPlanTypeChange: function(combo, value, oldValue) {
-    if (value == oldValue) return;
-
-    if(value == 'daily') {
-      this.getPlanEdit().getComponent('editFillField').getComponent('edit_begin_to_remind').setDisabled(true);
-      this.getPlanEdit().showDailyField();
-    } else {
-      this.getPlanEdit().getComponent('editFillField').getComponent('edit_begin_to_remind').setDisabled(false);
-      if(value == 'yearly') {
-        this.getPlanEdit().showYearlyField();
-      } else if(value == 'quarterly') {
-        this.getPlanEdit().showQuarterlyField();
-      } else if(value == 'monthly') {
-        this.getPlanEdit().showMonthlyField();
-      } else if(value == 'weekly') {
-        this.getPlanEdit().showWeeklyField();
-      }
-    }
-  },
   index: function() {
     this.render('TM.view.plan.Index');
   }