hr_lite 0.16.0 → 0.18.0

data/app/services/hr_lite/attendance_summary.rb

@@ -2,7 +2,8 @@ module HrLite
   # Month roll-up per user — the payroll contract. Exact math per date:
   #
   #   holiday / weekend / present / paid full-day leave  -> payable +1
-  #   unpaid full-day leave (LWP) / absent               -> lop +1
+  #   unpaid full-day leave (LWP, or a paid-type day beyond the balance —
+  #     LeaveRequest#unpaid_on) / absent                 -> lop +1
   #   half-day punch (no leave)                          -> payable +0.5, lop +0.5
   #   half-day PAID leave: leave half payable; other half payable if
   #     punched, else lop (unpaid half-day leave: leave half is lop too)
@@ -54,13 +55,11 @@ module HrLite
           summary[:payable_days] += BigDecimal("0.5")
           summary[:lop_days] += BigDecimal("0.5")
         when :leave
-          if day.leave.paid?
-            summary[:paid_leave] += 1
-            summary[:payable_days] += 1
-          else
-            summary[:unpaid_leave] += 1
-            summary[:lop_days] += 1
-          end
+          unpaid = day.leave.paid? ? day.leave.unpaid_on(date) : 1
+          summary[:paid_leave] += 1 - unpaid
+          summary[:payable_days] += 1 - unpaid
+          summary[:unpaid_leave] += unpaid
+          summary[:lop_days] += unpaid
         when :half_day_leave
           apply_half_day_leave(summary, day)
         when :upcoming
@@ -77,13 +76,11 @@ module HrLite
     def self.apply_half_day_leave(summary, day)
       half = BigDecimal("0.5")
 
-      if day.leave.paid?
-        summary[:paid_leave] += half
-        summary[:payable_days] += half
-      else
-        summary[:unpaid_leave] += half
-        summary[:lop_days] += half
-      end
+      unpaid = day.leave.paid? ? day.leave.unpaid_on(day.leave.start_date) : half
+      summary[:paid_leave] += half - unpaid
+      summary[:payable_days] += half - unpaid
+      summary[:unpaid_leave] += unpaid
+      summary[:lop_days] += unpaid
 
       if day.record&.check_in_at
         summary[:present] += half

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

@@ -0,0 +1,65 @@
+<% content_for(:page_title) { "Benefits" } %>
+<div class="hrl-page__head">
+  <h1 class="hrl-page__title">Benefits</h1>
+  <div class="hrl-page__actions">
+    <a class="hrl-btn hrl-btn--primary" href="<%= hr_lite.new_admin_benefit_path %>">Add benefit</a>
+  </div>
+</div>
+
+<% if @benefits.none? %>
+  <section class="hrl-card"><p class="hrl-card--empty">No benefits yet — add one, then enrol people here.</p></section>
+<% end %>
+<% people = HrLite.active_employees.map { |u| [ hr_display_name(u), u.id ] } %>
+<% @benefits.each do |benefit| %>
+  <section class="hrl-card">
+    <h2 class="hrl-card__title"><%= benefit.name %></h2>
+    <p class="hrl-small hrl-muted">
+      <%= benefit.kind.humanize %><%= " · #{benefit.provider}" if benefit.provider.present? %>
+      · cover <%= hrl_money(benefit.coverage) %>
+    </p>
+    <%= form_with url: hr_lite.enrol_admin_benefit_path(benefit), method: :post, local: true do %>
+      <div class="hrl-field">
+        <%= label_tag "enrol_user_#{benefit.id}", "Employee" %>
+        <%= select_tag :user_id, options_for_select(people), id: "enrol_user_#{benefit.id}" %>
+      </div>
+      <div class="hrl-field">
+        <%= label_tag "enrol_on_#{benefit.id}", "Covered from" %>
+        <%= date_field_tag :enrolled_on, Date.current, id: "enrol_on_#{benefit.id}" %>
+      </div>
+      <div class="hrl-field">
+        <%= label_tag "enrol_dependants_#{benefit.id}", "Dependants covered" %>
+        <%= number_field_tag :dependants, 0, min: 0, id: "enrol_dependants_#{benefit.id}" %>
+      </div>
+      <div class="hrl-form-actions"><%= submit_tag "Enrol", class: "hrl-btn hrl-btn--primary" %></div>
+    <% end %>
+  </section>
+<% end %>
+
+<% if @enrolments.any? %>
+  <section class="hrl-card">
+    <h2 class="hrl-card__title">Enrolled</h2>
+    <div class="hrl-table-wrap">
+      <table class="hrl-table hrl-table--stack">
+        <thead><tr><th>Who</th><th>Benefit</th><th>Since</th><th>Dependants</th><th></th></tr></thead>
+        <tbody>
+          <% @enrolments.each do |enrolment| %>
+            <tr>
+              <td data-label="Who"><%= hr_display_name(enrolment.user) %></td>
+              <td data-label="Benefit"><%= enrolment.benefit.name %></td>
+              <td data-label="Since"><%= enrolment.enrolled_on.strftime("%d %b %Y") %></td>
+              <td data-label="Dependants" class="hrl-num"><%= enrolment.dependants %></td>
+              <td data-label="">
+                <%= form_with url: hr_lite.unenrol_admin_benefit_path(enrolment.benefit), method: :post do %>
+                  <%= hidden_field_tag :user_id, enrolment.user_id %>
+                  <%= date_field_tag :ended_on, Date.current, class: "hrl-input", "aria-label": "Last day of cover" %>
+                  <%= submit_tag "End cover", class: "hrl-btn" %>
+                <% end %>
+              </td>
+            </tr>
+          <% end %>
+        </tbody>
+      </table>
+    </div>
+    <%= hrl_pagination %>
+  </section>
+<% end %>

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

