simple_teams 0.1.4 → 0.1.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ea436fc244351fbe757513bc528932e72825f362859ce81edf4036a2b353bfc1
-  data.tar.gz: 636891c0d6281d29494eef2231b7a76245b062c04c506af26cc969136e48fc51
+  metadata.gz: c7269707d1cb9ecf7ebc402e57e9c0575d859ae09423b37679fd952a6542e02a
+  data.tar.gz: d91aa3498e0dbf574afdf1280ffa87e4614da9e45a5c6aaf4e263cb23929df36
 SHA512:
-  metadata.gz: d8953835540518f246b25150d052553e8fce1de4bdbf70f8bb9045b918323b28d6d57a6b9ef18be6e998be6014816a23d5636de917cc30b1c7f235c5e397db25
-  data.tar.gz: 596cc17142a92d83a48393dc75e299941bde02cfedf5374db8be52526c2a870e3aac796259753500aa4dcc4818e5083671b5ab25a25d8dfa59fdef1fb3c15f70
+  metadata.gz: 22d4b9d0f0b45b10b6636ae23d2d5f6f48af925dfb494394c9c6db51c1cfc59b69cf02d75890f96f7cf8f168ee63081ce4d36284aa6d9729d6157ec70b87ad48
+  data.tar.gz: 1b0fd8305e5140e901b4849c676acd8b07331dfff4d487ff490b794e47fd1eb9a4c78aa55febc008a913d45eef9c7b5cd56be362bf03e2450d9d60c9d8e78dc5

data/README.md

@@ -1,17 +1,77 @@
-# WARNING:
-This gem is a work in progress. If you like what we are doing, feel free to watch it for updates, but please do not attempt to use it in production.
-
 # SimpleTeams
 SimpleTeams is an all-in-one solution for implementing teams quickly in a Ruby on Rails (RoR) application. It follows best practices, using the Rails Engine design pattern for easy configurability, CanCan for authorization, and polymorphic association (like ActiveStorage) to avoid dictating model names.
 
-## Usage
-Pending...
+## STATUS
+SimpleTeams is in use within several client-facing applications. However, the gem is still under development, and notably lacks standalone testing.
+
+That said, feel free to try it out, and let us know if you have any comments/questions. Just make sure to test things thoroughly, and be patient with the (sparse) documentation.
 
 ## Installation
-Pending...
+1. Add simple_teams to your Gemfile and run bundle install
+
+2. Add the necessary initializers to your config directory (NEED TO ADD DETAILS)
+
+- devise.rb (see devise gem for further details)
+
+- simple\_form.rb (see simple_form gem for further details)
+
+- simple\_teams.rb (NEED TO MAKE THIS AN INSTALL SCRIPT)
+
+3. Install the necessary migrations for simple\_teams and it's dependencies
+
+```
+devise generate User
+rails noticed:install:migrations
+rails simple_teams:install:migrations
+```
+
+4. Add the SimpleTeams concerns to the desired models. E.g.
+
+```
+#app/models/user.rb
+class User
+  include SimpleTeams::MemberObject
+...
+
+#app/models/Organization.rb
+class Organization
+  include SimpleTeams::TeamObject
+...
+```
+
+5. Make sure to initialize the TeamObject properly via the InitializeTeamService to specify the owner of the team. E.g.
+
+```
+#within the create action of app/controllers/organizations_controller.rb
+
+def create
+  if @organization.update(organization_params)
+    SimpleTeams::InitializeTeamService.new(current_user, @organization.team).perform
+    redirect_to @organization, ...
+...
+```
+
+## Usage
+1. SimpleTeams comes pre-packaged with all of the necessary controllers and views for adding/updating/removing team members. For the default functionality, you can simply link from the teamable object (e.g. the "Organization") to the team for users to view/manage these permissions. E.g.
+
+```
+#app/views/organizations/show.html.erb
+
+link_to "Organization Roles", simple_teams.team_path(@organization.team)
+
+```
+
+2. The breadcrumbs in these views will reference the default routes for the teamable resource automatically. E.g.
+Organizations / Test Organization / Team Members
+
+However, you can customize these views, as well, by installing them in your application via the standard Engine functionality (i.e. "rails simple\_teams:install:views")
+
+3. NOTE: NEED TO ADD INSTRUCTIONS REGARDING locale configuration.
 
 ## Contributing
