RubyGems - hr_lite - Versions diffs - 0.1.0 - Mend

hr_lite 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (176) hide show

checksums.yaml +7 -0
data/CHANGELOG.md +33 -0
data/MIT-LICENSE +20 -0
data/README.md +166 -0
data/Rakefile +3 -0
data/app/assets/javascripts/hr_lite/geo_punch.js +61 -0
data/app/assets/javascripts/hr_lite/mention.js +100 -0
data/app/assets/stylesheets/hr_lite/application.css +15 -0
data/app/assets/stylesheets/hr_lite/hr_lite.css +239 -0
data/app/controllers/hr_lite/admin/appraisals_controller.rb +74 -0
data/app/controllers/hr_lite/admin/attendances_controller.rb +79 -0
data/app/controllers/hr_lite/admin/audit_logs_controller.rb +9 -0
data/app/controllers/hr_lite/admin/base_controller.rb +16 -0
data/app/controllers/hr_lite/admin/designation_changes_controller.rb +33 -0
data/app/controllers/hr_lite/admin/employees_controller.rb +53 -0
data/app/controllers/hr_lite/admin/holidays_controller.rb +70 -0
data/app/controllers/hr_lite/admin/leadership_controller.rb +18 -0
data/app/controllers/hr_lite/admin/leave_balances_controller.rb +41 -0
data/app/controllers/hr_lite/admin/leave_requests_controller.rb +41 -0
data/app/controllers/hr_lite/admin/leave_types_controller.rb +54 -0
data/app/controllers/hr_lite/admin/office_locations_controller.rb +46 -0
data/app/controllers/hr_lite/admin/overview_controller.rb +12 -0
data/app/controllers/hr_lite/admin/payroll_runs_controller.rb +93 -0
data/app/controllers/hr_lite/admin/salary_slips_controller.rb +44 -0
data/app/controllers/hr_lite/admin/salary_structures_controller.rb +49 -0
data/app/controllers/hr_lite/admin/settings_controller.rb +18 -0
data/app/controllers/hr_lite/application_controller.rb +76 -0
data/app/controllers/hr_lite/appraisals_controller.rb +18 -0
data/app/controllers/hr_lite/attendance_controller.rb +37 -0
data/app/controllers/hr_lite/calendar_controller.rb +20 -0
data/app/controllers/hr_lite/career_controller.rb +9 -0
data/app/controllers/hr_lite/employee_profiles_controller.rb +9 -0
data/app/controllers/hr_lite/holidays_controller.rb +9 -0
data/app/controllers/hr_lite/home_controller.rb +7 -0
data/app/controllers/hr_lite/kudos_controller.rb +36 -0
data/app/controllers/hr_lite/leave_balances_controller.rb +11 -0
data/app/controllers/hr_lite/leave_requests_controller.rb +56 -0
data/app/controllers/hr_lite/salary_slips_controller.rb +39 -0
data/app/controllers/hr_lite/users_controller.rb +9 -0
data/app/helpers/hr_lite/application_helper.rb +105 -0
data/app/jobs/hr_lite/application_job.rb +4 -0
data/app/jobs/hr_lite/daily_digest_job.rb +33 -0
data/app/jobs/hr_lite/leave_year_rollover_job.rb +29 -0
data/app/mailers/hr_lite/application_mailer.rb +5 -0
data/app/mailers/hr_lite/event_mailer.rb +33 -0
data/app/models/concerns/hr_lite/audited.rb +70 -0
data/app/models/concerns/hr_lite/encrypted_money.rb +32 -0
data/app/models/hr_lite/application_record.rb +5 -0
data/app/models/hr_lite/appraisal.rb +89 -0
data/app/models/hr_lite/attendance_record.rb +41 -0
data/app/models/hr_lite/audit_log.rb +17 -0
data/app/models/hr_lite/designation_change.rb +52 -0
data/app/models/hr_lite/employee_profile.rb +72 -0
data/app/models/hr_lite/holiday.rb +18 -0
data/app/models/hr_lite/kudo.rb +54 -0
data/app/models/hr_lite/kudo_mention.rb +8 -0
data/app/models/hr_lite/leave_balance.rb +42 -0
data/app/models/hr_lite/leave_request.rb +207 -0
data/app/models/hr_lite/leave_type.rb +22 -0
data/app/models/hr_lite/office_location.rb +21 -0
data/app/models/hr_lite/payroll_run.rb +112 -0
data/app/models/hr_lite/salary_slip.rb +78 -0
data/app/models/hr_lite/salary_structure.rb +49 -0
data/app/models/hr_lite/setting.rb +14 -0
data/app/services/hr_lite/attendance_puncher.rb +103 -0
data/app/services/hr_lite/attendance_summary.rb +98 -0
data/app/services/hr_lite/calculators/esi.rb +25 -0
data/app/services/hr_lite/calculators/pf.rb +32 -0
data/app/services/hr_lite/calculators/professional_tax.rb +20 -0
data/app/services/hr_lite/calculators/proration.rb +30 -0
data/app/services/hr_lite/calculators/tds.rb +74 -0
data/app/services/hr_lite/day_status.rb +49 -0
data/app/services/hr_lite/leave_day_counter.rb +24 -0
data/app/services/hr_lite/overview_query.rb +39 -0
data/app/services/hr_lite/payroll_run_processor.rb +46 -0
data/app/services/hr_lite/pdf_renderer.rb +23 -0
data/app/services/hr_lite/slip_builder.rb +106 -0
data/app/services/hr_lite/working_calendar.rb +41 -0
data/app/views/hr_lite/admin/appraisals/_form.html.erb +29 -0
data/app/views/hr_lite/admin/appraisals/edit.html.erb +6 -0
data/app/views/hr_lite/admin/appraisals/new.html.erb +6 -0
data/app/views/hr_lite/admin/attendances/index.html.erb +49 -0
data/app/views/hr_lite/admin/attendances/show.html.erb +55 -0
data/app/views/hr_lite/admin/audit_logs/index.html.erb +39 -0
data/app/views/hr_lite/admin/designation_changes/new.html.erb +19 -0
data/app/views/hr_lite/admin/employees/_form.html.erb +40 -0
data/app/views/hr_lite/admin/employees/edit.html.erb +3 -0
data/app/views/hr_lite/admin/employees/index.html.erb +40 -0
data/app/views/hr_lite/admin/employees/new.html.erb +3 -0
data/app/views/hr_lite/admin/employees/show.html.erb +75 -0
data/app/views/hr_lite/admin/holidays/index.html.erb +59 -0
data/app/views/hr_lite/admin/leave_balances/index.html.erb +58 -0
data/app/views/hr_lite/admin/leave_requests/index.html.erb +35 -0
data/app/views/hr_lite/admin/leave_requests/show.html.erb +39 -0
data/app/views/hr_lite/admin/leave_types/_form.html.erb +27 -0
data/app/views/hr_lite/admin/leave_types/edit.html.erb +10 -0
data/app/views/hr_lite/admin/leave_types/index.html.erb +39 -0
data/app/views/hr_lite/admin/leave_types/new.html.erb +3 -0
data/app/views/hr_lite/admin/office_locations/_form.html.erb +18 -0
data/app/views/hr_lite/admin/office_locations/edit.html.erb +10 -0
data/app/views/hr_lite/admin/office_locations/index.html.erb +30 -0
data/app/views/hr_lite/admin/office_locations/new.html.erb +3 -0
data/app/views/hr_lite/admin/overview/index.html.erb +72 -0
data/app/views/hr_lite/admin/payroll_runs/index.html.erb +33 -0
data/app/views/hr_lite/admin/payroll_runs/new.html.erb +20 -0
data/app/views/hr_lite/admin/payroll_runs/show.html.erb +76 -0
data/app/views/hr_lite/admin/salary_slips/show.html.erb +42 -0
data/app/views/hr_lite/admin/salary_structures/_form.html.erb +25 -0
data/app/views/hr_lite/admin/salary_structures/edit.html.erb +6 -0
data/app/views/hr_lite/admin/salary_structures/new.html.erb +6 -0
data/app/views/hr_lite/admin/settings/edit.html.erb +18 -0
data/app/views/hr_lite/appraisals/index.html.erb +22 -0
data/app/views/hr_lite/appraisals/show.html.erb +32 -0
data/app/views/hr_lite/attendance/_month_grid.html.erb +41 -0
data/app/views/hr_lite/attendance/_punch_card.html.erb +41 -0
data/app/views/hr_lite/attendance/show.html.erb +22 -0
data/app/views/hr_lite/calendar/show.html.erb +45 -0
data/app/views/hr_lite/career/show.html.erb +49 -0
data/app/views/hr_lite/employee_profiles/show.html.erb +22 -0
data/app/views/hr_lite/event_mailer/event.html.erb +10 -0
data/app/views/hr_lite/event_mailer/event.text.erb +10 -0
data/app/views/hr_lite/event_mailer/leadership.html.erb +27 -0
data/app/views/hr_lite/event_mailer/leadership.text.erb +16 -0
data/app/views/hr_lite/holidays/_next_holiday.html.erb +12 -0
data/app/views/hr_lite/holidays/index.html.erb +30 -0
data/app/views/hr_lite/home/index.html.erb +25 -0
data/app/views/hr_lite/kudos/_kudo.html.erb +17 -0
data/app/views/hr_lite/kudos/index.html.erb +39 -0
data/app/views/hr_lite/leave_balances/index.html.erb +19 -0
data/app/views/hr_lite/leave_requests/_balance_chips.html.erb +17 -0
data/app/views/hr_lite/leave_requests/index.html.erb +37 -0
data/app/views/hr_lite/leave_requests/new.html.erb +36 -0
data/app/views/hr_lite/leave_requests/show.html.erb +25 -0
data/app/views/hr_lite/salary_slips/_slip_detail.html.erb +48 -0
data/app/views/hr_lite/salary_slips/index.html.erb +29 -0
data/app/views/hr_lite/salary_slips/pdf.html.erb +72 -0
data/app/views/hr_lite/salary_slips/show.html.erb +12 -0
data/app/views/hr_lite/shared/_form_errors.html.erb +10 -0
data/app/views/hr_lite/shared/_pagination.html.erb +11 -0
data/app/views/layouts/hr_lite/application.html.erb +56 -0
data/app/views/layouts/hr_lite/mailer.html.erb +30 -0
data/app/views/layouts/hr_lite/mailer.text.erb +6 -0
data/app/views/layouts/hr_lite/pdf.html.erb +26 -0
data/config/routes.rb +57 -0
data/db/migrate/20260718190726_create_hr_lite_kudos.rb +14 -0
data/db/migrate/20260718190727_create_hr_lite_kudo_mentions.rb +12 -0
data/db/migrate/20260718190728_create_hr_lite_audit_logs.rb +15 -0
data/db/migrate/20260718192342_create_hr_lite_office_locations.rb +13 -0
data/db/migrate/20260718192343_create_hr_lite_attendance_records.rb +27 -0
data/db/migrate/20260718193045_create_hr_lite_holidays.rb +14 -0
data/db/migrate/20260718193046_create_hr_lite_leave_types.rb +20 -0
data/db/migrate/20260718193047_create_hr_lite_leave_balances.rb +17 -0
data/db/migrate/20260718193048_create_hr_lite_leave_requests.rb +23 -0
data/db/migrate/20260718193049_create_hr_lite_settings.rb +10 -0
data/db/migrate/20260718194534_create_hr_lite_employee_profiles.rb +27 -0
data/db/migrate/20260718194535_create_hr_lite_salary_structures.rb +23 -0
data/db/migrate/20260718194536_create_hr_lite_payroll_runs.rb +20 -0
data/db/migrate/20260718194537_create_hr_lite_salary_slips.rb +28 -0
data/db/migrate/20260718195953_create_hr_lite_appraisals.rb +22 -0
data/db/migrate/20260718195954_create_hr_lite_designation_changes.rb +17 -0
data/lib/generators/hr_lite/install/install_generator.rb +29 -0
data/lib/generators/hr_lite/install/templates/AFTER_INSTALL +35 -0
data/lib/generators/hr_lite/install/templates/initializer.rb +45 -0
data/lib/hr_lite/configuration.rb +60 -0
data/lib/hr_lite/current.rb +7 -0
data/lib/hr_lite/engine.rb +39 -0
data/lib/hr_lite/geo.rb +22 -0
data/lib/hr_lite/mention_parser.rb +18 -0
data/lib/hr_lite/money.rb +33 -0
data/lib/hr_lite/notifications.rb +99 -0
data/lib/hr_lite/seeds.rb +42 -0
data/lib/hr_lite/statutory_rate_card.rb +60 -0
data/lib/hr_lite/version.rb +3 -0
data/lib/hr_lite.rb +104 -0
data/lib/tasks/hr_lite_tasks.rake +8 -0
metadata +250 -0

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