@@ -0,0 +1,37 @@
+<% content_for(:page_title) { "Add benefit" } %>
+<div class="hrl-page__head"><h1 class="hrl-page__title">Add benefit</h1></div>
+
+<section class="hrl-card">
+  <%= form_with model: @benefit, url: hr_lite.admin_benefits_path, method: :post, local: true do |f| %>
+    <%= render "hr_lite/shared/form_errors", record: @benefit %>
+    <div class="hrl-field"><%= f.label :name %><%= f.text_field :name %></div>
+    <div class="hrl-field">
+      <%= f.label :kind %>
+      <%= f.select :kind, HrLite::Benefit::KINDS.map { |k| [ k.humanize, k ] } %>
+    </div>
+    <div class="hrl-field"><%= f.label :provider, "Provider (optional)" %><%= f.text_field :provider %></div>
+    <div class="hrl-field">
+      <%= f.label :policy_number, "Policy number (optional)" %>
+      <%= f.text_field :policy_number %>
+    </div>
+    <div class="hrl-field">
+      <%= f.label :coverage, "Cover (₹)" %>
+      <%= f.text_field :coverage, value: @benefit.coverage&.to_s("F"), inputmode: "decimal" %>
+    </div>
+    <div class="hrl-field">
+      <%= f.label :employer_premium, "Premium the company pays (₹)" %>
+      <%= f.text_field :employer_premium, value: @benefit.employer_premium&.to_s("F"), inputmode: "decimal" %>
+    </div>
+    <div class="hrl-field">
+      <%= f.label :employee_premium, "Premium the employee pays (₹)" %>
+      <%= f.text_field :employee_premium, value: @benefit.employee_premium&.to_s("F"), inputmode: "decimal" %>
+    </div>
+    <div class="hrl-field"><%= f.label :effective_from, "Starts" %><%= f.date_field :effective_from %></div>
+    <div class="hrl-field"><%= f.label :expires_on, "Expires" %><%= f.date_field :expires_on %></div>
+    <div class="hrl-field"><%= f.label :notes %><%= f.text_field :notes %></div>
+    <div class="hrl-form-actions">
+      <%= f.submit "Save", class: "hrl-btn hrl-btn--primary" %>
+      <a class="hrl-btn" href="<%= hr_lite.admin_benefits_path %>">Cancel</a>
+    </div>
+  <% end %>
+</section>

data/app/views/hr_lite/admin/expense_categories/_form.html.erb