-Contribution directions go here.
+This gem is still in its initial stages, so it is important to ensure that it grows in the proper directions.
+
+That said, contributions are welcome, but please give me a heads up on your ideas (via Github issues) so that we can discuss them beforehand.
 
 ## License
 The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/app/controllers/simple_teams/accept_invitations_controller.rb

@@ -16,7 +16,7 @@ module SimpleTeams
         if @service_object.valid?
           @service_object.perform
 
-          SimpleTeams::Invitations::AcceptedNotification.with(
+          SimpleTeams::Invitations::AcceptedNotifier.with(
             :team_id => @team.id,
             :invitation_id => @invitation.id,
             :user_id => current_user.id,

data/app/controllers/simple_teams/invitations_controller.rb

@@ -60,7 +60,7 @@ module SimpleTeams
       invitation_email = @invitation.email
       @invitation.destroy
 
-      SimpleTeams::Invitations::DestroyedNotification.with(
+      SimpleTeams::Invitations::DestroyedNotifier.with(
         :team_id => @team.id,
         :invitation_id => invitation_id,
         :user_id => current_user.id,

data/app/controllers/simple_teams/memberships_controller.rb

@@ -32,7 +32,7 @@ module SimpleTeams
 
       @membership.destroy
 
-      SimpleTeams::Memberships::DestroyedNotification.with(
+      SimpleTeams::Memberships::DestroyedNotifier.with(
         :team_id => @team.id,
         :member_id => member_id,
         :user_id => current_user.id,

data/app/forms/application_form.rb

@@ -0,0 +1,3 @@
+class ApplicationForm
+  include ActiveModel::Model
+end

data/app/forms/simple_teams/invitation_forms/create.rb

@@ -10,7 +10,7 @@ module SimpleTeams
     private
 
     def generate_notification
-      SimpleTeams::Invitations::CreatedNotification.with(
+      SimpleTeams::Invitations::CreatedNotifier.with(
         :team_id => team.id,
         :invitation_id => invitation.id,
         :user_id => current_user.id,

data/app/forms/simple_teams/invitation_forms/create_bulk.rb

@@ -112,7 +112,7 @@ module SimpleTeams
     end
 
     def generate_notification
-      SimpleTeams::BulkInvitationsNotification.with(
+      SimpleTeams::BulkInvitationsNotifier.with(
         :team_id => team.id,
         :user_id => current_user.id,
         :team_name => team.name,

data/app/forms/simple_teams/invitation_forms/update.rb

@@ -15,7 +15,7 @@ module SimpleTeams
     private
 
     def generate_notification
-      SimpleTeams::Invitations::UpdatedNotification.with(
+      SimpleTeams::Invitations::UpdatedNotifier.with(
         :team_id => team.id,
         :invitation_id => invitation.id,
         :user_id => current_user.id,

data/app/forms/simple_teams/membership_form.rb

@@ -77,7 +77,7 @@ module SimpleTeams
     end
 
     def generate_notification
-      SimpleTeams::Memberships::UpdatedNotification.with(
+      SimpleTeams::Memberships::UpdatedNotifier.with(
         :team_id => team.id,
         :member_id => membership.member.id,
         :user_id => current_user.id,

data/app/helpers/simple_teams/base_helper.rb

@@ -0,0 +1,11 @@
+module SimpleTeams
+  module BaseHelper
+    def team_based_role_name(team, role)
+      t "simple_teams.#{team.teamable.class.model_name.plural}.roles.names.#{role}", :default => [t("simple_teams.roles.names.#{role}")]
+    end
+
+    def team_based_role_description(team, role)
+      t "simple_teams.#{team.teamable.class.model_name.plural}.roles.descriptions.#{role}", :default => [t("simple_teams.roles.descriptions.#{role}")]
+    end
+  end
+end

data/app/helpers/simple_teams/teams_helper.rb

@@ -1,4 +1,11 @@
 module SimpleTeams
   module TeamsHelper
+    def team_based_role_name(team, role)
+      t "simple_teams.#{team.teamable.class.to_s.underscore}.role_names.#{role}", :default => [t("simple_teams.role_names.#{role}")]
+    end
+
+    def team_based_role_description(team, role)
+      t "simple_teams.#{team.teamable.class.to_s.underscore}.role_descriptions.#{role}", :default => [t("simple_teams.role_descriptions.#{role}")]
+    end
   end
 end

data/app/mailers/simple_teams/application_mailer.rb

@@ -1,6 +1,6 @@
 module SimpleTeams
   class ApplicationMailer < ActionMailer::Base
-    default from: "from@example.com"
+    default from: SimpleTeams.from_address
     layout "mailer"
   end
 end

data/app/models/concerns/simple_teams/member_object.rb

@@ -5,6 +5,7 @@ module SimpleTeams::MemberObject
     has_many :team_memberships, :class_name => "SimpleTeams::Membership", :foreign_key => :member_id, :dependent => :destroy
     has_many :teams, :through => :team_memberships, :class_name => "SimpleTeams::Team"
     has_many :team_members, :through => :teams, :source => :members, :class_name => SimpleTeams.member_class.to_s
+    has_many :notifications, as: :recipient, :class_name => "Noticed::Notification", dependent: :destroy
   end
 
   def member_of_team?(team)

data/app/models/simple_teams/ability.rb

@@ -14,11 +14,11 @@ module SimpleTeams
       end
 
       can [:update], Team do |team|
-          %w"owner administrator".include? user.role_for_team(team)
+        %w"owner administrator".include? user.role_for_team(team)
       end
 
       can [:destroy], Team do |team|
-          %w"owner".include? user.role_for_team(team)
+        %w"owner".include? user.role_for_team(team)
       end
 
       # Team Memberships/Invitations

data/app/notifiers/concerns/simple_teams/invitation_notifier.rb

@@ -0,0 +1,59 @@
+module SimpleTeams
+  module InvitationNotifier
+    extend ActiveSupport::Concern
+
+    included do
+      required_params :team_id, :invitation_id, :user_id, :team_name, :invitation_name, :user_name
+
+      notification_methods do
+        def message
+          raise NotImplemented
+        end
+
+        def subject
+          raise NotImplemented
+        end
+
+        def url
+          if team.present? and team.members.include? recipient
+            SimpleTeams::Engine.routes.url_helpers.team_path(team)
+          end
+        end
+
+        def link_text
+          "View Invitations"
+        end
+
+        # Objects
+        def team
+          Team.find_by(id: params[:team_id])
+        end
+
+        def user
+          User.find_by(id: params[:user_id])
+        end
+
+        def invitation
+          team.invitations.find_by(id: params[:invitation_id]) if team.present?
+        end
+
+        # Names (fallback)
+        def team_name
+          team.present? ? team.name : params[:team_name]
+        end
+
+        def invitation_name
+          invitation.present? ? invitation.email : params[:invitation_name]
+        end
+
+        def user_name
+          if recipient.id == params[:user_id]
+            "You"
+          else
+            user.present? ? user.full_name : params[:user_name]
+          end
+        end
+      end
+    end
+  end
+end

data/app/notifiers/concerns/simple_teams/membership_notifier.rb

@@ -0,0 +1,63 @@
+module SimpleTeams
+  module MembershipNotifier
+    extend ActiveSupport::Concern
+
+    included do
+      required_params :team_id, :member_id, :user_id, :team_name, :member_name, :user_name
+
+      notification_methods do
+        def message
+          raise NotImplemented
+        end
+
+        def subject
+          raise NotImplemented
+        end
+
+        def url
+          if team.present? and team.members.include? recipient
+            SimpleTeams::Engine.routes.url_helpers.team_path(team)
+          end
+        end
+
+        def link_text
+          "View Permissions"
+        end
+
+        # Objects
+        def team
+          Team.find_by(id: params[:team_id])
+        end
+
+        def user
+          User.find_by(id: params[:user_id])
+        end
+
+        def member
+          team.members.find_by(id: params[:member_id]) if team.present?
+        end
+
+        # Names (fallback)
+        def team_name
+          team.present? ? team.name : params[:team_name]
+        end
+
+        def member_name
+          if recipient.id == params[:member_id]
+            "you"
+          else
+            member.present? ? member.full_name : params[:member_name]
+          end
+        end
+
+        def user_name
+          if recipient.id == params[:user_id]
+            "You"
+          else
+            user.present? ? user.full_name : params[:user_name]
+          end
+        end
+      end
+    end
+  end
+end

data/app/notifiers/simple_teams/application_notifier.rb

@@ -0,0 +1,6 @@
+module SimpleTeams
+  class ApplicationNotifier < Noticed::Event
+    #deliver_by :email, mailer: "NotificationMailer", :method => "notification"
+
+  end
+end

data/app/notifiers/simple_teams/bulk_invitations_notifier.rb

@@ -0,0 +1,52 @@
+module SimpleTeams
+  class BulkInvitationsNotifier < SimpleTeams::ApplicationNotifier
+    required_params :team_id, :user_id, :team_name, :user_name, :invitation_names
+
+    notification_methods do
+      def message
+        "#{user_name} invited #{invitation_names.to_sentence} to #{team_name}."
+      end
+
+      def subject
+        "Users Invited"
+      end
+
+      def url
+        if team.present?
+          SimpleTeams::Engine.routes.url_helpers.team_path(team)
+        end
+      end
+
+      def link_text
+        "View Invitations"
+      end
+
+      # Objects
+      def team
+        Team.find_by(id: params[:team_id])
+      end
+
+      def user
+        User.find_by(id: params[:user_id])
+      end
+
+      # Names (fallback)
+      def team_name
+        team.present? ? team.name : params[:team_name]
+      end
+
+      def invitation_names
+        params[:invitation_names]
+      end
+
+      def user_name
+        if recipient.id == params[:user_id]
+          "You"
+        else
+          user.present? ? user.full_name : params[:user_name]
+        end
+      end
+    end
+
+  end
+end

data/app/notifiers/simple_teams/invitations/accepted_notifier.rb

@@ -0,0 +1,16 @@
+module SimpleTeams
+  class Invitations::AcceptedNotifier < ApplicationNotifier
+    include SimpleTeams::InvitationNotifier
+
+    notification_methods do
+      def message
+        "#{user_name} accepted the invitation to #{team_name}."
+      end
+
+      def subject
+        "Invitation Accepted"
+      end
+    end
+
+  end
+end

data/app/notifiers/simple_teams/invitations/created_notifier.rb

@@ -0,0 +1,16 @@
+module SimpleTeams
+  class Invitations::CreatedNotifier < ApplicationNotifier
+    include SimpleTeams::InvitationNotifier
+
+    notification_methods do
+      def message
+        "#{user_name} invited #{invitation_name} to #{team_name}."
+      end
+
+      def subject
+        "User Invited"
+      end
+    end
+
+  end
+end

data/app/notifiers/simple_teams/invitations/destroyed_notifier.rb

@@ -0,0 +1,16 @@
+module SimpleTeams
+  class Invitations::DestroyedNotifier < ApplicationNotifier
+    include SimpleTeams::InvitationNotifier
+
+    notification_methods do
+      def message
+        "#{user_name} deleted the invitation for #{invitation_name} to #{team_name}."
+      end
+
+      def subject
+        "Invitation Deleted"
+      end
+    end
+
+  end
+end

data/app/notifiers/simple_teams/invitations/updated_notifier.rb

@@ -0,0 +1,16 @@
+module SimpleTeams
+  class Invitations::UpdatedNotifier < ApplicationNotifier
+    include SimpleTeams::InvitationNotifier
+
+    notification_methods do
+      def message
+        "#{user_name} updated the invitation for #{invitation_name} to #{team_name}."
+      end
+
+      def subject
+        "Invitation Updated"
+      end
+    end
+
+  end
+end

data/app/notifiers/simple_teams/memberships/destroyed_notifier.rb

@@ -0,0 +1,16 @@
+module SimpleTeams
+  class Memberships::DestroyedNotifier < ApplicationNotifier
+    include SimpleTeams::MembershipNotifier
+
+    notification_methods do
+      def message
+        "#{user_name} removed #{member_name} from #{team_name}."
+      end
+
+      def subject
+        "Member Removed"
+      end
+    end
+
+  end
+end

data/app/notifiers/simple_teams/memberships/left_notifier.rb

@@ -0,0 +1,20 @@
+module SimpleTeams
+  class Memberships::LeftNotifier < ApplicationNotifier
+    include SimpleTeams::MembershipNotifier
+
+    notification_methods do
+      def message
+        if recipient.id == params[:member_id]
+          "You left #{team_name}."
+        else
+          "#{member_name} left #{team_name}."
+        end
+      end
+
+      def subject
+        "Member Left"
+      end
+    end
+
+  end
+end

data/app/notifiers/simple_teams/memberships/updated_notifier.rb

@@ -0,0 +1,20 @@
+module SimpleTeams
+  class Memberships::UpdatedNotifier < ApplicationNotifier
+    include SimpleTeams::MembershipNotifier
+
+    notification_methods do
+      def message
+        if recipient.id == params[:member_id]
+          "#{user_name} updated your role for #{team_name}."
+        else
+          "#{user_name} updated the role of #{member_name} for #{team_name}."
+        end
+      end
+
+      def subject
+        "Member Updated"
+      end
+    end
+
+  end
+end

data/app/service_objects/simple_teams/leave_team_service.rb

@@ -42,7 +42,7 @@ module SimpleTeams
 
     def generate_notification
       recipients = team.members.to_a << user
-      SimpleTeams::Memberships::LeftNotification.with(
+      SimpleTeams::Memberships::LeftNotifier.with(
         :team_id => team.id,
         :member_id => user.id,
         :user_id => user.id,

data/app/views/simple_teams/_nested_action_breadcrumb.html.erb

@@ -0,0 +1,8 @@
+<nav aria-label="breadcrumb">
+  <ol class="breadcrumb">
+    <li class="breadcrumb-item"><%= link_to @team.teamable.class.model_name.human(count: 2), main_app.url_for(@team.teamable.class) %></li>
+    <li class="breadcrumb-item"><%= link_to @team.teamable.name, main_app.url_for(@team.teamable) %></li>
+    <li class="breadcrumb-item"><%= link_to "Team Members", @team %></li>
+    <li class="breadcrumb-item active" aria-current="page"><%= current_page_name %></li>
+  </ol>
+</nav>

data/app/views/simple_teams/_roles_field.html.erb

@@ -7,8 +7,8 @@
           <%= radio_button_tag "#{prefix}[role]", name, [name].include?(f.object.role), :class => "form-check-input" %>
           <%= label_tag "#{prefix}_role_#{name}", :class => "form-check-label w-100" do %>
             <div class="">
-              <div class="col"><b><%= name.capitalize %></b></div>
-              <div class="col"><%= t "simple_teams.roles.#{name}" %></div>
+              <div class="col"><b><%= team_based_role_name(@team, name) %></b></div>
+              <div class="col"><%= team_based_role_description(@team, name) %></div>
             </div>
           <% end %>
         </div>

data/app/views/simple_teams/invitations/_invitation.html.erb

@@ -1,6 +1,6 @@
 <tr id="<%= dom_id invitation %>">
   <td><%= invitation.email %></td>
-  <td><%= invitation.role.capitalize %></td>
+  <td><%= team_based_role_name(team, invitation.role) %></td>
   <td>Invited</td>
   <td><%= invitation.created_at.to_date %></td>
   <td>

data/app/views/simple_teams/invitations/edit.html.erb

@@ -1,10 +1,5 @@
 <div class="centered-content-template">
-  <nav aria-label="breadcrumb">
-    <ol class="breadcrumb">
-      <li class="breadcrumb-item"><a href="<%= team_path(@team) %>"><%= @team.name %></a></li>
-      <li class="breadcrumb-item active" aria-current="page">Update Invitation</li>
-    </ol>
-  </nav>
+  <%= render "simple_teams/nested_action_breadcrumb", :current_page_name => "Update Invitation" %>
 
   <h1>Update Invitation</h1>
 

data/app/views/simple_teams/invitations/new.html.erb

@@ -1,10 +1,5 @@
 <div class="centered-content-template">
-  <nav aria-label="breadcrumb">
-    <ol class="breadcrumb">
-      <li class="breadcrumb-item"><a href="<%= team_path(@team) %>"><%= @team.name %></a></li>
-      <li class="breadcrumb-item active" aria-current="page">Invite User</li>
-    </ol>
-  </nav>
+  <%= render "simple_teams/nested_action_breadcrumb", :current_page_name => "Invite Users" %>
 
   <h1>Invite Users</h1>
 

data/app/views/simple_teams/memberships/_membership.html.erb

@@ -1,6 +1,6 @@
 <tr id="<%= dom_id membership %>">
   <td><%= membership.member.full_name %><%= " (you)" if current_user.membership_for_team(team) == membership %></td>
-  <td><%= membership.role.capitalize %></td>
+  <td><%= team_based_role_name(team, membership.role) %></td>
   <td>Active</td>
   <td><%= membership.created_at.to_date %></td>
   <td>

data/app/views/simple_teams/memberships/edit.html.erb

@@ -1,10 +1,5 @@
 <div class="centered-content-template">
-  <nav aria-label="breadcrumb">
-    <ol class="breadcrumb">
-      <li class="breadcrumb-item"><a href="<%= team_path(@team) %>"><%= @team.name %></a></li>
-      <li class="breadcrumb-item active" aria-current="page">Edit Member</li>
-    </ol>
-  </nav>
+  <%= render "simple_teams/nested_action_breadcrumb", :current_page_name => "Edit Member" %>
 
   <h1>Edit Member: <%= @membership.member.full_name %></h1>
 

data/app/views/simple_teams/teams/_add_member_link.html.erb

@@ -1,3 +1,3 @@
 <div class="text-center">
-  <%= link_to text, new_team_invitation_path(@team), :class => "btn btn-primary" %>
+  <%= link_to "Invite Users", new_team_invitation_path(@team), :class => "btn btn-primary" %>
 </div>

data/app/views/simple_teams/teams/_dropdown_menu.html.erb

@@ -0,0 +1,14 @@
+<div class="dropdown mt-2">
+  <button class="btn btn-outline-dark btn-sm dropdown-toggle" type="button" id="<%= @team.id %>-dropdown-menu" data-bs-toggle="dropdown" aria-expanded="false">
+    Actions
+  </button>
+  <ul class="dropdown-menu" aria-labelledby="<%= @team.id %>-dropdown-menu">
+    <% if can? :create, @team.invitations.new %>
+      <%= link_to "Invite Users", new_team_invitation_path(@team), :class => "dropdown-item" %>
+    <% end %>
+
+    <% if current_user.membership_for_team(@team).present? %>
+      <%= button_to "Leave", team_leave_team_path(@team), :method => :delete, :class => "btn btn-link dropdown-item", :form => { :data => { "turbo-confirm" => "Are you sure you want to leave this #{ @team.teamable.class.model_name.human }?" } } %>
+    <% end %>
+  </ul>
+</div>