@@ -0,0 +1,56 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <title><%= [ content_for(:page_title), "Earthly HR" ].compact.join(" · ") %></title>
+  <meta name="viewport" content="width=device-width, initial-scale=1, viewport-fit=cover">
+  <%= csrf_meta_tags %>
+  <%= csp_meta_tag %>
+  <%= yield :head %>
+  <%= stylesheet_link_tag "hr_lite/hr_lite", media: "all" %>
+  <% HrLite.config.extra_stylesheets.each do |sheet| %>
+    <%= stylesheet_link_tag sheet, media: "all" %>
+  <% end %>
+</head>
+<body class="hrl-body">
+  <header class="hrl-appbar">
+    <div class="hrl-appbar__inner">
+      <a class="hrl-appbar__brand" href="<%= hr_lite.root_path %>"><%= HrLite.config.company.call[:name].presence || "HR" %></a>
+      <nav class="hrl-nav hrl-nav--top" aria-label="HR">
+        <% hrl_nav_items(HrLite::ApplicationHelper::NAV_ITEMS).each do |item| %>
+          <%= hrl_nav_link(item) %>
+        <% end %>
+        <% if hr_admin? || hr_leadership? %>
+          <span class="hrl-nav__sep" aria-hidden="true"></span>
+          <% hrl_nav_items(HrLite::ApplicationHelper::ADMIN_NAV_ITEMS).each do |item| %>
+            <%= hrl_nav_link(item) %>
+          <% end %>
+        <% end %>
+        <% if hr_leadership? %>
+          <% hrl_nav_items(HrLite::ApplicationHelper::LEADERSHIP_NAV_ITEMS).each do |item| %>
+            <%= hrl_nav_link(item) %>
+          <% end %>
+        <% end %>
+        <% if HrLite.config.back_link %>
+          <a class="hrl-nav__link hrl-nav__link--back" href="<%= HrLite.config.back_link[:url] %>"><%= HrLite.config.back_link[:label] %></a>
+        <% end %>
+      </nav>
+      <span class="hrl-appbar__user"><%= hr_display_name(hr_current_user) %></span>
+    </div>
+  </header>
+  <main class="hrl-main">
+    <% if flash[:notice].present? %><div class="hrl-flash hrl-flash--ok" role="status"><%= flash[:notice] %></div><% end %>
+    <% if flash[:alert].present? %><div class="hrl-flash hrl-flash--warn" role="alert"><%= flash[:alert] %></div><% end %>
+    <%= yield %>
+  </main>
+  <nav class="hrl-tabbar" aria-label="HR sections">
+    <% hrl_nav_items(HrLite::ApplicationHelper::NAV_ITEMS).first(5).each do |item| %>
+      <%= hrl_nav_link(item) %>
+    <% end %>
+  </nav>
+  <%= javascript_include_tag "hr_lite/mention", defer: true %>
+  <%= yield :scripts %>
+</body>
+</html>