@@ -0,0 +1,16 @@
+<section class="hrl-card">
+  <%= form_with model: expense_category, url: url, method: method, local: true do |f| %>
+    <%= render "hr_lite/shared/form_errors", record: expense_category %>
+    <div class="hrl-field"><%= f.label :name %><%= f.text_field :name %></div>
+    <div class="hrl-field">
+      <%= f.label :monthly_cap, "Monthly cap per person (₹, blank = no cap)" %>
+      <%= f.number_field :monthly_cap, step: 0.01, min: 0, value: expense_category.monthly_cap&.to_s("F") %>
+    </div>
+    <div class="hrl-field hrl-field--check"><%= f.check_box :receipt_required %><%= f.label :receipt_required, "Receipt required" %></div>
+    <div class="hrl-field hrl-field--check"><%= f.check_box :active %><%= f.label :active, "Active (offered on the claim form)" %></div>
+    <div class="hrl-form-actions">
+      <%= f.submit "Save", class: "hrl-btn hrl-btn--primary" %>
+      <a class="hrl-btn" href="<%= hr_lite.admin_expense_categories_path %>">Cancel</a>
+    </div>
+  <% end %>
+</section>

data/app/views/hr_lite/admin/expense_categories/edit.html.erb

@@ -0,0 +1,3 @@
+<% content_for(:page_title) { "Edit expense category" } %>
+<div class="hrl-page__head"><h1 class="hrl-page__title">Edit <%= @expense_category.name %></h1></div>
+<%= render "form", expense_category: @expense_category, url: hr_lite.admin_expense_category_path(@expense_category), method: :patch %>

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

@@ -0,0 +1,30 @@
+<% content_for(:page_title) { "Expense categories" } %>
+<div class="hrl-page__head">
+  <h1 class="hrl-page__title">Expense categories</h1>
+  <div class="hrl-page__actions">
+    <a class="hrl-btn hrl-btn--primary" href="<%= hr_lite.new_admin_expense_category_path %>">Add category</a>
+  </div>
+</div>
+
+<section class="hrl-card">
+  <% if @expense_categories.any? %>
+    <div class="hrl-table-wrap">
+      <table class="hrl-table hrl-table--stack">
+        <thead><tr><th>Name</th><th>Monthly cap</th><th>Receipt</th><th>Active</th><th></th></tr></thead>
+        <tbody>
+          <% @expense_categories.each do |category| %>
+            <tr>
+              <td data-label="Name"><%= category.name %></td>
+              <td data-label="Monthly cap" class="hrl-num"><%= category.uncapped? ? "No cap" : hrl_money(category.monthly_cap) %></td>
+              <td data-label="Receipt"><%= category.receipt_required ? "Required" : "Optional" %></td>
+              <td data-label="Active"><%= category.active ? "Yes" : "No" %></td>
+              <td data-label=""><a class="hrl-small" href="<%= hr_lite.edit_admin_expense_category_path(category) %>">Edit</a></td>
+            </tr>
+          <% end %>
+        </tbody>
+      </table>
+    </div>
+  <% else %>
+    <p class="hrl-card--empty">No categories yet — nobody can file an expense claim until one exists.</p>
+  <% end %>
+</section>

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

@@ -0,0 +1,3 @@
+<% content_for(:page_title) { "Add expense category" } %>
+<div class="hrl-page__head"><h1 class="hrl-page__title">Add expense category</h1></div>
+<%= render "form", expense_category: @expense_category, url: hr_lite.admin_expense_categories_path, method: :post %>

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

@@ -3,6 +3,8 @@
   <h1 class="hrl-page__title">Team leave balances <%= HrLite::LeaveYear.label(@year) %></h1>
 </div>
 
+<%= render "hr_lite/admin/shared/approvals_tabs", active: :balances %>
+
 <section class="hrl-card">
   <div class="hrl-table-wrap">
     <table class="hrl-table">
@@ -24,6 +26,7 @@
   </div>
 </section>
 
+<% if hr_can?("leave.manage", scope: :team) %>
 <section class="hrl-card">
   <h2 class="hrl-card__title">Adjust a balance</h2>
   <p class="hrl-small hrl-muted">Positive credits (comp-off), negative debits. Fully audited.</p>
@@ -56,3 +59,4 @@
     </div>
   <% end %>
 </section>
