dcidev_approval 0.0.8 → 0.0.9

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 113b68a6c6cc3aa09902b2ede950d44deaa4a3f9cfe8a72c4ab4e1a9051e5ca7
-  data.tar.gz: 489f1c91e45864e4d88ab12bd32dd34f9eafc1c1e381d9d8be92884703e7f316
+  metadata.gz: e97350e7fc396ea5b6badf639f46c97c256de119290e7f4cf209a29b55c13fc2
+  data.tar.gz: 32378050bd803f53adf02652f4d5502b871e2ea6ce7aed380970a395d1562761
 SHA512:
-  metadata.gz: 6b59254605c479585ecd5289dfd6e1f41c15aa4cde5888a4c1f834633a1f56e13d04fe1570762507adf249411d11234e0aaf102bd13e150e9f2dfbe98c40aa98
-  data.tar.gz: c1af9bc61fb9ae9fc0ce9da4daef4b1c9dc44975f04a4a68ca07371f4109ea7c3569f508243ed8fd799c0cb0b354aa2b3e106f27083973ff9875b307bb5becd5
+  metadata.gz: 59b9cf658199b5dd33f76c3eb22f6d302718a908f220d986a46d9fe90a28f82b490fbc31993a36193f555cadcd5bed77ef91f73c8276a513af210db61aa7f53b
+  data.tar.gz: f800249db88dacaafadfaa400946f602753c558288e6f0671c25c780de21b3fd4660d4e4954472ec8d1264fde3b3214d9c24dee755284224d2cbb146979d85de

data/README.md

@@ -1 +1,93 @@
-dcidev_approval
+# Setup
+##### 1. Add new column named `status` to every model requiring this gem
+`db/migrate/migration_file.rb`
+```ruby
+class AddStatusToProduk < ActiveRecord::Migration[6.0]
+    def change 
+        add_column :produk, :status, :string
+        add_column :produk, :change_status, :string
+    end
+end
+```
+`app/models/model.rb`
+```ruby
+STATUS = %w[waiting approved rejected].freeze
+enum status: STATUS.zip(STATUS).to_h, _prefix: true
+
+CHANGE_STATUS = %w(pending_delete pending_update).freeze
+enum change_status: CHANGE_STATUS.zip(CHANGE_STATUS).to_h, _prefix: true
+```
+
+
+
+##### 2. Format your `Agent` and `Role` with one-many relationship.
+##### 3.  Declare instance method `is_admin?` to `Agent` to find out whether an agent is an admin or not
+
+```ruby
+def is_admin?
+    # add your custom logic here
+    self.approved? && ["admin", "super_admin", "checker"].include?(self.try(:roles).try(:first).try(:code))
+end
+```
+
+##### 4. Include the module to every model requiring approval. Or just put it in `ApplicationRecord`
+`app/models/application_record.rb`
+```ruby
+class ApplicationRecord < ActiveRecord::Base
+    include DcidevApproval
+    self.abstract_class = true
+    # ...
+end
+```
+
+# Features
+* Create: `Model.create_data(declared(params), current_user, bypass)`
+* Update: `model.edit_data(declared(params), current_user, bypass)`
+* Delete: `model.delete_data(declared(params), current_user, bypass)`
+* Approval: `model.approval(declared(params))`
+* Compare current database value and argument to check if there are any update: `model.changes_present?(params)`
+* Check approval status: `model.waiting_approval?`, `model.pending_insert?`, `model.pending_update?`, `model.pending_delete?`
+* Find last lodifier & timestamp: `model.last_modified_by`
+* Find author: `model.created_by`
+* Find approval agent & timestamp: `model.last_approved_by`
+
+Explanation
+* `declared(params)`: is a hash value from Grape Parameters, plain ruby hash can also be used
+* `current_user`: the agent responsible for the changes
+* `bypass`: boolean value to toogle the approval system. If not sent, the default value is `true`
+
+To track changes peformed to a record, call 
+# Callbacks
+To execute code before/after the CRUD, include module `DcidevApproval` in `ApplicationRecord` and peform overide and or overload on it's child model.
+
+`app/models/application_record.rb`
+```ruby
+class ApplicationRecord < ActiveRecord::Base
+    include DcidevApproval
+    self.abstract_class = true
+    # ...
+end
+```
+
+`app/models/child_model.rb`
+```ruby
+class ChildModel < ApplicationRecord
+    # ...
+    def self.create_data(params, agent, request)
+        super(params, agent, false) do |data|
+            # do something after the record is successfully created
+            # in this case, write an activity log
+            # the data variable will return the created record
+            ActivityLog.write("#{agent.is_admin? || params.bypass ? nil : "Request "} Add #{self.class.to_s}", request, agent, menu, data) if params.log
+        end
+    end
+    
+    def edit_data(params, agent, request)
+        super(params, agent, false) do |_|
+            # do something after the record is successfully edited and require approval
+        end
+    end
+    # ...
+end
+
+```

data/lib/dcidev_approval.rb

@@ -37,7 +37,7 @@ module DcidevApproval
     end
 
     def approved?
-      self.status == "approved"
+      self.status == "approved" || self.change_status.nil?
     end
 
     def rejected?
@@ -56,7 +56,7 @@ module DcidevApproval
         log = self.activity_logs.where("activity LIKE '%edit%'").limit(1).order(created_at: :desc).try(:first)
       end
       {
-        modified_by: log.present? ? log.try(:agent).try(:name).to_s + " (#{log.try(:agent).try(:username).to_s} | #{log.try(:agent).try(:roles).try(:first).try(:name)})" : "System",
+        modified_by: log.present? ? log.try(:agent).try(:name).to_s + " (#{log.try(:agent).try(:username).to_s} | #{log.try(:agent).try(:roles).try(:first).try(:name)})" : nil,
         modified_at: log.present? ? log.try(:created_at) || self.try(:updated_at) || self.try(:created_at) : nil
       }
     end
@@ -121,7 +121,7 @@ module DcidevApproval
           # ActivityLog.write("#{agent.is_admin? ? nil : "Request "}Edit #{self.class.to_s}", request, agent, menu, self) if params.log
         end
       end
-      yield true
+      yield self
     end
 
     def approval(params)
@@ -130,7 +130,7 @@ module DcidevApproval
       elsif params.status == "rejected"
         self.delete_changes
       end
-      yield true
+      yield self
     end
 
     def delete_data(agent, bypass = true)
@@ -155,15 +155,15 @@ module DcidevApproval
           data = params.merge!({ status: :approved })
           d = self.new_from_params(data)
           raise d.errors.full_messages.join(", ") unless d.save
+          yield d
           # ActivityLog.write("#{agent.is_admin? ? nil : "Request "} Add #{self.to_s}", request, agent, menu, d) if params.log
         end
       else
         d = self.new_from_params(params)
         d.status = agent.is_admin? ? :approved : :waiting
         raise d.errors.full_messages.join(", ") unless d.save
-        # ActivityLog.write("Add #{self.to_s}", request, agent, menu, d) if params.log
+        yield d
       end
-      yield d
     end
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: dcidev_approval
 version: !ruby/object:Gem::Version
-  version: 0.0.8
+  version: 0.0.9
 platform: ruby
 authors:
 - Punto Damar P
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-02-04 00:00:00.000000000 Z
+date: 2022-02-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: dcidev_active_record
@@ -51,7 +51,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.3.1
+rubygems_version: 3.1.2
 signing_key: 
 specification_version: 4
 summary: Logic for implementing record changes approval