qwester 0.0.1

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright 2013 YOURNAME
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.rdoc

@@ -0,0 +1,29 @@
+= Qwester
+
+
+
+== Integration with ActiveAdmin
+
+Qwester contains a set of ActiveAdmin registration files, that allow Qwester
+models to be managed from within the parent app's active_admin space. Of course
+ActiveAdmin needs to be installed and working in the parent rails application
+
+To use the Qwester ActiveAdmin registration files, add this to the active_admin 
+initializer in your application.
+
+    config.load_paths << Qwester.active_admin_load_path
+
+See test/dummy/config/initializers/active_admin.rb for an example
+
+Links to the admin pages for Qwester models will appear in a 'Qwester' sub-menu.
+If you wish to change the name of the menu parent group, add this to an 
+initializer:
+
+    Qwester.active_admin_menu = 'menu name'
+
+Alternatively, if you want the Qwester models not to be grouped add this to an
+initializer:
+
+    Qwester.active_admin_menu = 'none'
+
+See test/dummy/config/initializers/qwester.rb for an example

data/Rakefile

@@ -0,0 +1,40 @@
+#!/usr/bin/env rake
+begin
+  require 'bundler/setup'
+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    = 'Qwester'
+  rdoc.options << '--line-numbers'
+  rdoc.rdoc_files.include('README.rdoc')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end
+
+APP_RAKEFILE = File.expand_path("../test/dummy/Rakefile", __FILE__)
+load 'rails/tasks/engine.rake'
+
+
+
+Bundler::GemHelper.install_tasks
+
+require 'rake/testtask'
+
+Rake::TestTask.new(:test) do |t|
+  t.libs << 'lib'
+  t.libs << 'test'
+  t.pattern = 'test/**/*_test.rb'
+  t.verbose = false
+end
+
+
+task :default => :test

data/app/assets/javascripts/qwester/application.js

@@ -0,0 +1,15 @@
+// This is a manifest file that'll be compiled into application.js, which will include all the files
+// listed below.
+//
+// Any JavaScript/Coffee file within this directory, lib/assets/javascripts, vendor/assets/javascripts,
+// or vendor/assets/javascripts of plugins, if any, can be referenced here using a relative path.
+//
+// It's not advisable to add code directly here, but if you do, it'll appear at the bottom of the
+// the compiled file.
+//
+// WARNING: THE FIRST BLANK LINE MARKS THE END OF WHAT'S TO BE PROCESSED, ANY BLANK LINE SHOULD
+// GO AFTER THE REQUIRES BELOW.
+//
+//= require jquery
+//= require jquery_ujs
+//= require_tree .

data/app/assets/stylesheets/qwester/application.css

@@ -0,0 +1,13 @@
+/*
+ * This is a manifest file that'll be compiled into application.css, which will include all the files
+ * listed below.
+ *
+ * Any CSS and SCSS file within this directory, lib/assets/stylesheets, vendor/assets/stylesheets,
+ * or vendor/assets/stylesheets of plugins, if any, can be referenced here using a relative path.
+ *
+ * You're free to add application-wide styles to this file and they'll appear at the top of the
+ * compiled file, but it's generally better to create a new file per style scope.
+ *
+ *= require_self
+ *= require_tree .
+ */

data/app/controllers/qwester/application_controller.rb

@@ -0,0 +1,4 @@
+module Qwester
+  class ApplicationController < ActionController::Base
+  end
+end

data/app/helpers/qwester/application_helper.rb

@@ -0,0 +1,4 @@
+module Qwester
+  module ApplicationHelper
+  end
+end

data/app/models/qwester/answer.rb

@@ -0,0 +1,44 @@
+module Qwester
+  class Answer < ActiveRecord::Base
+    attr_accessible :value, :question_id, :position, :cope_index
+
+    DEFAULT_VALUE = 'Not applicable'
+    STANDARD_VALUES = ['Yes', 'No', DEFAULT_VALUE]
+
+    has_and_belongs_to_many(
+      :rule_sets,
+      :join_table => :qwester_answers_rule_sets
+    )
+    
+    has_and_belongs_to_many(
+      :answer_stores,
+      :join_table => :qwester_answer_stores_answers
+    )
+
+    belongs_to :question
+
+    acts_as_list :scope => :question
+
+    validates :value, :presence => true
+
+    def self.find_first_or_create(attributes)
+      where(attributes).first || create(attributes)
+    end
+
+    def self.standard_values
+      STANDARD_VALUES
+    end
+
+    def self.default_value
+      DEFAULT_VALUE
+    end
+
+    def self.rule_label_prefix
+      @rule_label_prefix ||= 'a'
+    end
+
+    def rule_label
+      "#{self.class.rule_label_prefix}#{self.id}"
+    end
+  end
+end

data/app/models/qwester/answer_store.rb