+<% end %>

data/app/views/hr_lite/admin/leave_requests/show.html.erb

@@ -18,6 +18,9 @@
     <% unless @request.leave_type.unlimited? %>
       <dt>Balance</dt>
       <dd><%= @balance.available.to_f %> of <%= @balance.entitled.to_f %> available</dd>
+      <% if (@request.pending? || @request.approved?) && (short = @request.days_beyond_balance).positive? %>
+        <dt>Loss of pay</dt><dd><%= short.to_s("F") %> day(s) beyond the balance will be unpaid</dd>
+      <% end %>
     <% end %>
     <% if @request.decision_note.present? %><dt>Decision note</dt><dd><%= @request.decision_note %></dd><% end %>
   </dl>

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

@@ -35,5 +35,6 @@
 <div class="hrl-row">
   <a class="hrl-btn" href="<%= hr_lite.admin_office_locations_path %>">Office locations</a>
   <a class="hrl-btn" href="<%= hr_lite.admin_holidays_path %>">Holidays</a>
+  <a class="hrl-btn" href="<%= hr_lite.admin_expense_categories_path %>">Expense categories</a>
   <a class="hrl-btn" href="<%= hr_lite.edit_admin_setting_path %>">Weekend policy</a>
 </div>

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

@@ -0,0 +1,47 @@
+<% content_for(:page_title) { "One-off pay items" } %>
+<div class="hrl-page__head">
+  <h1 class="hrl-page__title">One-off pay items</h1>
+  <div class="hrl-page__actions">
+    <a class="hrl-btn hrl-btn--primary" href="<%= hr_lite.new_admin_payroll_line_item_path(month: @month.strftime("%Y-%m")) %>">Add an item</a>
+  </div>
+</div>
+
+<section class="hrl-card">
+  <div class="hrl-row">
+    <a class="hrl-btn" href="<%= hr_lite.admin_payroll_line_items_path(month: (@month - 1.month).strftime("%Y-%m")) %>">&larr;</a>
+    <strong><%= @month.strftime("%B %Y") %></strong>
+    <a class="hrl-btn" href="<%= hr_lite.admin_payroll_line_items_path(month: (@month + 1.month).strftime("%Y-%m")) %>">&rarr;</a>
+  </div>
+  <p class="hrl-muted hrl-small">
+    Payroll reads these when the month's run is computed. Add them before
+    computing, or recompute the run while it is still in review.
+  </p>
+</section>
+
+<section class="hrl-card">
+  <% if @items.empty? %>
+    <p class="hrl-muted">Nothing added for <%= @month.strftime("%B %Y") %>.</p>
+  <% else %>
+    <div class="hrl-table-wrap">
+      <table class="hrl-table hrl-table--stack">
+        <thead><tr><th>Person</th><th>Item</th><th>Amount</th><th>Note</th><th></th></tr></thead>
+        <tbody>
+          <% @items.each do |item| %>
+            <tr>
+              <td data-label="Person"><%= hr_display_name(item.user) %></td>
+              <td data-label="Item"><%= item.component.label %> (<%= item.component.kind %>)</td>
+              <td data-label="Amount" class="hrl-num"><%= hrl_money(item.amount) %></td>
+              <td data-label="Note"><%= item.note %></td>
+              <td data-label="">
+                <%= button_to "Remove", hr_lite.admin_payroll_line_item_path(item),
+                      method: :delete, class: "hrl-btn hrl-btn--danger",
+                      form: { data: { turbo_confirm: "Remove this item?" } } %>
+              </td>
+            </tr>
+          <% end %>
+        </tbody>
+      </table>
+    </div>
+  <% end %>
+  <%= hrl_pagination %>
+</section>

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

