pairer 1.0.0

data/app/views/pairer/boards/_recently_accessed_boards.html.slim

@@ -0,0 +1,26 @@
+- session_key = :pairer_board_access_list
+
+- if session[session_key]
+  - begin
+    - access_list_by_time = session[session_key].to_a.sort_by{|_id,time| Time.parse(time)}.reverse.to_h
+
+    - if access_list_by_time.any?
+      - access_list_by_time.each do |id, time|
+        - if Time.parse(time) < 30.days.ago
+          - session[session_key] = access_list_by_time = access_list_by_time.except(id)
+
+      - boards = Pairer::Board.where(org_id: session[:pairer_current_org_id], public_id: access_list_by_time.keys).map{|x| [x.public_id, x]}.to_h
+
+      - if boards.any?
+        .recently-accessed-boards.well.well-sm.space-above5
+          h1.space-above Recently Accessed Boards
+
+          ul style="list-style: none; padding-left: 0"
+            - access_list_by_time.each do |public_id, _time|
+              - board = boards[public_id]
+
+              - if board
+                li style="margin-top: 10px;" = link_to "#{board.name}", pairer.board_path(public_id), style: "color: #333; text-decoration: underline;"
+  - rescue => e
+    - session.delete(session_key)
+    - raise(e)

data/app/views/pairer/boards/_role.html.slim

@@ -0,0 +1,6 @@
+span.role data-role-name=role 
+  = role
+
+  span.space-left2.delete
+    = link_to board_path(@board, remove_role_name: role), data: {method: :patch, confirm: "Are you sure you want to remove '#{role}' role ?"}, title: "Delete Role", class: 'btn btn-xs btn-danger' do
+      i.icon-trash

data/app/views/pairer/boards/_stats.html.slim

@@ -0,0 +1,37 @@
+.stats
+  h3.space-above5
+    .pull-left
+      | Stats
+    = link_to "Reset Stats and Groups", board_path(@board, clear_board: true), class: 'btn btn-danger btn-sm space-left2', data: {method: :patch}
+
+  p
+    = form_tag board_path(@board), method: :patch, class: 'form-inline space-above3' do
+      small
+        span.space-right Statistics will only consider last
+        input.form-control.change-submit name="board[num_iterations_to_track]" value=@board.num_iterations_to_track style="width: 40px; height: 30px; padding: 0 7px; text-align: center;"
+        span.space-left iterations
+
+  - stats = @board.stats
+
+  - if stats.empty?
+    p Cannot show stats with only 1 person on the board
+  - else
+    table.table.table-condensed.table-bordered#stats style="max-width: 400px;"
+      thead
+        th Pair
+        th style="width: 90px;" Count
+      tbody
+        - people_by_id = @board.people.map{|x| [x.to_param, x] }.to_h
+
+        - stats.each do |person_ids, count|
+          tr
+            td = person_ids.map{|person_id| people_by_id[person_id]&.name || "<Person Removed>" }.sort.join(", ")
+            td.text-center = count
+
+  - if Rails.env.development?
+    .well.space-above5
+      h4 Debug Info
+
+      = "Number of Tracked Groups: #{@board.tracked_groups.size}"
+      br
+      = "Tracked Groups Iteration Numbers: #{@board.tracked_groups.collect(&:board_iteration_number).uniq.join(", ")}"

data/app/views/pairer/boards/create_group.js.erb

@@ -0,0 +1,3 @@
+$(".groups-container tbody").append("<%= j render 'pairer/boards/group', group: @group %>");
+
+window.init_sortable_lists();

data/app/views/pairer/boards/create_person.js.erb

@@ -0,0 +1,7 @@
+if(<%= raw @person.persisted? %>){
+  $(".unassigned-lists-container .person-list").append("<%= j render 'pairer/boards/person', person: @person %>")
+
+  $("form.new-person-form").find("input","select","textarea").val('')
+}else if(<%= raw @person.errors[:name].present? %>){
+  alert("Name <%= @person.errors[:name].first %>");
+}

data/app/views/pairer/boards/delete_group.js.erb

@@ -0,0 +1,7 @@
+var group_row = $(".group-row[data-group-id=<%= @group.public_id %>]");
+
+$('.unassigned-lists-container .person-list').append(group_row.find(".person"));
+
+$('.unassigned-lists-container .roles-list').append(group_row.find(".role"));
+
+group_row.remove();

