hr_lite 0.60.0 → 0.61.0

data/app/views/hr_lite/admin/hiring_templates/index.html.erb

@@ -0,0 +1,15 @@
+<% content_for(:page_title) { "Hiring emails" } %>
+<div class="hrl-page__head">
+  <h1 class="hrl-page__title">Hiring email templates</h1>
+  <div class="hrl-page__actions"><a class="hrl-btn hrl-btn--primary" href="<%= hr_lite.new_admin_hiring_template_path %>">New template</a></div>
+</div>
+<section class="hrl-card">
+  <ul class="hrl-feed">
+    <% @templates.each do |template| %>
+      <li class="hrl-feed__item"><div class="hrl-feed__body">
+        <a class="hrl-card__link" href="<%= hr_lite.edit_admin_hiring_template_path(template) %>"><%= template.name %></a>
+        <span class="hrl-feed__meta"><%= template.subject %></span>
+      </div></li>
+    <% end %>
+  </ul>
+</section>

data/app/views/hr_lite/admin/hiring_templates/new.html.erb

@@ -0,0 +1,3 @@
+<% content_for(:page_title) { "New template" } %>
+<div class="hrl-page__head"><h1 class="hrl-page__title">New hiring email</h1></div>
+<section class="hrl-card"><%= render "form", template: @template %></section>

data/config/routes.rb

@@ -71,6 +71,16 @@ HrLite::Engine.routes.draw do
 
   namespace :admin do
     resources :policies, only: %i[index new create]
+    resources :hiring_campaigns, except: %i[destroy] do
+      member { get :import; post :import }
+      resources :hiring_sends, path: "send", only: %i[new create]
+    end
+    resources :hiring_candidates, only: %i[show] do
+      member { patch :stage }
+      resources :hiring_interviews, path: "interviews", only: %i[create update destroy]
+    end
+    resources :hiring_templates, except: %i[show destroy]
+    post "hiring_messages/:id/retry", to: "hiring_sends#retry", as: :retry_hiring_message
     get "overview", to: "overview#index"
     resources :attendances, only: %i[index show update], param: :user_id do
       collection { get :week }

data/db/migrate/20261021100000_create_hr_lite_hiring_campaigns.rb

@@ -0,0 +1,15 @@
+class CreateHrLiteHiringCampaigns < ActiveRecord::Migration[8.1]
+  def change
+    create_table :hr_lite_hiring_campaigns do |t|
+      t.string :title, null: false
+      t.string :position, null: false
+      t.string :programme
+      t.string :stipend
+      t.string :ctc
+      t.string :location
+      t.string :schedule
+      t.string :status, null: false, default: "open"
+      t.timestamps
+    end
+  end
+end

data/db/migrate/20261021100100_create_hr_lite_hiring_candidates.rb

@@ -0,0 +1,22 @@
+class CreateHrLiteHiringCandidates < ActiveRecord::Migration[8.1]
+  def change
+    create_table :hr_lite_hiring_candidates do |t|
+      t.references :campaign, null: false, foreign_key: { to_table: :hr_lite_hiring_campaigns }
+      t.string :name, null: false
+      t.string :email, null: false
+      t.text :phone
+      t.text :date_of_birth
+      t.string :campus
+      t.string :course
+      t.string :branch
+      t.string :cv_url
+      t.json :extra, null: false, default: {}
+      t.string :stage, null: false, default: "imported"
+      t.integer :round, null: false, default: 0
+      t.string :rejection_reason
+      t.timestamps
+    end
+    add_index :hr_lite_hiring_candidates, %i[campaign_id email], unique: true
+    add_index :hr_lite_hiring_candidates, %i[campaign_id stage]
+  end
+end

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/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.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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: hr_lite
 version: !ruby/object:Gem::Version
-  version: 0.60.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