@@ -0,0 +1,42 @@
+<% content_for(:page_title) { "Add a pay item" } %>
+<div class="hrl-page__head"><h1 class="hrl-page__title">Add a pay item</h1></div>
+
+<section class="hrl-card">
+  <p class="hrl-muted hrl-small">
+    A bonus, incentive, arrears, reimbursement or one-time deduction on one
+    month's payslip. Payroll picks it up when that month's run is computed —
+    add it first, or recompute the run while it is in review. A month that
+    has already been paid is refused.
+  </p>
+  <%= form_with model: @item, url: hr_lite.admin_payroll_line_items_path, method: :post, local: true do |f| %>
+    <%= render "hr_lite/shared/form_errors", record: @item %>
+    <div class="hrl-field">
+      <%= f.label :user_id, "Employee" %>
+      <%= f.select :user_id, options_for_select(HrLite.employees.map { |u| [ hr_display_name(u), u.id ] },
+                                                @item.user_id) %>
+    </div>
+    <div class="hrl-field">
+      <%= f.label :component_id, "Item" %>
+      <%# Loan repayment is left out: finalize books that line against the person's loans. %>
+      <%= f.select :component_id,
+                   HrLite::SalaryComponent.active.ordered.where.not(code: "loan_repayment")
+                                          .map { |c| [ "#{c.label} (#{c.kind})", c.id ] } %>
+    </div>
+    <div class="hrl-field">
+      <%= f.label :period_month, "Month" %>
+      <%= f.month_field :period_month, value: @item.period_month&.strftime("%Y-%m") %>
+    </div>
+    <div class="hrl-field">
+      <%= f.label :amount, "Amount (₹)" %>
+      <%= f.text_field :amount, value: @item.amount&.to_s("F"), inputmode: "decimal" %>
+    </div>
+    <div class="hrl-field">
+      <%= f.label :note, "Note (optional)" %>
+      <%= f.text_field :note %>
+    </div>
+    <div class="hrl-form-actions">
+      <%= f.submit "Add", class: "hrl-btn hrl-btn--primary" %>
+      <a class="hrl-btn" href="<%= hr_lite.admin_payroll_line_items_path(month: @item.period_month&.strftime("%Y-%m")) %>">Cancel</a>
+    </div>
+  <% end %>
+</section>

data/app/views/hr_lite/admin/payroll_runs/show.html.erb

@@ -2,6 +2,7 @@
 <div class="hrl-page__head">
   <h1 class="hrl-page__title">Payroll — <%= @run.label %></h1>
   <div class="hrl-page__actions">
+    <a class="hrl-btn" href="<%= hr_lite.admin_payroll_line_items_path(month: @run.period_month.strftime("%Y-%m")) %>">One-off items</a>
     <a class="hrl-btn" href="<%= hr_lite.admin_payroll_runs_path %>">All runs</a>
   </div>
 </div>

data/app/views/hr_lite/admin/salary_structures/_form.html.erb

@@ -14,7 +14,11 @@
     <div class="hrl-field hrl-field--check"><%= f.check_box :esi_applicable %><%= f.label :esi_applicable, "ESI applicable (auto-exempt above gross ceiling)" %></div>
     <div class="hrl-field">
       <%= f.label :pt_state, "Professional tax state" %>
-      <%= f.select :pt_state, HrLite::StatutoryRateCard.for(Date.current)[:pt].keys.map { |s| [ s.humanize, s ] } %>
+      <%# A stored rate card carries no PT (slabs live in their own table), so list those states too. %>
+      <% pt_states = [ HrLite::ProfessionalTaxSlab::NO_LEVY, structure.pt_state ] |
+                     HrLite::ProfessionalTaxSlab.distinct.order(:state).pluck(:state) |
+                     HrLite::StatutoryRateCard.for(Date.current)[:pt].keys %>
+      <%= f.select :pt_state, pt_states.map { |s| [ s.humanize, s ] } %>
     </div>
     <div class="hrl-field"><%= f.label :notes %><%= f.text_area :notes %></div>
     <div class="hrl-form-actions">

data/app/views/hr_lite/admin/shared/_approvals_tabs.html.erb

@@ -1,4 +1,4 @@
-<%# locals: active (:leaves | :comp_off | :regularizations) %>
+<%# locals: active (:leaves | :comp_off | :regularizations | :balances) %>
 <div class="hrl-row" style="margin-bottom:.85rem;">
   <a class="hrl-btn <%= 'hrl-btn--primary' if active == :leaves %>"
      href="<%= hr_lite.admin_leave_requests_path %>">Leaves</a>