data/app/views/pairer/boards/index.html.slim

@@ -0,0 +1,28 @@
+.text-center style="max-width: 600px; margin: 0 auto;"
+  .well.well-sm
+    h1.space-above Find Existing Board
+
+    = form_tag nil, method: :get, class: 'form-inline' do
+      .form-group
+        label Board Password
+        input.form-control name="password" type="password" autofocus=true
+      
+      button.btn.btn-sm.btn-success.space-left3 type="submit" Find Board
+
+  .well.well-sm.space-above5
+    h1.space-above Create New Board
+
+    .hint.small.space-below2 You can give out this password to give others access to your new board
+
+    = form_tag boards_path, method: :post, class: 'form-inline' do
+      .form-group
+        label Board Password
+
+        input.form-control.password name="password" type="password"
+        i.icon-eye-open.space-left title="Toggle Password Visibility" onclick="$('input.password').attr('type', ($('input.password').attr('type') == 'text' ? 'password' : 'text'))"
+
+      button.btn.btn-sm.btn-default.space-left3 type="submit" 
+        i.icon-plus.space-right
+        span Create Board
+
+  = render "recently_accessed_boards"

data/app/views/pairer/boards/lock_group.js.erb

@@ -0,0 +1 @@
+$(".group-row[data-group-id=<%= @group.public_id %>] .group-lock-btn").replaceWith("<%= j render "group_lock_button", group: @group %>");

data/app/views/pairer/boards/lock_person.js.erb

@@ -0,0 +1 @@
+$(".person[data-person-id=<%= @person.public_id %>]").replaceWith("<%= j render "person", person: @person %>")

data/app/views/pairer/boards/show.html.slim

