hr_lite 0.58.0 → 0.61.0

data/db/migrate/20261021100200_create_hr_lite_hiring_templates.rb

@@ -0,0 +1,10 @@
+class CreateHrLiteHiringTemplates < ActiveRecord::Migration[8.1]
+  def change
+    create_table :hr_lite_hiring_templates do |t|
+      t.string :name, null: false
+      t.string :subject, null: false
+      t.text :body, null: false
+      t.timestamps
+    end
+  end
+end

data/db/migrate/20261021100300_create_hr_lite_hiring_messages.rb

@@ -0,0 +1,19 @@
+class CreateHrLiteHiringMessages < ActiveRecord::Migration[8.1]
+  def change
+    create_table :hr_lite_hiring_messages do |t|
+      t.references :candidate, null: false, foreign_key: { to_table: :hr_lite_hiring_candidates }
+      t.references :template, null: false, foreign_key: { to_table: :hr_lite_hiring_templates }
+      t.string :batch, null: false
+      t.string :status, null: false, default: "queued"
+      t.string :gmail_message_id
+      t.string :gmail_thread_id
+      t.string :error
+      t.datetime :sent_at
+      t.bigint :sent_by_id
+      t.timestamps
+    end
+    # One send of a template per candidate: double clicks and job redelivery cannot repeat it.
+    add_index :hr_lite_hiring_messages, %i[candidate_id template_id], unique: true
+    add_index :hr_lite_hiring_messages, :batch
+  end
+end

data/db/migrate/20261021100400_create_hr_lite_hiring_interviews.rb

@@ -0,0 +1,16 @@
+class CreateHrLiteHiringInterviews < ActiveRecord::Migration[8.1]
+  def change
+    create_table :hr_lite_hiring_interviews do |t|
+      t.references :candidate, null: false, foreign_key: { to_table: :hr_lite_hiring_candidates }
+      t.integer :round, null: false
+      t.datetime :starts_at, null: false
+      t.datetime :ends_at, null: false
+      t.string :status, null: false, default: "scheduled"
+      t.string :event_id
+      t.string :meet_link
+      t.string :error
+      t.timestamps
+    end
+    add_index :hr_lite_hiring_interviews, %i[candidate_id round]
+  end
+end

data/db/migrate/20261021100500_seed_hr_lite_hiring.rb