@@ -8,4 +8,6 @@
   <a class="hrl-btn <%= 'hrl-btn--primary' if active == :regularizations %>"
      href="<%= hr_lite.admin_regularization_requests_path %>">Regularization
     <% if (n = HrLite::RegularizationRequest.pending.count).positive? %><span class="hrl-badge hrl-badge--warn"><%= n %></span><% end %></a>
+  <a class="hrl-btn <%= 'hrl-btn--primary' if active == :balances %>"
+     href="<%= hr_lite.admin_leave_balances_path %>">Balances</a>
 </div>

data/app/views/hr_lite/leave_requests/index.html.erb

@@ -2,6 +2,7 @@
 <div class="hrl-page__head">
   <h1 class="hrl-page__title">My leaves</h1>
   <div class="hrl-page__actions">
+    <a class="hrl-btn" href="<%= hr_lite.leave_balances_path %>">Balances</a>
     <a class="hrl-btn" href="<%= hr_lite.comp_off_requests_path %>">Comp-off</a>
     <a class="hrl-btn hrl-btn--primary" href="<%= hr_lite.new_leave_request_path %>">Apply</a>
   </div>

data/app/views/hr_lite/leave_requests/new.html.erb

@@ -4,6 +4,7 @@
 </div>
 
 <%= render "hr_lite/leave_requests/balance_chips" %>
+<p class="hrl-small hrl-muted">Days beyond your balance are unpaid (loss of pay), cut from that month's salary.</p>
 
 <section class="hrl-card">
   <%= form_with model: @request, url: hr_lite.leave_requests_path, local: true do |f| %>

data/app/views/hr_lite/salary_slips/index.html.erb

@@ -24,6 +24,6 @@
     </div>
     <%= hrl_pagination %>
   <% else %>
-    <p class="hrl-card--empty">No published salary slips yet.</p>
+    <p class="hrl-card--empty">No published salary slips yet.<% if (day = HrLite.config.slip_release_day) %> Each month's slip opens on the <%= day.ordinalize %> of the next month.<% end %></p>
   <% end %>
 </section>

data/app/views/layouts/hr_lite/application.html.erb

@@ -30,10 +30,10 @@
           <%= hrl_nav_link(item) %>
         <% end %>
 
-        <% if hr_admin? || hr_leadership? %>
+        <% if hr_admin? || hr_leadership? || hr_can?("expense.approve", scope: :team) %>
           <span class="hrl-side__group">Manage</span>
           <% hrl_nav_items(HrLite::ApplicationHelper::ADMIN_NAV_ITEMS).each do |item| %>
-            <%= hrl_nav_link(item) %>
+            <%= hrl_nav_link(item) if item[:if] || hr_admin? || hr_leadership? %>
           <% end %>
         <% end %>
 
@@ -100,10 +100,10 @@
         <% rest.each do |item| %>
           <%= hrl_nav_link(item) %>
         <% end %>
-        <% if hr_admin? || hr_leadership? %>
+        <% if hr_admin? || hr_leadership? || hr_can?("expense.approve", scope: :team) %>
           <span class="hrl-side__group">Manage</span>
           <% hrl_nav_items(HrLite::ApplicationHelper::ADMIN_NAV_ITEMS).each do |item| %>
-            <%= hrl_nav_link(item) %>
+            <%= hrl_nav_link(item) if item[:if] || hr_admin? || hr_leadership? %>
           <% end %>
         <% end %>
         <% if hr_leadership? || hr_superadmin? %>

data/config/routes.rb

@@ -91,11 +91,15 @@ HrLite::Engine.routes.draw do
     resources :assets, only: %i[index new create] do
       member { post :assign; post :take_back }
     end
+    resources :benefits, only: %i[index new create] do
+      member { post :enrol; post :unenrol }
+    end
     resources :checklists, only: :index do
       member { post :complete; post :reopen }
     end
     resources :leave_types, except: :show
     resources :office_locations, except: :show
+    resources :expense_categories, except: %i[show destroy]
     resources :holidays, only: %i[index create update destroy] do
       collection { post :bulk_create }
     end
@@ -119,6 +123,7 @@ HrLite::Engine.routes.draw do
         get :register
       end
     end