@@ -0,0 +1,240 @@
+.pull-right
+  .text-right
+    button.btn.btn-default.btn-sm.space-right2 type="button" onclick=("$('.password-form').toggle()") Change Password
+    = link_to "Delete Board", board_path(@board), class: "btn btn-danger btn-sm", data: {method: :delete, confirm: "Are you sure you want to delete this board?"}
+
+  = form_tag board_path(@board), method: :patch, class: 'form-inline password-form', style: 'display:none' do
+    h3 Change Board Password
+
+    label Board Password
+    input.form-control.password name="board[password]" type="password" value=@board.password style="width: 100px;"
+    i.icon-eye-open.space-left onclick="$('input.password').attr('type', ($('input.password').attr('type') == 'text' ? 'password' : 'text'))"
+
+    span.space-left2
+      button.btn.btn-xs.btn-success type="submit" Update
+
+= form_tag board_path(@board), method: :patch, class: 'form-inline' do
+  - if @board.errors.any?
+    .well.well-sm
+      div.bold Errors:
+      = @board.errors.full_messages.join("<br>").html_safe
+
+  div
+    .form-group
+      label Board Name
+      input.form-control.change-submit name="board[name]" value=@board.name style="width: 180px;"
+
+    br.visible-xs
+    span.space-left3.hidden-xs
+
+    .form-group
+      label Group Size
+      input.form-control.change-submit name="board[group_size]" value=@board.group_size style="width: 50px;"
+
+.row
+  .col-sm-9.groups-container
+    h3
+      .pull-left.space-right2 Groups
+      = link_to create_group_board_path(@board), data: {method: :post}, remote: true, class: 'btn btn-sm btn-default' do
+        i.icon-plus.space-right
+        span Add Group
+
+    .text-center.space-below3 style="margin-top: -53px;"
+      = link_to shuffle_board_path(@board), class: "btn btn-success", data: {method: :post} do
+        i.icon-refresh.space-right
+        span Shuffle
+
+    = render "current_groups"
+
+    div
+      = link_to create_group_board_path(@board), data: {method: :post}, remote: true, class: 'btn btn-sm btn-default' do
+        i.icon-plus.space-right
+        span Add Group
+
+    .hidden-xs = render 'stats'
+
+  .col-sm-3.unassigned-lists-container
+    .well.space-above3.board-roles-container
+      h3.space-above
+        .pull-left.space-right3 Roles
+
+        = form_tag board_path(@board), method: :patch, class: 'form-inline space-below space-left3' do
+          = text_field_tag :add_role_name, nil, placeholder: "Role Name", style: "width: 150px;", class: 'form-control'
+
+          span.space-left
+            button.btn.btn-sm.btn-default type="submit" Add
+
+      - group_roles = @board.current_groups.flat_map(&:roles_array)
+      - unassigned_roles = @board.roles_array - group_roles
+      .roles-list data-prev-roles=unassigned_roles style="min-height: 25px;"
+        - unassigned_roles.each do |role|
+          = render 'role', role: role
+
+      .board-people-container
+        h3.space-above5
+          .pull-left.space-right3 People
+
+          = form_tag create_person_board_path(@board), remote: true, class: 'form-inline new-person-form space-below space-left3' do
+            = text_field_tag :name, nil, placeholder: "Name", style: "width: 150px;", class: 'form-control'
+
+            span.space-left
+              button.btn.btn-sm.btn-default type="submit" Add
+
+        - group_person_ids = @board.current_groups.flat_map(&:person_ids_array)
+        - unassigned_people = @board.people.select{|x| group_person_ids.exclude?(x.public_id) }.sort_by{|x| x.name }
+        .person-list data-prev-person-ids=unassigned_people.map(&:public_id) style="min-height: 40px;"
+          - unassigned_people.each do |person|
+            = render 'person', person: person
+
+.visible-xs = render 'stats'
+
+css:
+  .role,
+  .person{
+    display: inline-block;
+    border: 1px solid black;
+    border-radius: 4px;
+    padding: 0px 10px 3px 10px;
+    margin: 5px 5px;
+    line-height: 40px;
+    cursor: grab;
+    user-select: none;
+
+    box-shadow: 4px 4px rgba(0,0,0, 0.2);
+  }
+
+  .groups-container .person .delete,
+  .groups-container .role .delete{
+    display: none;
+  }
+
+  .group-sweep-btn{
+    background-color: none;
+    color: #333;
+    padding: 3px 5px;
+    line-height: 1;
+    font-size: 20px;
+    border: 1px solid #999;
+  }
+  .group-sweep-btn:hover{
+    background-color: #ede175;
+    color: #333;
+  }
+  .group-lock-btn{
+    padding: 5px 9px;
+  }
+
+  .btn-highlight{
+    background-color: orange;
+    color: white;
+  }
+  .btn-highlight:hover{
+    background-color: darkorange;
+  }
+
+  @media (min-width: 768px){
+    .unassigned-lists-container{
+      min-width: 360px;
+    }
+    .groups-container{
+      max-width: calc(100% - 360px);
+    }
+  }
+
+javascript:
+  $(function(){
+
+    $('.change-submit').on('change', function(){
+      var item = $(this);
+      setTimeout(function(){
+        if(item.val() == "" && item.is('select[multiple]')){
+          item.attr('disabled', true);
+          $("<input name='"+item.attr('name')+"' value='"+item.val()+"' />").insertBefore(item);
+        }
+        item.closest("form").submit();
+      }, 1);
+    });
+
+    window.init_sortable_lists = function(){
+      $(".person-list").sortable({
+        connectWith: ".person-list",
+        items: "> .person",
+        revert: true,
+        update: function(){
+          var group_id = $(this).data('group-id');
+          var prev_person_ids = $(this).data('prev-person-ids');
+
+          var $el = $(this);
+
+          if(!group_id){
+            // When on the unassigned list
+            return true; // true only skips ajax update, false cancels the entire item drag/move
+          }
+
+          var person_ids = [];
+
+          $el.find('.person').each(function(i, item){
+            person_ids.push($(item).data('person-id'));
+          });
+
+          if(equals(prev_person_ids.sort(), person_ids.sort())){
+            return true; // true only skips ajax update, false cancels the entire item drag/move
+          }
+
+          if(person_ids.length === 0){
+            person_ids.push(""); // to ensure empty array value make the params
+          }
+
+          $.ajax({
+            url: "#{update_group_board_path(@board, format: :js)}",
+            method: "POST",
+            data: {group_id: group_id, person_ids: person_ids},
+          }).done(function(){
+            $el.data('prev-person-ids', person_ids);
+          });
+        },
+      });
+
+      $(".roles-list").sortable({
+        connectWith: ".roles-list",
+        items: "> .role",
+        revert: true,
+        update: function(){
+          var group_id = $(this).data('group-id');
+          var prev_roles = $(this).data('prev-roles');
+
+          $el = $(this);
+
+          if(!group_id){
+            // When on the unassigned list
+            return true; // true only skips ajax update, false cancels the entire item drag/move
+          }
+
+          var roles = [];
+
+          $el.find('.role').each(function(i, item){
+            roles.push($(item).data('role-name'));
+          });
+
+          if(equals(prev_roles.sort(), roles.sort())){
+            return true; // true only skips ajax update, false cancels the entire item drag/move
+          }
+
+          if(roles.length === 0){
+            roles.push(""); // to ensure empty array value make the params
+          }
+
+          $.ajax({
+            url: "#{update_group_board_path(@board, format: :js)}",
+            method: "POST",
+            data: {group_id: group_id, roles: roles},
+          }).done(function(){
+            $el.data('prev-roles', roles);
+          });
+        },
+      });
+    };
+
+    window.init_sortable_lists();
+
+  });

