hr_lite 0.8.0 → 0.11.0

data/app/services/hr_lite/slip_builder.rb

@@ -33,8 +33,17 @@ module HrLite
       earnings = Calculators::Proration.call(
         structure: @structure, payable_days: payable, days_in_month: days_in_month
       )
+      # One-off heads for this month: a bonus, arrears after a backdated
+      # revision, a reimbursement. A prorated head is scaled like basic; a
+      # bonus is not halved because somebody joined mid-month.
+      extra_earnings, extra_deductions = one_off_lines(payable, days_in_month)
+      earnings += extra_earnings
+
       gross_earned = earnings.sum(BigDecimal(0)) { |row| row[:amount] }
       basic_earned = earnings.find { |row| row[:code] == "basic" }&.fetch(:amount) || BigDecimal(0)
+      # ESI is assessed on wages, and a reimbursement is not one. Heads that
+      # opt out are excluded from the gross it reads.
+      esi_gross = gross_earned - earnings.sum(BigDecimal(0)) { |row| row[:excluded_from_esi] ? row[:amount] : 0 }
 
       deductions = []
       employer_costs = {}
@@ -50,7 +59,7 @@ module HrLite
         )
       end
 
-      esi = Calculators::Esi.call(monthly_gross: esi_reference_gross, gross_earned: gross_earned,
+      esi = Calculators::Esi.call(monthly_gross: esi_reference_gross, gross_earned: esi_gross,
                                   applicable: @structure.esi_applicable, rates: @rates[:esi])
       if esi.applicable?
         deductions << { code: "esi_employee", label: "ESI", amount: esi.employee }
@@ -61,9 +70,13 @@ module HrLite
                                              period_month: @run.period_month, rates: @rates[:pt])
       deductions << { code: "pt", label: "Professional tax", amount: pt } if pt.positive?
 
+      deductions.concat(extra_deductions)
+      loan = loan_instalment
+      deductions << loan if loan
+
       fy = SalarySlip.fy_to_date(@user, @run.period_month)
       tds = Calculators::Tds.call(
-        regime: @profile.tax_regime,
+        regime: tax_regime,
         structure_monthly_gross: @structure.monthly_gross,
         gross_earned_this_month: gross_earned,
         # Plus anything paid this FY that this install never ran — a previous
@@ -73,7 +86,7 @@ module HrLite
         fy_gross_paid: fy[:gross] + Money.d(@profile.fy_opening_gross),
         fy_tds_paid: fy[:tds] + Money.d(@profile.fy_opening_tds),
         months_remaining: months_remaining_in_fy,
-        declared_annual_deductions: @profile.declared_annual_deductions,
+        declared_annual_deductions: annual_deductions,
         rates: @rates[:income_tax],
         override: @tds_override
       )
@@ -107,6 +120,66 @@ module HrLite
 
     private
 
