hr_lite 0.60.0 → 0.62.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/db/migrate/20261022090000_create_hr_lite_hiring_replies.rb

@@ -0,0 +1,26 @@
+class CreateHrLiteHiringReplies < ActiveRecord::Migration[8.1]
+  # One reply link per candidate per interview round: their answers, the day
+  # and 2-hour slot they picked, an optional alternate phone, and (from round
+  # 2) their documents through Active Storage, stored encrypted. Round 3 adds
+  # the joining KYC: Aadhaar, PAN (or "PAN pending") and salary slips.
+  def change
+    create_table :hr_lite_hiring_replies do |t|
+      t.references :candidate, null: false, foreign_key: { to_table: :hr_lite_hiring_candidates }
+      t.integer :round, null: false
+      t.string :token, null: false
+      t.json :answers, null: false, default: {}
+      t.text :alternate_phone
+      t.text :aadhaar_number
+      t.text :pan_number
+      t.boolean :pan_pending, null: false, default: false
+      t.boolean :no_salary_slips, null: false, default: false
+      t.date :preferred_date
+      t.string :preferred_slot
+      t.datetime :responded_at
+      t.timestamps
+    end
+    add_index :hr_lite_hiring_replies, :token, unique: true
+    add_index :hr_lite_hiring_replies, %i[candidate_id round], unique: true
+    add_index :hr_lite_hiring_replies, %i[preferred_date preferred_slot]
+  end
+end

data/db/migrate/20261022090100_add_allow_sunday_to_hr_lite_hiring_campaigns.rb

@@ -0,0 +1,6 @@
+class AddAllowSundayToHrLiteHiringCampaigns < ActiveRecord::Migration[8.1]
+  # Sunday is off; HR can open it for one campaign's interview slots.
+  def change
+    add_column :hr_lite_hiring_campaigns, :allow_sunday, :boolean, null: false, default: false
+  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/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.60.0"
+  VERSION = "0.62.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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: hr_lite
 version: !ruby/object:Gem::Version
-  version: 0.60.0
+  version: 0.62.0
 platform: ruby
 authors:
 - kshitiz sinha
@@ -75,6 +75,7 @@ files:
 - app/assets/javascripts/hr_lite/photo_crop.js
 - app/assets/javascripts/hr_lite/print.js
 - app/assets/javascripts/hr_lite/search.js
+- app/assets/javascripts/hr_lite/select_all.js
 - app/assets/javascripts/hr_lite/select_filter.js
 - app/assets/javascripts/hr_lite/share.js
 - app/assets/javascripts/hr_lite/tax_preview.js
@@ -97,6 +98,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
@@ -136,6 +142,7 @@ files:
 - app/controllers/hr_lite/documents_controller.rb
 - app/controllers/hr_lite/employee_profiles_controller.rb
 - app/controllers/hr_lite/expenses_controller.rb
+- app/controllers/hr_lite/hiring_replies_controller.rb
 - app/controllers/hr_lite/holidays_controller.rb
 - app/controllers/hr_lite/home_controller.rb
 - app/controllers/hr_lite/hr_requests_controller.rb
@@ -168,6 +175,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 +213,12 @@ 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_reply.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 +262,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 +312,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
@@ -381,6 +410,7 @@ files:
 - app/views/hr_lite/event_mailer/leadership.text.erb
 - app/views/hr_lite/expenses/index.html.erb
 - app/views/hr_lite/expenses/new.html.erb
+- app/views/hr_lite/hiring_replies/show.html.erb
 - app/views/hr_lite/holidays/_next_holiday.html.erb
 - app/views/hr_lite/holidays/index.html.erb
 - app/views/hr_lite/home/_today_checkins.html.erb
@@ -431,6 +461,7 @@ files:
 - app/views/layouts/hr_lite/mailer.html.erb
 - app/views/layouts/hr_lite/mailer.text.erb
 - app/views/layouts/hr_lite/pdf.html.erb
+- app/views/layouts/hr_lite/public.html.erb
 - config/routes.rb
 - db/migrate/20260718190726_create_hr_lite_kudos.rb
 - db/migrate/20260718190727_create_hr_lite_kudo_mentions.rb
@@ -508,6 +539,14 @@ 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
+- db/migrate/20261022090000_create_hr_lite_hiring_replies.rb
+- db/migrate/20261022090100_add_allow_sunday_to_hr_lite_hiring_campaigns.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