+    resources :payroll_line_items, only: %i[index new create destroy]
     resources :salary_slips, only: %i[show update]
     resource :setting, only: %i[edit update]
     resources :audit_logs, only: :index

data/db/migrate/20260929081109_add_paid_days_to_hr_lite_leave_requests.rb

@@ -0,0 +1,5 @@
+class AddPaidDaysToHrLiteLeaveRequests < ActiveRecord::Migration[8.1]
+  def change
+    add_column :hr_lite_leave_requests, :paid_days, :decimal, precision: 4, scale: 1
+  end
+end

data/lib/hr_lite/configuration.rb

@@ -14,7 +14,7 @@ module HrLite
                   # the HR shell; nil (default) shows nothing.
                   :notifications
 
-    attr_reader :leave_year_start_month
+    attr_reader :leave_year_start_month, :slip_release_day
 
     # Misconfiguration must fail at boot, not as production 500s on every
     # balance screen. Accepts "7" (ENV-friendly) and validates 1..12.
@@ -27,6 +27,15 @@ module HrLite
       @leave_year_start_month = month
     end
 
+    # nil = an employee sees a slip the moment it is published; 10 = the
+    # October slip opens on 10 November. 1..28 so every month has that day.
+    def slip_release_day=(value)
+      day = value.presence && Integer(value)
+      raise ArgumentError, "slip_release_day must be 1..28 or nil, got #{value.inspect}" if day && !(1..28).cover?(day)
+
+      @slip_release_day = day
+    end
+
     # 0.1.0 pre-release name for public_url_base; kept as an alias so early
     # adopters' initializers don't break.
     alias_method :mail_link_base, :public_url_base
@@ -67,6 +76,7 @@ module HrLite
       @notification_matrix   = nil # resolved lazily to Notifications::DEFAULT_MATRIX
       @back_link             = nil # optional {label:, url:} for the shell nav
       @leave_year_start_month = 1  # 1 = calendar year; 7 = July–June leave year
+      @slip_release_day       = nil # e.g. 10 = slips open on the 10th of the next month
 
       # Leadership onboarding/offboarding. onboard_user must return a saved
       # user record (default: create on user_class with whatever of

data/lib/hr_lite/notifications.rb

@@ -48,7 +48,7 @@ module HrLite
       "resignation.accepted"  => { bell: true,  email: true,  leadership_email: true,  leadership_bell: false },
       "resignation.withdrawn" => { bell: true,  email: false, leadership_email: true,  leadership_bell: false },
       "employee.onboarded"    => { bell: true,  email: true,  leadership_email: true,  leadership_bell: false },
-      "payroll.draft_ready"   => { bell: false, email: false, leadership_email: true,  leadership_bell: true  },
+      "payroll.draft_ready"   => { bell: true,  email: true,  leadership_email: false, leadership_bell: false },
       "leave.team_notice"     => { bell: true,  email: false, leadership_email: false, leadership_bell: false },
       "comp_off.requested"    => { bell: true,  email: false, leadership_email: true,  leadership_bell: true  },
       "comp_off.approved"     => { bell: true,  email: true,  leadership_email: true,  leadership_bell: false },
@@ -73,8 +73,10 @@ module HrLite
       # employee-scoped path ("Your appraisal has been shared", /appraisals/7):
       # fanned out verbatim, leadership read them as being about themselves and
       # followed a link their own scope 404s or resolves to their own record.
+      # `skip_leadership:` is for a delayed employee half of an event whose
+      # leadership copy already went out.
       def publish(event, title:, body: nil, path: nil, bell_to: [], email_to: [], lines: [],
-                  diff: nil, link_url: nil, leadership: {})
+                  diff: nil, link_url: nil, leadership: {}, skip_leadership: false)
         row = matrix[event.to_s]
         unless row
           Rails.logger.warn("[hr_lite] unknown notification event #{event}")
@@ -87,6 +89,8 @@ module HrLite
 
         deliver_bells(event, row, bell_to, title, body, path)
         deliver_emails(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)
         deliver_leadership_bells(event, row, bell_to, lead_title, lead_body, lead_path)
         nil

data/lib/hr_lite/version.rb