+    # The declaration if the employee filed one, else the single figure an
+    # admin typed on the profile. Old-regime deductions came from that one
+    # opaque number, with nothing to show what it was made of and nowhere to
+    # keep the proof; a filed declaration supersedes it, and once HR has
+    # verified the proof only what the proof supported counts.
+    # A declaration names the regime the employee chose for that year, which
+    # is a per-YEAR decision; the profile column is only the fallback for
+    # somebody who never filed one.
+    def tax_regime
+      TaxDeclaration.for(@user, @run.period_month)&.regime || @profile.tax_regime
+    end
+
+    def annual_deductions
+      declaration = TaxDeclaration.for(@user, @run.period_month)
+      return @profile.declared_annual_deductions if declaration.nil?
+      return @profile.declared_annual_deductions if declaration.draft?
+
+      declaration.allowable_total
+    end
+
+    # Splits this month's one-off lines into earnings and deductions, in the
+    # component order an install configured. Returns [earnings, deductions].
+    def one_off_lines(payable, days_in_month)
+      rows = PayrollLineItem.for_slip(@user, @run.period_month)
+                            .sort_by { |item| [ item.component.position, item.component.label ] }
+      earnings = []
+      deductions = []
+
+      rows.each do |item|
+        component = item.component
+        amount = if component.prorated
+          Money.round2(item.amount * (Money.d(payable) / Money.d(days_in_month)))
+        else
+          item.amount
+        end
+        next unless amount.positive?
+
+        row = { code: component.code, label: component.label, amount: amount }
+        if component.earning?
+          earnings << row.merge(excluded_from_esi: !component.counts_for_esi)
+        else
+          deductions << row
+        end
+      end
+
+      [ earnings, deductions ]
+    end
+
+    # The month's loan instalment, as one deduction line. Computed here and
+    # BOOKED only when the run is finalized — a draft is recomputed freely,
+    # and booking at compute would take a repayment on every pass.
+    def loan_instalment
+      total = Loan.active.where(user_id: @user.id).sum(BigDecimal(0)) do |loan|
+        loan.instalment_for(@run.period_month)
+      end
+      return nil unless total.positive?
+
+      { code: "loan_repayment", label: "Loan repayment", amount: total }
+    end
+
     # Months left in the Indian FY (Apr–Mar) including the run month itself:
     # April = 12, December = 4, January = 3, March = 1. Capped at the exit
     # month for a leaver, so a final settlement is not spread over months

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

@@ -0,0 +1,66 @@
+<% content_for(:page_title) { "Waiting on you" } %>
+<div class="hrl-page__head">
+  <h1 class="hrl-page__title">Waiting on you</h1>
+</div>
+
+<% if @covering_for.any? %>
+  <section class="hrl-card">
+    <p class="hrl-small hrl-muted">
+      You are covering for
+      <%= @covering_for.map { |d| hr_display_name(d.from_user) }.to_sentence %>.
+      Their approvals appear below alongside your own.
+    </p>
+  </section>
+<% end %>
+
+<section class="hrl-card">
+  <% if @approvals.empty? %>
+    <p class="hrl-muted">Nothing is waiting on you.</p>
+  <% else %>
+    <div class="hrl-table-wrap">
+      <table class="hrl-table hrl-table--stack">
+        <thead><tr><th>Request</th><th>From</th><th>Waiting</th><th></th></tr></thead>
+        <tbody>
+          <% @approvals.each do |approval| %>
+            <% subject = approval.subject %>
+            <tr>
+              <td data-label="Request">
+                <strong><%= approval.label %></strong>
+                <% if approval.overdue? %>
+                  <span class="hrl-badge hrl-badge--bad">Overdue</span>
+                <% end %>
+                <% if approval.approver_id != hr_current_user.id %>
+                  <span class="hrl-badge hrl-badge--muted">
+                    for <%= hr_display_name(approval.approver) %>
+                  </span>
+                <% end %>
+              </td>
+              <td data-label="From"><%= hr_display_name(subject&.user) %></td>
+              <td data-label="Waiting"><%= time_ago_in_words(approval.created_at) %></td>
+              <td data-label="">
+                <% if (path = hrl_approval_path(approval)) %>
+                  <a class="hrl-small" href="<%= path %>">Open</a>
+                <% end %>
+              </td>
+            </tr>
+          <% end %>
+        </tbody>
+      </table>
+    </div>
+    <%= hrl_pagination %>
+  <% end %>
+</section>
+
+<% if @delegations.any? %>
+  <section class="hrl-card">
+    <h2 class="hrl-card__title">While you are away</h2>
+    <ul>
+      <% @delegations.each do |delegation| %>
+        <li class="hrl-small">
+          <%= hr_display_name(delegation.to_user) %> decides for you,
+          <%= delegation.starts_on.strftime("%d %b") %> – <%= delegation.ends_on.strftime("%d %b %Y") %>
+        </li>
+      <% end %>
+    </ul>
+  </section>
+<% end %>

data/config/routes.rb

@@ -19,6 +19,7 @@ HrLite::Engine.routes.draw do
   resources :regularization_requests, only: %i[index new create] do
     member { post :cancel }
   end