@@ -0,0 +1,38 @@
+module Qwester
+  class AnswerStore < ActiveRecord::Base
+
+    has_and_belongs_to_many(
+      :answers,
+      :join_table => :qwester_answer_stores_answers,
+      :uniq => true
+    )
+    has_and_belongs_to_many(
+      :questionnaires, 
+      :join_table => :qwester_answer_stores_questionnaires,
+      :uniq => true
+    )
+
+    before_save :generate_session_id
+
+    def cope_index_sum
+      answers.sum(:cope_index)
+    end
+
+    def reset
+      answers.clear
+      questionnaires.clear
+    end
+
+    def to_param
+      session_id
+    end
+
+    private
+
+    def generate_session_id
+      if !self.session_id or self.session_id.empty?
+        self.session_id = RandomString.new(15)
+      end
+    end
+  end
+end

data/app/models/qwester/question.rb

@@ -0,0 +1,36 @@
+module Qwester
+  class Question < ActiveRecord::Base
+    attr_accessible :title, :description, :ref, :answers_attributes, :multi_answer
+
+    has_many(
+      :answers, 
+      :order => 'position',
+      :dependent => :destroy
+    )
+    accepts_nested_attributes_for :answers
+
+    has_many :questionnaires_questions
+
+    has_many(
+      :questionnaires,
+      :through => :questionnaires_questions, 
+      :uniq => true
+    )
+
+    validates :title, :presence => true
+
+    def build_standard_answers
+      created_answers = Array.new
+      Answer.standard_values.each_with_index do |value, index|
+        answer = answers.find_or_initialize_by_value(value)
+        answer.position = index + 1
+        created_answers << answer
+      end
+      return created_answers
+    end
+
+    def create_standard_answers
+      build_standard_answers.each(&:save)
+    end
+  end
+end

data/app/models/qwester/questionnaire.rb

@@ -0,0 +1,77 @@
+module Qwester
+  class Questionnaire < ActiveRecord::Base
+    attr_accessible :title, :description, :button_image, :question_ids
+
+    has_many(
+      :questionnaires_questions, 
+      :order => 'position'
+    )
+
+    has_many(
+      :questions,
+      :uniq => true,
+      :through => :questionnaires_questions,
+      :order => 'position'
+    )
+
+    has_many(
+      :answers,
+      :through => :questions,
+      :uniq => true
+    )
+    accepts_nested_attributes_for :answers
+
+    has_attached_file(
+      :button_image,
+      :styles => {
+        :link => '150x125>',
+        :thumbnail => '50x50>'
+      }
+    )
+
+    has_and_belongs_to_many :answer_stores, :uniq => true
+
+    validates :title, :presence => true
+
+    private
+    def method_missing(symbol, *args, &block)
+      if acts_as_list_method?(symbol)
+        pass_method_to_questionnaires_question(symbol, args.first)
+      else
+        super
+      end
+    end
+
+  #  Allows acts_as_list methods to be used within the questionnaire. 
+  #  If questions were the act_as_list object, you could do things like this
+  #   
+  #       questionnaire.questions.last.move_higher
+  #       
+  #   However, as questions are used on multiple questionnaires and they
+  #   need to be independently sortable within each questionnaire, it is the
+  #   through table model QuestionnairesQuestion that acts_as_list. To change
+  #   position the change must be made in the context of the questionnaire. 
+  #   pass_method_to_questionnaires_question in combination with method_missing,
+  #   allows you to pass to a questionnaire the acts_as_list method together with
+  #   the question it needs to effect. The equivalent move_higher call then becomes:
+  #   
+  #       questionnaire.move_higher(questionnaire.questions.last)
+  #       
+  #   You can also do:
+  #   
+  #       questionnaire.move_to_top(question)
+  #       questionnaire.last?(question)
+  # 
+    def pass_method_to_questionnaires_question(symbol, question)
+      raise "A Question is needed to identify QuestionnairesQuestion" unless question.kind_of? Question
+      questionnaires_question = questionnaires_questions.where(:question_id => question.id).first
+      questionnaires_question.send(symbol) if questionnaires_question
+    end
+
+    def acts_as_list_method?(symbol)
+      ActiveRecord::Acts::List::InstanceMethods.instance_methods.include?(symbol.to_sym)
+    end
+
+
+  end
+end

data/app/models/qwester/questionnaires_question.rb

@@ -0,0 +1,10 @@
+module Qwester
+  class QuestionnairesQuestion < ActiveRecord::Base
+    attr_accessible :position
+
+    belongs_to :questionnaire
+    belongs_to :question
+
+    acts_as_list :scope => :questionnaire
+  end
+end

data/app/models/qwester/rule_set.rb