@@ -1,3 +1,3 @@
 module HrLite
-  VERSION = "0.16.0"
+  VERSION = "0.18.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: hr_lite
 version: !ruby/object:Gem::Version
-  version: 0.16.0
+  version: 0.18.0
 platform: ruby
 authors:
 - kshitiz sinha
@@ -75,11 +75,13 @@ files:
 - app/controllers/hr_lite/admin/attendances_controller.rb
 - app/controllers/hr_lite/admin/audit_logs_controller.rb
 - app/controllers/hr_lite/admin/base_controller.rb
+- app/controllers/hr_lite/admin/benefits_controller.rb
 - app/controllers/hr_lite/admin/checklists_controller.rb
 - app/controllers/hr_lite/admin/comp_off_requests_controller.rb
 - app/controllers/hr_lite/admin/designation_changes_controller.rb
 - app/controllers/hr_lite/admin/documents_controller.rb
 - 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/holidays_controller.rb
 - app/controllers/hr_lite/admin/hr_requests_controller.rb
@@ -90,6 +92,7 @@ files:
 - app/controllers/hr_lite/admin/loans_controller.rb
 - app/controllers/hr_lite/admin/office_locations_controller.rb
 - app/controllers/hr_lite/admin/overview_controller.rb
+- app/controllers/hr_lite/admin/payroll_line_items_controller.rb
 - app/controllers/hr_lite/admin/payroll_runs_controller.rb
 - app/controllers/hr_lite/admin/policies_controller.rb
 - app/controllers/hr_lite/admin/regularization_requests_controller.rb
@@ -137,6 +140,7 @@ files:
 - app/jobs/hr_lite/document_expiry_job.rb
 - app/jobs/hr_lite/leave_year_rollover_job.rb
 - app/jobs/hr_lite/payroll_auto_draft_job.rb
+- app/jobs/hr_lite/slips_ready_job.rb
 - app/mailers/hr_lite/application_mailer.rb
 - app/mailers/hr_lite/event_mailer.rb
 - app/models/concerns/hr_lite/approvable.rb
@@ -214,6 +218,8 @@ files:
 - app/views/hr_lite/admin/attendances/index.html.erb
 - app/views/hr_lite/admin/attendances/show.html.erb
 - app/views/hr_lite/admin/audit_logs/index.html.erb
+- app/views/hr_lite/admin/benefits/index.html.erb
+- app/views/hr_lite/admin/benefits/new.html.erb
 - app/views/hr_lite/admin/checklists/index.html.erb
 - app/views/hr_lite/admin/comp_off_requests/index.html.erb
 - app/views/hr_lite/admin/comp_off_requests/show.html.erb
@@ -225,6 +231,10 @@ files:
 - app/views/hr_lite/admin/employees/index.html.erb
 - app/views/hr_lite/admin/employees/new.html.erb
 - app/views/hr_lite/admin/employees/show.html.erb
+- app/views/hr_lite/admin/expense_categories/_form.html.erb
+- app/views/hr_lite/admin/expense_categories/edit.html.erb
+- 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/holidays/index.html.erb
 - app/views/hr_lite/admin/hr_requests/index.html.erb
@@ -245,6 +255,8 @@ files:
 - app/views/hr_lite/admin/office_locations/index.html.erb
 - app/views/hr_lite/admin/office_locations/new.html.erb
 - app/views/hr_lite/admin/overview/index.html.erb
+- app/views/hr_lite/admin/payroll_line_items/index.html.erb
+- app/views/hr_lite/admin/payroll_line_items/new.html.erb
 - app/views/hr_lite/admin/payroll_runs/index.html.erb
 - app/views/hr_lite/admin/payroll_runs/new.html.erb
 - app/views/hr_lite/admin/payroll_runs/show.html.erb
@@ -361,6 +373,7 @@ files:
 - db/migrate/20260818010401_create_hr_lite_assets_and_onboarding.rb
 - db/migrate/20260927100145_add_id_card_fields_to_hr_lite_employee_profiles.rb
 - db/migrate/20260927101031_add_created_by_id_to_hr_lite_leave_requests.rb
+- db/migrate/20260929081109_add_paid_days_to_hr_lite_leave_requests.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