+  resources :approvals, only: :index
   get "team", to: "team#show"
   get "org", to: "org#show"
   resources :holidays, only: :index

data/db/migrate/20260818001151_create_hr_lite_approvals.rb

@@ -0,0 +1,79 @@
+class CreateHrLiteApprovals < ActiveRecord::Migration[8.1]
+  # Leave, comp-off, regularization and resignation each grew their own
+  # approve/reject/cancel, with their own transition guard and their own
+  # notification. Four copies of one idea, and every module still to come
+  # (expenses, loans, salary revisions, document verification) would have
+  # been a fifth.
+  #
+  # A FLOW is the definition — "leave needs the manager, then HR". A STEP is
+  # one rung of it, naming an approver by RULE rather than by person, so the
+  # flow survives somebody leaving. An APPROVAL is one live decision on one
+  # record.
+  def change
+    create_table :hr_lite_approval_flows do |t|
+      # The model this flow decides on, e.g. "HrLite::LeaveRequest".
+      t.string :subject_type, null: false
+      t.string :name, null: false
+      t.boolean :active, null: false, default: true
+      t.timestamps
+    end
+    add_index :hr_lite_approval_flows, :subject_type,
+              unique: true, where: "active", name: "index_hr_lite_approval_flows_one_active_per_type"
+
+    create_table :hr_lite_approval_steps do |t|
+      t.references :flow, null: false, index: false,
+                   foreign_key: { to_table: :hr_lite_approval_flows, on_delete: :cascade }
+      t.integer :position, null: false
+      # manager | manager_of_manager | permission | user
+      t.string :approver_rule, null: false
+      # permission key for `permission`, user id for `user`, unused otherwise
+      t.string :approver_key
+      # Everybody on this rung must decide, rather than the first to answer.
+      t.boolean :unanimous, null: false, default: false
+      # Hours before the step is escalated. Null = never.
+      t.integer :sla_hours
+      t.timestamps
+    end
+    add_index :hr_lite_approval_steps, %i[flow_id position], unique: true
+    add_check_constraint :hr_lite_approval_steps,
+                         "approver_rule IN ('manager', 'manager_of_manager', 'permission', 'user')",
+                         name: "hr_lite_approval_steps_rule_check"
+
+    create_table :hr_lite_approvals do |t|
+      t.string :subject_type, null: false
+      t.bigint :subject_id, null: false
+      t.references :step, null: false, index: false,
+                   foreign_key: { to_table: :hr_lite_approval_steps, on_delete: :cascade }
+      t.integer :position, null: false
+      t.bigint :approver_id, null: false
+      # pending | approved | rejected | returned | skipped | cancelled
+      t.string :status, null: false, default: "pending"
+      t.text :note
+      t.datetime :decided_at
+      # Who decided in the approver's place, when they had delegated.
+      t.bigint :decided_by_id
+      t.datetime :escalated_at
+      t.timestamps
+    end
+    add_index :hr_lite_approvals, %i[subject_type subject_id position]
+    # One live row per approver per rung: two would let the same person
+    # decide twice, or a retry double-count a unanimous step.
+    add_index :hr_lite_approvals, %i[subject_type subject_id position approver_id],
+              unique: true, name: "index_hr_lite_approvals_one_per_approver_per_step"
+    add_index :hr_lite_approvals, :approver_id
+    add_check_constraint :hr_lite_approvals,
+                         "status IN ('pending', 'approved', 'rejected', 'returned', 'skipped', 'cancelled')",
+                         name: "hr_lite_approvals_status_check"
+
+    create_table :hr_lite_approval_delegations do |t|
+      t.bigint :from_user_id, null: false
+      t.bigint :to_user_id, null: false
+      t.date :starts_on, null: false
+      t.date :ends_on, null: false
+      t.string :reason
+      t.timestamps
+    end
+    add_index :hr_lite_approval_delegations, %i[from_user_id starts_on ends_on],
+              name: "index_hr_lite_delegations_on_from_and_dates"
+  end
+end

data/db/migrate/20260818002627_create_hr_lite_payroll_components_and_loans.rb