data/app/views/pairer/exceptions/show.html.slim

@@ -0,0 +1,8 @@
+div style="text-align: center; padding-top: 25%"
+  - case response.status.to_s
+  - when "404"
+    h1 Page Not Found
+  - else
+    h1 Sorry, an error occured. The administrator has been notified.
+
+  .badge.badge-error = "Error #{response.status}"

data/app/views/pairer/sessions/sign_in.html.slim

@@ -0,0 +1,10 @@
+.text-center style="max-width: 600px; margin: 0 auto;"
+  .well.well-sm
+    h1.space-above Sign In
+
+    = form_tag nil, method: :post, class: 'form-inline' do
+      .form-group
+        label Organization ID
+        input.form-control type="password" name="org_id" autofocus=true
+
+      button.btn.btn-sm.btn-success.space-left2 type="submit" Submit

data/app/views/pairer/shared/_flash.html.slim

@@ -0,0 +1,6 @@
+#flash-container
+  - flash.each do |name, msg|
+    - if msg.is_a?(String)
+      .alert.alert-dismissible class="alert-#{name.to_s == 'notice' ? 'success' : 'danger'}"
+        button.close type="button" data-dismiss="alert" aria-hidden="true" ×
+        span id="flash_#{name}" = msg

data/app/views/pairer/shared/svg/_broom.html.slim

@@ -0,0 +1,2 @@
+svg width="1em" height="1em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 32 32" class="iconify iconify--la"
+  path fill="currentColor" d="m28.281 2.281l-10 10L17 11v-.031l-.031-.031c-.64-.57-1.477-.844-2.282-.844c-.804 0-1.582.3-2.187.906l-.156.125l-.5.5l-.344.281L2.375 19l-.875.719L12.281 30.5l.719-.875l7.063-9.063l.03.032l1-1h.032l.031-.032c1.14-1.285 1.149-3.257-.062-4.468l-1.375-1.375l10-10zm-13.593 9.813a1.39 1.39 0 0 1 .906.312c.011.008.02.024.031.031l4.063 4.063c.375.375.41 1.172 0 1.688c-.016.019-.016.042-.032.062l-.312.281l-5.782-5.781l.344-.344c.192-.191.473-.304.781-.312zM12.03 14.03l5.938 5.938l-5.875 7.5l-1.438-1.438l2.156-2.25l-1.437-1.375l-2.125 2.219l-1.313-1.313l3.875-3.906L10.406 18L6.5 21.875l-1.969-1.969z"

data/config/locales/en.yml

@@ -0,0 +1,5 @@
+en:
+  activerecord:
+    attributes:
+      'pairer/board':
+        num_iterations_to_track: "Number of Iterations to Track"

data/config/routes.rb

@@ -0,0 +1,26 @@
+Pairer::Engine.routes.draw do
+  get :sign_in, to: "sessions#sign_in"
+  post :sign_in, to: "sessions#sign_in"
+  get :sign_out, to: "sessions#sign_out"
+
+  resources :boards, controller: :boards, except: [:new, :edit] do
+    member do
+      post :shuffle
+      post :create_person
+      post :lock_person
+      delete :delete_person
+      post :create_group
+      post :lock_group
+      delete :delete_group
+      post :update_group
+    end
+  end
+
+  get '/robots', to: 'application#robots', constraints: ->(req){ req.format == :text }
+
+  match '*a', to: 'application#render_404', via: :get
+
+  get "/", to: "boards#index"
+
+  root "boards#index"
+end