@@ -0,0 +1,43 @@
+class SeedHrLiteHiring < ActiveRecord::Migration[8.1]
+  # hiring.manage is new in 0.61.0. RoleSeeds only creates missing roles, so
+  # the existing HR, Leadership and Super Admin roles get it here. Also seeds
+  # the first outreach email so HR starts from the approved wording.
+  BODY = <<~TEXT.freeze
+    Hi @first_name,
+
+    I hope you're doing well.
+
+    I've gone through your profile and CV, and I believe your experience could be a good fit for the @position position at escapes.asia
+
+    Before proceeding with the interview process, we'd like to confirm your interest and comfort with the following details:
+
+    Position: @position
+    Programme: @programme
+    Monthly Stipend: @stipend
+    Full-Time CTC: @ctc, subject to performance and successful completion of the programme
+    Work Location: @location
+    Work Schedule: @schedule
+
+    The programme includes structured training during the first three months, followed by performance reviews and continued hands-on experience. Progression to a full-time role is merit-based and depends on performance throughout the programme.
+
+    Please reply to confirm your interest and availability. Once we receive your confirmation, we'll share the interview schedule and further details.
+
+    Looking forward to hearing from you.
+
+    Best,
+    @sender_name
+  TEXT
+
+  def up
+    HrLite::Role.where(name: [ "HR", "Leadership", "Super Admin" ]).find_each do |role|
+      HrLite::RoleGrant.find_or_initialize_by(role: role, permission_key: "hiring.manage").update!(scope: "all")
+    end
+    execute <<~SQL
+      INSERT INTO hr_lite_hiring_templates (name, subject, body, created_at, updated_at)
+      VALUES (#{connection.quote("Interest check")}, #{connection.quote("@position at escapes.asia: please confirm your interest")},
+              #{connection.quote(BODY)}, CURRENT_TIMESTAMP, CURRENT_TIMESTAMP)
+    SQL
+  end
+
+  def down; end
+end

data/lib/hr_lite/configuration.rb

@@ -35,7 +35,13 @@ module HrLite
                   # ->(user, query) { [{ id:, label: }] } — leads to link to a client meeting
                   :crm_search,
                   # ->(id) { { label:, url: } or nil } — one lead, to validate and link it
-                  :crm_find
+                  :crm_find,
+                  # An object with sender, send_email, create_event, update_event and
+                  # cancel_event (see README, Hiring). nil = hiring cannot send or schedule.
+                  :hiring,
+                  # ->(path, filename) { rows as arrays, headers first } — reads an
+                  # uploaded candidate sheet. Default: .csv only.
+                  :read_sheet
 
     attr_reader :leave_year_start_month, :slip_release_day, :self_regularization, :work_hours
 
@@ -124,6 +130,13 @@ module HrLite
       @require_punch_location = false
       @attendance_slots       = false
       @office_geofence        = false
+      @hiring                 = nil
+      @read_sheet             = ->(path, filename) {
+        raise ArgumentError, "Upload the sheet as a .csv file." unless filename.to_s.downcase.end_with?(".csv")
+
+        require "csv"
+        CSV.read(path, encoding: "bom|utf-8")
+      }
       @work_hours             = nil # e.g. { day: 8, probation_day: 9, week: 40 } — short days close as half days
 
       # Leadership onboarding/offboarding. onboard_user must return a saved

data/lib/hr_lite/notifications.rb

@@ -110,7 +110,7 @@ module HrLite
         lead_path = leadership[:path] || path
 
         deliver_bells(event, row, bell_to, title, body, path)
-        deliver_emails(row, email_to, title, body, path, lines, link_url)
+        deliver_emails(event, row, email_to, title, body, path, lines, link_url)
         return if skip_leadership
 
         deliver_leadership_email(event, row, lead_title, lead_body, lead_path, lines, diff)
@@ -128,7 +128,7 @@ module HrLite
         end
       end
 
-      def deliver_emails(row, email_to, title, body, path, lines, link_url = nil)
+      def deliver_emails(event, row, email_to, title, body, path, lines, link_url = nil)
         return unless row[:email]
 
         # Rescued PER RECIPIENT. Wrapping the whole loop meant one bad address
@@ -147,7 +147,7 @@ module HrLite
             held = held_until[user.id]
             held ? mail.deliver_later(wait_until: held) : mail.deliver_later
           rescue => e
-            Rails.logger.error("[hr_lite] event email failed: #{e.class}: #{e.message}")
+            HrLite.record_failure("#{event}.email", e, subject: user)
           end
         end
       end
@@ -162,7 +162,7 @@ module HrLite
                                body: body, lines: lines, diff: diff, path: path, event: event.to_s)
                    .deliver_later
       rescue => e
-        Rails.logger.error("[hr_lite] leadership email failed: #{e.class}: #{e.message}")
+        HrLite.record_failure("#{event}.leadership_email", e)
       end
 
       def deliver_leadership_bells(event, row, bell_to, title, body, path)
@@ -175,7 +175,7 @@ module HrLite
           HrLite.notify(user: leader, kind: event.to_s, title: title, body: body, path: path)
         end
       rescue => e
-        Rails.logger.error("[hr_lite] leadership bell failed: #{e.class}: #{e.message}")
+        HrLite.record_failure("#{event}.leadership_bell", e)
       end
     end
   end

data/lib/hr_lite/permissions.rb

@@ -65,7 +65,8 @@ module HrLite
       "settings.manage" => [ "Administration", "Change company settings, offices and policy" ],
       "audit.view" => [ "Administration", "Read the audit trail" ],
       "audit.view_money" => [ "Administration", "Read audit rows about pay, appraisals and promotions" ],
-      "role.manage" => [ "Administration", "Create roles and grant permissions" ]
+      "role.manage" => [ "Administration", "Create roles and grant permissions" ],
+      "hiring.manage" => [ "Hiring", "Import candidates, email them from the hiring mailbox, schedule interviews and decide" ]
     }.freeze
 
     KEYS = REGISTRY.keys.freeze