@@ -0,0 +1,72 @@
+class CreateHrLitePayrollComponentsAndLoans < ActiveRecord::Migration[8.1]
+  # Payroll knew exactly four earning heads — basic, HRA, special allowance,
+  # "other" — because they were columns on the salary structure. A bonus, an
+  # incentive, an LTA or a reimbursement had nowhere to go but "other", which
+  # is one number on a payslip that should have said what it was for.
+  #
+  # Heads are DATA now. Amounts stay encrypted for the same reason every
+  # amount in this engine is: a payslip line is somebody's pay.
+  def change
+    create_table :hr_lite_salary_components do |t|
+      t.string :code, null: false
+      t.string :label, null: false
+      # earning | deduction
+      t.string :kind, null: false, default: "earning"
+      # Prorated by attendance like basic, or paid whole (a bonus is not
+      # halved because somebody joined mid-month).
+      t.boolean :prorated, null: false, default: true
+      t.boolean :taxable, null: false, default: true
+      # Counts toward the gross ESI is assessed on.
+      t.boolean :counts_for_esi, null: false, default: true
+      t.integer :position, null: false, default: 0
+      t.boolean :active, null: false, default: true
+      t.timestamps
+    end
+    add_index :hr_lite_salary_components, :code, unique: true
+    add_check_constraint :hr_lite_salary_components, "kind IN ('earning', 'deduction')",
+                         name: "hr_lite_salary_components_kind_check"
+
+    # A one-off on a single month's payslip: a bonus, an incentive, an
+    # arrears line after a backdated revision, a reimbursement. Dated to the
+    # month rather than to the run, so it survives a run being deleted and
+    # recomputed.
+    create_table :hr_lite_payroll_line_items do |t|
+      t.bigint :user_id, null: false
+      t.date :period_month, null: false
+      t.references :component, null: false, index: true,
+                   foreign_key: { to_table: :hr_lite_salary_components }
+      t.text :amount, null: false # encrypted BigDecimal
+      t.string :note
+      t.bigint :created_by_id
+      t.timestamps
+    end
+    add_index :hr_lite_payroll_line_items, %i[user_id period_month]
+
+    create_table :hr_lite_loans do |t|
+      t.bigint :user_id, null: false
+      t.text :principal, null: false      # encrypted
+      t.text :monthly_instalment, null: false # encrypted
+      t.date :starts_on, null: false
+      t.string :reason
+      # active | closed | cancelled
+      t.string :status, null: false, default: "active"
+      t.bigint :approved_by_id
+      t.timestamps
+    end
+    add_index :hr_lite_loans, %i[user_id status]
+    add_check_constraint :hr_lite_loans, "status IN ('active', 'closed', 'cancelled')",
+                         name: "hr_lite_loans_status_check"
+
+    # One row per month actually deducted. The outstanding balance is derived
+    # from these rather than stored, so a recompute cannot double-count and a
+    # deleted run cannot leave the balance wrong.
+    create_table :hr_lite_loan_repayments do |t|
+      t.references :loan, null: false, index: true,
+                   foreign_key: { to_table: :hr_lite_loans, on_delete: :cascade }
+      t.date :period_month, null: false
+      t.text :amount, null: false # encrypted
+      t.timestamps
+    end
+    add_index :hr_lite_loan_repayments, %i[loan_id period_month], unique: true
+  end
+end

data/db/migrate/20260818003616_create_hr_lite_documents_and_declarations.rb