data/db/migrate/20210821001344_add_pairer_tables.rb

@@ -0,0 +1,34 @@
+class AddPairerTables < ActiveRecord::Migration[6.0]
+  def change
+
+    create_table :pairer_boards do |t|
+      t.string :name, :password
+      t.text :roles
+      t.integer :current_iteration_number, null: false
+      t.integer :group_size
+      t.integer :num_iterations_to_track, null: false
+      t.timestamps
+      t.string :public_id, index: true
+      t.string :org_id
+    end
+
+    create_table :pairer_people do |t|
+      t.references :board
+      t.string :name
+      t.timestamps
+      t.boolean :locked, default: false, null: false
+      t.string :public_id, index: true
+    end
+
+    create_table :pairer_groups do |t|
+      t.references :board
+      t.integer :board_iteration_number
+      t.timestamps
+      t.boolean :locked, default: false, null: false
+      t.text :person_ids
+      t.text :roles
+      t.string :public_id, index: true
+    end
+
+  end
+end

data/lib/pairer/config.rb

@@ -0,0 +1,38 @@
+module Pairer
+  class Config
+
+    @@allowed_org_ids = []
+    mattr_reader :allowed_org_ids
+
+    def self.allowed_org_ids=(val)
+      if val.is_a?(Array)
+        @@allowed_org_ids = val.collect(&:presence).compact
+      else
+        raise "Must be an array"
+      end
+    end
+
+    @@hash_id_salt = true
+    mattr_reader :hash_id_salt
+
+    def self.hash_id_salt=(val)
+      if val.is_a?(String)
+        @@hash_id_salt = val
+      else
+        raise ArgumentError.new("hash_id_salt must be String")
+      end
+    end
+
+    @@max_iterations_to_track = 100
+    mattr_reader :max_iterations_to_track
+
+    def self.max_iterations_to_track=(val)
+      if val.is_a?(Integer) && val >= 1
+        @@max_iterations_to_track = val
+      else
+        raise "Must be a positive integer"
+      end
+    end
+
+  end
+end

data/lib/pairer/engine.rb

@@ -0,0 +1,47 @@
+require 'slim'
+require 'sassc-rails'
+require 'bootstrap-sass'
+require 'bootswatch-rails'
+require 'hashids'
+
+module Pairer
+  class Engine < ::Rails::Engine
+    isolate_namespace Pairer
+
+    initializer "pairer.assets.precompile" do |app|
+      app.config.assets.precompile << "pairer_manifest.js" ### manifest file required
+      app.config.assets.precompile << "pairer/favicon.ico"
+
+      ### Automatically precompile assets in specified folders
+      ["app/assets/images/"].each do |folder|
+        dir = app.root.join(folder)
+
+        if Dir.exist?(dir)
+          Dir.glob(File.join(dir, "**/*")).each do |f|
+            asset_name = f.to_s
+              .split(folder).last # Remove fullpath
+              .sub(/^\/*/, '') ### Remove leading '/'
+
+            app.config.assets.precompile << asset_name
+          end
+        end
+      end
+    end
+
+    initializer "pairer.append_migrations" do |app|
+      ### Automatically load all migrations into main rails app
+      
+      if !app.root.to_s.match?(root.to_s)
+        config.paths["db/migrate"].expanded.each do |expanded_path|
+          app.config.paths["db/migrate"] << expanded_path
+        end
+      end
+    end
+
+    initializer "pairer.load_static_assets" do |app|
+      ### Expose static assets
+      app.middleware.use ::ActionDispatch::Static, "#{root}/public"
+    end
+
+  end
+end

data/lib/pairer/version.rb

@@ -0,0 +1,3 @@
+module Pairer
+  VERSION = '1.0.0'
+end

data/lib/pairer.rb

@@ -0,0 +1,24 @@
+require "pairer/engine"
+require "pairer/config"
+
+module Pairer
+
+  def self.config(&block)
+    c = Pairer::Config
+
+    if block_given?
+      block.call(c)
+    else
+      return c
+    end
+  end
+
+end
+
+if RUBY_VERSION.to_f <= 2.6 && !Array.new.respond_to?(:intersection)
+  Array.class_eval do
+    def intersection(other)
+      self & other
+    end
+  end
+end

data/lib/tasks/pairer_engine_tasks.rake

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