@@ -0,0 +1,81 @@
+require 'array_logic'
+module Qwester
+  class RuleSet < ActiveRecord::Base
+    attr_accessible :title, :description, :answers, :url, :rule, :answer_ids, :link_text, :warning_id
+
+    before_save :keep_answers_in_step_with_rule
+
+    DEFAULT_RULE_JOIN = 'or'
+    ANSWERS_LIMIT = 10
+
+    has_and_belongs_to_many(
+      :answers, 
+      :uniq => true,
+      :join_table => :qwester_answers_rule_sets
+    )
+    accepts_nested_attributes_for :answers
+
+    has_many(
+      :questions,
+      :through => :answers
+    )
+
+    validate :check_rule_is_valid
+
+    validates :title, :presence => true
+    validates :url, :presence => true
+
+
+    def self.matching(answers)
+      all.collect{|rule_set| rule_set if rule_set.match(answers)}.compact
+    end
+
+    def match(answers_to_check = nil)
+      return unless answers_to_check and !answers_to_check.empty?
+      generate_default_rule && save
+      logic.match(answers_to_check)
+    end
+
+    def logic
+      @logic || get_logic
+    end
+
+    def matching_answer_sets
+      @matching_answer_sets ||= logic.matching_combinations 
+    end
+
+    def blocking_answer_sets
+      @blocking_answer_set ||= logic.blocking_combinations
+    end
+
+    def default_rule
+      answers.collect(&:rule_label).join(" #{DEFAULT_RULE_JOIN} ")
+    end
+
+    private
+    def get_logic
+      @logic = ArrayLogic::Rule.new rule
+    end
+
+    def generate_default_rule
+      if (!self.rule or self.rule.empty?) and answers.length > 0
+        self.rule = default_rule
+      end
+    end  
+
+    def keep_answers_in_step_with_rule
+      generate_default_rule
+      self.answers = get_logic.object_ids_used.collect{|id| Answer.find(id)}
+    end
+
+    def check_rule_is_valid
+      if rule.present?
+        begin
+        logic.send :check_rule
+        rescue => e
+          errors.add(:rule, "error: #{e.message}")
+        end
+      end
+    end
+  end
+end

data/app/views/layouts/qwester/application.html.erb

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

data/config/routes.rb

@@ -0,0 +1,2 @@
+Qwester::Engine.routes.draw do
+end

data/db/migrate/20121008151526_create_questions.rb

@@ -0,0 +1,13 @@
+class CreateQuestions < ActiveRecord::Migration
+  def change
+    create_table :qwester_questions do |t|
+      t.string :title
+      t.text :description
+      t.integer :parent_id
+      t.integer :lft
+      t.integer :rgt
+      t.integer :depth
+      t.timestamps
+    end
+  end
+end

data/db/migrate/20121008152106_create_answers.rb

@@ -0,0 +1,9 @@
+class CreateAnswers < ActiveRecord::Migration
+  def change
+    create_table :qwester_answers do |t|
+      t.integer :question_id
+      t.boolean :value
+      t.timestamps
+    end
+  end
+end

data/db/migrate/20121008153758_create_rule_sets.rb

@@ -0,0 +1,15 @@
+class CreateRuleSets < ActiveRecord::Migration
+  def change
+    create_table :qwester_rule_sets do |t|
+      t.string :title
+      t.string :description
+      t.string :url
+      t.timestamps
+    end
+    
+    create_table :qwester_answers_rule_sets, :id => false do |t|
+      t.integer :answer_id
+      t.integer :rule_set_id
+    end
+  end
+end

data/db/migrate/20121009080219_create_questionnaires.rb

@@ -0,0 +1,14 @@
+class CreateQuestionnaires < ActiveRecord::Migration
+  def change
+    create_table :qwester_questionnaires do |t|
+      t.string :title
+      t.text :description
+      t.timestamps
+    end
+    
+    create_table :qwester_questionnaires_questions, :id => false do |t|
+      t.integer :questionnaire_id
+      t.integer :question_id
+    end
+  end
+end

data/db/migrate/20121009095600_create_answer_stores.rb

@@ -0,0 +1,13 @@
+class CreateAnswerStores < ActiveRecord::Migration
+  def change
+    create_table :qwester_answer_stores do |t|
+      t.string :session_id
+      t.timestamps
+    end
+    
+    create_table :qwester_answer_stores_answers, :id => false do |t|
+      t.integer :answer_id
+      t.integer :answer_store_id
+    end
+  end
+end

data/db/migrate/20121009160807_add_questionnaire_id_to_answers.rb

@@ -0,0 +1,5 @@
+class AddQuestionnaireIdToAnswers < ActiveRecord::Migration
+  def change
+    add_column :qwester_answers, :questionnaire_id, :integer
+  end
+end

data/db/migrate/20121009161206_change_answers_value_to_string.rb

@@ -0,0 +1,9 @@
+class ChangeAnswersValueToString < ActiveRecord::Migration
+  def up
+    change_column(:qwester_answers, :value, :string)
+  end
+
+  def down
+    change_column(:qwester_answers, :value, :boolean)
+  end
+end