@@ -0,0 +1,73 @@
+class CreateHrLiteDocumentsAndDeclarations < ActiveRecord::Migration[8.1]
+  # Two gaps that were table stakes and simply absent: nowhere to keep an
+  # employee's documents, and a tax declaration that was ONE opaque number.
+  #
+  # `declared_annual_deductions` on the profile is a single figure an admin
+  # types in. Nobody can see what it is made of, the employee cannot submit
+  # their own, and there is nowhere to put the proof. That is the number the
+  # whole year's TDS is projected from.
+  def change
+    create_table :hr_lite_documents do |t|
+      t.bigint :user_id, null: false
+      # aadhaar | pan | passport | bank | offer_letter | ... — data, so an
+      # install can add its own without a release.
+      t.string :category, null: false
+      t.string :title, null: false
+      t.string :reference_number
+      t.date :issued_on
+      t.date :expires_on
+      # self | hr | money — who may open the file. A payslip and a passport
+      # are not the same kind of secret.
+      #
+      # No column default on purpose: the model derives one from the category
+      # when none was chosen, and a column default would make "unset" and
+      # "deliberately hr" indistinguishable.
+      t.string :visibility, null: false
+      # pending | verified | rejected
+      t.string :verification, null: false, default: "pending"
+      t.bigint :verified_by_id
+      t.datetime :verified_at
+      t.string :verification_note
+      t.bigint :uploaded_by_id
+      t.timestamps
+    end
+    add_index :hr_lite_documents, %i[user_id category]
+    add_index :hr_lite_documents, :expires_on
+    add_check_constraint :hr_lite_documents, "visibility IN ('self', 'hr', 'money')",
+                         name: "hr_lite_documents_visibility_check"
+    add_check_constraint :hr_lite_documents,
+                         "verification IN ('pending', 'verified', 'rejected')",
+                         name: "hr_lite_documents_verification_check"
+
+    create_table :hr_lite_tax_declarations do |t|
+      t.bigint :user_id, null: false
+      # 1 April of the financial year it covers.
+      t.date :financial_year, null: false
+      t.string :regime, null: false, default: "new"
+      # draft | submitted | verified | rejected
+      t.string :status, null: false, default: "draft"
+      t.datetime :submitted_at
+      t.bigint :verified_by_id
+      t.datetime :verified_at
+      t.string :note
+      t.timestamps
+    end
+    add_index :hr_lite_tax_declarations, %i[user_id financial_year], unique: true
+    add_check_constraint :hr_lite_tax_declarations,
+                         "status IN ('draft', 'submitted', 'verified', 'rejected')",
+                         name: "hr_lite_tax_declarations_status_check"
+
+    create_table :hr_lite_tax_declaration_items do |t|
+      t.references :declaration, null: false, index: true,
+                   foreign_key: { to_table: :hr_lite_tax_declarations, on_delete: :cascade }
+      # 80c | 80d | hra | 80ccd_1b | 24b | other
+      t.string :section, null: false
+      t.string :label
+      t.text :declared_amount, null: false # encrypted
+      # What proof actually supported, once HR has looked. Null until then.
+      t.text :verified_amount
+      t.timestamps
+    end
+    add_index :hr_lite_tax_declaration_items, %i[declaration_id section]
+  end
+end

data/lib/hr_lite/notifications.rb

@@ -24,6 +24,16 @@ module HrLite
       "appraisal.shared"      => { bell: true,  email: true,  leadership_email: true,  leadership_bell: false },
       "promotion.recorded"    => { bell: true,  email: true,  leadership_email: true,  leadership_bell: true  },
       "policy.changed"        => { bell: false, email: false, leadership_email: true,  leadership_bell: true  },
+      # An approval past its deadline. Leadership hears too — a decision
+      # nobody is making is a process problem, not just one person's inbox.
+      "approval.escalated"    => { bell: true,  email: true,  leadership_email: true,  leadership_bell: false },
+      # Tax declarations. The submission bells whoever verifies them; the
+      # decision goes back to the employee, whose year's TDS depends on it.
+      "tax.declaration_submitted" => { bell: true, email: false, leadership_email: false, leadership_bell: false },
+      "tax.declaration_decided"   => { bell: true, email: true,  leadership_email: false, leadership_bell: false },
+      # A document about to lapse — a passport or a visa is somebody's right
+      # to work, and finding out late is the whole problem.
+      "document.expiring"     => { bell: true,  email: true,  leadership_email: true,  leadership_bell: false },
       "digest.daily"          => { bell: false, email: false, leadership_email: true,  leadership_bell: false },
       "resignation.submitted" => { bell: true,  email: false, leadership_email: true,  leadership_bell: true  },
       "resignation.accepted"  => { bell: true,  email: true,  leadership_email: true,  leadership_bell: false },