data/lib/hr_lite/role_seeds.rb

@@ -42,7 +42,7 @@ module HrLite
           "expense.claim" => "self", "benefit.view" => "all", "benefit.manage" => "all",
           "hr_request.raise" => "self", "hr_request.manage" => "all", "policy.view" => "all",
           "asset.view" => "all", "asset.manage" => "all", "checklist.manage" => "all",
-          "work_analytics.view" => "all"
+          "work_analytics.view" => "all", "hiring.manage" => "all"
         }
       },
       Role::FINANCE => {
@@ -69,7 +69,7 @@ module HrLite
           "document.view" => "all", "expense.approve" => "all", "benefit.manage" => "all",
           "hr_request.manage" => "all", "policy.view" => "all", "policy.manage" => "all",
           "asset.view" => "all", "asset.manage" => "all", "checklist.manage" => "all",
-          "work_analytics.view" => "all"
+          "work_analytics.view" => "all", "hiring.manage" => "all"
         }
       },
       Role::CA => {

data/lib/hr_lite/version.rb

@@ -1,3 +1,3 @@
 module HrLite
-  VERSION = "0.58.0"
+  VERSION = "0.61.0"
 end

data/lib/hr_lite.rb

@@ -17,6 +17,12 @@ require "hr_lite/amount_in_words"
 require "hr_lite/statutory_rate_card"
 
 module HrLite
+  # Raised by a host hiring adapter. Failed: Google refused, nothing was sent.
+  # Unknown: Google may or may not have acted (a timeout, a 5xx), so the row is
+  # marked for a person to check and never retried by itself.
+  HiringDeliveryFailed = Class.new(StandardError)
+  HiringDeliveryUnknown = Class.new(StandardError)
+
   # Full day / first half / second half — one picker for leave and attendance.
   DAY_PARTS = [ [ "Full day", "" ], [ "First half", "first" ], [ "Second half", "second" ] ].freeze
   class << self
@@ -173,8 +179,18 @@ module HrLite
     def notify(user:, kind:, title:, body: nil, path: nil)
       config.notify.call(user: user, kind: kind, title: title, body: body, path: path)
     rescue => e
-      Rails.logger.error("[hr_lite] notify failed: #{e.class}: #{e.message}")
+      record_failure("notify", e, subject: user)
       nil
     end
+
+    # A background side effect failed: log it and keep a row that HR admins
+    # see on the overview, so nothing fails where nobody looks. Never raises.
+    def record_failure(event, error, subject: nil)
+      Rails.logger.error("[hr_lite] #{event} failed: #{error.class}: #{error.message}")
+      AuditLog.create!(actor: Current.actor, action: "failure.#{event}", subject_type: subject ? subject.class.name : config.user_class,
+                       subject_id: subject&.id || 0, audited_changes: { "error" => error.class.name, "message" => error.message.to_s.truncate(200) })
+    rescue => e
+      Rails.logger.error("[hr_lite] recording a failure failed: #{e.class}: #{e.message}")
+    end
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: hr_lite
 version: !ruby/object:Gem::Version
-  version: 0.58.0
+  version: 0.61.0
 platform: ruby
 authors:
 - kshitiz sinha
@@ -97,6 +97,11 @@ files:
 - app/controllers/hr_lite/admin/employees_controller.rb
 - app/controllers/hr_lite/admin/expense_categories_controller.rb
 - app/controllers/hr_lite/admin/expenses_controller.rb
+- app/controllers/hr_lite/admin/hiring_campaigns_controller.rb
+- app/controllers/hr_lite/admin/hiring_candidates_controller.rb
+- app/controllers/hr_lite/admin/hiring_interviews_controller.rb
+- app/controllers/hr_lite/admin/hiring_sends_controller.rb
+- app/controllers/hr_lite/admin/hiring_templates_controller.rb
 - app/controllers/hr_lite/admin/holidays_controller.rb
 - app/controllers/hr_lite/admin/hr_requests_controller.rb
 - app/controllers/hr_lite/admin/leadership_controller.rb
@@ -168,6 +173,7 @@ files:
 - app/jobs/hr_lite/calendar_meeting_sync_job.rb
 - app/jobs/hr_lite/daily_digest_job.rb
 - app/jobs/hr_lite/document_expiry_job.rb
+- app/jobs/hr_lite/hiring_send_job.rb
 - app/jobs/hr_lite/leave_year_rollover_job.rb
 - app/jobs/hr_lite/payroll_auto_approve_job.rb
 - app/jobs/hr_lite/payroll_auto_draft_job.rb
@@ -205,6 +211,11 @@ files:
 - app/models/hr_lite/employee_profile.rb
 - app/models/hr_lite/expense.rb
 - app/models/hr_lite/expense_category.rb
+- app/models/hr_lite/hiring_campaign.rb
+- app/models/hr_lite/hiring_candidate.rb
+- app/models/hr_lite/hiring_interview.rb
+- app/models/hr_lite/hiring_message.rb
+- app/models/hr_lite/hiring_template.rb
 - app/models/hr_lite/holiday.rb
 - app/models/hr_lite/hr_request.rb
 - app/models/hr_lite/kudo.rb
@@ -248,6 +259,8 @@ files:
 - app/services/hr_lite/calculators/proration.rb
 - app/services/hr_lite/calculators/tds.rb
 - app/services/hr_lite/day_status.rb
+- app/services/hr_lite/hiring_import.rb
+- app/services/hr_lite/hiring_merge.rb
 - app/services/hr_lite/leave_day_counter.rb
 - app/services/hr_lite/overview_query.rb
 - app/services/hr_lite/payroll_run_processor.rb
@@ -296,6 +309,19 @@ files:
 - app/views/hr_lite/admin/expense_categories/index.html.erb
 - app/views/hr_lite/admin/expense_categories/new.html.erb
 - app/views/hr_lite/admin/expenses/index.html.erb
+- app/views/hr_lite/admin/hiring_campaigns/_form.html.erb
+- app/views/hr_lite/admin/hiring_campaigns/edit.html.erb
+- app/views/hr_lite/admin/hiring_campaigns/import.html.erb
+- app/views/hr_lite/admin/hiring_campaigns/index.html.erb
+- app/views/hr_lite/admin/hiring_campaigns/new.html.erb
+- app/views/hr_lite/admin/hiring_campaigns/preview.html.erb
+- app/views/hr_lite/admin/hiring_campaigns/show.html.erb
+- app/views/hr_lite/admin/hiring_candidates/show.html.erb
+- app/views/hr_lite/admin/hiring_sends/new.html.erb
+- app/views/hr_lite/admin/hiring_templates/_form.html.erb
+- app/views/hr_lite/admin/hiring_templates/edit.html.erb
+- app/views/hr_lite/admin/hiring_templates/index.html.erb
+- app/views/hr_lite/admin/hiring_templates/new.html.erb
 - app/views/hr_lite/admin/holidays/index.html.erb
 - app/views/hr_lite/admin/hr_requests/index.html.erb
 - app/views/hr_lite/admin/hr_requests/show.html.erb
@@ -508,6 +534,12 @@ files:
 - db/migrate/20261016100000_add_hours_allowance_repeat_to_hr_lite_employee_profiles.rb
 - db/migrate/20261017161441_make_hr_lite_benefit_enrolments_unique_while_open.rb
 - db/migrate/20261017161443_add_attendance_record_id_index_to_hr_lite_work_mode_events.rb
+- db/migrate/20261021100000_create_hr_lite_hiring_campaigns.rb
+- db/migrate/20261021100100_create_hr_lite_hiring_candidates.rb
+- db/migrate/20261021100200_create_hr_lite_hiring_templates.rb
+- db/migrate/20261021100300_create_hr_lite_hiring_messages.rb
+- db/migrate/20261021100400_create_hr_lite_hiring_interviews.rb
+- db/migrate/20261021100500_seed_hr_lite_hiring.rb
 - lib/generators/hr_lite/install/install_generator.rb
 - lib/generators/hr_lite/install/templates/AFTER_INSTALL
 - lib/generators/hr_lite/install/templates/initializer.rb