data/db/migrate/20121019111051_add_button_image_to_questionnaires.rb

@@ -0,0 +1,7 @@
+require 'paperclip'
+ActiveRecord::ConnectionAdapters::AbstractAdapter.send :include, Paperclip::Schema::Statements
+class AddButtonImageToQuestionnaires < ActiveRecord::Migration
+  def change
+    add_attachment :qwester_questionnaires, :button_image
+  end
+end

data/db/migrate/20121114084347_create_ckeditor_assets.rb

@@ -0,0 +1,26 @@
+class CreateCkeditorAssets < ActiveRecord::Migration
+  def self.up
+    create_table :qwester_ckeditor_assets do |t|
+      t.string  :data_file_name, :null => false
+      t.string  :data_content_type
+      t.integer :data_file_size
+      
+      t.integer :assetable_id
+      t.string  :assetable_type, :limit => 30
+      t.string  :type, :limit => 30
+
+      # Uncomment	it to save images dimensions, if your need it
+      t.integer :width
+      t.integer :height
+
+      t.timestamps
+    end
+    
+    add_index "qwester_ckeditor_assets", ["assetable_type", "type", "assetable_id"], :name => "qwester_idx_ckeditor_assetable_type"
+    add_index "qwester_ckeditor_assets", ["assetable_type", "assetable_id"], :name => "qwester_idx_ckeditor_assetable"
+  end
+
+  def self.down
+    drop_table :qwester_ckeditor_assets
+  end
+end

data/db/migrate/20121115114408_add_ref_to_questions.rb

@@ -0,0 +1,5 @@
+class AddRefToQuestions < ActiveRecord::Migration
+  def change
+    add_column :qwester_questions, :ref, :string
+  end
+end

data/db/migrate/20121120092108_add_ids_to_questionnaires_questions.rb

@@ -0,0 +1,25 @@
+class AddIdsToQuestionnairesQuestions < ActiveRecord::Migration
+  def up
+    add_column qq_table, :id, :primary_key
+    add_column qq_table, :position, :integer
+    add_column qq_table, :created_at, :datetime
+    add_column qq_table, :updated_at, :datetime
+
+    execute "UPDATE #{qq_table} SET created_at = #{Time.now.to_s(:db)}, updated_at = #{Time.now.to_s(:db)};"
+
+    puts "=============================================="
+    puts "Now run 'rake qwester:reset_positions RAILS_ENV=#{Rails.env}' to set the positions"
+    puts "=============================================="
+  end
+  
+  def down
+    remove_column qq_table, :id
+    remove_column qq_table, :position
+    remove_column qq_table, :created_at
+    remove_column qq_table, :updated_at
+  end
+  
+  def qq_table
+    :qwester_questionnaires_questions
+  end
+end

data/db/migrate/20121122130930_add_cope_index_and_position_to_answers.rb

@@ -0,0 +1,6 @@
+class AddCopeIndexAndPositionToAnswers < ActiveRecord::Migration
+  def change
+    add_column :qwester_answers, :position, :integer
+    add_column :qwester_answers, :cope_index, :integer, :default => 0
+  end
+end

data/db/migrate/20121122141628_remove_questionnaire_from_answer.rb

@@ -0,0 +1,9 @@
+class RemoveQuestionnaireFromAnswer < ActiveRecord::Migration
+  def up
+    remove_column :qwester_answers, :questionnaire_id
+  end
+
+  def down
+    add_column :qwester_answers, :questionnaire_id, :integer
+  end
+end

data/db/migrate/20121126152146_add_rule_to_rule_sets.rb

@@ -0,0 +1,5 @@
+class AddRuleToRuleSets < ActiveRecord::Migration
+  def change
+    add_column :qwester_rule_sets, :rule, :text
+  end
+end

data/db/migrate/20121203150555_add_multi_answer_to_questions.rb

@@ -0,0 +1,5 @@
+class AddMultiAnswerToQuestions < ActiveRecord::Migration
+  def change
+    add_column :qwester_questions, :multi_answer, :boolean
+  end
+end

data/db/migrate/20121204082213_create_answer_stores_questionnaires.rb

@@ -0,0 +1,10 @@
+class CreateAnswerStoresQuestionnaires < ActiveRecord::Migration
+  def change
+    
+    create_table :qwester_answer_stores_questionnaires, :id => false do |t|
+      t.integer :questionnaire_id
+      t.integer :answer_store_id
+    end
+
+  end
+end

data/db/migrate/20121204100803_add_link_text_to_rule_sets.rb

@@ -0,0 +1,5 @@
+class AddLinkTextToRuleSets < ActiveRecord::Migration
+  def change
+    add_column :qwester_rule_sets, :link_text, :string
+  end
+end