data/lib/hr_lite/permissions.rb

@@ -43,6 +43,10 @@ module HrLite
       "appraisal.manage" => [ "Growth", "Write, share and act on appraisals and promotions" ],
       "resignation.view" => [ "Lifecycle", "See resignations" ],
       "resignation.manage" => [ "Lifecycle", "Accept resignations and set the last working day" ],
+      "document.view" => [ "Documents", "Open other people's documents" ],
+      "document.manage" => [ "Documents", "Upload, verify and open identity and bank documents" ],
+      "tax.view" => [ "Payroll", "See tax declarations" ],
+      "tax.manage" => [ "Payroll", "Verify tax declarations and the proof behind them" ],
       "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" ],

data/lib/hr_lite/role_seeds.rb

@@ -17,7 +17,7 @@ module HrLite
           "leave.request" => "self", "leave.view" => "self",
           "attendance.view" => "self", "payroll.view" => "self",
           "profile.view" => "self", "appraisal.view" => "self",
-          "resignation.view" => "self"
+          "resignation.view" => "self", "document.view" => "self", "tax.view" => "self"
         }
       },
       Role::MANAGER => {
@@ -35,7 +35,8 @@ module HrLite
           "leave.request" => "self", "leave.view" => "all", "leave.approve" => "all",
           "leave.manage" => "all", "attendance.view" => "all", "attendance.manage" => "all",
           "profile.view" => "all", "payroll.view" => "self",
-          "appraisal.view" => "self", "resignation.view" => "all"
+          "appraisal.view" => "self", "resignation.view" => "all",
+          "document.view" => "all", "tax.view" => "self"
         }
       },
       Role::FINANCE => {
@@ -45,6 +46,7 @@ module HrLite
           "attendance.view" => "all", "profile.view" => "all",
           "payroll.view" => "all", "payroll.manage" => "all", "payroll.export" => "all",
           "salary.view" => "all", "salary.manage" => "all",
+          "tax.view" => "all", "tax.manage" => "all",
           "audit.view" => "all", "audit.view_money" => "all"
         }
       },
@@ -55,7 +57,8 @@ module HrLite
           "leave.manage" => "all", "attendance.view" => "all", "attendance.manage" => "all",
           "profile.view" => "all", "profile.manage" => "all",
           "resignation.view" => "all", "resignation.manage" => "all",