data/app/views/layouts/hr_lite/mailer.html.erb ADDED Viewed

@@ -0,0 +1,30 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
+  <style>
+    body { margin: 0; background: #f4f5f7; font-family: -apple-system, "Segoe UI", Roboto, Arial, sans-serif; color: #111827; }
+    .wrap { max-width: 560px; margin: 0 auto; padding: 24px 16px; }
+    .card { background: #ffffff; border: 1px solid #e5e7eb; border-radius: 12px; padding: 24px; }
+    .brand { font-size: 13px; color: #6b7280; margin-bottom: 12px; }
+    h1 { font-size: 18px; margin: 0 0 12px; }
+    p { font-size: 14px; line-height: 1.55; }
+    .lines { margin: 16px 0; padding: 0; }
+    .lines li { font-size: 14px; margin: 4px 0 4px 18px; }
+    .diff { width: 100%; border-collapse: collapse; margin: 16px 0; font-size: 13px; }
+    .diff th, .diff td { text-align: left; border-bottom: 1px solid #e5e7eb; padding: 6px 8px; }
+    .diff th { color: #6b7280; font-weight: 600; }
+    .btn { display: inline-block; background: #2563eb; color: #ffffff !important; padding: 10px 18px; border-radius: 8px; text-decoration: none; font-size: 14px; font-weight: 600; margin-top: 8px; }
+    .foot { font-size: 12px; color: #6b7280; margin-top: 16px; }
+  </style>
+</head>
+<body>
+  <div class="wrap">
+    <div class="card">
+      <div class="brand"><%= HrLite.config.company.call[:name].presence || "HR" %></div>
+      <%= yield %>
+      <p class="foot">Sent by the HR system. Do not reply to this email.</p>
+    </div>
+  </div>
+</body>
+</html>

data/app/views/layouts/hr_lite/mailer.text.erb ADDED Viewed

@@ -0,0 +1,6 @@
+<%= HrLite.config.company.call[:name].presence || "HR" %>
+<%= yield %>
+--
+Sent by the HR system. Do not reply to this email.

data/app/views/layouts/hr_lite/pdf.html.erb ADDED Viewed

@@ -0,0 +1,26 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
+  <style>
+    body { font-family: "Helvetica Neue", Helvetica, Arial, sans-serif; color: #111; font-size: 12px; margin: 0; }
+    .pdf-card { border: 1px solid #ddd; border-radius: 10px; padding: 18px; margin-bottom: 14px; }
+    .pdf-head { display: flex; justify-content: space-between; align-items: flex-start; }
+    .pdf-company { font-size: 16px; font-weight: 700; }
+    .pdf-muted { color: #666; }
+    h1 { font-size: 15px; margin: 0 0 4px; }
+    table { width: 100%; border-collapse: collapse; margin: 8px 0; }
+    th, td { text-align: left; padding: 6px 8px; border-bottom: 1px solid #e5e5e5; }
+    th { font-size: 10px; text-transform: uppercase; letter-spacing: .04em; color: #666; }
+    td.num, th.num { text-align: right; }
+    tr.total td { font-weight: 700; border-top: 2px solid #111; }
+    .pdf-net { background: #f0f7f2; border-radius: 8px; padding: 12px 16px; font-size: 14px; font-weight: 700; }
+    .pdf-foot { font-size: 9px; color: #888; margin-top: 16px; }
+    .cols { display: flex; gap: 14px; }
+    .cols > div { flex: 1; }
+  </style>
+</head>
+<body>
+  <%= yield %>
+</body>
+</html>

data/config/routes.rb ADDED Viewed

@@ -0,0 +1,57 @@
+HrLite::Engine.routes.draw do
+  root "home#index"
+  resources :kudos, only: %i[index create destroy]
+  get "users/search", to: "users#search"
+  resource :attendance, only: :show, controller: "attendance" do
+    post :check_in
+    post :check_out
+  end
+  resources :leave_requests, only: %i[index show new create] do
+    member { post :cancel }
+  end
+  resources :leave_balances, only: :index
+  resources :holidays, only: :index
+  get "calendar", to: "calendar#show"
+  resources :salary_slips, only: %i[index show]
+  resource :employee_profile, only: :show, path: "profile"
+  get "career", to: "career#show"
+  resources :appraisals, only: %i[index show]
+  namespace :admin do
+    get "overview", to: "overview#index"
+    resources :attendances, only: %i[index show update], param: :user_id
+    resources :leave_requests, only: %i[index show] do
+      member { post :approve; post :reject }
+    end
+    resources :leave_balances, only: :index do
+      collection { post :adjust }
+    end
+    resources :leave_types, except: :show
+    resources :office_locations, except: :show
+    resources :holidays, only: %i[index create update destroy] do
+      collection { post :bulk_create }
+    end
+    resources :employees, except: :destroy do
+      resources :salary_structures, only: %i[new create edit update]
+      resources :appraisals, only: %i[new create edit update destroy] do
+        member { post :share }
+      end
+      resources :designation_changes, only: %i[new create]
+    end
+    resources :payroll_runs, only: %i[index show new create destroy] do
+      member do
+        post :compute
+        post :finalize
+        post :unlock
+        post :publish
+        get :register
+      end
+    end
+    resources :salary_slips, only: %i[show update]
+    resource :setting, only: %i[edit update]
+    resources :audit_logs, only: :index
+  end
+end

data/db/migrate/20260718190726_create_hr_lite_kudos.rb ADDED Viewed

@@ -0,0 +1,14 @@
+class CreateHrLiteKudos < ActiveRecord::Migration[8.1]
+  def change
+    create_table :hr_lite_kudos do |t|
+      # No FK to the host user table — its name is host-specific.
+      t.bigint :giver_id, null: false
+      t.string :badge
+      t.text :message, null: false
+      t.timestamps
+    end
+    add_index :hr_lite_kudos, :giver_id
+    add_index :hr_lite_kudos, :created_at
+  end
+end

data/db/migrate/20260718190727_create_hr_lite_kudo_mentions.rb ADDED Viewed

@@ -0,0 +1,12 @@
+class CreateHrLiteKudoMentions < ActiveRecord::Migration[8.1]
+  def change
+    create_table :hr_lite_kudo_mentions do |t|
+      t.references :kudo, null: false, foreign_key: { to_table: :hr_lite_kudos, on_delete: :cascade }
+      t.bigint :user_id, null: false
+      t.timestamps
+    end
+    add_index :hr_lite_kudo_mentions, [ :kudo_id, :user_id ], unique: true
+    add_index :hr_lite_kudo_mentions, :user_id
+  end
+end

data/db/migrate/20260718190728_create_hr_lite_audit_logs.rb ADDED Viewed

@@ -0,0 +1,15 @@
+class CreateHrLiteAuditLogs < ActiveRecord::Migration[8.1]
+  def change
+    create_table :hr_lite_audit_logs do |t|
+      t.bigint :actor_id
+      t.string :action, null: false
+      t.string :subject_type, null: false
+      t.bigint :subject_id, null: false
+      t.json :audited_changes, null: false, default: {}
+      t.datetime :created_at, null: false
+    end
+    add_index :hr_lite_audit_logs, [ :subject_type, :subject_id ]
+    add_index :hr_lite_audit_logs, :created_at
+  end
+end

data/db/migrate/20260718192342_create_hr_lite_office_locations.rb ADDED Viewed

@@ -0,0 +1,13 @@
+class CreateHrLiteOfficeLocations < ActiveRecord::Migration[8.1]
+  def change
+    create_table :hr_lite_office_locations do |t|
+      t.string :name, null: false
+      t.decimal :lat, precision: 9, scale: 6, null: false
+      t.decimal :lng, precision: 9, scale: 6, null: false
+      t.integer :radius_m, null: false, default: 200
+      t.boolean :active, null: false, default: true
+      t.timestamps
+    end
+  end
+end

data/db/migrate/20260718192343_create_hr_lite_attendance_records.rb ADDED Viewed

@@ -0,0 +1,27 @@
+class CreateHrLiteAttendanceRecords < ActiveRecord::Migration[8.1]
+  def change
+    create_table :hr_lite_attendance_records do |t|
+      t.bigint :user_id, null: false
+      t.date :date, null: false
+      t.datetime :check_in_at
+      t.datetime :check_out_at
+      t.decimal :check_in_lat, precision: 9, scale: 6
+      t.decimal :check_in_lng, precision: 9, scale: 6
+      t.integer :check_in_accuracy_m
+      t.decimal :check_out_lat, precision: 9, scale: 6
+      t.decimal :check_out_lng, precision: 9, scale: 6
+      t.integer :check_out_accuracy_m
+      t.string :status, null: false, default: "present"
+      t.boolean :flagged, null: false, default: false
+      t.string :flag_note
+      t.bigint :regularized_by_id
+      t.datetime :regularized_at
+      t.text :regularization_note
+      t.timestamps
+    end
+    add_index :hr_lite_attendance_records, [ :user_id, :date ], unique: true
+    add_index :hr_lite_attendance_records, :date
+    add_index :hr_lite_attendance_records, [ :date, :flagged ]
+  end
+end

data/db/migrate/20260718193045_create_hr_lite_holidays.rb ADDED Viewed

@@ -0,0 +1,14 @@
+class CreateHrLiteHolidays < ActiveRecord::Migration[8.1]
+  def change
+    create_table :hr_lite_holidays do |t|
+      t.date :date, null: false
+      t.string :name, null: false
+      # Optional/restricted holidays render on the calendar but do NOT
+      # count as working-day exclusions.
+      t.boolean :optional, null: false, default: false
+      t.timestamps
+    end
+    add_index :hr_lite_holidays, :date, unique: true
+  end
+end

data/db/migrate/20260718193046_create_hr_lite_leave_types.rb ADDED Viewed

@@ -0,0 +1,20 @@
+class CreateHrLiteLeaveTypes < ActiveRecord::Migration[8.1]
+  def change
+    create_table :hr_lite_leave_types do |t|
+      t.string :name, null: false
+      t.string :code, null: false
+      t.string :color, null: false, default: "#0ea5e9"
+      t.boolean :paid, null: false, default: true
+      # nil quota = unlimited (LWP).
+      t.decimal :annual_quota, precision: 4, scale: 1
+      t.string :accrual, null: false, default: "yearly_upfront"
+      t.decimal :carry_forward_cap, precision: 4, scale: 1, null: false, default: 0
+      t.boolean :active, null: false, default: true
+      t.integer :position, null: false, default: 0
+      t.timestamps
+    end
+    add_index :hr_lite_leave_types, :code, unique: true
+    add_index :hr_lite_leave_types, :name, unique: true
+  end
+end

data/db/migrate/20260718193047_create_hr_lite_leave_balances.rb ADDED Viewed

@@ -0,0 +1,17 @@
+class CreateHrLiteLeaveBalances < ActiveRecord::Migration[8.1]
+  def change
+    create_table :hr_lite_leave_balances do |t|
+      t.bigint :user_id, null: false
+      t.references :leave_type, null: false, foreign_key: { to_table: :hr_lite_leave_types }
+      t.integer :year, null: false
+      # Only carry-in and manual adjustments are materialized; entitlement
+      # and usage are computed live so they self-heal.
+      t.decimal :carried_forward, precision: 4, scale: 1, null: false, default: 0
+      t.decimal :adjustment, precision: 5, scale: 1, null: false, default: 0
+      t.string :adjustment_note
+      t.timestamps
+    end
+    add_index :hr_lite_leave_balances, [ :user_id, :leave_type_id, :year ], unique: true
+  end
+end

data/db/migrate/20260718193048_create_hr_lite_leave_requests.rb ADDED Viewed

@@ -0,0 +1,23 @@
+class CreateHrLiteLeaveRequests < ActiveRecord::Migration[8.1]
+  def change
+    create_table :hr_lite_leave_requests do |t|
+      t.bigint :user_id, null: false
+      t.references :leave_type, null: false, foreign_key: { to_table: :hr_lite_leave_types }
+      t.date :start_date, null: false
+      t.date :end_date, null: false
+      t.boolean :half_day, null: false, default: false
+      t.text :reason
+      t.string :status, null: false, default: "pending"
+      # Display cache; balance math always recomputes live.
+      t.decimal :days_count, precision: 4, scale: 1, null: false
+      t.bigint :decided_by_id
+      t.datetime :decided_at
+      t.text :decision_note
+      t.timestamps
+    end
+    add_index :hr_lite_leave_requests, [ :user_id, :status ]
+    add_index :hr_lite_leave_requests, [ :status, :start_date ]
+    add_index :hr_lite_leave_requests, [ :start_date, :end_date ]
+  end
+end

data/db/migrate/20260718193049_create_hr_lite_settings.rb ADDED Viewed

@@ -0,0 +1,10 @@
+class CreateHrLiteSettings < ActiveRecord::Migration[8.1]
+  def change
+    # Singleton row — engine-owned settings (weekend policy for now).
+    create_table :hr_lite_settings do |t|
+      t.string :weekend_policy, null: false, default: "sat_sun"
+      t.timestamps
+    end
+  end
+end

data/db/migrate/20260718194534_create_hr_lite_employee_profiles.rb ADDED Viewed

@@ -0,0 +1,27 @@
+class CreateHrLiteEmployeeProfiles < ActiveRecord::Migration[8.1]
+  def change
+    create_table :hr_lite_employee_profiles do |t|
+      t.bigint :user_id, null: false
+      t.string :employee_code, null: false
+      t.string :designation
+      t.date :date_of_birth
+      t.date :date_of_joining, null: false
+      t.date :date_of_exit
+      t.string :department
+      t.string :work_location
+      # Encrypted (Rails AR encryption — text columns):
+      t.text :pan_number
+      t.text :pf_uan
+      t.text :esi_number
+      t.text :bank_account_number
+      t.text :bank_ifsc
+      t.text :declared_annual_deductions
+      t.string :bank_name
+      t.string :tax_regime, null: false, default: "new"
+      t.timestamps
+    end
+    add_index :hr_lite_employee_profiles, :user_id, unique: true
+    add_index :hr_lite_employee_profiles, :employee_code, unique: true
+  end
+end

data/db/migrate/20260718194535_create_hr_lite_salary_structures.rb ADDED Viewed

@@ -0,0 +1,23 @@
+class CreateHrLiteSalaryStructures < ActiveRecord::Migration[8.1]
+  def change
+    create_table :hr_lite_salary_structures do |t|
+      t.bigint :user_id, null: false
+      # Always the 1st of a month — revisions take effect from the 1st only.
+      t.date :effective_from, null: false
+      # Encrypted money (text columns, BigDecimal via EncryptedMoney):
+      t.text :basic
+      t.text :hra
+      t.text :special_allowance
+      t.text :other_earnings
+      t.boolean :pf_applicable, null: false, default: true
+      t.boolean :pf_on_full_basic, null: false, default: false
+      t.boolean :esi_applicable, null: false, default: true
+      t.string :pt_state, null: false, default: "none"
+      t.text :notes
+      t.bigint :created_by_id
+      t.timestamps
+    end
+    add_index :hr_lite_salary_structures, [ :user_id, :effective_from ], unique: true
+  end
+end

data/db/migrate/20260718194536_create_hr_lite_payroll_runs.rb ADDED Viewed

@@ -0,0 +1,20 @@
+class CreateHrLitePayrollRuns < ActiveRecord::Migration[8.1]
+  def change
+    create_table :hr_lite_payroll_runs do |t|
+      t.date :period_month, null: false
+      t.string :status, null: false, default: "draft"
+      t.json :warnings, null: false, default: []
+      t.datetime :processed_at
+      t.datetime :finalized_at
+      t.datetime :published_at
+      t.bigint :created_by_id
+      t.bigint :finalized_by_id
+      t.bigint :published_by_id
+      t.text :notes
+      t.timestamps
+    end
+    add_index :hr_lite_payroll_runs, :period_month, unique: true
+    add_index :hr_lite_payroll_runs, :status
+  end
+end

data/db/migrate/20260718194537_create_hr_lite_salary_slips.rb ADDED Viewed

@@ -0,0 +1,28 @@
+class CreateHrLiteSalarySlips < ActiveRecord::Migration[8.1]
+  def change
+    create_table :hr_lite_salary_slips do |t|
+      t.references :payroll_run, null: false,
+                   foreign_key: { to_table: :hr_lite_payroll_runs, on_delete: :cascade }
+      t.bigint :user_id, null: false
+      t.date :period_month, null: false
+      t.integer :days_in_month, null: false
+      t.decimal :payable_days, precision: 5, scale: 2, null: false
+      t.decimal :lop_days, precision: 5, scale: 2, null: false, default: 0
+      t.decimal :lop_override, precision: 5, scale: 2
+      # Encrypted money / encrypted JSON (text columns):
+      t.text :tds_override
+      t.text :earnings
+      t.text :deductions
+      t.text :employer_costs
+      t.text :tax_details
+      t.text :gross_earnings
+      t.text :total_deductions
+      t.text :net_pay
+      t.datetime :computed_at
+      t.timestamps
+    end
+    add_index :hr_lite_salary_slips, [ :payroll_run_id, :user_id ], unique: true
+    add_index :hr_lite_salary_slips, [ :user_id, :period_month ], unique: true
+  end
+end

data/db/migrate/20260718195953_create_hr_lite_appraisals.rb ADDED Viewed

@@ -0,0 +1,22 @@
+class CreateHrLiteAppraisals < ActiveRecord::Migration[8.1]
+  def change
+    create_table :hr_lite_appraisals do |t|
+      t.bigint :user_id, null: false
+      t.bigint :reviewer_id, null: false
+      t.date :period_start, null: false
+      t.date :period_end, null: false
+      t.integer :rating
+      t.text :strengths
+      t.text :improvements
+      t.string :outcome, null: false, default: "none"
+      t.date :effective_date
+      t.string :new_designation
+      t.string :status, null: false, default: "draft"
+      t.datetime :shared_at
+      t.timestamps
+    end
+    add_index :hr_lite_appraisals, [ :user_id, :period_end ]
+    add_index :hr_lite_appraisals, :status
+  end
+end

data/db/migrate/20260718195954_create_hr_lite_designation_changes.rb ADDED Viewed

@@ -0,0 +1,17 @@
+class CreateHrLiteDesignationChanges < ActiveRecord::Migration[8.1]
+  def change
+    # Append-only career history.
+    create_table :hr_lite_designation_changes do |t|
+      t.bigint :user_id, null: false
+      t.string :from_designation
+      t.string :to_designation, null: false
+      t.date :effective_date, null: false
+      t.text :note
+      t.bigint :appraisal_id
+      t.bigint :created_by_id
+      t.timestamps
+    end
+    add_index :hr_lite_designation_changes, [ :user_id, :effective_date ]
+  end
+end

data/lib/generators/hr_lite/install/install_generator.rb ADDED Viewed

@@ -0,0 +1,29 @@
+require "rails/generators"
+require "rails/generators/base"
+module HrLite
+  module Generators
+    # `rails g hr_lite:install` — drops the annotated initializer and prints
+    # the remaining wiring steps. With --route it also appends a mount line.
+    class InstallGenerator < Rails::Generators::Base
+      source_root File.expand_path("templates", __dir__)
+      class_option :route, type: :boolean, default: false,
+                           desc: "Append `mount HrLite::Engine => \"/hr\"` to config/routes.rb"
+      def copy_initializer
+        template "initializer.rb", "config/initializers/hr_lite.rb"
+      end
+      def add_route
+        return unless options[:route]
+        route 'mount HrLite::Engine => "/hr", as: :hr_lite'
+      end
+      def show_next_steps
+        readme "AFTER_INSTALL" if behavior == :invoke
+      end
+    end
+  end
+end

data/lib/generators/hr_lite/install/templates/AFTER_INSTALL ADDED Viewed

@@ -0,0 +1,35 @@
+hr_lite is almost ready. Remaining steps:
+  1. Mount it (skip if you passed --route):
+       # config/routes.rb — a path…
+       mount HrLite::Engine => "/hr", as: :hr_lite
+       # …or a subdomain:
+       constraints subdomain: "hr" do
+         mount HrLite::Engine => "/", as: :hr_lite
+       end
+  2. Run the migrations — they load straight from the gem, nothing to copy:
+       bin/rails db:migrate
+     (Prefer copies in your repo? `bin/rails hr_lite:install:migrations`
+     first — the engine detects the copies and steps aside.)
+  3. Seed leave types + fixed national holidays (idempotent, deploy-safe):
+       bin/rails hr_lite:seed
+  4. Ensure ActiveRecord encryption keys exist (payroll PII is encrypted):
+       bin/rails db:encryption:init   # if you don't have keys yet
+  5. Schedule the recurring jobs in your job scheduler:
+       HrLite::DailyDigestJob        # each morning
+       HrLite::LeaveYearRolloverJob  # Jan 1
+  6. Review config/initializers/hr_lite.rb — set leadership emails, then
+     restart. Docs: https://github.com/kshtzkr/hr_lite/tree/main/docs

data/lib/generators/hr_lite/install/templates/initializer.rb ADDED Viewed

@@ -0,0 +1,45 @@
+# hr_lite — every host integration point in one place.
+# Full reference: https://github.com/kshtzkr/hr_lite/blob/main/docs/CONFIGURATION.md
+HrLite.configure do |c|
+  # Inherit your auth stack. MUST be set before boot; restart after changing.
+  c.parent_controller   = "ApplicationController"
+  c.user_class          = "User"
+  c.current_user_method = :current_user
+  c.authenticate_method = :authenticate_user!
+  # Operations tier (team attendance, leave decisions, overview board).
+  c.admin_check = ->(user) { user.respond_to?(:admin?) && user.admin? }
+  # Governing tier — ONLY these people change policy, employee profiles,
+  # salary structures, payroll and appraisals. Keep it in an env var so
+  # changing leadership never needs a deploy.
+  c.leadership_emails = ENV.fetch("HR_LEADERSHIP_EMAILS", "").split(",").map(&:strip)
+  # Where the portal is reachable (subdomain or path). Enables email link
+  # buttons and HrLite.public_url / HrLite.public_url? for deep links.
+  # c.public_url_base = "https://hr.example.com"
+  c.mailer_from = "hr@example.com"
+  c.company = -> { { name: "Your Company", address: nil, logo_path: nil } }
+  c.time_zone = "Asia/Kolkata"
+  # In-app notifications -> your bell/notification system (optional).
+  # c.notify = ->(user:, kind:, title:, body:, path:) {
+  #   Notifier.notify(user, kind: kind, title: title, body: body,
+  #                   path: HrLite.public_url(path))
+  # }
+  # Salary-slip PDFs: plug your renderer, or add `gem "wicked_pdf"` +
+  # wkhtmltopdf and the built-in renderer takes over (optional).
+  # c.render_pdf = ->(template:, assigns:, cache_key:) { ... }
+  # Mirror promotions into your own user model (optional).
+  # c.on_designation_change = ->(user, designation) { user.update!(designation: designation) }
+  # Retheme via CSS variables (optional): create a stylesheet overriding
+  # --hrl-* vars and list it here.
+  # c.extra_stylesheets = [ "hr_lite_overrides" ]
+  # Escape hatch back to your app in the HR nav (optional).
+  # c.back_link = { label: "Back to app", url: "https://app.example.com" }
+end