-          "settings.manage" => "all", "audit.view" => "all", "payroll.view" => "self"
+          "settings.manage" => "all", "audit.view" => "all", "payroll.view" => "self",
+          "document.view" => "all"
         }
       },
       Role::SUPER_ADMIN => {

data/lib/hr_lite/version.rb

@@ -1,3 +1,3 @@
 module HrLite
-  VERSION = "0.8.0"
+  VERSION = "0.11.0"
 end

data/lib/tasks/hr_lite_tasks.rake

@@ -4,7 +4,8 @@ namespace :hr_lite do
     require "hr_lite/seeds"
     require "hr_lite/role_seeds"
     require "hr_lite/statutory_seeds"
-    created = HrLite::Seeds.run! + HrLite::RoleSeeds.call + HrLite::StatutorySeeds.call
+    created = HrLite::Seeds.run! + HrLite::RoleSeeds.call + HrLite::StatutorySeeds.call +
+              HrLite::SalaryComponent.seed_defaults!
     puts created.any? ? "hr_lite:seed created: #{created.join(', ')}" : "hr_lite:seed — nothing to do"
   end
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: hr_lite
 version: !ruby/object:Gem::Version
-  version: 0.8.0
+  version: 0.11.0
 platform: ruby
 authors:
 - kshitiz sinha
@@ -81,6 +81,7 @@ files:
 - app/controllers/hr_lite/admin/superadmin_controller.rb
 - app/controllers/hr_lite/application_controller.rb
 - app/controllers/hr_lite/appraisals_controller.rb
+- app/controllers/hr_lite/approvals_controller.rb
 - app/controllers/hr_lite/attendance_controller.rb
 - app/controllers/hr_lite/calendar_controller.rb
 - app/controllers/hr_lite/career_controller.rb
@@ -99,19 +100,27 @@ files:
 - app/controllers/hr_lite/users_controller.rb
 - app/helpers/hr_lite/application_helper.rb
 - app/jobs/hr_lite/application_job.rb
+- app/jobs/hr_lite/approval_escalation_job.rb
 - app/jobs/hr_lite/daily_digest_job.rb
+- 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/mailers/hr_lite/application_mailer.rb
 - app/mailers/hr_lite/event_mailer.rb
+- app/models/concerns/hr_lite/approvable.rb
 - app/models/concerns/hr_lite/audited.rb
 - app/models/concerns/hr_lite/encrypted_money.rb
 - app/models/hr_lite/application_record.rb
 - app/models/hr_lite/appraisal.rb
+- app/models/hr_lite/approval.rb
+- app/models/hr_lite/approval_delegation.rb
+- app/models/hr_lite/approval_flow.rb
+- app/models/hr_lite/approval_step.rb
 - app/models/hr_lite/attendance_record.rb
 - app/models/hr_lite/audit_log.rb
 - app/models/hr_lite/comp_off_request.rb
 - app/models/hr_lite/designation_change.rb
+- app/models/hr_lite/document.rb
 - app/models/hr_lite/employee_profile.rb
 - app/models/hr_lite/holiday.rb
 - app/models/hr_lite/kudo.rb
@@ -119,7 +128,10 @@ files:
 - app/models/hr_lite/leave_balance.rb
 - app/models/hr_lite/leave_request.rb
 - app/models/hr_lite/leave_type.rb
+- app/models/hr_lite/loan.rb
+- app/models/hr_lite/loan_repayment.rb
 - app/models/hr_lite/office_location.rb
+- app/models/hr_lite/payroll_line_item.rb
 - app/models/hr_lite/payroll_run.rb
 - app/models/hr_lite/professional_tax_slab.rb
 - app/models/hr_lite/regularization_request.rb
@@ -127,11 +139,15 @@ files:
 - app/models/hr_lite/role.rb
 - app/models/hr_lite/role_assignment.rb
 - app/models/hr_lite/role_grant.rb
+- app/models/hr_lite/salary_component.rb
 - app/models/hr_lite/salary_slip.rb
 - app/models/hr_lite/salary_structure.rb
 - app/models/hr_lite/setting.rb
 - app/models/hr_lite/statutory_rate_card_record.rb
+- app/models/hr_lite/tax_declaration.rb
+- app/models/hr_lite/tax_declaration_item.rb
 - app/services/hr_lite/access.rb
+- app/services/hr_lite/approval_route.rb
 - app/services/hr_lite/attendance_puncher.rb
 - app/services/hr_lite/attendance_summary.rb
 - app/services/hr_lite/calculators/esi.rb
@@ -195,6 +211,7 @@ files:
 - app/views/hr_lite/admin/statutory_rate_cards/new.html.erb
 - app/views/hr_lite/appraisals/index.html.erb
 - app/views/hr_lite/appraisals/show.html.erb
+- app/views/hr_lite/approvals/index.html.erb
 - app/views/hr_lite/attendance/_month_grid.html.erb
 - app/views/hr_lite/attendance/_punch_card.html.erb
 - app/views/hr_lite/attendance/show.html.erb
@@ -263,6 +280,9 @@ files:
 - db/migrate/20260817183347_create_hr_lite_roles_and_grants.rb
 - db/migrate/20260817183629_seed_hr_lite_roles_from_email_tiers.rb
 - db/migrate/20260817190159_create_hr_lite_statutory_rate_cards.rb
+- db/migrate/20260818001151_create_hr_lite_approvals.rb
+- db/migrate/20260818002627_create_hr_lite_payroll_components_and_loans.rb
+- db/migrate/20260818003616_create_hr_lite_documents_and_declarations.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